WARNING: XProc 1.0 support is considered deprecated and will be removed in the near future!
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.xplThis 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). |
docbook-to-xhtml.xplFile: xpl/docbook-to-xhtml.xpl
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.
xdoc-to-docbook.xplPipeline 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 |
|---|---|---|---|
alttarget | () | The target for applying alternate settings. | |
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.xplConvenience 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 |
|---|---|---|---|
alttarget | () | The target for applying alternate settings. | |
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.xplConvenience 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 |
|---|---|---|---|
alttarget | () | The target for applying alternate settings. | |
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|…. |
| Module/Pipeline | Description |
|---|---|
xtpxlib-xdoc.mod.xpl | Library with support pipelines for xdoc and related conversions. |
xtpxlib-xdoc.mod.xplFile: xplmod/xtpxlib-xdoc.mod/xtpxlib-xdoc.mod.xpl
Library with support pipelines for xdoc and related conversions.
xdoc:markdown-to-docbookConverts the contents of xdoc:MARKDOWN elements into DocBook.
This pipeline checks the incoming XML for xdoc:MARKDOWN elements. The contents of these elements is assumed to contain Markdown. The pipeline tries to convert this into DocBook. The xdoc:MARKDOWN element is removed/unwrapped.
The contents of an xdoc:MARKDOWN element is stringified (so any child elements are lost).
The resulting text can be indented, using space characters only (no tabs!). The non-empty line with the minimum indent is assumed to be its left margin.
If you add an header-only="true" attribute to the xdoc:MARKDOWN element, only the first paragraph will be output.