Version 5.5.8

Textformate

Textformate dienen zur Steuerung der Absätze. Hierüber lassen sich verschiedene Dinge wie Texteinzug, Textausrichtung, Hurenkinder und Schusterjungen, Umbruchverhalten und mehr steuern.

Die einzelnen Parameter werden in der Referenz unter <DefineTextformat> beschrieben.

Übersicht aller Attribute

Attribut	Beschreibung
`alignment`	Textausrichtung: `justified` (Blocksatz), `leftaligned`, `rightaligned`, `centered`, `start`, `end`
`border-top`, `border-bottom`	Dicke der Linie über/unter dem Text
`break-before`	Seitenumbruch vor dem Text erzwingen (`page`)
`break-below`	Umbruch unter dem Text erlauben/verbieten (`yes`/`no`)
`hyphenate`	Silbentrennung an/aus (`yes`/`no`)
`hyphenchar`	Trennzeichen (Voreinstellung: `-`)
`indentation`	Einzug der ersten Zeile(n)
`letter-spacing`	Zeichenabstand in 1/1000 em (z.B. `50` = 0,05 em)
`margin-top`, `margin-bottom`	Außenabstand oben/unten
`padding-top`, `padding-bottom`	Innenabstand oben/unten
`orphan`, `widow`	Schusterjungen/Hurenkinder verhindern
`rows`	Anzahl der eingerückten Zeilen
`tab`	Verhalten bei Tabulator (`space`/`hspace`)

Das Textformat mit dem Namen text ist im Publisher vorgegeben und wird an allen Stellen benutzt, wo kein anderes Textformat angegeben wird. Es ist wie folgt definiert:

<DefineTextformat name="text" alignment="justified"/>

Damit werden alle Texte in Blocksatz und mit Silbentrennung, ohne Einzug und ohne Abstände oben und unten ausgegeben, solange

das Format text nicht neu definiert wird oder
ein anderes Textformat bei <Paragraph> oder <Textblock> angegeben wird (das Attribut dazu heißt textformat).

Umbruch zwischen Texten

Seitenumbrüche beispielsweise nach einer Überschrift sind unerwünscht. Um Umbrüche an diesen Stellen zu unterbinden, kann die Textformat-Eigenschaft break-below ausgeschaltet werden:

<Layout xmlns="urn:speedata.de:2009/publisher/en"
  xmlns:sd="urn:speedata:2009/publisher/functions/en">
  <Pageformat width="100mm" height="70mm"/>
  <Trace textformat="yes"/>

  <DefineTextformat name="keeptogether" break-below="no"/>

  <DefineFontfamily name="h1" fontsize="18" leading="20">
    <Regular fontface="sans-bold"/>
  </DefineFontfamily>

  <Record element="data">
    <Output>
      <Text>
        <Paragraph fontfamily="h1" textformat="keeptogether">
          <Value>A Title</Value>
        </Paragraph>
        <Paragraph>
          <Value select="sd:dummytext()"/>
        </Paragraph>
      </Text>
    </Output>
  </Record>
</Layout>

Um zu verhindern, dass zwischen der Überschrift und dem Text ein Seitenumbruch eingefügt wird, muss man das Textformat der Überschrift anpassen.

Ausgabe einer Überschrift. Das Textformat mit der Eigenschaft break-below verhindert einen Umbruch unter der Überschrift.

Umbruch innerhalb eines Textes

Umbrüche innerhalb eines Textes können durch die Eigenschaft break-before erzwungen werden. Das ist beispielsweise bei einer Überschrift sinnvoll, die immer auf einer neuen Seite beginnen soll. Dazu wird das Textformat der Überschrift angepasst:

<Layout xmlns="urn:speedata.de:2009/publisher/en"
    xmlns:sd="urn:speedata:2009/publisher/functions/en">

    <DefineTextformat name="h1" break-before="page" />
    <Record element="data">
        <Output>
            <Text>
                <Paragraph>
                    <Value>Page one</Value>
                </Paragraph>
                <Paragraph textformat="h1">
                    <Value>H1 on page two</Value>
                </Paragraph>
                <Paragraph>
                    <Value>Some text</Value>
                </Paragraph>
            </Text>
        </Output>
    </Record>
</Layout>

Um zu erzwingen, dass die Überschrift immer auf einer neuen Seite beginnt, muss das Attribut break-before auf page gesetzt werden.

Die Eigenschaften break-below="no" und break-before="page" werden allerdings nur innerhalb einer Textausgabe (<Output>) berücksichtigt. Zwischen zwei Textausgaben kann sehr wohl ein Seitenumbruch eingefügt werden, das lässt sich nicht verhindern. Um dennoch einen Text an einem Stück auszugeben, der erst aus den Daten zusammengesetzt werden muss, speichert man die einzelnen Inhalte in Variablen und gibt sie dann an einem Stück aus.

  <Record element="data">
    <SetVariable variable="mytitle">
      <Paragraph fontfamily="h1" textformat="keeptogether">
        <Value>A Title</Value>
      </Paragraph>
    </SetVariable>

    <SetVariable variable="mytext">
      <Paragraph>
        <Value select="sd:dummytext()"/>
      </Paragraph>
    </SetVariable>

    <Output>
      <Text>
        <Copy-of select="$mytitle"/>
        <Copy-of select="$mytext"/>
      </Text>
    </Output>
  </Record>

Mit Variablen und kann man Texte zusammensetzen und an einem Stück ausgeben.

Tracing

Der Befehl <Trace textformat="yes"/> aktiviert »tooltips« im PDF über den Texten, die das dort verwendete Textformat ausgeben.