Re: [A-a-p-user] About the docs

[Dan S. <dw...@ho...>]

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

> 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 -->
]>


Dan Sharp