Vytvářejte své šablony ručně.
Jim Evins
evins@snaught.com
Mario Blättermann
mariobl@gnome.org

Creative Commons Share Alike 3.0

# Ruční vytváření nových šablon

Tato stránka je příručkou k ručnímu vytváření šablon gLabels. Šablony gLabels jsou definovány v jednoduchých souborech XML, které jsou popsány v DTD: glabels-2.3.dtd (toto DTD popisuje i ostatní formáty XML používané v aplikaci gLabels).

Soubory s ručně vytvořenými šablonami by měly být umístěny ve složce ${HOME}/.glabels a jejich název by měl mít příponu .template.

Aplikace gLabels hledá šablony na několika další místech, konkrétně na těchto:

Umístění | Popis
${prefix}/share/libglabels-3.0/templates | Předdefinované šablony šířené s aplikací gLabels. ${prefix} je obvykle /usr nebo /usr/local podle toho, kde je nainstalována vlastní aplikace gLabels.
${XDG_CONFIG_HOME}/libglabels/templates | Uživatelem definované šablony vytvořené pomocí Návrháře šablon gLabels. Neumisťujte do této složky ručně vytvořené šablony. Pokud není ${XDG_CONFIG_HOME} definováno, použije se výchozí ${HOME}/.config.
${HOME}/.glabels | Uživatelem definované šablony, které byly vytvořeny ručně, by měly být umístěny v této složce. Do této složky by ukládaly šablony také starší verze Návrháře šablon gLabels (před verzí 3.0).

Soubory s hotovými šablonami můžete posílat do poštovní konference o šablonách gLabels a možná budou zařazeny jako součást příští verze gLabels.

# Předpoklady/upozornění

Stránka obsahuje etiketu nebo vizitku pouze jedné velikosti (pokud má stránka obsahovat více než jednu velikost položky, můžete ji rozdělit do více šablon a vytisknout na vícekrát)

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

# Soubory šablon

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

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

…šablony…

</Glabels-templates>

## Příklad šablony

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

Vlastnost | Popis
`brand` | Značka nebo výrobce papírenského produktu. Např. "S&K Label"
`part` | Produktové číslo nebo název papírenského produktu. Např. "8160"
`size` | Size of sheet. E.g., "`US-Letter`", "`A4`", ...
`description` | Popis papírenského produktu. Např. "Mailing Labels."
`_description` | Popis papírenského produktu s možností překladu. Např. "Mailing Labels." (Použitelné pouze pro předdefinované šablony)
`width` | Šířka stránky. Platné jen v případě, že size="Other"
`height` | Výška stránky. Platné jen v případě, že size="Other"
`equiv` | Ekvivalentní produktové číslo. Pokud je tato vlastnost nastavena, je šablona klonem jiné šablony téže značky. Šablona pak dědí všechny vlastnosti z jiné šablony, vyjma značky a názvu. Tato vlastnost se musí odkazovat na šablonu definovanou dříve – aplikace gLabels v současnosti nepodporuje dopředné odkazy.

# Meta Node

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

Podřízený uzel | Popis

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

Hodnota kategorie musí odpovídat jednomu z předdefinovaných ID kategorie ze souboru ${prefix}/libglabels-3.0/templates/categories.xml. Aktuálně jsou definovány tato ID kategorií:

`label (etiketa)`

`round-label (etiketa se zaoblenými rohy)`

`elliptical-label (eliptická etiketa)`

`square-label (čtvercová etiketa)`

`rectangle-label (obdélníková etiketa)`

`card (karta)`

`business-card (vizitka)`

`media (médium)`

`mail (poštovní)`

`foldable (přání)`

`photo (fotka)`

`product_url` | Adresa URL odkazující na webovou stránku výrobce a to tu, pokud existuje, která se týká konkrétního výrobku.

Doporučení na další kategorie můžete zasílat do vývojářské poštovní konference aplikace gLabels.

Použití adresy URL výrobku může být omezené, protože adresa nemusí být trvalá.

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

Vlastnost | Popis
`id` | Rezervované pro pozdější použití. Vždy by mělo být nastavené na 0.
`width` | Šířka etikety/vizitky
`height` | Výška etikety/vizitky
`round` | Poloměr rohů. Pro položky s ostrými rohy (např. vizitky) by mělo být nastaveno na 0.
`x_waste` | Velikost dovoleného vodorovného odsazení (umožňuje přetisk). To je užitečné kvůli zamezení problémům se zarovnáním v situaci, kdy se nepoužívá bílé pozadí, ale např. obrázkové.
`y_waste` | Velikost dovoleného svislého odsazení (umožňuje přetisk). To je užitečné kvůli zamezení problémům se zarovnáním v situaci, kdy se nepoužívá bílé pozadí, ale např. obrázkové.

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.

Vlastnost | Popis
`id` | Rezervované pro pozdější použití. Vždy by mělo být nastavené na 0.
`width` | Šířka elipsy
`height` | Výška elipsy
`waste` | Velikost dovoleného odsazení (umožňuje přetisk). To je užitečné kvůli zamezení problémům se zarovnáním v situaci, kdy se nepoužívá bílé pozadí, ale např. obrázkové.

Label-ellipse parameters

Label-ellipse parameters

# Label-round Node

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

Vlastnost | Popis
`id` | Rezervované pro pozdější použití. Vždy by mělo být nastavené na 0.
`radius` | Poloměr (½ průměru) etikety.
`waste` | Velikost dovoleného odsazení (umožňuje přetisk). To je užitečné kvůli zamezení problémům se zarovnáním v situaci, kdy se nepoužívá bílé pozadí, ale např. obrázkové.

Label-ellipse parameters

Label-ellipse parameters

# Label-cd Node

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

Vlastnost | Popis
`id` | Rezervované pro pozdější použití. Vždy by mělo být nastavené na 0.
`radius` | Vnější poloměr etikety.
`hole` | Poloměr středové díry.
`width` | Pokud je zadáno, bude etiketa oříznuta na uvedenou šířku. (Vhodné pro „vizitková CD“).
`height` | Pokud je zadáno, bude etiketa oříznuta na uvedenou výšku. (Vhodné pro „vizitková CD“).
`waste` | Velikost dovoleného odsazení (umožňuje přetisk). To je užitečné kvůli zamezení problémům se zarovnáním v situaci, kdy se nepoužívá bílé pozadí, ale např. obrázkové.

Label-cd parameters

Parametry etiket na CD

# Markup Nodes

Šablona může volitelně obsahovat uzly se značkami. Tyto uzly se používají k popisu jednoduchých sad pomocných čar, které jsou viditelné na kreslící ploše aplikace glabels, ale netisknou se. Tyto čáry mohou představovat například okraje, přehyby, speciální oblasti a další pomůcky užitečné pro uživatele šablony.

## Markup-margin Node

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

Vlastnost | Popis
`size` | Velikost okraje. Např. vzdálenost hranice okraje od hrany etikety/vizitky.

## Markup-line Node

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

Vlastnost | Popis
`x1` | x-ová souřadnice 1. koncového bodu úsečky.
`y1` | y-ová souřadnice 1. koncového bodu úsečky.
`x2` | x-ová souřadnice 2. koncového bodu úsečky.
`y2` | y-ová souřadnice 2. koncového bodu úsečky.

## Markup-circle Node

A `Markup-circle` describes a markup circle.

Vlastnost | Popis
`x0` | x-ová souřadnice středu kruhu.
`y0` | y-ová souřadnice středu kruhu.
`radius` | Poloměr kruhu.

## Markup-rect Node

A `Markup-rect` describes a markup rectangle.

Vlastnost | Popis
`x1` | x-ová souřadnice levého horního rohu obdélníku.
`y1` | y-ová souřadnice levého horního rohu obdélníku.
`w` | Šířka obdélníku.
`h` | Výška obdélníku.
`r` | Poloměr zakulacených rohů obdélníku.

## Markup-ellipse Node

A `Markup-ellipse` describes a markup ellipse.

Vlastnost | Popis
`x1` | x-ová souřadnice levého horního rohu elipsy.
`y1` | y-ová souřadnice levého horního rohu elipsy.
`w` | Šířka elipsy.
`h` | Výška elipsy.

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

Typický příklad pro více rozvržení Layout je list se třemi etiketami na CD:

List s etiketami na CD

List s etiketami na CD

Dvě etikety na levé straně jde zarovnat do mřížky, což předpokládá správně nadefinovat souřadnice pro levou horní etiketu a vzdálenost ke druhé etiketě. Vzdálenost od levého okraje je pro tyto etikety společná. Třetí etiketa na pravé straně nemá s ostatními tuto vzdálenost společnou, takže musíme nadefinovat druhé rozvržení s odlišnými souřadnicemi pro levý horní roh této etikety.

Více rozvržení pomocí uzlu Layout můžete nadefinovat jen za předpokladu, že etikety na listě jsou tvarově a velikostně totožné. Pokud se na jednom listě liší, musíte pro každý druh nadefinovat šablonu zvlášť. Budoucí verze gLabels bude toto pravděpodobně řešit spojováním takových listů s různými etiketami do jedné šablony.

Jedna etiketa může být vždy považována za mřížku s jednou buňkou.

Vlastnost | Popis
`nx` | Počet etiket/vizitek v mřížce (vodorovně).
`ny` | Počet etiket/vizitek v mřížce (svisle).
`x0` | Vzdálenost od levé hrany stránky k levé hraně levého sloupce etiket/vizitek v rozvržení.
`y0` | Vzdálenost od horní hrany stránky k horní hraně horní řady etiket/vizitek v rozvržení.
`dx` | Vodorovná rozteč mřížky.
`dy` | Svislá rozteč mřížky.

Layout parameters

Layout Parameters