Re: About the docs

Dan Sharp wrote:

> Bram Moolenaar wrote:
> > Adriaan de Groot wrote:
> > 
> >>FWIW, I've already converted all the docs to XML for home use, and use
> >>
> >>	xsltproc /usr/local/kde-3.1/share/apps/ksgmltools2/docbook/xsl/html/chunk.xsl 
> >>exec.sgml
> >>
> >>to use the KDE stylesheets to divide the docbook into one html file per 
> >>chapter; it looks pretty much exactly like your HTML files.
> > 
> > I don't like the idea of having to install KDE 3.1 just for this.  Is
> > the file available separately?  And does it work when just obtaining
> > that chunk.xsl file or are other files included from it?
> 
> 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.

> > 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.
> 
> Basically, my first line went from
> 
> <!doctype article PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
> [
> 	<!-- Entity list -->
> ]>
> 
> to
> 
> <?xml version="1.0"?>
> <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.2//EN" 
> "../../dtd/docbookx.dtd"
> [
> 	<!-- Entity list -->
> ]>

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.

-- 
For a moment, nothing happened.
Then, after a second or so, nothing continued to happen.
		-- Douglas Adams, "The Hitchhiker's Guide to the Galaxy"

 /// Bram Moolenaar -- [email protected] -- http://www.Moolenaar.net   \\\
///          Creator of Vim - Vi IMproved -- http://www.Vim.org          \\\
\\\              Project leader for A-A-P -- http://www.A-A-P.org        ///
 \\\  Help AIDS victims, buy here: http://ICCF-Holland.org/click1.html  ///


-------------------------------------------------------
This SF.Net email sponsored by: Free pre-built ASP.NET sites including
Data Reports, E-commerce, Portals, and Forums are available now.
Download today and enter to win an XBOX or Visual Studio .NET.
http://aspnet.click-url.com/go/psa00100003ave/direct;at.aspnet_072303_01/01