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.
|Country:||Antigua & Barbuda|
|Published (Last):||11 May 2016|
|PDF File Size:||6.30 Mb|
|ePub File Size:||17.82 Mb|
|Price:||Free* [*Free Regsitration Required]|
Apache FOP has a long history. These are useful for automated batch processing of many documents, so you do not have to open them one at a time in a graphical interface. Setting up the tools Chapter 1. I am using the directory structure he created as well as sample files, with little modifications. Docbokk should never turn on the extensions for a processor you are not using, or you will likely get a lot of error messages from the XSL-FO processor that does not understand the extra code.
Preface What is DocBook? Creating user manuals for the software docboik are building is an important task.
FOP is distributed as a zip file, which can be opened on almost all systems. Apache FOP is providing some utilities for generating font metrics, however none of that is based on Maven. However, that has been solved with the latest versions, and I think the output generated by the DocBook stylesheets can be quite ok. The examples that follow are executed from the distribution documentation.
Profiling conditional text Marking conditional text Marking small bits of text Multiple profiling conditions Processing profiled 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 If the DocBook lang attribute is set then things like table of contents, figure and table captions and admonition captions will be output in the specified language setting the AsciiDoc lang attribute sets the DocBook lang attribute.
I will explain later why the language attribute is important.
DocBook toolchains can also optionally generate separate chunked linked HTML pages for each document section. AsciiDoc focbook articlebook and refentry DocBook documents corresponding to the AsciiDoc articlebook and manpage document types.
DocBook XSL: The Complete Guide
When the extensions for one of these processors is turned on, extra code is written by the stylesheet into the XSL-FO file. Use the stylesheet parameter fop1. 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 Top direction Chapter Toolchain processing performs link and document validity checks.
Stylesheet options Chapter 6. Ofcourse you will have to change manual.
If you are using XEP, then set the xep. You probably want the binary version rather than the source version.
If you find in their documentation an extension you want to use, you can write a customization layer that implements an extension. You can download the JAI files from http: Introduction How this book is organized Online resources for finding solutions to problems Chapter 2. In Antenna House, an extension attribute named axf: It is used internally by FOP. For some reason, it seems impossible to ever arrive at a version 1. Last weekend I realized that — although the Maven Docbkx Plugin supports something like that — dofbook is probably one of its best kept secrets.
DocBook, FOP and Fonts
If you want to see how the complete documentation set is processed take a look at the A-A-P script. This example is run on MS Windows from a Cygwin shell prompt: That extra code is understood only by a specific processor, so this feature is controlled socbook stylesheet parameters. If you are using the Maven Docbkx Plugin, then you might want something that integrates fopp Maven. Special DocBook features Chapter Copy it to the lib subdirectory of the FOP installation.
The options for FOP are listed at http: The sourceDirectory parameter is pointing to a directory containing the.
One of the biggest hurdles for new users is installing, configuring and using a DocBook XML toolchain. FOP will convert a. Cross references Cross references within a document Linking from other elements Options for generated xref text Odcbook references between docboko 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