Crear sus plantillas manualmente.
Jim Evins
evins@snaught.com
Mario Blättermann
mario.blaettermann@gmail.com

Creative Commons Compartir Igual 3.0

Daniel Mustieles
daniel.mustieles@gmail.com 2010-2016
Jorge González
jorgegonz@svn.gnome.org 2010

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

Las distancias se pueden expresar en las unidades `pt`, `in`, `mm`, `cm`, o `pc`. Por ejemplo: «`1.0in`» o «`2.54cm`». Si no se especifican la unidades, se asumirá que son puntos informáticos (`pt`), donde 1 pt = 1/72 in = 0.352778 mm.

# Archivos de plantillas

Un archivo de plantilla contiene un único nodo `Glabels-templates` de nivel superior.

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

...templates...

</Glabels-templates>

## Plantilla de ejemplo

Ejemplo de archivo de plantilla de gLabels con un nodo `Template`.
<?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>

# Nodo `Plantilla`

Un nodo `Template` describe un único producto de papelería. Debe contener una instancia de cada tipo de nodo «Etiqueta» (`Label-rectangle`, `Label-round`, o `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` | Tamaño de la hoja. Ej. "`Carta`", "`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.

# Nodo `Meta`

un nodo `Meta` contiene información adicional sobre la plantilla. Un nodo `Template` puede contener cero o más nodos `Meta`.

Subnodo | Descripción

`category`

Una categoría para la plantilla. Una plantilla puede pertenecer a varias categorías simplemente añadiendo múltiples nodos `Meta` al nodo `Template` padre. El Diálogo de tarjeta nueva de gLabels usa las categorías de las plantillas para filtrar los resultados de búsquedas de plantillas.

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.

# Nodo `Label-rectangle`

Un nodo`Label-rectangle` describe las dimensiones de una única etiqueta o tarjeta de visita de forma rectangular (Puede tener los bordes redondeados).

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

Parámetros de `Label-rectangle`

`Label-rectangle` parameters

# Nodo `Label-ellipse`

Un nodo `Label-ellipse` describe las dimensiones de una única etiqueta o tarjeta de visita de forma elíptica.

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

Parámetros de Label-ellipse

Parámetros de `Label-ellipse`

# Nodo `Label-round`

Un nodo `Label-round` describe las dimensiones de una sola etiqueta circular (no un 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).

Parámetros de `Label-ellipse`

`Label-ellipse` parameters

# Nodo `Label-cd`

Un nodo `Label-cd` describe las dimensiones de un CD, DVD o un CD de tarjeta de visita.

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

Parámetros de `Label-cd`

CD label parameters

# Nodos `Markup`

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.

## Nodo `Markup-margin`

Un `Markup-margin` describe un margen a lo largo de los bordes de una etiqueta.

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

## Nodo `Markup-line`

Un nodo `Markup-line` describe una línea de marcado.

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.

## Nodo `Markup-circle`

Un `Markup-circle` describe un círculo de marcado.

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

## Nodo `Markup-rect`

Un `Markup-rect` describe un rectángulo de marcado.

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.

## Nodo `Markup-ellipse`

Un `Markup-ellipse` describe una elipse de marcado.

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.

# Nodo `Layout`

Un nodo de etiqueta puede contener varios hijos `Layout`. Si las etiquetas se colocan en un patrón de rejilla, sólo se necesita un diseño. sin embargo, si las etiquetas se colocan en varias rejillas, como un patrón de unión, se pueden usar múltiples etiquetas `Layout`.

Un ejemplo común de varios diseños es una hoja con etiquetas para CD:

Hoja de etiquetas de CD

CD label sheet

Las dos etiquetas del borde izquierdo se pueden asignar a una cuadrí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 común en estas etiquetas. La tercera en el borde derecho no tiene valores de distancias comunes con las demás, por lo que se debe definir un segundo diseño, con coordenadas ú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.

Parámetros de `Layout`

Layout Parameters