This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
RE: Generate PDF with docbook xsl and Saxon
- From: Martin Polley <Martinp at Surf-com dot com>
- To: Th Templ <templ_th at hotmail dot com>
- Cc: docbook at lists dot oasis-open dot org
- Date: Thu, 04 Jul 2002 13:24:13 +0200
- Subject: RE: DOCBOOK: Generate PDF with docbook xsl and Saxon
Hi,
You can download the images from the systems/texlive directory of one of
the mirrors listed here:
http://www.ctan.org/tex-archive/CTAN.sites
HTH,
Martin Polley
Technical Communicator
http://www.surf-com.com/
Tel: (+972) (4) 9095-732
Mobile: (053) 864-280
-----Original Message-----
From: Th Templ [mailto:templ_th@hotmail.com]
Sent: Thursday, July 04, 2002 11:40 AM
To: bobs@caldera.com
Cc: docbook@lists.oasis-open.org
Subject: Re: DOCBOOK: Generate PDF with docbook xsl and Saxon
Hello,
Where can I download the cd? Must I join the TeX User's Group (TUG) to
be
able to download it?
Thanks for your help
Templth
>Most problems with print output are in the FO processor,
>not the DocBook XSL stylesheets. PassiveTeX is another FO processor
>that formats verbatim elements properly, and it runs on Windows as well
>as Linux. I've written a draft of a short PassiveTeX Howto article
>that I've included below. If you would be willing to try it out and
>give me feedback, I'd appreciate it.
>
>
>
> Getting started with PassiveTeX
>_________________________________________________________________
>
>This article describes how to install and run PassiveTeX.
>
>Installing PassiveTeX
>---------------------------
>
>PassiveTeX is an extension of the TeX typesetting system that permits
>conversion of XSLFO files to PDF. More accurately, it is an extension
>of other extensions such as pdftex, pdflatex, and xmltex. For this
>reason, trying to add the necessary packages to an existing TeX
>installation can sometimes lead to mismatched components that don't
>work together. Because of the large number of files involved in a
>complete TeX installation, it can be difficult to sort out the
>problems.
>
>Currently the easiest way to get PassiveTeX working is to install a new
>TeX system that supports it. Sebastian Rahtz, the author of PassiveTeX,
>has assembled such a system and made it available as part of the TeX
>Live CD distribution. Version 7 of TeX Live CD defines several
>"schemes", which are selections of TeX packages designed for particular
>purposes. One of those schemes is called "XML Typesetting". That scheme
>includes the PassiveTeX pieces needed to process XSLFO files generated
>by the DocBook XSL stylesheets.
>
>The TeX Live CD has support for Windows, Linux, UNIX, and MacOSX
>systems. It also permits you to run your TeX processing almost entirely
>from the CD, installing just a minimum number of files. Since the size
>of a TeX installation for DocBook is over 200 MB, that may be a
>necessary option. But it does make the processing run more slowly
>because it has to read many files from the CD each time.
>
>To install PassiveTeX from the TeX Live 7 CD:
>
> 1. Obtain a TeX Live 7 CD
> Instructions for obtaining a TeX Live 7 CD are available at:
> http://www.tug.org/texlive.html
> You can obtain the CD by joining the TeX User's Group (TUG), or
> you can download the CD image and burn your own CD. It is a huge
> download and requires a fast Internet connection.
>
> 2. Start the installation program
> On Windows, the CD may automatically start when you put the CD in
> the drive. If not, then run \bin\win32\TeXLive.exe to start it
> manually. Then select Install->TeXLive. That will start the setup
> wizard.
> On Linux or UNIX, run sh install-cd.sh in the top directory of the
> CD. The file itself is not executable, which is why you need to
> precede it with sh. That command presents a text interface for
> selecting installation options.
>
> 3. Select the XML Typesetting scheme
> As you step through the installation interface, you can select
> where TeX installs, what languages you want to support, and other
> options. The important step for DocBook is to select the "XML
> Typesetting" scheme. If you aren't offered a scheme selection as
> part of the options, then your TeX Live CD is older than version
> 7.
>
> 4. Run the installation
> After you have selected all the options and scheme, run the
> Install and sit back until it completes.
>
> 5. Adjust some TeX settings
> You need to increase the values of certain TeX parameters to
> process DocBook files. The settings are located in the following
> file:
>
> Windows:
> \Program Files\TeXLive\texmf-var\web2c\texmf.cnf
>
> Linux or UNIX:
> /usr/TeX/texmf-var/web2c/texmf.cnf
>
> Make a backup copy of the original file, and then use a text
> editor to locate and change the following values to be at least
> these sizes:
>
> main_memory = 2500000 (that's 2,500,000)
> hash_extra = 50000
> pool_size = 500000
> save_size = 50000
>
> Confirm that the following values are set:
> param_size = 1500
> stack_size = 1500
> string_vacancies = 45000
> pool_free = 47500
> nest_size = 500
> max_strings = 65000
> buf_size = 200000
>
> 6. Set environment variables
> To use a TeX system, it needs to know where the commands are
> located (PATH) and where the TeX configuration files are installed
> (TEXMFCNF). So you need to set these two environment variables. On
> Windows they should be set automatically, but you should check
> them anyway.
>
> Windows:
> PATH=C:\Program Files\TeXLive\bin\win32;etc.
> TEXMFCNF=C:\Program Files\TeXLive\texmf-var\web2c
>
> Linux and UNIX:
> PATH=/usr/TeX/bin:$PATH check this path
> TEXMFCNF=/usr/TeX/texmf-var/web2c
> export PATH TEXMFCNF
>
>You can test to see if your installation is working by typing at a
>command prompt:
>
>pdftex -ini "&pdflatex" pdfxmltex.ini
>
>That will generate a lot of status messages, but should result in a
>file named pdfxmltex.fmt.
>
>
>Using PassiveTeX
>---------------------
>
>PassiveTeX will convert a .fo file created using one of the XSLT
>processors into a .pdf file. Once the system is set up and working, you
>should be able to execute the following command on your .fo files:
>
>pdftex --interaction nonstopmode "&pdfxmltex" myfile.fo
>pdftex --interaction nonstopmode "&pdfxmltex" myfile.fo
>
>You want to run the same command twice in order to resolve page numbers
>in the table of contents. You'll notice that it generates a lot of
>status messages. If you don't end up with a myfile.pdf file, then
>something went wrong. All the noise is recorded in a log file named
>myfile.log, which you can scan for clues as to what went wrong.
>
>Dissecting this command:
>
> * The pdftex command runs the version of the TeX formatting engine
> that generates PDF output instead of the original TeX DVI output.
>
> * The --interaction nonstopmode option forces it to keep going even
> if it comes across something questionable. Generally the questions
> it asks can only be answered by a TeX expert.
>
> * The "&pdfxmltex" argument tells the formatter to use the TeX
> format file named pdfxmltex.fmt that was installed with the XML
> Typesetting scheme. This is the PassiveTeX extension that parses
> the XSLFO file and applies TeX formatting.
>
>Note
>
>Tables processed by PassiveTeX currently require width specifications
>with units in colspec elements. Proportional width specifications do
>not work.
>
>
>--
>
>Bob Stayton 400 Encinal Street
>Publications Architect Santa Cruz, CA 95060
>Technical Publications voice: (831) 427-7796
>Caldera International, Inc. fax: (831) 429-1887
> email: bobs@caldera.com
_________________________________________________________________
Join the world's largest e-mail service with MSN Hotmail.
http://www.hotmail.com