[Vim-latex-devel] Re: Whats the best way to write vim documentation?

[Luc H. <her...@fr...>]

hello,

* On Fri, Jan 17, 2003 at 09:10:56PM -0800, Srinath Avadhanula <sr...@fa...> wrote:
> 1. Maintain documentation in a single format. This could be one of
>    vim-help, html, latex, xml or whatever. I have actually never done
>    xml before, but have heard lots about it... I don't know if there
>    are any nice xml tools for windows platforms...

xml is not complicated at all.
There exists several interresting tools that manipulate xml files under
windows platform.
For instance, XT can parse a xml data file and apply an xslt file on it to
convert the data into any desired format: xsl:fo (used to produced
pdf), html, latex, text, etc ; or even vim help file.
It you are interrested, I can search through my bookmarks the links I
got.

> 2. From this one file, I would like to create the vim-help file and the
>    html documentation for the web-page.
> The only way I know of to maintain a single source of documentation is:
> 
> Always edit the vim help file. Use the 2html.vim script to convert to
> html and use that in the web-page. 

I use another way to produce html help file from vim help file. It is
based on awk scripts shipped with vim. It is not so bad.

> Unfortunately I am working on too many things right now to be also
> working on a latex2vim or similar scipt...

-- 
Luc Hermitte
http://hermitte.free.fr/vim/