Version 5.9.4

# `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).
`runs` (number, optional, since version 5.9.4)
  Number of publishing runs. Some layouts need more than one run, for example to get page references or the total number of pages right. The command line option `--runs` takes precedence over this attribute, this attribute takes precedence over the setting in the configuration file. Since the value is read during the first run, it takes effect from the second run on.
`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`)

#### On this page