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
- 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.10.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
- 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

# Paragraph

Insert a paragraph of text. The width of the paragraph is inherited from the surrounding element.

## Child elements

`A`, `Action`, `B`, `Br`, `Color`, `Fontface`, `ForAll`, `Frame`, `HSpace`, `I`, `Image`, `Initial`, `Loop`, `NoBreak`, `Span`, `Sub`, `Sup`, `Switch`, `U`, `URL`, `Value`

## Parent elements

`Case`, `ForAll`, `Loop`, `Otherwise`, `SetVariable`, `Text`, `Textblock`, `Until`, `While`

## Attributes

`allowbreak` (text, optional)

  (Experimental!) list of characters where a line break is possible. Space character is not implied when this attribute is set.

`bidi` (optional, since version 4.1.14)

  Analyze direction of the text. Useful for mixing left-to-right and right-to-left text.

  `yes`

    Analyze text.

  `no`

    Don’t handle mixed directions (default).

`class` (text, optional)

  CSS class for this paragraph.

`color` (text, optional, CSS property: color)

  Color of the paragraph. Must be defined with DefineColor before use.

`direction` (text, optional, since version 4.1.12)

  The text direction (ltr or rtl)

`fontface` (text, optional, CSS property: font-family)

  Deprecated. Use `fontfamily` instead.

`fontfamily` (text, optional, CSS property: font-family)

  The name of the font family for the paragraph. The default is »text« (lowercase t).

`html` (optional, since version 4.1.2)

  Set the HTML processing mode. Defaults to 'all'.

  `all`

    Interpret HTML starting from the current element.

  `inner`

    Ignore the name of the outer element.

  `off`

    Switch off HTML in this paragraph. Use only the text value.

`id` (text, optional)

  CSS id for this paragraph.

`label-left` (text, optional, since version 4.1.4)

  A text to the left of the paragraph.

`label-left-align` (optional, since version 4.1.4)

  Alignment of the text.

  `left`

    Left aligned

  `right`

    Right aligned

`label-left-distance` (length, optional, since version 4.1.4)

  Horizontal distance between text and paragraph (if right aligned).

`label-left-width` (length, optional, since version 4.1.4)

  Width of the text.

`language` (optional)

  Name of the language for hyphenation and rendering.

`padding-left` (length, optional, since version 3.9.27)

  Set the left padding, i.e. the inner distance to the allocated area.

`padding-right` (length, optional, since version 3.9.27)

  Set the right padding, i.e. the inner distance to the allocated area.

`role` (optional, since version 3.5.7)

  The role for PDF/UA (accessibility, tagged PDF)

  `H1`

    Heading level 1

  `P`

    A paragraph.

`textformat` (text, optional)

  Name of the textformat that is applied to the paragraph. If none is specified the textformat `text` is used.

## Example

    <Textblock>
      <Paragraph fontfamily="Title">
        <Value>Hello World</Value>
      </Paragraph>
    </Textblock>

## See also

The section text formatting and the command Options for a list of all languages.

- Pagetype
- PDFOptions