how to build dvi/ps/pdf of documentation?

classic Classic list List threaded Threaded
11 messages Options
Reply | Threaded
Open this post in threaded view
|

how to build dvi/ps/pdf of documentation?

Tim Olsen
Hi.  I'm looking to build a dvi or postscript or pdf of the concepts
guide and help manual.  I would like to build my own because the ones
provided on the web site are for A4 paper, and I would like them on
letter paper.

The dvi targets in the gnucash-docs Makefiles appear to do nothing.

Anyone know how to compile a dvi/ps/pdf of the docs?

thanks,
Tim

_______________________________________________
gnucash-user mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-user
Reply | Threaded
Open this post in threaded view
|

Re: how to build dvi/ps/pdf of documentation?

Neil Williams-2
On Sunday 17 July 2005 5:31 am, Tim Olsen wrote:
> Hi.  I'm looking to build a dvi or postscript or pdf of the concepts
> guide and help manual.

Use the docbook files in CVS.

http://cvs.gnucash.org/cgi-bin/cvsweb.cgi/gnucash-docs/guide/C/
gnucash-guide.sgml

(simile help/C/gnucash-help.sgml)

If that's not in your gnucash-docs source package, get a later version from
CVS. (There are other changes as well as this).

http://www.gnucash.org/en/hacking.phtml
> I would like to build my own because the ones
> provided on the web site are for A4 paper, and I would like them on
> letter paper.

That's probably a locale thing (UK) - I didn't give that option explicitly
when the PDF was generated.

> Anyone know how to compile a dvi/ps/pdf of the docs?

docbook2pdf gnucash-guide.sgml
http://packages.debian.org/stable/text/docbook-utils

I don't know if it's available for other distributions but the current CVS
help and guide content does have valid DocBook content, specifically to
generate PDF.

Other docbook tools can convert to single or chunked HTML, DVI, PS or other
formats.

--

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


_______________________________________________
gnucash-user mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-user

attachment0 (196 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

RE: how to build dvi/ps/pdf of documentation?

ted creedon
Not familiar on what editor to use.

Is there a WYSWYG editor available or are the DocBook sources edited in text
format?

Thanks.

tedc

-----Original Message-----
From: [hidden email]
[mailto:[hidden email]] On Behalf Of Neil Williams
Sent: Sunday, July 17, 2005 6:14 AM
To: Tim Olsen
Cc: [hidden email]
Subject: Re: how to build dvi/ps/pdf of documentation?

On Sunday 17 July 2005 5:31 am, Tim Olsen wrote:
> Hi.  I'm looking to build a dvi or postscript or pdf of the concepts
> guide and help manual.

Use the docbook files in CVS.

http://cvs.gnucash.org/cgi-bin/cvsweb.cgi/gnucash-docs/guide/C/
gnucash-guide.sgml

(simile help/C/gnucash-help.sgml)

If that's not in your gnucash-docs source package, get a later version from
CVS. (There are other changes as well as this).

http://www.gnucash.org/en/hacking.phtml
> I would like to build my own because the ones provided on the web site
> are for A4 paper, and I would like them on letter paper.

That's probably a locale thing (UK) - I didn't give that option explicitly
when the PDF was generated.

> Anyone know how to compile a dvi/ps/pdf of the docs?

docbook2pdf gnucash-guide.sgml
http://packages.debian.org/stable/text/docbook-utils

I don't know if it's available for other distributions but the current CVS
help and guide content does have valid DocBook content, specifically to
generate PDF.

Other docbook tools can convert to single or chunked HTML, DVI, PS or other
formats.

--

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


_______________________________________________
gnucash-user mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-user
Reply | Threaded
Open this post in threaded view
|

Re: how to build dvi/ps/pdf of documentation?

Neil Williams-2
On Sunday 17 July 2005 6:09 pm, ted creedon wrote:
> Not familiar on what editor to use.

? DocBook is SGML from which HTML and XML are derived. It's plain text with
angle brackets.

> Is there a WYSWYG editor available or are the DocBook sources edited in
> text format?

There is NO editing involved - you need a docbook handling package that can
apply XSL stylesheets or can convert the SGML using Perl etc.

Do not edit any of the files in gnucash-docs just to produce PDF's!

http://www.docbook.org/tdg/en/html/docbook.html
http://www.dpawson.co.uk/docbook/

You need to install a docbook utility - search the package lists for your
distribution for packages related to docbook. On Debian, it's simply:
apt-get install docbook-utils


--

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


_______________________________________________
gnucash-user mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-user

attachment0 (196 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: how to build dvi/ps/pdf of documentation?

Neil Williams-2
In reply to this post by ted creedon
On Sunday 17 July 2005 6:09 pm, ted creedon wrote:
> Not familiar on what editor to use.

Read the README from the CVS of gnucash-docs, it documents what you need to
produce other formats from the content - WITHOUT editing anything.

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

--

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


_______________________________________________
gnucash-user mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-user

attachment0 (196 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

RE: how to build dvi/ps/pdf of documentation?

ted creedon
In reply to this post by Neil Williams-2
I'm not interested in editing gnucash docs.

I'm intersted in editing OpenAFS docs and I thought I'd ask how you do that.

tedc

-----Original Message-----
From: [hidden email]
[mailto:[hidden email]] On Behalf Of Neil Williams
Sent: Sunday, July 17, 2005 10:21 AM
To: [hidden email]
Subject: Re: how to build dvi/ps/pdf of documentation?

On Sunday 17 July 2005 6:09 pm, ted creedon wrote:
> Not familiar on what editor to use.

? DocBook is SGML from which HTML and XML are derived. It's plain text with
angle brackets.

> Is there a WYSWYG editor available or are the DocBook sources edited
> in text format?

There is NO editing involved - you need a docbook handling package that can
apply XSL stylesheets or can convert the SGML using Perl etc.

Do not edit any of the files in gnucash-docs just to produce PDF's!

http://www.docbook.org/tdg/en/html/docbook.html
http://www.dpawson.co.uk/docbook/

You need to install a docbook utility - search the package lists for your
distribution for packages related to docbook. On Debian, it's simply:
apt-get install docbook-utils


--

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


_______________________________________________
gnucash-user mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-user
Reply | Threaded
Open this post in threaded view
|

Re: how to build dvi/ps/pdf of documentation?

Neil Williams-2
On Sunday 17 July 2005 7:10 pm, ted creedon wrote:
> I'm not interested in editing gnucash docs.
>
> I'm intersted in editing OpenAFS docs and I thought I'd ask how you do
> that.

on a gnucash mailing list .... me thinks this may be a tad off-topic!

I have no idea what OpenAFS documents contain but if they are DocBook then you
still don't edit them to convert them into HTML, PDF, DVI, TXT, Texi, PS or
whatever. You still need docbook-utils or docbook-xsl.

Only edit them to change the actual content - i.e. if it is YOUR Docbook file.

Read the Docbook website and learn the syntax.

--

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


_______________________________________________
gnucash-user mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-user

attachment0 (196 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

RE: how to build dvi/ps/pdf of documentation?

ted creedon
Sorry for the off-topic but I was somewhat mystified...

tedc

-----Original Message-----
From: [hidden email]
[mailto:[hidden email]] On Behalf Of Neil Williams
Sent: Sunday, July 17, 2005 12:39 PM
To: [hidden email]
Subject: Re: how to build dvi/ps/pdf of documentation?

On Sunday 17 July 2005 7:10 pm, ted creedon wrote:
> I'm not interested in editing gnucash docs.
>
> I'm intersted in editing OpenAFS docs and I thought I'd ask how you do
> that.

on a gnucash mailing list .... me thinks this may be a tad off-topic!

I have no idea what OpenAFS documents contain but if they are DocBook then
you still don't edit them to convert them into HTML, PDF, DVI, TXT, Texi, PS
or whatever. You still need docbook-utils or docbook-xsl.

Only edit them to change the actual content - i.e. if it is YOUR Docbook
file.

Read the Docbook website and learn the syntax.

--

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


_______________________________________________
gnucash-user mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-user
Reply | Threaded
Open this post in threaded view
|

Re: how to build dvi/ps/pdf of documentation?

Tim Olsen
In reply to this post by Neil Williams-2
I get an error:

tim@computadora:/usr/local/src/gnucash-docs/guide/C$ docbook2pdf
gnucash-guide.sgml
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#print
Working on: /usr/local/src/gnucash-docs/guide/C/gnucash-guide.sgml
jade:/usr/local/src/gnucash-docs/guide/C/ch_oview.xml:17:13:E:
character "_" is not allowed in the value of attribute "ID"
jade:/usr/local/src/gnucash-docs/guide/C/ch_oview.xml:24:13:E:
character "_" is not allowed in the value of attribute "ID"
jade:/usr/local/src/gnucash-docs/guide/C/ch_oview.xml:27:13:E:
character "_" is not allowed in the value of attribute "ID"
jade:/usr/local/src/gnucash-docs/guide/C/ch_oview.xml:70:13:E:
character "_" is not allowed in the value of attribute "ID"
.
.
.
jade:/usr/local/src/gnucash-docs/guide/C/ch_loans.xml:96:17:E:
character "_" is not allowed in the value of attribute "ID"
jade:/usr/local/src/gnucash-docs/guide/C/ch_loans.xml:100:43:E:
character data is not allowed here
jade:/usr/local/src/gnucash-docs/guide/C/ch_loans.xml:139:17:E:
character "_" is not allowed in the value of attribute "ID"
jade:I: maximum number of errors (200) reached; change with -E option
tim@computadora:/usr/local/src/gnucash-docs/guide/C$

Is something wrong with my setup?

thanks,
Tim

On 7/17/05, Neil Williams <[hidden email]> wrote:

> On Sunday 17 July 2005 5:31 am, Tim Olsen wrote:
> > Hi.  I'm looking to build a dvi or postscript or pdf of the concepts
> > guide and help manual.
>
> Use the docbook files in CVS.
>
> http://cvs.gnucash.org/cgi-bin/cvsweb.cgi/gnucash-docs/guide/C/
> gnucash-guide.sgml
>
> (simile help/C/gnucash-help.sgml)
>
> If that's not in your gnucash-docs source package, get a later version from
> CVS. (There are other changes as well as this).
>
> http://www.gnucash.org/en/hacking.phtml
> > I would like to build my own because the ones
> > provided on the web site are for A4 paper, and I would like them on
> > letter paper.
>
> That's probably a locale thing (UK) - I didn't give that option explicitly
> when the PDF was generated.
>
> > Anyone know how to compile a dvi/ps/pdf of the docs?
>
> docbook2pdf gnucash-guide.sgml
> http://packages.debian.org/stable/text/docbook-utils
>
> I don't know if it's available for other distributions but the current CVS
> help and guide content does have valid DocBook content, specifically to
> generate PDF.
>
> Other docbook tools can convert to single or chunked HTML, DVI, PS or other
> formats.
>
> --
>
> Neil Williams
> =============
> http://www.data-freedom.org/
> http://www.nosoftwarepatents.com/
> http://www.linux.codehelp.co.uk/
>
>
>
>

_______________________________________________
gnucash-user mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-user
Reply | Threaded
Open this post in threaded view
|

Re: how to build dvi/ps/pdf of documentation?

Neil Williams-2
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/


_______________________________________________
gnucash-user mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-user

attachment0 (196 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: how to build dvi/ps/pdf of documentation?

Tim Olsen
Sorry.  I didn't realize the README had changed from my source package
to the CVS.

Next time I'll know not to trust so much what you write and be sure to
read the README. ;-)

but seriously, thanks for the help

-Tim

On 7/19/05, Neil Williams <[hidden email]> wrote:
> 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:

>>>> Anyone know how to compile a dvi/ps/pdf of the docs?

>>>docbook2pdf gnucash-guide.sgml
>>>http://packages.debian.org/stable/text/docbook-utils

_______________________________________________
gnucash-user mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-user