Creative Commons Share Alike 3.0
This page is a reference guide to manually creating
Manually created template files should be placed in the
Location |
Description |
Predefined templates distributed with |
|
User defined templates created with the If |
|
User defined templates that have been created manually should be placed in this
directory.
Older versions of the |
Completed template files can be sent to the
A sheet contains only one size of label or card (if a sheet contains more than one size of item, it can be split into multiple templates for multiple pass printing)
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).
A template file contains a single Glabels-templates
top-level
node.
<?xml version="1.0"?>
<Glabels-templates>
...templates...
</Glabels-templates>
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>
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
).
Property | Description |
|
Brand or manufacturer of stationery product. E.g. "Avery" |
|
Part number or name of stationery product. E.g. "8160" |
|
Size of sheet.
E.g., " |
|
Description of stationery product. E.g, "Mailing Labels." |
|
Translatable description of stationery product. E.g, "Mailing Labels." (Only useful for predefined templates) |
|
Page width. Only valid if size="Other" |
|
Page height. Only valid if size="Other" |
|
Equivalent part number. If this property is present, the template
is a clone of another template of the same brand. The template will
inherit all properties, except brand and name from the other template.
This equiv property must refer to a previously defined template -
|
A Meta
node contains some additional
information about the template. A Template
node may contain zero or more Meta
nodes.
Subnode | Description |
|
A category for the template.
A template can belong to multiple categories by simply adding multiple
The value of this category must match a predefined category ID defined in
the file
|
|
A URL pointing to the vendor's webpage for the specific product, if available. |
Suggestions for additional categories can be sent to the
Product URLs may be of limited use, because they may not be permanent.
A Label-rectangle
node describes the
dimensions of a single label or business card that is rectangular
in shape (may have rounded edges).
Property | Description |
|
Reserved for future use. Should always be 0. |
|
Width of label/card |
|
Heigth of label/card |
|
Radius of corners. For items with square edges (business cards), the radius should be 0. |
|
Amount of horizontal waste (over-print) to allow. This is useful for minimizing alignment problems when using non-white backgrounds (e.g. images). |
|
Amount of vertical waste (over-print) to allow. This is useful for minimizing alignment problems when using non-white backgrounds (e.g. images). |
A Label-ellipse
node describes the
dimensions of a single label or business card that is elliptic
in shape.
Property | Description |
|
Reserved for future use. Should always be 0. |
|
Width of the ellipse |
|
Heigth of the ellipse |
|
Amount of waste (over-print) to allow. This is useful for minimizing alignment problems when using non-white backgrounds (e.g. images). |
A Label-round
node describes the dimensions
of a simple round label (not a CD).
Property | Description |
|
Reserved for future use. Should always be 0. |
|
Radius (1/2 diameter) of label |
|
Amount of waste (over-print) to allow. This is useful for minimizing alignment problems when using non-white backgrounds (e.g. images). |
A Label-cd
node describes the dimensions
of a CD, DVD, or business card CD.
Property | Description |
|
Reserved for future use. Should always be 0. |
|
Outer radius of label |
|
Radius of concentric hole |
|
If present, the label is clipped to the given width. (Useful for "business card CDs"). |
|
If present, the label is clipped to the given height. (Useful for "business card CDs"). |
|
Amount of waste (over-print) to allow. This is useful for minimizing alignment problems when using non-white backgrounds (e.g. images). |
Templates may contain optional markup nodes. These nodes are used to describe
a simple set of markup lines that are visible in the
A Markup-margin
describes a margin along
all edges of a label.
Property | Description |
|
Size of the margin. I.e. the distance of the margin line from the edge of the card/label. |
A Markup-line
node describes a markup line.
Property | Description |
|
x coordinate of 1st endpoint of the line segment. |
|
y coordinate of 1st endpoint of the line segment. |
|
x coordinate of 2st endpoint of the line segment. |
|
y coordinate of 2st endpoint of the line segment. |
A Markup-circle
describes a markup circle.
Property | Description |
|
x coordinate of circle origin (center). |
|
y coordinate of circle origin (center). |
|
Radius of circle. |
A Markup-rect
describes a markup rectangle.
Property | Description |
|
x coordinate of upper left corner of rectangle. |
|
y coordinate of upper left corner of rectangle. |
|
Width of rectangle. |
|
Height of rectangle. |
|
Radius of rounded corners of rectangle. |
A Markup-ellipse
describes a markup ellipse.
Property | Description |
|
x coordinate of upper left corner of ellipse. |
|
y coordinate of upper left corner of ellipse. |
|
Width of ellipse. |
|
Height of ellipse. |
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.
A single label can always be treated as a grid of one.
Property | Description |
|
Number of labels/cards across in the grid (horizontal) |
|
Number of labels/cards across in the grid (vertical) |
|
Distance from left edge of sheet to the left edge of the left column of cards/labels in the layout. |
|
Distance from the top edge of sheet to the top edge of the top row of labels/cards in the layout. |
|
Horizontal pitch of grid. |
|
Vertical pitch of grid. |