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: Arasho Shami
Country: Slovenia
Language: English (Spanish)
Genre: Finance
Published (Last): 23 July 2017
Pages: 400
PDF File Size: 12.98 Mb
ePub File Size: 14.31 Mb
ISBN: 531-6-13703-993-7
Downloads: 23945
Price: Free* [*Free Regsitration Required]
Uploader: Tojagami

If you are processing languages other than English, then you need to download an additional file named fop-hyph.

In Antenna House, an extension attribute named axf: For starters I do not use any PHP code in my documentation so I do not have the need for Phing tasks that take care of syntax highlighting program listings yet.

Which script you use depends on the operating system: Last weekend I realized that — although the Maven Docbkx Plugin supports something like that — it is probably one of its best fkp secrets. Accented characters are replaced with hashes if flp do not use a font that supports multi-byte characters.

Glossaries Glossary formatting Glossary formatting in docboko Linking to a glossary entry What about link and xref? This example generates an asciidoc. Now the refactored version has been released, with the first stable version 0.

Part 2. FO Parameter Reference

Replace any version strings in the example below with the actual version numbers on the files in your FOP distribution. The problems is that these fonts do not have support for all the characters you are probably using if your are converting a document that is not written in English. Unpack the archive FOP is distributed as a zip file, which can be opened on almost all systems. In Arbortext, the element is fo: If you are using XEP, then set the xep.

So the below will change the body docboook to Calibri. Apache FOP is providing some utilities for generating font metrics, however none of that is based on Maven.

DocBook, FOP and Fonts — Xebia Blog

Converting DocBook to other file formats. 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. Because these products docboko undergoing rapid development, and because they provide their own documentation and support, this book will not provide general instructions on how to use them.


I will explain later why the language attribute is important. HTML from DocBook can optionally include automatically generated indexes, tables of contents, footnotes, lists of figures and tables.

The stylesheets are used in conjunction with an XML parser such as xsltproc 1. On the other hand, HTML output directly from AsciiDoc is much faster, is easily customized and can be used in situations where there is no suitable DocBook toolchain for example, see the AsciiDoc website. 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 After playing fore the most part of the day with DocBook and various utilities I decided to write it down for future reference.

If you find in their documentation an extension you want to use, you can write a customization layer that implements an extension.

You can increase the memory allocation by adding a -Xmx option to any Java command. 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 templates Formatting determined by attribute value Adding processing steps Handling new elements Template selection rules Processing instructions Customizing Focbook 5 XSL DocBook 5 customization details Annotations customization Chapter Some provide extension elements and processing instructions to enable features that fpp not cocbook in the XSL-FO 1.

Of course there was the occasional warning that we were all expected to use StarOffice, but by docbookk sure the DocBook generated output resembled the printed material produced by HQ, it never turned into a big argument.

Depending on the memory configuration of your machine, your FOP process may fail on large documents with a java.


DocBook, FOP and Fonts

The docbkok for FOP are listed at http: Linux users can also download a gzipped tar file. FOP has built-in support for some graphics formats, but some popular formats such as PNG are not supported natively.

To download FOP, go to http: You probably want the binary version rather than the source version. You can download the JAI files from http: That extra code is understood only by a specific processor, so this feature is controlled by stylesheet parameters.

For a long time, version 0. Docgook List titles List spacing List vertical fopp List horizontal spacing itemizedlist options Different bullet symbol Print properties for itemizedlist orderedlist options Different numbering style Number continuation List starting number Print properties for orderedlist variablelist options Multiple term elements Variable list formatting in print Variable list formatting in HTML simplelist options Chapter The following are some examples of using the scripts:.

dobook If you are using the Maven Docbkx Plugin, then you might want something that integrates with Maven. The cleanup process entails removing duplicate page numbers on an entry, and converting a sequence of consecutive numbers to a page range.

Add a docobok First of all, you need to add a plugin to the plugins section. The lib directory has other. A wide range of user output format requirements coupled with a choice of available tools and stylesheets results in many valid tool chain combinations. You also need to make sure the font metrics can be found. The sourceDirectory parameter is pointing to a directory containing the.

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 Antenna House, the extension is an attribute named axf: You will most likely want to process bitmap graphics in your document.

Another thing I needed ddocbook add was language information for my so for Croatian language it dobcook looks like this:.