Sphinx extension to create Vim help files.
Converting API documentation of programming languages to Vim help format just got easier.
pip3 install vimbuilder
Add the extension to your conf.py
file:
extensions = [
...,
"vimbuilder",
...,
]
Build Vim help files with sphinx-build
command
sphinx-build -M vimhelp ./docs ./build
You can add the following configurations to your conf.py
file:
Option | Default | Description |
---|---|---|
vimhelp_tag_prefix |
'' |
String to prefix all tags. Useful for separating namespaces in case of multiple sources of documentation. |
vimhelp_tag_suffix |
'' |
String to suffix all tags. See above. |
vimhelp_tag_filename |
True |
Whether to suffix filename to all tags in the file. Clarifies topic of help tag. |
vimhelp_tag_topic |
False |
Same as above except without file extension. |
vimhelp_filename_extension |
'txt' |
Generated filenames will have this extension. |
vimhelp_filename_suffix |
'' |
First tag in a help file is the filename itself. This option adds a suffix to just that tag. |
- Python documentation for Vim and Neovim