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.

Abstände können in den Einheiten `pt`, `in`, `mm`, `cm` oder `pc` ausgedrückt werden. Beispiel: »`1.0in`« oder »`2.54cm`«. Falls keine Einheiten angegeben werden, nimmt der Rechner Punkt an. Ein Punkt (`pt`) entspricht = 1/72 in = 0.352778 mm.

# Vorlagedateien

Eine Vorlagendatei enthält in der obersten Ebene einen einzelnen `Glabels-templates`-Knoten.

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

...Vorlagen...

</Glabels-templates>

## Beispielvorlage

Beispiel-Vorlagendatei von gLabels, die einen einzelnen `Template`-Knoten enthält.
<?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-Knoten

Ein Template-Knoten beschreibt ein einzelnes Produkt. Es muss eine Instanz eines der anderen Label-Knoten (`Label-rectangle`, `Label-round` oder `Label-cd`) enthalten.

Eigenschaft | Beschreibung
`brand` | Marke oder Hersteller des Produkts, z.B. »Avery«
`part` | Bestellnummer oder Name des Produkts, z.B. »8160«
`size` | Größe des Papiers, z.B. »`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-Knoten

Ein `Meta`-Knoten enthält eine Reihe zusätzlicher Eigenschaften des jeweiligen Produkts. Ein `Template`-Knoten kann keinen, einen oder auch mehrere `Meta`-Knoten enthalten.

Unterknoten | Beschreibung

`category`

Die Kategorie, der dieses Produkt zugeordnet ist. Eine Vorlage kann mehreren Kategorien zugeordnet werden, indem einfach mehrere `Meta`-Knoten zum übergeordneten `Template`-Knoten hinzugegügt werden. Die Werte dieser Kategorien werden von der Vorlagenauswahl in gLabels verwendet, um die Ansicht beispielsweise auf die Darstellung von Etiketten zu beschränken oder anders ausgedrückt, Etiketten allgemein anzuzeigen und die Anzeige anderer Produkte zu unterdrücken, an denen der Benutzer im jeweiligen Fall nicht interessiert ist.

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-Knoten

Ein `Label-rectangle`-Knoten beschreibt die Abmessungen eines einzelnen Etiketts oder einer einzelnen Karte in rechteckiger Form, wobei abgerundete Ecken möglich sind.

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

Parameter zu Label-rectangle

Parameter zu Label-rectangle

# Label-ellipse-Knoten

Ein `Label-ellipse`-Knoten beschreibt die Abmessungen eines einzelnen Etiketts oder einer einzelnen Karte in elliptischer Form.

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

Parameter zu Label-ellipse

Parameter zu Label-ellipse

# Label-round-Knoten

Ein `Label-round`-Knoten beschreibt die Abmessungen eines einfachen Rundetiketts (nicht einer 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).

Parameter zu Label-ellipse

Parameter zu Label-ellipse

# Label-cd-Knoten

Ein `Label-cd`-Knoten beschreibt die Abmessungen einer CD, DVD oder Visitenkarten-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-Parameter

CD-Label-Parameter

# Markup-Knoten

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-Knoten

Ein `Markup-margin`-Knoten beschreibt die Ränder entlang der Seiten eines Etiketts.

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

## Markup-line-Knoten

Ein `Markup-line`-Knoten beschreibt eine Markierungslinie.

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-Knoten

Ein `Markup-circle`-Knoten beschreibt einen Markierungskreis.

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

## Markup-rect-Knoten

Ein `Markup-rect`-Knoten beschreibt ein Markierungsrechteck.

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-Knoten

Ein `Markup-ellipse`-Knoten beschreibt eine Markierungsellipse.

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-Knoten

Ein Label-Knoten kann mehrere `Layout`-Unterknoten enthalten. Wenn die Etiketten in einem einfachen rechteckigen Raster angeordnet sind, dann wird nur ein Layout benötigt. Falls die Etiketten jedoch in komplizierteren Rasteranordnungen vorliegen, können mehrere `Layout`

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-Parameter

Layout-Parameter