Crear sus plantillas manualmente.
Jim Evins
evins@snaught.com
Mario Blättermann
mariobl@gnome.org

Creative Commons Compartir Igual 3.0

# Crear plantillas nuevas manualmente

Esta página es una guía de referencia para la creación manual de plantillas de gLabels. Las plantillas de gLabels se definen en un archivo XML, tal como se describe en la DTD: glabels-2.3.dtd (Este DTD también describe otros formatos XML usados por glabels).

Las plantillas creadas manualmente se guardarán en ${HOME}/.glabels y se nombrarán con extensión .template.

gLabels busca plantillas en varias ubicaciones, como se define aquí:

Ubicación | Descripción
${prefix}/share/libglabels-3.0/templates | Plantillas predefinidas distribuidas con gLabels. ${prefix} normalmente es /usr o /usr/local, dependiendo de dónde se haya instalado gLabels.
${XDG_CONFIG_HOME}/libglabels/templates | Plantillas definidas por el usuario creadas con el Diseñador de plantillas de gLabels. No ponga plantillas creadas manualmente en esta carpeta. Si ${XDG_CONFIG_HOME} no está definido, su valor predeterminado es ${HOME}/.config.
${HOME}/.glabels | Las plantillas definidas por el usuario creadas manualmente se deben poner en esta carpeta. Las versiones del Diseñador de plantillas de gLabels (anteriores a 3.0) también pondrían plantillas en esta carpeta.

Los archivos de plantillas completadas se pueden enviar a la lista de correo de plantillas de gLabels, para incluirlas posiblemente en versiones futuras de gLabels.

# Supuestos/advertencias

Una hoja contiene etiquetas o tarjetas de un sólo tamaño (si una hoja contiene más de un tamaño por elemento, se puede dividir el varias plantillas para imprimir en múltiples pasadas)

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

# Archivos de plantillas

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

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

...plantillas...

</Glabels-templates>

## Plantilla de ejemplo

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

Propiedad | Descripción
`brand` | Marca o fabricante de productos de papelería. Por ejemplo «Avery».
`part` | Número de pieza o nombre de un producto de papelería. Ej «8160»
`size` | Size of sheet. E.g., "`US-Letter`", "`A4`", ...
`description` | Descripción de un producto de papelería. Por ejemplo, «Etiquetas de dirección».
`_description` | Descripción traducible para un producto de papelería. Por ejemplo, «Etiquetas de correo». (Útil sólo para plantillas predefinidas.)
`width` | Ancho de la página. Sólo es válido si tamaño=«Otro»
`height` | Altura de la página. Sólo es válido si tamaño=«Otro»
`equiv` | Parte numérica equivalente. Si esta propiedad está presente, la plantilla es un clon de otra plantilla de la misma marca. La plantilla heredará todas las propiedades, excepto la marca y el nombre de la otra plantilla. Esta propiedad debe referirse a una plantilla definida anteriormente: actualmente gLabels no soporta hacia adelante.

# Meta Node

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

Subnodo | Descripción

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

El valor de esta categoría debe coincidir con un ID de categoría predefinido en el archivo ${prefix}/libglabels-3.0/templates/categories.xml. Los ID de categoría definidos actualmente incluyen:

`label`

`round-label`

`elliptical-label`

`square-label`

`rectangle-label`

`card`

`business-card`

`media`

`mail`

`foldable`

`photo`

`product_url` | Un URL que apunta a la página web del fabricante para un producto determinado, si está disponible.

La sugerencias sobre categorías adicionales se pueden enviar a la lista de correo de los desarrolladores de gLabels.

Los URL de productos deben ser de uso limitado, ya que pueden no ser permanentes.

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

Propiedad | Descripción
`id` | Reservado para el futuro. Debería ser siempre 0.
`width` | Ancho de la etiqueta/tarjeta
`height` | Altura de la etiqueta/tarjeta
`round` | Radio de la esquina. Para elementos con bordes cuadrados (tarjetas de visita), el radio debe ser 0.
`x_waste` | Cantidad de residuos horizontales (sobreimpresión) que permitir. Esto es útil para minimizar problemas de alineación al usar fondos no blancos (ej. imágenes).
`y_waste` | Cantidad de residuos verticales (sobreimpresión) que permitir. Esto es útil para minimizar problemas de alineación al usar fondos no blancos (ej. imágenes).

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.

Propiedad | Descripción
`id` | Reservado para el futuro. Debería ser siempre 0.
`width` | Anchura de la elipse
`height` | Altura de la elipse
`waste` | Cantidad de residuos (sobreimpresión) que permitir. Esto es útil para minimizar problemas de alineación al usar fondos no blancos (ej. imágenes).

Label-ellipse parameters

Label-ellipse parameters

# Label-round Node

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

Propiedad | Descripción
`id` | Reservado para el futuro. Debería ser siempre 0.
`radius` | Radio (1/2 del diámetro) de la etiqueta
`waste` | Cantidad de residuos (sobreimpresión) que permitir. Esto es útil para minimizar problemas de alineación al usar fondos no blancos (ej. imágenes).

Label-ellipse parameters

Label-ellipse parameters

# Label-cd Node

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

Propiedad | Descripción
`id` | Reservado para el futuro. Debería ser siempre 0.
`radius` | Radio exterior de la etiqueta
`hole` | Radio del agujero concéntrico
`width` | Si está presente, la etiqueta se recorta a la anchura dada. (Útil para «tarjetas de visita en CD»).
`height` | Si está presente, la etiqueta se recorta a la altura dada. (Útil para «tarjetas de visita en CD»).
`waste` | Cantidad de residuos (sobreimpresión) que permitir. Esto es útil para minimizar problemas de alineación al usar fondos no blancos (ej. imágenes).

Label-cd parameters

Parámetros de etiqueta de CD

# Markup Nodes

Las plantillas pueden contener nodos de marcado opcionales. Estos nodos se usan para describir un conjunto de líneas de marcado que son visibles en la ventana de dibujo de glabels, pero no son visibles cuando se imprime. Estas líneas pueden representar márgenes, líneas de plegado o de centrado, áreas especiales u otros indicios útiles para el usuario de una plantilla.

## Markup-margin Node

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

Propiedad | Descripción
`size` | Tamaño del margen. Ej. la distancia de la línea del margen desde el borde de la tarjeta/etiqueta.

## Markup-line Node

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

Propiedad | Descripción
`x1` | coordenada X del primero punto final del segmento de línea.
`y1` | coordenada Y del primero punto final del segmento de línea.
`x2` | coordenada X del segundo punto final del segmento de línea.
`y2` | coordenada Y del segundo punto final del segmento de línea.

## Markup-circle Node

A `Markup-circle` describes a markup circle.

Propiedad | Descripción
`x0` | coordenada X del círculo origen (centro).
`y0` | coordenada Y del círculo origen (centro).
`radius` | Radio del círculo.

## Markup-rect Node

A `Markup-rect` describes a markup rectangle.

Propiedad | Descripción
`x1` | coordenada X de la esquina superior izquierda del rectángulo
`y1` | coordenada Y de la esquina superior izquierda del rectángulo
`w` | Anchura del rectángulo.
`h` | Altura del rectángulo.
`r` | Radio de las esquinas redondeadas del rectángulo.

## Markup-ellipse Node

A `Markup-ellipse` describes a markup ellipse.

Propiedad | Descripción
`x1` | coordenada «x» de la esquina superior izquierda de la elipse.
`y1` | coordenada «y» de la esquina superior izquierda de la elipse.
`w` | Anchura de la elipse.
`h` | Altura de la elipse.

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

Un ejemplo común de varios diseños es una hoja con etiquetas para CD:

Hoja de etiquetas de CD

Hoja de etiquetas de CD

Las dos etiquetas del borde izquierdo se pueden asignar a una cuadrícula, asumiendo que se puede definir correctamente la coordenada de la etiqueta superior izquierda y la distancia hasta la segunda etiqueta. La distancia al borde izquierdo es común en estas etiquetas. La tercera en el borde derecho no tiene valores de distancias comunes con las demás, por lo que se debe definir un segundo diseño, con coordenadas únicas para la esquina superior izquierda de esa etiqueta.

Sólo puede definir varios diseños si las etiquetas en la hoja tienen la misma forma. si su hoja contiene diferentes formas, puede definir cada forma en otra plantilla aparte. Las versiones futuras de gLabels, probablemente podrán concatenar estas hojas con diferentes formas en una única plantilla.

Una única etiqueta se puede tratar con una rejilla de una.

Propiedad | Descripción
`nx` | Número de etiquetas/tarjetas en la rejilla (horizontal)
`ny` | Número de etiquetas/tarjetas en la rejilla (vertical)
`x0` | Distancia desde el borde izquierdo de la hoja hasta el borde izquierdo de la columna de la izquierda de las tarjetas/etiquetas en la disposición.
`y0` | Distancia desde el borde superior de la hoja hasta el borde superior de la fila de arriba de las tarjetas/etiquetas en la disposición.
`dx` | Inclinación horizontal de la rejilla.
`dy` | Inclinación vertical de la rejilla.

Layout parameters

Layout Parameters