Search manual:

- Main page
- Introduction
- Hello, world!
- Basics
  - How to write the layout
  - Structure of the data file and the layout rules
  - Outputting objects
  - Grid
  - Areas on the page (PositioningArea)
  - File organization
  - Hyphenation / language settings
  - Using fonts
  - Text formats
  - Text formatting
  - Colors
- Programming
- Image inclusion
- Tables
- Advanced topics
  - Bookmarks
  - Creation of XML structures
  - Print output / crop marks
  - Using CSS with the speedata Publisher
  - Groups (virtual objects)
  - Virtual pages
  - Rotation of contents
  - Sorting data
  - Wrap around images
  - Page types
  - Starting the Publisher via the Hotfolder
  - Lua-Filter / pre-processing
  - Schema validation
  - Quality assurance and PDF comparison
  - Troubleshooting / Debugging
  - Server mode (REST API)
  - Control of the layout when calling the Publisher
  - Create and use images with MetaPost
- Cookbook
  - Thumb index
  - Embed multipage PDF files
  - Layout optimization using groups
  - Imitate bulleted lists
  - Automatically generated directories
  - Create table of contents in one go
  - Page numbers: Page x of y
- Installation instructions
- File name in the Publisher
- speedata Publisher defaults
- Running the speedata publisher on the command line
- How to configure the speedata publisher
- Lenghts and units
- XPath- and Layoutfunctions
- Internal variables
- Associate XML editor with schema
  - Visual Studio Code
  - OxygenXML
  - Atom
- Changelog
- Glossary
- Compatibility with other software
- Command reference
  - A
  - Action
  - AddSearchpath
  - AtPageCreation
  - AtPageShipout
  - AttachFile
  - Attribute
  - B
  - Barcode
  - Bold
  - BoldItalic
  - Bookmark
  - Box
  - Br
  - Case
  - Circle
  - ClearPage
  - Color
  - Column
  - Columns
  - Compatibility
  - Contents
  - Copy-of
  - DefineColor
  - DefineColorprofile
  - DefineFontalias
  - DefineFontfamily
  - DefineGraphic
  - DefineMatter
  - DefineTextformat
  - Element
  - Fallback
  - Fontface
  - ForAll
  - Frame
  - Grid
  - Group
  - Groupcontents
  - HSpace
  - Hyphenation
  - I
  - Image
  - Include
  - Initial
  - InsertPages
  - Italic
  - Layout
  - Li
  - LoadDataset
  - LoadFontfile
  - Loop
  - Makeindex
  - Margin
  - Mark
  - Message
  - NewPage
  - NextFrame
  - NextRow
  - NoBreak
  - Ol
  - Options
  - Otherwise
  - Output
  - Overlay
  - Pageformat
  - Pagetype
  - Paragraph
  - PDFOptions
  - PlaceObject
  - Position
  - PositioningArea
  - PositioningFrame
  - ProcessNode
  - Record
  - Regular
  - Rule
  - SaveDataset
  - SavePages
  - SetGrid
  - SetVariable
  - SortSequence
  - Stylesheet
  - Span
  - Sub
  - Sup
  - Switch
  - Table
  - TableNewPage
  - Tablefoot
  - Tablehead
  - Tablerule
  - Td
  - Text
  - Textblock
  - Tr
  - Trace
  - Transformation
  - U
  - Ul
  - Until
  - URL
  - Value
  - VSpace
  - While

Version 4.6.0
Search manual

- Main page
- Introduction
- Hello, world!
- Basics
  - How to write the layout
  - Structure of the data file and the layout rules
  - Outputting objects
  - Grid
  - Areas on the page (PositioningArea)
  - File organization
  - Hyphenation / language settings
  - Using fonts
  - Text formats
  - Text formatting
  - Colors
- Programming
- Image inclusion
- Tables
- Advanced topics
  - Bookmarks
  - Creation of XML structures
  - Print output / crop marks
  - Using CSS with the speedata Publisher
  - Groups (virtual objects)
  - Virtual pages
  - Rotation of contents
  - Sorting data
  - Wrap around images
  - Page types
  - Starting the Publisher via the Hotfolder
  - Lua-Filter / pre-processing
  - Schema validation
  - Quality assurance and PDF comparison
  - Troubleshooting / Debugging
  - Server mode (REST API)
  - Control of the layout when calling the Publisher
  - Create and use images with MetaPost
- Cookbook
  - Thumb index
  - Embed multipage PDF files
  - Layout optimization using groups
  - Imitate bulleted lists
  - Automatically generated directories
  - Create table of contents in one go
  - Page numbers: Page x of y
- Installation instructions
- File name in the Publisher
- speedata Publisher defaults
- Running the speedata publisher on the command line
- How to configure the speedata publisher
- Lenghts and units
- XPath- and Layoutfunctions
- Internal variables
- Associate XML editor with schema
  - Visual Studio Code
  - OxygenXML
  - Atom
- Changelog
- Glossary
- Compatibility with other software
- Command reference
  - A
  - Action
  - AddSearchpath
  - AtPageCreation
  - AtPageShipout
  - AttachFile
  - Attribute
  - B
  - Barcode
  - Bold
  - BoldItalic
  - Bookmark
  - Box
  - Br
  - Case
  - Circle
  - ClearPage
  - Color
  - Column
  - Columns
  - Compatibility
  - Contents
  - Copy-of
  - DefineColor
  - DefineColorprofile
  - DefineFontalias
  - DefineFontfamily
  - DefineGraphic
  - DefineMatter
  - DefineTextformat
  - Element
  - Fallback
  - Fontface
  - ForAll
  - Frame
  - Grid
  - Group
  - Groupcontents
  - HSpace
  - Hyphenation
  - I
  - Image
  - Include
  - Initial
  - InsertPages
  - Italic
  - Layout
  - Li
  - LoadDataset
  - LoadFontfile
  - Loop
  - Makeindex
  - Margin
  - Mark
  - Message
  - NewPage
  - NextFrame
  - NextRow
  - NoBreak
  - Ol
  - Options
  - Otherwise
  - Output
  - Overlay
  - Pageformat
  - Pagetype
  - Paragraph
  - PDFOptions
  - PlaceObject
  - Position
  - PositioningArea
  - PositioningFrame
  - ProcessNode
  - Record
  - Regular
  - Rule
  - SaveDataset
  - SavePages
  - SetGrid
  - SetVariable
  - SortSequence
  - Stylesheet
  - Span
  - Sub
  - Sup
  - Switch
  - Table
  - TableNewPage
  - Tablefoot
  - Tablehead
  - Tablerule
  - Td
  - Text
  - Textblock
  - Tr
  - Trace
  - Transformation
  - U
  - Ul
  - Until
  - URL
  - Value
  - VSpace
  - While

- Dieses Handbuch auf Deutsch

# speedata Publisher defaults

The speedata Publisher defines some default settings that can be changed in the layout file. These defaults concern the colors, fonts and page size and margins.

## Fonts

The distribution includes the free font family TeXGyreHeros, a high quality clone of Helvetica. It comes in the variants regular, bold, italic and bolditalic. It is defined as follows:

    <LoadFontfile
           name="TeXGyreHeros-Regular"
           filename="texgyreheros-regular.otf" />
    <LoadFontfile
           name="TeXGyreHeros-Bold"
           filename="texgyreheros-bold.otf" />
    <LoadFontfile
           name="TeXGyreHeros-Italic"
           filename="texgyreheros-italic.otf" />
    <LoadFontfile
           name="TeXGyreHeros-BoldItalic"
           filename="texgyreheros-bolditalic.otf" />

    <LoadFontfile
           name="CamingoCode-Bold"
           filename="CamingoCode-Bold.ttf" />
    <LoadFontfile
           name="CamingoCode-BoldItalic"
           filename="CamingoCode-BoldItalic.ttf" />
    <LoadFontfile
           name="CamingoCode-Italic"
           filename="CamingoCode-Italic.ttf" />
    <LoadFontfile
           name="CamingoCode-Regular"
           filename="CamingoCode-Regular.ttf" />

    <LoadFontfile
           name="CrimsonPro-Bold"
           filename="CrimsonPro-Bold.ttf" />
    <LoadFontfile
           name="CrimsonPro-BoldItalic"
           filename="CrimsonPro-BoldItalic.ttf" />
    <LoadFontfile
           name="CrimsonPro-Italic"
           filename="CrimsonPro-Italic.ttf" />
    <LoadFontfile
           name="CrimsonPro-Regular"
           filename="CrimsonPro-Regular.ttf" />

The corresponding font family is defined as:

    <DefineFontfamily name="text" fontsize="10" leading="12">
      <Regular    fontface="TeXGyreHeros-Regular"/>
      <Bold       fontface="TeXGyreHeros-Bold"/>
      <Italic     fontface="TeXGyreHeros-Italic"/>
      <BoldItalic fontface="TeXGyreHeros-BoldItalic"/>
    </DefineFontfamily>

and since the font family named text is taken as the default for the paragraphs, without any change the text appears in Helvetica 10pt/12pt. With re-defining the font family text you can change the document font.

The font aliases are defined for the default font:

- `TeXGyreHeros-Regular` → sans
- `TeXGyreHeros-Bold` → sans-bold
- `TeXGyreHeros-Italic` → sans-italic
- `TeXGyreHeros-BoldItalic` → sans-bolditalic
- `CrimsonPro-Regular` → serif
- `CrimsonPro-Bold` → serif-bold
- `CrimsonPro-Italic` → serif-italic
- `CrimsonPro-BoldItalic` → serif-bolditalic
- `CamingoCode-Regular` → monospace
- `CamingoCode-Bold` → monospace-bold
- `CamingoCode-Italic` → monospace-italic
- `CamingoCode-BoldItalic` → monospace-bolditalic

The OpenType features activated with the `harfbuzz` mode are:

Feature | Description
--- | ---
`abvm` | Above-base Mark Positioning
`blwm` | Below-base Mark Positioning
`calt` | Contextual Alternates
`ccmp` | Glyph Composition/Decomposition
`clig` | Contextual Ligatures
`curs` | Cursive Positioning
`dist` | Distances
`kern` | Kerning
`locl` | Localized Forms
`mark` | Mark Positioning
`mkmk` | Mark to Mark Positioning
`rclt` | Required Contextual Alternates
`rlig` | Required Ligatures

## Textformats

The following text formats are predefined:

    <DefineTextformat name="text" alignment="justified"/>
    <DefineTextformat name="centered" alignment="centered" />
    <DefineTextformat name="left" alignment="leftaligned"/>
    <DefineTextformat name="right" alignment="rightaligned"/>

    <DefineTextformat name="__justified" alignment="justified"/>
    <DefineTextformat name="__centered" alignment="centered" />
    <DefineTextformat name="__leftaligned" alignment="leftaligned"/>
    <DefineTextformat name="__rightaligned" alignment="rightaligned"/>

The last four are used in tables. See the section on text formats in tables.

## Page size and margin

The page size defaults to A4 (210mm × 297mm).

The master page for all pages is defined as follows:

    <Pagetype name="Default Page" test="true()">
      <Margin left="1cm" right="1cm" top="1cm" bottom="1cm"/>
    </Pagetype>

The page grid is set to 10mm × 10mm.

## Colors

The known CSS colors are defined in the RGB color space. The colors 'black' and 'white' are defined in the grayscale color space. See also the command `DefineColor`, there the predefined colors are listed.

The special colors HKS 1-97 and many Pantone colors are already defined with their CMYK values.

## Matters

There are two sections defined:

    <DefineMatter name="mainmatter" label="decimal" resetbefore="yes" />
    <DefineMatter name="frontmatter" label="lowercase-romannumeral" />

- File name in the Publisher
- Running the speedata publisher on the command line