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

Label-rectangle-Parameter

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

Label-ellipse-Parameter

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

Label-ellipse-Parameter

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

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-Unterknoten verwendet werden.

Ein gutes Beispiel für mehrere Layouts ist ein Blatt mit drei 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-Parameter