Re: [A-a-p-user] About the docs
Brought to you by:
vimboss
From: Dan S. <dw...@ho...> - 2003-07-31 14:52:46
|
>From: Bram Moolenaar <Br...@mo...> > >Dan Sharp wrote: > > > It looks like it is just using the DocBook XSL stylesheets (from the > > docbook/xsl/html/chunk.xsl part of the command). You can get those from > > http://sourceforge.net/project/showfiles.php?group_id=21935 > >OK, I downloaded docbook-xsl-1.61.3.tar.gz and unpacked it. Hmm, that's >a whole bunch of files. I can find the html/chunk.xsl file in there. To make a single-file HTML doc, you will want to reference the docbook.xsl file in the same directory. If you want to get really wild, you can use the changebars.xsl stylesheet and add the revisionflag attribute to tags and give it a value of 'added', 'changed', or 'deleted' and it will appropriately mark the section enclosed by the tag. Looks pretty neat, but probably a lot more than you need :) > > > By the way, how did you convert the documentation from SGML to XML? > > > > When I first started working on my Vim HOWTO, I had to use the SGML > > tools under Linux but used the XML tools in Windows. The only > > conversion I had to do from SGML -> XML was to add > > > > <?xml version="1.0"?> > > > > as the first line above the DOCTYPE, and change the DOCTYPE itself to > > V4.2, since that is what the XML stuff was written to use. I also had > > to add the DTD to the DOCTYPE, but I don't know if that was specific to > > the tool I use or not. > >OK, did that and moved the <?xml thing to before the first comment to >get rid of an obvious error. > >Without the "docbookx.dtd" thing I'm getting lots of errors. >Thus I suppose I need to add that line. But where do I find this file? >It's not in the archive mentioned above. Sorry, I forgot about that. The DTD archive is at http://www.oasis-open.org/docbook/xml/4.2/docbook-xml-4.2.zip I just did a trial and created an empty directory and copied in the DTD files and the docbook-xsl files and my document, and I was able to convert it to HTML and chunked HTML with xsltproc, so these should be all the files you need for that. You will need an extra tool to convert to PDF, though, since xsltproc can only create the FO file. http://docbook.org/wiki/moin.cgi/DocBookPublishingTools Dan Sharp _________________________________________________________________ Add photos to your messages with MSN 8. Get 2 months FREE*. http://join.msn.com/?page=features/featuredemail |