[Vim-latex-devel] Re: tex-refs project and xml to vim-help conversion

[Michael W. <mw...@mi...>]

* Srinath Avadhanula <sr...@fa...> [030201 12:29]:
...
> But if I do lynx test.html and from within lynx do
> print -> save to local file -> test.txt
> then I correctly get:
> 
>    =====================================================================
>    Section name                                            *section-tag*

OK, so I will try to get some helpot to customize the XSL stylesheets
to generate your mentioned HTML output. This may take a while....

...
> It looks like customizing docbook xsl stylesheets is a complicated
> affair from what you said about customizing the output of the section
> tag. So another question: how hard is it to add tags of our own... For
> example, in a vim help file, we typically describe vim options in a
> consistent manner which lends itself nicely to markup.
> (For example try :help 'statusline'). We could do the same thing with a
> series of <table>'s but then we'll have to take care of the indexing
> and stuff ourselves which kind of defeats the purpose of docbook.

If you want a 'valid DocBook XML' document, you are _not_ allowed to
add tags of your own. The reason is obvious: usually you want to process
your XML document using several tools to process different kinds of output
formats. And each tool must know whioch tags are valid, so that it can
handle the source file.

One possibility might be the use of so-called 'processing instrucions'
like e.g.:

<?vimhelp some information for the vim help file backend?>

Processing instructions contain information  required by a specific 
application expected to process the XML data. But then your 'application'
must be capable of handling such processing instructions.

Let me know if this might be a way to ease the development of a special
'tex-refs to vim-help filter application'. I could add such PIs to
the XML source file.

Michael
-- 
mw...@mi...                              http://www.miwie.org
mw...@mi...