The xtpxlib-xdoc component contains the following XProc (1.0) pipelines:

ModuleDescription
docbook-to-pdf.xplThis turns Docbook (5.1) into a PDF using FOP.
docbook-to-xhtml.xplThis turns Docbook (5.1) into XHTML.
xdoc-to-docbook.xplPipeline that transforms a DocBook source containing xdoc extensions into "pure" DocBook format.
xdoc-to-pdf.xplConvenience pipeline: Combines the xdoc-to-docbook and the docbook-to-pdf steps in one.
xdoc-to-xhtml.xplConvenience pipeline: Combines the xdoc-to-docbook and the docbook-to-xhtml steps in one.

4.1 XProc (1.0) pipeline: docbook-to-pdf.xpl

File: xpl/docbook-to-pdf.xpl

Type: xdoc:docbook-to-pdf

This turns Docbook (5.1) into a PDF using FOP.

All necessary xdoc pre-processing (usually with xdoc-to-docbook.xpl) must have been done.

It will only convert a partial DocBook tagset.

If you don't use xdoc-to-docbook.xpl, you have to make sure to get correct xml:base attributes in, so the pipeline can find includes and images. The following XProc (1.0) code takes care of that:

<p:xinclude>
  <p:with-option name="fixup-xml-base" select="true()"/>
</p:xinclude>
<p:add-attribute attribute-name="xml:base" match="/*">
  <p:with-option name="attribute-value" select="/reference/to/source/document.xml"/>
</p:add-attribute>
PortTypePrimary?Description
sourceinyesThe docbook source document, fully expanded (with appropriate xml:base attributes)
resultoutyesThe resulting XSL-FO (that was transformed into the PDF).
OptionRq?DefaultDescription
chapter-id ''Specific chapter identifier to output.
fop-config resolve-uri('../../xtpxlib-common/data/fop-default-config.xml', static-base-uri())Reference to the FOP configuration file
global-resources-directory ()Images that are tagged as role="global" are searched here (discarding any directory information in the image's URI)
href-pdfyesThe name of the resulting PDF file (must have file:// in front).
main-font-size 10Main font size as an integer. Usual values somewhere between 8 and 10.
output-type 'a4'Output type. Use either a4 or sb (= standard book size)
preliminary-version false()If true, adds a preliminary version marker and output any db:remark elements. If false, output of db:remark elements will be suppressed.

4.2 XProc (1.0) pipeline: docbook-to-xhtml.xpl

File: xpl/docbook-to-xhtml.xpl

Type: xdoc:docbook-to-xhtml

This turns Docbook (5.1) into XHTML.

All necessary xdoc pre-processing (usually with xdoc-to-docbook.xpl) must have been done.

It will only convert a partial DocBook tagset.

The resulting XHTML will not be directly useable, post-processing the result into a complete and correct HTML page is necessary. The result of this pipeline consists of nested div elements. There is no surrounding html or body element.

PortTypePrimary?Description
sourceinyesThe docbook source document.
resultoutyesThe resulting XHTML

4.3 XProc (1.0) pipeline: xdoc-to-docbook.xpl

File: xpl/xdoc-to-docbook.xpl

Type: xdoc:xdoc-to-docbook

Pipeline that transforms a DocBook source containing xdoc extensions into "pure" DocBook format.

PortTypePrimary?Description
sourceinyesThe DocBook source with xdoc extensions
resultoutyesThe resulting DocBook
OptionRq?DefaultDescription
href-parameters ()Optional reference to a document with parameter settings. See here for details.
parameter-filters ()Optional filter settings for processing the parameters. Format: name=value|name=value|….

4.4 XProc (1.0) pipeline: xdoc-to-pdf.xpl

File: xpl/xdoc-to-pdf.xpl

Type: xdoc:xdoc-to-pdf

Convenience pipeline: Combines the xdoc-to-docbook and the docbook-to-pdf steps in one.

PortTypePrimary?Description
sourceinyesThe DocBook source with xdoc extensions
resultoutyesSome XML report about the conversion
OptionRq?DefaultDescription
chapter-id ''Specific chapter identifier to output.
fop-config resolve-uri('../../xtpxlib-common/data/fop-default-config.xml', static-base-uri())Reference to the FOP configuration file
global-resources-directory ()Images that are tagged as role="global" are searched here (discarding any directory information in the image's URI)
href-parameters ()Optional reference to a document with parameter settings. See here for details.
href-pdfyesThe name of the resulting PDF file
main-font-size 10Main font size as an integer. Usual values somewhere between 8 and 10.
output-type 'a4'Output type. Use either a4 or sb (= standard book size)
parameter-filters ()Optional filter settings for processing the parameters. Format: name=value|name=value|….
preliminary-version false()If true, adds a preliminary version marker and output any db:remark elements. If false, output of db:remark elements will be suppressed.

4.5 XProc (1.0) pipeline: xdoc-to-xhtml.xpl

File: xpl/xdoc-to-xhtml.xpl

Type: xdoc:xdoc-to-xhtml

Convenience pipeline: Combines the xdoc-to-docbook and the docbook-to-xhtml steps in one.

PortTypePrimary?Description
sourceinyesThe DocBook source with xdoc extensions
resultoutyesThe resulting XHTML
OptionRq?DefaultDescription
href-parameters ()Optional reference to a document with parameter settings. See here for details.
parameter-filters ()Optional filter settings for processing the parameters. Format: name=value|name=value|….