Erstellen Sie Ihre Vorlagen manuell.
Jim Evins
evins@snaught.com
Mario Blättermann
mariobl@gnome.org

Creative Commons Share Alike 3.0

# Manuelles Erstellen neuer Vorlagen

Diese Seite ist eine Referenzanleitung für die manuelle Erstellung von gLabels-Vorlagen. gLabels-Vorlagen sind einfache XML-Dateien, deren Struktur in der folgenden DTD beschrieben ist: glabels-2.3.dtd. Diese DTD beschreibt außerdem weitere von gLabels benutzte XML-Formate.

Manuell erstellte Vorlagen sollten in ${HOME}/.glabels gespeichert und mit der Erweiterung .template versehen werden.

gLabels sucht an verschiedenen anderen Orten nach Vorlagen, die folgendermaßen definiert werden:

Ort | Beschreibung
${prefix}/share/libglabels-3.0/templates | In gLabels mitgelieferte vordefinierte Vorlagen. ${prefix} ist üblicherweise /usr oder /usr/local, abhängig davon, wo gLabels installiert wurde.
${XDG_CONFIG_HOME}/libglabels/templates | Mit dem Vorlagen-Designer von gLabels erstellte Vorlagen. Legen Sie hier bitte keine manuell erstellten Vorlagen ab. Falls ${XDG_CONFIG_HOME} nicht definiert ist, wird als Vorgabe ${HOME}/.config verwendet.
${HOME}/.glabels | Manuell erstellte benutzerdefinierte Vorlagen sollten hier abgelegt werden. Ältere Versionen des Vorlagen-Designers von gLabels (vor 3.0) speichern hier ebenfalls ihre Vorlagen.

Vollständige Vorlagendateien können Sie an die Vorlagen-Mailingliste von gLabels senden, damit diese in zukünftigen Versionen von gLabels mitgeliefert werden können.

# Voraussetzungen

Eine Seite enthält nur eine Etiketten- oder Kartengröße. Falls eine Seite mehrere Größen enthält, kann sie für das Drucken in mehreren Durchläufen über mehrere Vorlagen verteilt werden.

Distances can be expressed in units of `pt`, `in`, `mm`, `cm`, or `pc`. For example: "`1.0in`" or "`2.54cm`". If no units are specified, computer points (`pt`) will be assumed (1 pt = 1/72 in = 0.352778 mm).

# Vorlagedateien

A template file contains a single `Glabels-templates` top-level node.

<?xml version="1.0"?> <Glabels-templates>

...Vorlagen...

</Glabels-templates>

## Beispielvorlage

Example gLabels template file containing a single `Template` node.
<?xml version="1.0"?> <Glabels-templates>

<Template brand="Avery" part="8160" size="US-Letter" description="Mailing Labels"> <Meta category="label"/> <Meta category="mail"/> <Meta product_url="http://www.avery.com/avery/en_us/"/> <Label-rectangle id="0" width="189pt" height="72pt" round="5pt"> <Markup-margin size="5pt"/> <Layout nx="3" ny="10" x0="11.25pt" y0="36pt" dx="200pt" dy="72pt"/> </Label-rectangle> </Template>

</Glabels-templates>

# Template Node

A `Template` node describes a single stationery product. It must contain one instance of any type of Label node (`Label-rectangle`, `Label-round`, or `Label-cd`).

Eigenschaft | Beschreibung
`brand` | Marke oder Hersteller des Produkts, z.B. »Avery«
`part` | Bestellnummer oder Name des Produkts, z.B. »8160«
`size` | Size of sheet. E.g., "`US-Letter`", "`A4`", ...
`description` | Beschreibung des Produkts, z.B. »Mailing Labels«.
`_description` | Übersetzbare Beschreibung des Produkts, z.B. »Mailing Labels« (nur sinnvoll für vordefinierte Vorlagen)
`width` | Seitenbreite. Nur gültig, wenn als Größe »Other« festgelegt ist.
`height` | Seitenhöhe. Nur gültig, wenn als Größe »Other« festgelegt ist.

`equiv`

Äquivalente Bestellnummer. Falls diese Eigenschaft vorhanden ist, handelt es sich bei dieser Vorlage um eine Kopie einer anderen Vorlage der gleichen Marke. Die Vorlage erbt alle Eigenschaften der anderen Vorlage, ausgenommen die Marke und die Bezeichnung. Die »equiv«-Eigenschaft muss sich auf eine bereits definierte Vorlage beziehen, denn derzeit unterstützt libglabels keine Vorwärtsreferenzen.

# Meta Node

A `Meta` node contains some additional information about the template. A `Template` node may contain zero or more `Meta` nodes.

Unterknoten | Beschreibung

`category`

A category for the template. A template can belong to multiple categories by simply adding multiple `Meta` nodes to the parent `Template` node. Template categories are used by the gLabels New Label Dialog to filter the results of template searches.

Der Wert dieser Kategorie muss einem der in der Datei ${prefix}/libglabels-3.0/templates/categories.xml vordefinierten Werte entsprechen. Derzeit stehen folgende Kategorien zur Verfügung:

`label`

`round-label`

`elliptical-label`

`square-label`

`rectangle-label`

`card`

`business-card`

`media`

`mail`

`foldable`

`photo`

`product_url` | Diese Adresse leitet auf die Webseite des Anbieters weiter. Idealerweise ist dies die Adresse genau dieses Produkts, falls diese verfügbar ist.

Falls Sie Ideen für neue Kategorien haben, senden Sie Ihre Vorschläge bitte an die Mailingliste der gLabels-Entwickler.

Produktadressen sind oft nur begrenzt gültig, das sich diese auch ändern können.

# Label-rectangle Node

A `Label-rectangle` node describes the dimensions of a single label or business card that is rectangular in shape (may have rounded edges).

Eigenschaft | Beschreibung
`id` | Für zukünftige Verwendung reserviert. Sollte immer 0 sein.
`width` | Breite des Etiketts oder der Karte
`height` | Höhe des Etiketts oder der Karte
`round` | Radius der Ecken. Für Objekte mit nicht abgerundeten Ecken (Visitenkarten) sollte der Radius 0 sein.
`x_waste` | Erlaubte Breite des horizontalen Überdruckens. Dies minimiert Ausrichtungsprobleme auf anderen als weißen Hintergründen (z.B. Bilder).
`y_waste` | Erlaubte Breite des vertikalen Überdruckens. Dies minimiert Ausrichtungsprobleme auf anderen als weißen Hintergründen (z.B. Bilder).

Label-rectangle parameters

Label-rectangle parameters

# Label-ellipse Node

A `Label-ellipse` node describes the dimensions of a single label or business card that is elliptic in shape.

Eigenschaft | Beschreibung
`id` | Für zukünftige Verwendung reserviert. Sollte immer 0 sein.
`width` | Breite der Ellipse
`height` | Höhe der Ellipse
`waste` | Erlaubte Breite des Überdruckens. Dies minimiert Ausrichtungsprobleme auf anderen als weißen Hintergründen (z.B. Bilder).

Label-ellipse parameters

Label-ellipse parameters

# Label-round Node

A `Label-round` node describes the dimensions of a simple round label (not a CD).

Eigenschaft | Beschreibung
`id` | Für zukünftige Verwendung reserviert. Sollte immer 0 sein.
`radius` | Radius (halber Durchmesser) des Etiketts
`waste` | Erlaubte Breite des Überdruckens. Dies minimiert Ausrichtungsprobleme auf anderen als weißen Hintergründen (z.B. Bilder).

Label-ellipse parameters

Label-ellipse parameters

# Label-cd Node

A `Label-cd` node describes the dimensions of a CD, DVD, or business card CD.

Eigenschaft | Beschreibung
`id` | Für zukünftige Verwendung reserviert. Sollte immer 0 sein.
`radius` | Äußerer Radius des Etiketts
`hole` | Radius des Mittellochs
`width` | Falls vorhanden, wird das Etikett auf die angegebene Größe begrenzt (nützlich für »Visitenkarten-CDs«)
`height` | Falls vorhanden, wird das Etikett auf die angegebene Höhe begrenzt (nützlich für »Visitenkarten-CDs«)
`waste` | Erlaubte Breite des Überdruckens. Dies minimiert Ausrichtungsprobleme auf anderen als weißen Hintergründen (z.B. Bilder).

Label-cd parameters

CD-Label-Parameter

# Markup Nodes

Vorlagen können optional auch Markierungs-Knoten enthalten. Diese Knoten beschreiben eine Reihe von Markierungslinien, die zwar im Zeichenbereich von gLabels angezeigt werden, jedoch im späteren Ausdruck nicht sichtbar sind. Diese Linien können Ränder, Falzlinien, Mittellinien oder spezielle Bereiche darstellen sowie dem Benutzer einer Vorlage weitere hilfreiche Hinweise geben.

## Markup-margin Node

A `Markup-margin` describes a margin along all edges of a label.

Eigenschaft | Beschreibung
`size` | Randbreite. Die Breite des Bereichs zwischen der Randlinie und dem Rand des Etiketts/der Karte.

## Markup-line Node

A `Markup-line` node describes a markup line.

Eigenschaft | Beschreibung
`x1` | x-Koordinate des Anfangspunkts des Linienabschnitts.
`y1` | y-Koordinate des Anfangspunkts des Linienabschnitts.
`x2` | x-Koordinate des zweiten Endpunkts des Linienabschnitts.
`y2` | y-Koordinate des zweiten Endpunkts des Linienabschnitts.

## Markup-circle Node

A `Markup-circle` describes a markup circle.

Eigenschaft | Beschreibung
`x0` | x-Koordinate des Kreismittelpunkts.
`y0` | y-Koordinate des Kreismittelpunkts.
`radius` | Radius des Kreises.

## Markup-rect Node

A `Markup-rect` describes a markup rectangle.

Eigenschaft | Beschreibung
`x1` | x-Koordinate der oberen linken Ecke des Rechtecks.
`y1` | y-Koordinate der oberen linken Ecke des Rechtecks.
`w` | Breite des Rechtecks.
`h` | Höhe des Rechtecks.
`r` | Radius der abgerundeten Ecken des Rechtecks.

## Markup-ellipse Node

A `Markup-ellipse` describes a markup ellipse.

Eigenschaft | Beschreibung
`x1` | x-Koordinate der oberen linken Ecke des die Ellipse umschließenden Rechtecks.
`y1` | x-Koordinate der oberen linken Ecke des die Ellipse umschließenden Rechtecks.
`w` | Die Breite der Ellipse.
`h` | Die Höhe der Ellipse.

# Layout Node

A label node may contain multiple `Layout` children. If labels are arranged in a simple grid pattern, only one layout is needed. However, if labels are arranged in multiple grids, such as a running bond pattern, multiple `Layout` tags can be used.

Ein gutes Beispiel für mehrere Layouts ist ein Blatt mit drei CD-Etiketten:

Bogen mit CD-Etiketten

Bogen mit CD-Etiketten

Die zwei Etiketten am linken Rand können einem Raster zugeordnet werden, vorausgesetzt sie lassen sich über die Koordinaten des linken oberen Etiketts und den Abstand zum zweiten Etikett sauber definieren. Diese zwei Etiketten haben den Abstand zum linken Rand gemeinsam. Das dritte Etikett am rechten Rand hat keine gemeinsamen Randabstände mit den anderen, so dass ein zweites Layout mit eindeutigen Koordinaten der linken oberen Ecke des Etiketts angegeben werden muss.

Sie können mehrere Layouts nur dann definieren, wenn die Etiketten auf dem Blatt die gleiche Form aufweisen. Falls Ihr Blatt unterschiedliche Formen enthält, dann müssen Sie für jede Form eine separate Vorlage anlegen. Zukünftige Versionen von gLabels werden wahrscheinlich in der Lage sein, solche Bögen mit verschiedenen Formen in einer einzigen Vorlage zusammenzufassen.

Beachten Sie, dass ein einzelnes Etikett immer auch als ein Raster aus Etiketten betrachtet werden kann.

Eigenschaft | Beschreibung
`nx` | Anzahl der Etiketten/Karten im Raster in horizontaler Richtung
`ny` | Anzahl der Etiketten/Karten im Raster in vertikaler Richtung
`x0` | Abstand von linken Rand des Papiers zum linken Rand der linken Reihe der Karten/Etiketten im Layout.
`y0` | Abstand von oberen Rand des Papiers zum oberen Rand der oberen Reihe der Karten/Etiketten im Layout.
`dx` | Horizontaler Rasterabstand des Zeichengitters.
`dy` | Vertikaler Rasterabstand des Zeichengitters.

Layout parameters

Layout Parameters