vimdoc2html

Converts Vim-style documentation into HTML

GPL-3.0 License

Stars
8

Overview

This is a script to convert Vim documentation file into HTML.

Dependencies

  • Perl
  • Python

Description

The basic usage is:

./vimdoc2html.py plugin.txt

or if the script is somewhere in the $PATH:

vimdoc2html.py plugin.txt

The only "advanced" usage is currently enabled by -r or --raw flag, in which case instead of outputting complete standalone HTML page only minimal output is produced. This way after customizing style/template only the contents can be replaced.

Credit

HTML formatting is performed via modified version of vimh2h.py by Carlo Teubner <(first name) dot (last name) at gmail dot com>. This one is simplified to remove unused here code and a bit improved to add anchors to each tag definition. CSS style is from there too.

Tags are extracted via helpztags tool written by Jakub Turski [email protected] and Artur R. Czechowski [email protected]. It's supplied alongside for convenience and to provide a couple of changes, see there.