how to build dvi/ps/pdf of documentation?

Neil Williams linux at codehelp.co.uk
Tue Jul 19 04:12:36 EDT 2005


On Tuesday 19 July 2005 5:15 am, you wrote:
> I get an error:

Please read the README before sending to the list, the README from the CVS of 
gnucash-docs documents what you need to produce other formats from the 
content:

Convert the GnuCash guide into a PDF:
cd guide/C/
docbook2pdf -e no-valid gnucash-guide.sgml

Convert the GnuCash Help Manual into DVI:
cd help/C/
docbook2dvi -e no-valid gnucash-help.sgml

http://cvs.gnucash.org/cgi-bin/cvsweb.cgi/gnucash-docs/README

SGML-based tools:
----------------

If you have docbook-utils installed, you can convert this documentation
into other formats like PDF, DVI, TXT, texi, RTF. docbook-utils is SGML
based and so a SGML header file is provided. The content files are still
XML based - this doesn't cause problems for conversion to HTML but to
generate PDF's validity errors need to be suppressed. 

Use -e no-valid to suppress SGML validity errors.

Currently, there are also problems incorporating the images into the 
PDF versions. However, unlike the XML/XSL tools, docbook-utils will 
generate a valid PDF, albeit without images.

Note that the docs are designed for XML/XSL. Allowing them to function
with SGML tools requires a few syntax tweaks. You may get errors reported
but as long as the majority of the tweaks are in place, the conversion
will succeed. Syntax errors are not suppressed with '-e -no-valid',
only validity errors (like _ instead of - in id attributes).

-- 

Neil Williams
=============
http://www.data-freedom.org/
http://www.nosoftwarepatents.com/
http://www.linux.codehelp.co.uk/

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.gnucash.org/pipermail/gnucash-user/attachments/20050719/255811f3/attachment.bin


More information about the gnucash-user mailing list