Version 5.5.8

Options

Set publisher specific options.

Child elements

(none)

Parent elements

AtPageCreation , AtPageShipout , Case , Contents , ForAll , Include , Layout , Loop , Otherwise , Record , SavePages , Section , Until , While

Attributes

background-color (text, optional, since version 4.19.11)
Render colored background behind each page. Defaults to ‘white’. State a color name or ‘-’ for no background.
bleed (length, optional)
The amount of bleed. Defaults to 0mm.
bleedmarks (optional, since version 2.3.24)
Trim marks will be placed in the PDF. The distance of the marks from the imaginary center is determined by the attribute trim, but is at least 5mm. The length of the cut marks is 1cm. The default of this attribute is no, that means no trim marks will be displayed. The trim marks show the additional trim distance.
  • yes: Show trim marks.
  • no: Don’t show trim marks (default).
crop (yes, no or length, optional, since version 2.3.21)
Crop the pages so that the pdf size of the page is at its minimum. Allowed values are yes, no and a length.
cutmarks (optional)
Cut marks / crop marks will be placed in the PDF. The distance of the marks from the imaginary center is determined by the attribute trim, but is at least 5mm. The length of the cut marks is 1cm. The default of this attribute is no, that means no cut marks will be displayed.
  • yes: Show crop marks.
  • no: Don’t show crop marks (default).
defaultarea (text, optional, since version 2.7.4)
Name of the area that is used as a default for placing text (commands Output and PlaceObject ). Default is _page.
fontexpansion (optional, since version 4.19.17)
Allow glyph stretching and shrinking. Default is ‘yes’.
  • no: Do not allow font stretching or shrinking.
  • some: Stretching and shrinking is applied after the line break.
  • yes: Stretching and shrinking is applied before linebreak, so the line breaking algorithm has more possible break points thus leading to a “better” visual appearance.
fontshrink (number, optional, since version 4.19.17)
Set the default maximum shrinkage factor of the fonts. Default is disabled. Values divided by 10 = percent. For example 20 means shrink by maxium of 2%.
fontstep (number, optional, since version 4.19.17)
Set the default step values for shrinkage / stretching. Value divided by 10 is step in percentage. For example: a value of 20 means increase / decrease size in 2% steps. Default 10.
fontstretch (number, optional, since version 4.19.17)
Set the default maximum stretch factor of the fonts. Default is disabled. Values divided by 10 = percent. For example 20 means stretch by maxium of 2%.
html (optional, since version 5.3.12)
Default setting for HTML parsing in paragraphs. Can be overridden locally in Paragraph . Setting this to ‘off’ can significantly improve typesetting performance when HTML tags like or are not used.
  • all: Parse HTML in all paragraphs (default).
  • inner: Parse HTML only in child elements of the current data element.
  • off: Disable HTML parsing in paragraphs.
ignoreeol (optional)
Ignore newlines in data-xml
  • yes: Ignore newlines in data-xml
  • no: Respect newlines in data-xml
imagenotfound (optional, since version 2.3.43)
When an image is not found: should the publisher raise an error?
  • warning: Show a warning
  • error: Raise an error (default)
interaction (yes or no, optional, since version 3.9.2)
If no, switch off all interaction (hyperlinks).
mainlanguage (optional)
The default language for text (hyphenation and rendering). You can also set the default language on the command line and locally set it at Paragraph and Textblock .
markdown-extensions (text, optional, since version 4.17.11)
Set the markdown extensions. Must be a comma seprarated list of one or more of these values: table, strikethrough, linkify, tasklist, gfm, definitionlist, footnote, typographer, cjk.
mpcolorwarning (yes or no, optional, since version 5.1.9)
Show a warning if the color name is not compatible with MetaPost.
namespaces (optional, since version 4.19.37)
Controls the handling of XML namespaces. The default is ’lax’ which ignores all namespaces with Record and ProcessNode .
  • lax: This is the default. XML namespaces in the data file are ignored.
  • strict: Record and ProcessNode are namespace sensitive.
overfull-line (optional, since version 4.19.10)
Raise a warning or an error if a text line is too wide for a text block.
  • warning: Show a warning
  • error: Raise an error
  • ignore: Ignore this case (default).
randomseed (number, optional, since version 3.9.24)
Set the seed for the random number generator (a positive integer).
reportmissingglyphs (optional, since version 3.1.17)
Issue an error if glyphs are missing from a font.
  • yes: Show error message (default)
  • no: Do not show an error message
  • warning: Show a warning
resetmarks (optional)
Yes: ignore the marks file from previous run.
  • yes: Ignore marks from the previous run.
  • no: Use marks from the previous run (default).
startpage (number, optional)
Set the number of the first page.
tablerulefix (yes or no, optional, since version 4.21.3)
Re-draw rules in table so they appear on top of the table. This fixes a display bug in Adobe Acrobat when colored backgrounds are used.

Remarks

Bleed used to be ’trim’ in version 2.7.6 and before.

Example 

<Options
    cutmarks="yes"
    bleed="3mm"/>

Info

The list of languages and the short code known to the system are:

Ancient Greek (grc), Armenian (hy), Bahasa Indonesia (id), Basque (eu), Bulgarian (bg), Catalan (ca), Chinese (zh), Croatian (hr), Czech (cs), Danish (da), Dutch (nl), English (en_GB), English (Great Britain) (en_GB), English (USA) (en_US), Esperanto (eo), Estonian (et), Finnish (fi), French (fr), Galician (gl), German (de), Greek (el), Gujarati (gu), Hindi (hi), Hungarian (hu), Icelandic (is), Irish (ga), Italian (it), Kannada (kn), Kurmanji (ku), Latvian (lv), Lithuanian (lt), Malayalam (ml), Norwegian Bokmål (nb), Norwegian Nynorsk (nn), Other (--), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru), Sanskrit (sa), Serbian (sr), Serbian (cyrillic) (sc), Slovak (sk), Slovenian (sl), Spanish (es), Swedish (sv), Turkish (tr), Ukrainian (uk), Welsh (cy)