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: Zukora Barisar
Country: Sri Lanka
Language: English (Spanish)
Genre: Health and Food
Published (Last): 9 December 2018
Pages: 18
PDF File Size: 8.84 Mb
ePub File Size: 15.50 Mb
ISBN: 288-9-65466-621-5
Downloads: 38775
Price: Free* [*Free Regsitration Required]
Uploader: Tujora

This produces a more usable index.

Chapter 5. DocBook

Note Use the stylesheet parameter fop1. Some provide extension elements and processing instructions to enable features that are not covered in the XSL-FO 1. It runs on MS Windows platforms and can be downloaded from http: Vop references Cross references within a document Linking from other elements Options for generated xref text Cross references between documents Linking to websites Breaking long URLs DocBook 5 cross references Customizing cross references Customizing with an xrefstyle attribute Modifying gentext dicbook Customizing cross reference behavior Customizing cross reference typography Specialized cross references Chapter If you find in their documentation an extension you want to use, you can write a customization layer that implements an extension.

Use the –verbose command-line option to view executed toolchain commands.

DocBook, FOP and Fonts

Note For a long time, version 0. Accented characters are replaced with hashes if you do not use a font that supports multi-byte characters. FOP has built-in support for some graphics formats, but some popular formats such as PNG are not supported natively.

If you are using XEP, then set the fkp.

One option you will not find is the ability to set DocBook stylesheet parameters on the command line when you use the -xsl option that processes the stylesheet. Stylesheet options Chapter 6.

If you want to see how the complete documentation set is processed take a look at the A-A-P script. Skiing as an agile vs waterfall docbpok.

You can make the change permanent by adding it in the FOP convenience script, such as fop. These drivers are also used by a2x 1.


I will not go into details on validating DocBoox syntax, but it is recommended that you validate your files because I guess cocbook 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.

Previous post Skiing as an agile vs waterfall metaphor. If you are using the Maven Docbkx Plugin, then you might want something that integrates with Maven. Converting DocBook to other file formats. In order to reap the benefits from these metrics files, you will need to tell the Maven Docbkx Plugin what to do with it.

Customization methods Customization layer Writing a customization layer Using a customization layer Customizing both HTML and FO Using catalogs with customizations Setting parameters Attribute sets Completing placeholder templates Generating new templates Generated text Default generated text Customizing generated text Replacing templates Finding the right template Import precedence Passing parameters Utility templates and modes Adding new top Formatting determined by attribute value Adding processing docblok Handling new elements Template selection rules Processing instructions Customizing DocBook 5 XSL DocBook 5 customization details Annotations customization Chapter If you are using Antenna House’s product, then set the axf.

See the a2x 1 man page for more details. Of course you will have to replace the embed-url with the path to Times New Roman. FOP is distributed as a zip file, which can be opened on almost all systems. In Antenna House, an extension attribute named axf: Toolchain processing performs link and document validity checks. FOP is more feature complete for example, callouts are processed inside literal layouts and arguably produces nicer looking output. Now the refactored version has been released, with the first stable version 0.

These are examples of optional dblatex output customization and are used by a2x 1. This should be enough to make the plugin aware of the existence of this font, and to have a way resolve its name to the required meta data. Another thing I needed to add was language information for my so for Croatian language it now looks like this:. In this example, the memory allocation is Docboook. They also differ in the features they offer. The following example assumes the FOP. Setting up the tools Chapter 1.


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. HTML from DocBook can optionally include automatically generated indexes, tables of contents, footnotes, lists of figures and tables.

Use the stylesheet parameter fop1. Apache FOP has a long history. Bibliographies Bibliography entries Bibliography database Bibliography database catalog entry Citing bibliographic entries Numbered bibliography entries Sorting a bibliography Customizing bibliography output ISO bibliography standard Bibliography title RefDB bibliographic database Chapter One of the biggest hurdles for new users is installing, configuring and using a DocBook XML toolchain.

Using stylesheet parameters Parameters on the command line Parameters in a file Chapter 7. Special DocBook features Chapter Not all extension functions in each product are used by the DocBook stylesheets. AsciiDoc generates articlebook and refentry DocBook documents corresponding to the AsciiDoc articlebook and manpage document types.

Copy it to the lib subdirectory of the FOP installation. The value you use should be less than the installed memory on the system, and should leave enough memory for other processes that may be running.

You can change what the message says in a customization layeror you could define it as an empty template there to turn off the message entirely.

But docbokk DocBook XSL stylesheets include support for some of the extensions provided by a few of docboo, processors, and those will be described in this book.

From DocBook to PDF using Apache FOP

Apache FOP is providing some utilities for generating font metrics, however none of that is based on Maven. Of course there was the occasional warning flp we were all expected to use StarOffice, but by making sure the DocBook generated output resembled the printed material produced by HQ, it never turned into a big argument. 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.