The xtpxlib-xdoc component contains the following XProc (1.0) pipelines:
| Module/Pipeline | Description |
|---|---|
docbook-to-pdf.xpl | This turns Docbook (5.1) into a PDF using FOP. |
docbook-to-xhtml.xpl | This turns Docbook (5.1) into XHTML. |
xdoc-to-docbook.xpl | Pipeline that transforms a DocBook source containing xdoc extensions into "pure" DocBook format. |
xdoc-to-pdf.xpl | Convenience pipeline: Combines the xdoc-to-docbook and the docbook-to-pdf steps in one. |
xdoc-to-xhtml.xpl | Convenience pipeline: Combines the xdoc-to-docbook and the docbook-to-xhtml steps in one. |
docbook-to-pdf.xplFile: 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>
| Port | Type | Primary? | Description |
|---|---|---|---|
source | in | yes | The docbook source document, fully expanded (with appropriate xml:base attributes) |
result | out | yes | The resulting XSL-FO (that was transformed into the PDF). |
| Option | Rq? | Default | Description |
|---|---|---|---|
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-pdf | yes | | The name of the resulting PDF file (must have file:// in front). |
href-xsl-fo | () | If set, writes the intermediate XSL-FO to this href (so you can inspect it when things go wrong in FOP) | |
main-font-size | 10 | Main 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. |
docbook-to-xhtml.xplFile: 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.
| Port | Type | Primary? | Description |
|---|---|---|---|
source | in | yes | The docbook source document. |
result | out | yes | The resulting XHTML |
xdoc-to-docbook.xplFile: xpl/xdoc-to-docbook.xpl
Type: xdoc:xdoc-to-docbook
Pipeline that transforms a DocBook source containing xdoc extensions into "pure" DocBook format.
| Port | Type | Primary? | Description |
|---|---|---|---|
source | in | yes | The DocBook source with xdoc extensions |
result | out | yes | The resulting DocBook |
| Option | Rq? | Default | Description |
|---|---|---|---|
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|…. |
xdoc-to-pdf.xplFile: 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.
| Port | Type | Primary? | Description |
|---|---|---|---|
source | in | yes | The DocBook source with xdoc extensions |
result | out | yes | Some XML report about the conversion |
| Option | Rq? | Default | Description |
|---|---|---|---|
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-docbook | () | If set, writes the intermediate full DocBook to this href (so you can inspect it when things go wrong) | |
href-parameters | () | Optional reference to a document with parameter settings. See here for details. | |
href-pdf | yes | | The name of the resulting PDF file |
href-xsl-fo | () | If set, writes the intermediate XSL-FO to this href (so you can inspect it when things go wrong in FOP) | |
main-font-size | 10 | Main 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. |
xdoc-to-xhtml.xplFile: 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.
| Port | Type | Primary? | Description |
|---|---|---|---|
source | in | yes | The DocBook source with xdoc extensions |
result | out | yes | The resulting XHTML |
| Option | Rq? | Default | Description |
|---|---|---|---|
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|…. |