Crear plantillas nuevas manualmente

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

Creative Commons Compartir Igual 3.0

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 unidade, se asumirá que es 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>

   ...plantillas...

</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 Template

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 nodoLabel-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

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

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

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

Parámetros de etiqueta de CD

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.

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