The author of this book is available for helping with DocBook or other XML publishing projects. Installing FOP · Using FOP · Using other XSL-FO processors. Docbook is easy to learn, easy to write, and does things other text To output to PDF, tell FOP to register your fonts with your file. And since my entire DocBook chain was built from open source, I had to use Apache FOP. Apache FOP has a long history. For some reason, it.

Author: Faum Faum
Country: Martinique
Language: English (Spanish)
Genre: Medical
Published (Last): 25 November 2006
Pages: 124
PDF File Size: 11.69 Mb
ePub File Size: 9.69 Mb
ISBN: 260-6-47895-916-1
Downloads: 28340
Price: Free* [*Free Regsitration Required]
Uploader: Kajill

HTML from DocBook can optionally include automatically generated indexes, tables of contents, footnotes, lists of figures and tables.

The distribution comes as a compressed zip file with everything you need. You can increase the memory allocation by adding a -Xmx option to any Java command.

You also need to make sure the font metrics can be found. This XML file is the one you want to edit if you want to change the output strings used for creation of the PDF document. Fopp the refactored version has been released, with the first stable version 0. When the extensions for one of these processors is turned on, extra code is written by the stylesheet into the XSL-FO file.

However, that has been solved with the latest versions, and I think the output fo by the DocBook stylesheets can be quite ok. AsciiDoc generates articlebook and refentry DocBook documents corresponding to the AsciiDoc articlebook and manpage document types.

The docnook parameter is pointing to a directory containing the. To download FOP, go to http: Since the Apache FOP will probably complain about hyphenation, grab the hyphenation patterns and copy the jar file fop-hyph. For a long time, version 0.

From DocBook to PDF using Apache FOP

Most of them are commercial products, but they are in serious competition on price and features, which benefits the user community. DocBook Consulting Services available. It runs on MS Windows platforms and can be downloaded from http: Cross references Cross references within a document Linking from other elements Options for generated xref text Cross references dodbook documents Linking to websites Breaking long URLs DocBook 5 cross references Customizing cross references Customizing with an xrefstyle attribute Modifying gentext templates Customizing cross reference behavior Customizing cross reference typography Specialized cross references Chapter You can change what the message says in a customization layeror you docboook define it as an empty template there to turn off the message entirely.


Although most people will run FOP using its included convenience scripts, it is useful to know where the files are. Introduction How this book is organized Online resources for finding solutions to problems Chapter 2. That extra code is understood only by a specific processor, so this feature is controlled by stylesheet parameters.

DocBook, FOP and Fonts

So the below will change the body font to Calibri. You can use the fonts name in all places where the stylesheets are referring to a font name. Using stylesheet parameters Parameters on the command line Parameters in a file Chapter 7. If you are using XEP, then set the xep. DocBook is the first thing that came to mind, but as it is usually the case the things are not so simple as they should be.

The versions I used at Sun unfortunately never supported the keep-with-next poperty, which resulted in weird page-endings, that I then had to manually fix. DocBook toolchains can also optionally generate separate chunked linked HTML pages for each document section.

DocBook, FOP and Fonts — Xebia Blog

If you are using the Arbortext processor, then set the arbortext. You will most likely want to process bitmap graphics in your document. The lib directory has other. Languages, characters and encoding Document encoding Output encoding Saxon output character representation Special characters Special characters in output Space characters Missing characters Language support Using the lang attribute Using language parameters Language codes Extending the set of languages Text direction Chapter FOP has built-in support for some graphics formats, but some popular formats such as PNG are not supported natively.

Take a look ad DocBook samples he provides. But the DocBook XSL stylesheets include support for some of the extensions provided by a few of the processors, and those will be described in this book. Linux users can also download a gzipped tar file.

Note Use the stylesheet parameter fop1. You should never turn on the extensions for a processor you are not using, or you will likely get a lot of error messages docbkok the XSL-FO processor that does dcobook understand the extra code. In Arbortext, the element is fo: The options for FOP are listed at http: Feel free to plough through the FOP documentation to understand what it is about. Some products provide a command line interface or convenience script. If you are using Antenna House’s product, then set the axf.


There are 14 most used fonts that you can use in your PDF files that do not require you to embedd the font file itself into the PDF. I will not go into details on validating DocBoox syntax, but it is recommended that you validate your files because I guess it is faster than invoking Apache FOP to generate you PDF and realising that somewhere at the end of your documentation there is a syntax error.

Use the –verbose command-line option to view executed toolchain commands. Not all extension functions in each product are used by the DocBook stylesheets.

I will not contemplate on the DocBook syntax as there are various sources on the internet that will teach you how to use the DocBook syntax for writing. It is used internally by Docbool. They also differ in the features they offer. Since I do not like to repeat myself I wanted a system that is capable of generating documentation in variety of formats, PDF being the most important one. In XEP, the extension element is rx: In Antenna House, the extension is an attribute named axf: Profiling conditional text Marking conditional text Marking small bits of text Multiple profiling conditions Processing docboook versions Single-pass processing Two-pass processing Customization and profiling Validation and profiling Custom profiling attribute Adding new profiling attributes Adding attributes to the DTD Adding attributes to RelaxNG Profiling with new attributes Using the role attribute for profiling Chapter With this in place, making the plugin use this font is pretty easy.

These drivers are also used by a2x 1.