1 <?xml version="1.0" encoding="utf-8"?>
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
3 <!ENTITY legal SYSTEM "legal.xml">
4 <!ENTITY appversion "2.2.6">
5 <!ENTITY manrevision "2.2.6">
6 <!ENTITY date "December 2007">
7 <!ENTITY app "<application>gLabels</application>">
8 <!-- Information about the entities
9 The legal.xml file contains legal information, there is no need to edit the file.
10 Use the appversion entity to specify the version of the application.
11 Use the manrevision entity to specify the revision number of this manual.
12 Use the date entity to specify the release date of this manual.
13 Use the app entity to specify the name of the application. -->]>
15 (Do not remove this comment block.)
16 Maintained by the GNOME Documentation Project
17 http://developer.gnome.org/projects/gdp
18 Template version: 2.0 beta
19 Template last modified Apr 11, 2002
21 <!-- =============Document Header ============================= -->
22 <article id="index" lang="es">
23 <!-- please do not change the id; for translations, change lang to -->
24 <!-- appropriate code -->
26 <title>Manual de <application>gLabels</application> V2.2.6</title>
27 <abstract role="description">
28 <para>Manual de usuario para el programa de creación de etiquetas y tarjetas de visita <application>gLabels</application></para>
31 <year>2003-2009</year>
32 <holder>Jim Evins</holder>
33 </copyright><copyright><year>2010</year><holder>Jorge González (jorgegonz@svn.gnome.org)</holder></copyright>
35 <publishername>Jim Evins</publishername>
38 <legalnotice id="legalnotice">
39 <para>Se otorga permiso para copiar, distribuir y/o modificar este documento bajo los términos de la Licencia de Documentación Libre de GNU, Versión 1.1 o cualquier otra versión posterior publicada por la Free Software Foundation; sin Secciones Invariantes ni Textos de Cubierta Delantera ni Textos de Cubierta Trasera. Puede encontrar una copia de la licencia GFDL en este <ulink type="help" url="ghelp:fdl">enlace</ulink> o en el archivo COPYING-DOCS distribuido con este manual.</para>
40 <para>Este manual es parte de una colección de manuales de GNOME distribuido bajo la GFDL. Si quiere distribuir este manual por separado de la colección, puede hacerlo añadiendo una copia de la licencia al manual, tal como se describe en la sección 6 de la licencia.</para>
42 <para>Muchos de los nombres utilizados por las empresas para distinguir sus productos y servicios se consideran marcas comerciales. Cuando estos nombres aparezcan en la documentación de GNOME, y siempre que se haya informado a los miembros del Proyecto de documentación de GNOME de dichas marcas comerciales, los nombres aparecerán en mayúsculas o con las iniciales en mayúsculas.</para>
44 <para>ESTE DOCUMENTO Y LAS VERSIONES MODIFICADAS DEL MISMO SE PROPORCIONAN SEGÚN LAS CONDICIONES ESTABLECIDAS EN LA LICENCIA DE DOCUMENTACIÓN LIBRE DE GNU (GFDL) Y TENIENDO EN CUENTA QUE: <orderedlist>
46 <para>EL DOCUMENTO SE OFRECE «TAL CUAL», SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO, PERO SIN LIMITARSE A ELLA, LA GARANTÍA DE QUE EL DOCUMENTO O LA VERSIÓN MODIFICADA DEL MISMO ESTÉ LIBRE DE DEFECTOS, GARANTÍA DE COMERCIALIZACIÓN, APTITUD PARA UN USO EN PARTICULAR O INCUMPLIMIENTO. TODOS LOS RIESGOS RELATIVOS A LA CALIDAD, EXACTITUD O RENDIMIENTO DEL DOCUMENTO O LA VERSIÓN MODIFICADA DEL MISMO SON ASUMIDOS POR VD. EN CASO DE QUE EL DOCUMENTO O LA VERSIÓN MODIFICADA SEAN DEFECTUOSOS, VD. (NO EL ESCRITOR ORIGINAL NI EL AUTOR NI NINGUNO DE LOS COLABORADORES) ASUMIRÁ EL COSTE DE CUALQUIER MANTENIMIENTO, REPARACIÓN O CORRECCIÓN QUE SEAN NECESARIOS. ESTA RENUNCIA DE GARANTÍA CONSTITUYE UNA PARTE ESENCIAL DE ESTA LICENCIA NO SE AUTORIZA EL USO DE NINGÚN DOCUMENTO NI VERSIÓN MODIFICADA DEL MISMO, SALVO EN LAS CONDICIONES ESPECIFICADAS EN ESTA RENUNCIA; Y </para>
49 <para>EN NINGUNA CIRCUNSTANCIA NI SEGÚN NINGÚN ARGUMENTO LEGAL, SEA POR MOTIVOS CULPOSOS (INCLUIDA LA NEGLIGENCIA), CONTRACTUALES O DE OTRO TIPO, NI EL AUTOR, NI EL REDACTOR INICIAL, NI CUALQUIER COLABORADOR, NI CUALQUIER DISTRIBUIDOR DEL DOCUMENTO O VERSIÓN MODIFICADA DEL MISMO, NI CUALQUIER PROVEEDOR DE CUALQUIERA DE DICHAS PARTES, SERÁN RESPONSABLES, ANTE NINGÚN TERCERO, DE NINGÚN DAÑO O PERJUICIO DIRECTO, INDIRECTO, ESPECIAL, INCIDENTAL O CONSIGUIENTE DE NINGÚN TIPO, INCLUIDOS, SIN LIMITACIÓN, LOS DAÑOS POR PÉRDIDA DE FONDO DE COMERCIO, INTERRUPCIÓN DEL TRABAJO, FALLO O MAL FUNCIONAMIENTO INFORMÁTICO, NI CUALQUIER OTRO DAÑO O PÉRDIDA DERIVADOS DEL USO DEL DOCUMENTO Y LAS VERSIONES MODIFICADAS DEL MISMO, O RELACIONADO CON ELLO, INCLUSO SI SE HABÍA COMUNICADO A AQUELLA PARTE LA POSIBILIDAD DE TALES DAÑOS.</para>
55 <!-- This file contains link to license for the documentation (GNU FDL), and
56 other legal stuff such as "NO WARRANTY" statement. Please do not change
60 <author role="maintainer">
61 <firstname>Jim</firstname>
62 <surname>Evins</surname>
65 <!-- This is appropriate place for other contributors: translators,
66 maintainers, etc. Commented out by default.
68 <othercredit role="translator">
69 <firstname>Latin</firstname>
70 <surname>Translator 1</surname>
72 <orgname>Latin Translation Team</orgname>
73 <address> <email>translator@gnome.org</email> </address>
75 <contrib>Latin translation</contrib>
81 <!-- According to GNU FDL, revision history is mandatory if you are -->
82 <!-- modifying/reusing someone else's document. If not, you can omit it. -->
83 <!-- Remember to remove the &manrevision; entity from the revision entries other
85 <!-- than the current revision. -->
86 <!-- The revision numbering system for GNOME manuals is as follows: -->
87 <!-- * the revision number consists of two components -->
88 <!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
89 <!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
90 <!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
91 <!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
92 <!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
93 <!-- to V3.0, and so on. -->
96 <revnumber>Manual de gLabels V2.2.6</revnumber>
97 <date>Octubre de 2009</date>
99 <para role="author">Mario Blättermann <email>mariobl@gnome.org</email></para>
100 <para role="publisher">Jim Evins</para>
104 <revnumber>Manual de gLabels V2.2</revnumber>
105 <date>Diciembre de 2007</date>
107 <para role="author">Jim Evins <email>evins@snaught.com</email></para>
108 <para role="publisher">Jim Evins</para>
113 <releaseinfo>Este manual describe la versión 2.2.6 de <application>gLabels</application>.</releaseinfo>
115 <title>Comentarios</title>
116 <para>To report a bug or make a suggestion regarding the <application>gLabels</application> application or
117 this manual, follow the directions in the <ulink url="http://glabels.sourceforge.net/contact/" type="http"><application>gLabels</application> Contact Page</ulink>.
119 <!-- Translators may also add here feedback address for translations -->
123 <indexterm zone="index">
124 <primary>gLabels</primary>
126 <indexterm zone="index">
127 <primary>glabels</primary>
133 <!-- ============= Document Body ============================= -->
134 <!-- ============= Introduction ============================== -->
135 <!-- Use the Introduction section to give a brief overview of what
136 the application is and what it does. -->
137 <sect1 id="glabels-introduction">
138 <title>Introducción</title>
140 <para>The <application>gLabels</application> application is a lightweight program for creating labels
141 and business cards for the <systemitem>GNOME desktop</systemitem>
142 environment. It is designed to work with various laser/ink-jet
143 peel-off label and business card sheets that you'll find at most
144 office supply stores.</para>
151 <!-- =========== Getting Started ============================== -->
152 <!-- Use the Getting Started section to describe the steps required
153 to start the application and to describe the user interface components
154 of the application. If there is other information that it is important
155 for readers to know before they start using the application, you should
156 also include this information here.
157 If the information about how to get started is very short, you can
158 include it in the Introduction and omit this section. -->
160 <sect1 id="glabels-getting-started">
161 <title>Inicio</title>
163 <sect2 id="glabels-start">
164 <title>Para iniciar <application>gLabels</application></title>
165 <para>You can start <application>gLabels</application> in the following ways:
169 <term>Menú <guimenu>Aplicaciones</guimenu></term>
173 <guisubmenu>Office</guisubmenu>
174 <guimenuitem>gLabels</guimenuitem>
175 </menuchoice>. </para>
179 <term>Línea de comandos</term>
181 <para>Type <command>glabels</command>,
182 then press <keycap>Return</keycap>:</para>
188 <sect2 id="glabels-when-start">
189 <title>When You Start <application>gLabels</application></title>
190 <para>When you start <application>gLabels</application>, the following window is displayed.</para>
192 <!-- ==== Figure ==== -->
193 <figure id="mainwindow-fig">
194 <title>Ventana de inicio de <application>gLabels</application></title>
197 <imageobject><imagedata fileref="figures/main-window-empty.png" format="PNG"/>
202 <!-- ==== End of Figure ==== -->
204 <!-- Include any descriptions of the GUI immediately after the screenshot of the main UI, -->
205 <!-- for example, the items on the menubar and on the toolbar. This section is optional. -->
207 <para>The <application>gLabels</application> window contains the following elements:
211 <term>Barra de menú.</term>
213 <para>The menus on the menubar contain all of the commands you
214 need to create and edit labels and business cards in
215 <application>gLabels</application>.</para>
219 <term>Barra de herramientas principal.</term>
221 <para>The main toolbar contains a subset of common File and Edit
222 commands that you can access from the menubar.</para>
226 <term>Drawing toolbar.</term>
228 <para>The drawing toolbar contains a subset of commands for
229 editing the current <application>gLabels</application> document.</para>
233 <term>Área de visualización.</term>
235 <para>The display area is the main drawing interface to
236 <application>gLabels</application>.</para>
240 <term>Object sidebar.</term>
242 <para>The object sidebar provides an interface for viewing and
243 editing all properties of an individual object. </para>
247 <term>Barra de herramientas de propiedades.</term>
249 <para>The properties toolbar contains a set of tools to
250 manipulate the properties of selected objects and set default
251 properties for new objects.</para>
255 <term>Barra de estado.</term>
257 <para>The statusbar displays information about current
258 <application>gLabels</application> activity and contextual
259 information about the menu items. </para>
269 <!-- ================ Usage ================================ -->
270 <!-- Use this section to describe how to use the application to perform the tasks for
271 which the application is designed. -->
272 <sect1 id="glabels-usage">
275 <!-- ============= To create a new file ============================= -->
276 <sect2 id="glabels-open-new">
277 <title>To Create a New Label or Card</title>
279 <para>To create a new label or business card, choose
280 <menuchoice> <guimenu>File</guimenu> <guimenuitem>New</guimenuitem>
282 to display the <guilabel>New Label or Card</guilabel> dialog. Select
283 the media type and orientation for the new document,
284 then click <guibutton>OK</guibutton>. A new document is
285 displayed in the display area of the <application>gLabels</application>
288 <para>If your particular media type is missing from this dialog,
289 see <xref linkend="glabels-create-template"/></para>
293 <!-- ============= To Open a File ============================= -->
294 <sect2 id="glabels-open-file">
295 <title>Abrir un archivo</title>
297 <para>To open a file, choose
298 <menuchoice> <guimenu>File</guimenu> <guimenuitem>Open</guimenuitem>
299 </menuchoice> to display the <guilabel>Open File</guilabel> dialog.
300 Select the file that you want to open, then click
301 <guibutton>OK</guibutton>. The file is displayed in the display area
302 of the <application>gLabels</application> window. </para>
304 <para>You can also open multiple files in
305 <application>gLabels</application>. The application creates a separate
306 application window for each open file.</para>
308 <para>The application records the paths and filenames of the
309 most recent files that you have edited and displays the files as menu
310 items on the <menuchoice>
311 <guimenu>File</guimenu><guisubmenu>Recent Files</guisubmenu>
312 </menuchoice> menu.</para>
316 <!-- ============= To Open Multiple Files from the Command Line ========= -->
317 <sect2 id="glabels-run-from-cmd-line">
318 <title>To Open Multiple Files from a Command Line</title>
320 <para>You can run <application>gLabels</application> from a command line
321 and open a single file or multiple files. To open multiple files from
322 a command line, type the following command, then press
323 <keycap>Return</keycap>:</para>
325 <para><command>glabels
326 <replaceable>file1.glabels file2.glabels file3.glabels</replaceable>
329 <para>When the application starts, the files that you specify are
330 displayed in separate <application>gLabels</application> windows.</para>
334 <!-- ============= To Save a File ========= -->
335 <sect2 id="glabels-save-file">
336 <title>Guardar un archivo</title>
338 <para>Puede guardar archivos de cualquiera de estas maneras:</para>
343 <para>Para guardar los cambios a un archivo existente, elija <menuchoice><guimenu>Archivo</guimenu><guimenuitem>Guardar</guimenuitem></menuchoice>.</para>
348 <para>To save a new file or to save an existing file under a new
349 filename, choose <menuchoice> <guimenu>File</guimenu>
350 <guimenuitem>Save As</guimenuitem> </menuchoice>. Enter a name
351 for the file in the <guilabel>Save As</guilabel> dialog box,
352 then click <guibutton>OK</guibutton>.</para>
359 <!-- ============= To Change Label Properties ========= -->
360 <sect2 id="glabels-label-properties">
361 <title>Cambiar las propiedades de una etiqueta</title>
363 <para>To change the media type and/or orientation of a label, choose
364 <menuchoice> <guimenu>File</guimenu>
365 <guimenuitem>Properties</guimenuitem> </menuchoice> to display the
366 <guilabel>Label properties</guilabel> dialog. Select the
367 new media type and orientation for the document, then click
368 <guibutton>OK</guibutton>.</para>
372 <!-- ============= To create a custom template ======================= -->
373 <sect2 id="glabels-create-template">
374 <title>To Create a Custom Template</title>
376 <para>To create a new custom template, choose
377 <menuchoice> <guimenu>File</guimenu>
378 <guimenuitem>Template Designer ...</guimenuitem> </menuchoice>
379 to display the <guilabel>Template Designer</guilabel> dialog.
380 This dialog will assist you in creating a custom template for
381 most types of label or card stationery that you may encounter.</para>
383 <para>If you prefer, you can create your templates manually.
384 For this option see <xref linkend="glabels-manual-create-template"/>
389 <!-- ============= To Close a File ========= -->
390 <sect2 id="glabels-close-file">
391 <title>Cerrar un archivo</title>
393 <para>To close the current document, choose
394 <menuchoice> <guimenu>File</guimenu>
395 <guimenuitem>Close</guimenuitem> </menuchoice> to close the application
396 window. If the current document is modified, a confirmation dialog
397 will be presented, allowing you to save the document or cancel
398 the command. If the window being closed is the only open window,
399 <application>gLabels</application> will exit.</para>
403 <!-- ============= To Quit ========= -->
404 <sect2 id="glabels-quit">
405 <title>To Quit <application>gLabels</application></title>
407 <para>To quit <application>gLabels</application>, choose
408 <menuchoice> <guimenu>File</guimenu>
409 <guimenuitem>Quit</guimenuitem> </menuchoice>. This is equivalent
410 to closing all open windows. See
411 <xref linkend="glabels-close-file"/>.</para>
415 <!-- ============= To Print Labels and Cards ========= -->
416 <sect2 id="glabels-print-file">
417 <title>To Print Labels or Cards</title>
419 <para>To print labels or cards, choose
420 <menuchoice> <guimenu>File</guimenu> <guimenuitem>Print</guimenuitem>
421 </menuchoice> to display the <guilabel>Print</guilabel> dialog.
422 Once print options have been selected, click <guilabel>Print</guilabel>
423 to print the labels or cards. To simply preview the results,
424 click <guilabel>Print Preview</guilabel> instead.</para>
426 <para>The <guilabel>Print</guilabel> dialog allows you to specify the
427 following print options:</para>
429 <sect3 id="print-dialog-job">
430 <title>The Labels Tab of the Print Dialog</title>
435 <term><guilabel>Print control (Simple)</guilabel></term>
438 <para>For simple labels or cards (no document merge), the <guilabel>labels</guilabel>
439 tabbed section contains the following copy controls.</para>
441 <!-- ==== Figure ==== -->
442 <figure id="print-copies-fig">
443 <title>Print Copy Controls</title>
446 <imageobject><imagedata fileref="figures/print-copies.png" format="PNG"/>
451 <!-- ==== End of Figure ==== -->
453 <para>The number of copies of the label can be selected by
454 choosing the number of full sheets to print, or a specific
455 subset of labels on a single sheet.</para>
457 <para>The mini-preview can also be used to graphically select
458 the subset of labels by clicking the first label on the
459 mini-preview and dragging to the last label.</para>
465 <term><guilabel>Print control (Merge)</guilabel></term>
468 <para>For labels or cards using the document merge (also known
469 as "mail merge") capability, the <guilabel>labels</guilabel> tabbed section contains
470 the following merge controls instead of copy controls.</para>
472 <!-- ==== Figure ==== -->
473 <figure id="print-merge-fig">
474 <title>Print Document Merge Controls</title>
477 <imageobject><imagedata fileref="figures/print-merge.png" format="PNG"/>
482 <!-- ==== End of Figure ==== -->
484 <para>The total number of labels or cards printed is the
485 product of the number of records in the merge source and
486 the number of copies selected. If multiple copies are
487 selected, these can be either collated (copies of the
488 same record grouped together) or un-collated (one copy
489 each record is printed before next copy).</para>
491 <para>Printing can begin on any label on the first sheet.
492 This can be selected with the <guilabel>Start on
493 label</guilabel> spinbutton.</para>
495 <para>The mini-preview can also be used to graphically select
496 this first label, by clicking on the desired label in the
502 <varlistentry> <term><guilabel>Opciones</guilabel> </term>
504 <para>The following options can also be selected.</para>
507 <para><guilabel>print outlines</guilabel></para>
508 <para>Print outlines of labels. This option is useful for
509 dry-runs, to test printer alignment.</para>
512 <para><guilabel>print in reverse</guilabel></para>
513 <para>Prints the labels as mirror images. This option is
514 useful for printing on clear labels that will be viewed
515 from the reverse side (e.g. in a car window).</para>
518 <para><guilabel>print crop marks</guilabel></para>
519 <para>Prints crop marks along the edge of the sheet.
520 This option is useful for printing on blank stock, to
521 be cut after printing. This option does not work well
522 with all templates.</para>
532 <!-- ============= To Create New Objects ========= -->
533 <sect2 id="glabels-new-objects">
534 <title>To Create New Objects</title>
536 <para>Objects are created by choosing the appropriate selection under
537 the <menuchoice> <guimenu>Objects</guimenu>
538 <guimenuitem>Create Object</guimenuitem> </menuchoice> submenu or
539 the <guilabel>Drawing Toolbar</guilabel>. This will place the
540 display area into object creation mode as indicated by its cursor.
541 To return to the default object selection mode without creating
542 an object, choose <menuchoice> <guimenu>Objects</guimenu>
543 <guimenuitem>Select Mode</guimenuitem> </menuchoice>. This will
544 return the display area's cursor to the default selection arrow.</para>
546 <para>The following describes the object creation mode for each object
554 <para>Click the desired location of the upper left corner of the
555 text object. New text objects are initialized with the
556 string "Text." To change this text, or other properties, see
557 <xref linkend="glabels-object-properties"/>.</para>
564 <para>Click the desired location of the upper left corner of the
565 box object and drag to the desired location of the lower right
566 corner. If you simply click in a single location, a square
567 box will be created. To change properties of the box object, see
568 <xref linkend="glabels-object-properties"/>.</para>
575 <para>Click the desired location of one end of the
576 line object and drag to the desired location of the other end.
577 If you simply click in a single location, a diagonal line
578 will be created. To change properties of the line object, see
579 <xref linkend="glabels-object-properties"/>.</para>
586 <para>Click the desired location of the upper left corner of the
587 ellipse object and drag to the desired location of the lower
588 right corner. If you simply click in a single location, a circle
589 will be created. To change properties of the ellipse object, see
590 <xref linkend="glabels-object-properties"/>.</para>
597 <para>Click the desired location of the upper left corner of the
598 image object and drag to the desired location of the lower
599 right corner. If you simply click in a single location, a square
600 will be created. New image objects are initialized with a
601 simple checkerboard image. To change this image, or other
602 properties of the image object, see
603 <xref linkend="glabels-object-properties"/>.</para>
610 <para>Click the desired location of the upper left corner of the
611 barcode object. New barcode objects are initialized to a
612 POSTNET barcode with representative data. To change data
613 and properties of the barcode object, see
614 <xref linkend="glabels-object-properties"/>.</para>
623 <!-- ============= To Select Objects ========= -->
624 <sect2 id="glabels-select-objects">
625 <title>To Select Objects</title>
627 <para>A prerequisite for performing operations on objects is the
628 selection of individual objects or groups of objects. The
629 display area must be in the object selection mode to create new
630 selections, as indicated by an arrow cursor. The object
631 selection mode is selected by the
632 <menuchoice> <guimenu>Objects</guimenu>
633 <guimenuitem>Select Mode</guimenuitem> </menuchoice> menu item,
634 or the corresponding command on the <guilabel>Drawing
635 Toolbar</guilabel>.</para>
640 <term>Selecting a single object</term>
642 <para>A single object can be selected simply by clicking
643 on the desired object in the display area.
644 Once selected the object will be highlighted with a set of
645 resizing handles.</para>
650 <term>Aggregate object selections</term>
652 <para>Multiple objects can be selected by first selecting the first
653 object as above and then by holding the <keycap>Ctrl</keycap>
654 key while selecting additional objects.
655 Individual objects can be added to an existing selection
656 at any time by holding the <keycap>Ctrl</keycap> key while
657 selecting the desired objects. All objects can also be
658 selected by using the <menuchoice> <guimenu>Edit</guimenu>
659 <guimenuitem>Select All</guimenuitem> </menuchoice>
660 menu item. All objects in an aggregate object selection will be
666 <term>Area selections</term>
668 <para>Multiple objects can also be selected by clicking an empty
669 area and dragging to form a rectangular area. When released,
670 all objects contained in the area will form an aggregate
671 selection. An area selection can be used to add to an existing
672 selection by holding the <keycap>Ctrl</keycap> key while
673 performing the selection.</para>
678 <term>Unselecting objects</term>
680 <para>Individual objects can be removed from an existing
681 selection by holding the <keycap>Ctrl</keycap> key while
682 clicking on a previously selected object. An entire selection
683 can be dismissed by using the <menuchoice>
684 <guimenu>Edit</guimenu> <guimenuitem>Un-select All</guimenuitem>
685 </menuchoice> menu item
686 or by simply clicking any empty space in the display area.
687 Once an object is unselected its highlight is removed.</para>
695 <!-- ============= Clipboard Commands ========= -->
696 <sect2 id="glabels-clipboard">
697 <title>Clipboard Commands</title>
699 <para>Object selections can be manipulated using the standard clipboard
700 operations <guimenuitem>Cut</guimenuitem>,
701 <guimenuitem>Copy</guimenuitem>, <guimenuitem>Paste</guimenuitem>,
702 and <guimenuitem>Delete</guimenuitem>.</para>
710 <keycombo><keycap>Ctrl</keycap><keycap>X</keycap></keycombo>
712 <guimenuitem>Cortar</guimenuitem>
716 <para>Moves selected objects to the clipboard. The objects are
717 then available for pasting back into the current document or
718 another document.</para>
726 <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo>
728 <guimenuitem>Copiar</guimenuitem>
732 <para>Copies selected objects to the clipboard without deleting
733 them. The objects are then available for pasting back into
734 the current document or another document.</para>
742 <keycombo><keycap>Ctrl</keycap><keycap>V</keycap></keycombo>
744 <guimenuitem>Pegar</guimenuitem>
748 <para>Pastes objects from the clipboard into the current document.
749 <application>gLabels</application> can only paste objects from
750 another <application>gLabels</application> document.</para>
758 <keycap>Borrar</keycap>
760 <guimenuitem>Borrar</guimenuitem>
764 <para>Deletes selected objects without placing them on the
773 <!-- ============= To Edit object Properties ========= -->
774 <sect2 id="glabels-object-properties">
775 <title>To Edit Object Properties</title>
777 <para>Most object properties can be modified through the object
778 editor sidebar, illustrated below. To use the object editor,
779 a single object must first be selected. See
780 <xref linkend="glabels-select-objects"/>.</para>
782 <!-- ==== Figure ==== -->
783 <figure id="object-editor-sidebar-fig">
784 <title>Object Editor Sidebar</title>
787 <imageobject><imagedata fileref="figures/object-editor-sidebar.png" format="PNG"/>
792 <!-- ==== End of Figure ==== -->
794 <para>The object editor will contain a subset of the following
795 tabbed sections, depending on object type:</para>
797 <sect3 id="object-editor-text">
798 <title>Text Tabbed Section (Text objects)</title>
800 <para>This section contains a small editor for changing the content
801 of a text object. It also contains a dropdown menu of available
802 document merge keys, that can be inserted into text.</para>
806 <sect3 id="object-editor-image">
807 <title>Image Tabbed Section (Image objecs)</title>
809 <para>This section contains a file entry with preview to select
810 image files. The browse button can be used to easily locate
811 image files. Alternatively, a document merge key can be used
812 instead to provide a filename at print time.</para>
816 <sect3 id="object-editor-data">
817 <title>Data Tabbed Section (Barcode objecs)</title>
819 <para>This section contains a text entry to enter literal barcode
820 data. Alternatively, a document merge key can be used to
821 provide this data at print time.</para>
825 <sect3 id="object-editor-style">
826 <title>Style Tabbed Section (Text objects)</title>
828 <para>This section contains controls to select text properties,
829 including font family, font size, font weight, color, and
830 text justification.</para>
834 <sect3 id="object-editor-barcode">
835 <title>Style Tabbed Section (Barcode objecs)</title>
837 <para>This section contains controls to select barcode properties,
838 including barcode style, color, whether to print text, and whether
839 to include a checksum digit.</para>
843 <sect3 id="object-editor-line">
844 <title>Line Tabbed Section</title>
846 <para>This section contains controls to select properties of lines
847 and outlines. These properties include line width and color.</para>
851 <sect3 id="object-editor-fill">
852 <title>Fill Tabbed Section</title>
854 <para>This section contains controls to select fill properties of box
855 and ellipse objects. Currently the only fill property is fill
860 <sect3 id="object-editor-size">
861 <title>Size Tabbed Section (All except line objects)</title>
863 <para>This section contains controls to select the width and height
864 of an object. A checkbox is provided, so that the current aspect
865 ratio can be locked while manipulating the width and height controls.
866 Image objects also provide a button to reset the size to the
867 image's natural size (Assumes 72DPI).</para>
871 <sect3 id="object-editor-size-line">
872 <title>Size Tabbed Section (Line objects)</title>
874 <para>This section contains controls to select the length and angle
875 of a line object.</para>
879 <sect3 id="object-editor-position">
880 <title>Position Tabbed Section</title>
882 <para>This section contains controls to change the position of an
888 <sect3 id="object-editor-shadow">
889 <title>Shadow Tabbed Section (All except image and barcode objects)</title>
891 <para>This section contains controls to add a shadow to an object.</para>
898 <!-- ============= Other Manipulations of Objects ========= -->
899 <sect2 id="glabels-object-manipulation">
900 <title>Other Manipulations of Objects</title>
902 <para>Objects can also be manipulated in the following ways.</para>
904 <sect3 id="other-moving-resizing">
905 <title>Moving and Resizing Objects</title>
907 <para>Objects can be moved by simply clicking on a selected
908 object and dragging the object to its new location. If the object
909 is part of an aggregate selection, all objects in the selection
910 will move with the object being dragged, maintaining their relative
911 positions to one another. If no object is selected, clicking on
912 an object will create a new selection containing that object.
913 See <xref linkend="glabels-select-objects"/>.</para>
915 <para>A selected object can be resized by clicking one of its resize
916 handle and dragging it to obtain the new size.</para>
920 <sect3 id="other-stacking-order">
921 <title>Changing Stacking Order</title>
923 <para>Stacking order refers to relative position in the z-axis of
924 objects. That is when objects overlap, which object will appear
925 on top of the other. By default, newer objects will appear above
926 older objects. To change this order, select one or more objects
927 and choose <menuchoice> <guimenu>Objects</guimenu>
928 <guimenuitem>Order</guimenuitem>
929 <guimenuitem>Bring to Front</guimenuitem> </menuchoice>
930 to raise the selection to the top of the stacking
931 order, or choose <menuchoice> <guimenu>Objects</guimenu>
932 <guimenuitem>Order</guimenuitem>
933 <guimenuitem>Send to Back</guimenuitem> </menuchoice>
934 to lower the selection to the bottom of the
935 stacking order. These menuitems are also available by right-clicking
936 the display area when there is a non-empty selection.</para>
940 <sect3 id="other-rotating-flipping">
941 <title>Rotating and Flipping Objects</title>
943 <para>Objects can be rotated 90 degrees in either direction, or flipped
944 horizontally or vertically, by choosing the appropriate menuitem
945 in the <menuchoice> <guimenu>Objects</guimenu>
946 <guimenuitem>Rotate/Flip</guimenuitem> </menuchoice> sub-menu. These
947 menuitems are also available by right-clicking
948 the display area when there is a non-empty selection.</para>
952 <sect3 id="other-alignment">
953 <title>Aligning Objects</title>
955 <para>Objects can be aligned horizontally or vertically, relative to
956 one another, or relative to the center line of the label, by
957 choosing the appropriate menuitem from the <menuchoice>
958 <guimenu>Objects</guimenu>
959 <guimenuitem>Align Horizontal</guimenuitem>
960 </menuchoice> or <menuchoice> <guimenu>Objects</guimenu>
961 <guimenuitem>Align Horizontal</guimenuitem> </menuchoice> sub-menus.
962 These menuitems are also available by right-clicking
963 the display area when there is a non-empty selection.</para>
967 <sect3 id="other-property-bar">
968 <title>Using the Property Bar</title>
970 <para>The property bar can be used to change some common properties
971 of objects en-masse. These properties include font family, font
972 size, font weight, text alignment, text color, fill color, line
973 or outline color, and line width. The property bar also controls
974 the defaults for these properties for any newly created objects.
983 <!-- ============= Document Merge Features ========= -->
984 <sect2 id="glabels-merge">
985 <title>Performing a Document Merge</title>
987 <para>Document Merge (sometimes called "Mail Merge") is a powerful
988 feature that allows a unique label or card to be printed for each
989 record in an external data source.</para>
991 <para>The first step to performing a document merge is to prepare
992 a source document that contains your merge data. This data could
993 be mailing addresses or any other data that you wish to create
994 unique labels or cards for. Currently back-ends only exist for
995 text files and the evolution data server -- others are planned. The currently
996 supported text-file format is very simple: each line is a record;
997 fields are delimited by commas (CSV), tabs, or colons; and newlines
998 can be embedded into fields by using the "\n" entity. This file
999 could be created using any text editor or could be created by
1000 another program or script. A common way of creating CSV files is
1001 to export them from a spreadsheet program.</para>
1003 <para>A label must then be configured to "point at" this data file.
1004 To configure the merge properties of a document, choose
1005 <menuchoice> <guimenu>Objects</guimenu>
1006 <guimenuitem>Merge Properties</guimenuitem> </menuchoice> menu item
1007 to display the <guilabel>merge properties</guilabel> dialog. This
1008 dialog is used to select the exact data file format and file
1009 name (location) of the merge data.</para>
1011 <para>Finally, once the label has been configured for a data file,
1012 field keys can be inserted into text objects and used as source
1013 or data for barcode objects and image filenames for image objects.
1014 See <xref linkend="glabels-object-properties"/> for more information
1015 on using merge data for these object types.</para>
1017 <para>Now that your label is configured, <application>gLabels</application> will print a unique
1018 label for each record in your source document -- substituting fields
1019 from each record for field keys in the all text, barcode, and
1020 image objects.</para>
1022 <para>See <xref linkend="glabels-merge-tutorial"/> for a detailed
1023 tutorial on the document merge feature.</para>
1034 <!-- ============= Customization ============================= -->
1035 <!-- Use this section to describe how to customize the application. -->
1036 <sect1 id="glabels-prefs">
1037 <title>Configuración</title>
1038 <para>To configure <application>gLabels</application>, choose
1040 <guimenu>Settings</guimenu>
1041 <guimenuitem>Preferences</guimenuitem>
1043 <guilabel>Preferences</guilabel> dialog contains the following tabbed
1048 <xref linkend="glabels-prefs-locale"/></para>
1052 <xref linkend="glabels-prefs-object-defaults"/></para>
1055 <!-- =============== Customization Subsection ================ -->
1056 <!-- Use a new section to describe different tabbed sections on the Settings or Preferences
1058 <sect2 id="glabels-prefs-locale">
1059 <title>Región</title>
1063 <guilabel>Unidades</guilabel> </term>
1065 <para>Use this radio button group to specify your preferred units.
1066 Select one of the following options:</para>
1070 <guilabel>Puntos</guilabel> </para>
1071 <para>Use points (1 point = 1/72 in = 0.352778 mm).</para>
1075 <guilabel>Pulgadas</guilabel> </para>
1076 <para>Use inches.</para>
1080 <guilabel>Milímetros</guilabel> </para>
1081 <para>Use millimeters.</para>
1085 <guilabel>Inches</guilabel>.</para>
1090 <guilabel>Default page size</guilabel> </term>
1092 <para>Use this radio button group to specify your preferred page size.
1093 This will make it quicker for you to locate media types when creating a new
1094 label or card.</para>
1098 <guilabel>US Letter</guilabel> </para>
1099 <para>Most of your media will be of the US Letter page size (8.5 x 11 inches).</para>
1103 <guilabel>ISO A4</guilabel> </para>
1104 <para>Most of your media will be of the ISO A4 page size (210 x 297 mm).</para>
1108 <guilabel>US Letter</guilabel>.</para>
1113 <!-- ============= Customization Subsection ===================== -->
1114 <!-- Another tabbed section on the Preferences dialog. -->
1115 <sect2 id="glabels-prefs-object-defaults">
1116 <title>Opciones predeterminadas para el objeto</title>
1120 <guilabel>Texto</guilabel> </term>
1122 <para>Use these controls to set the default properties of new text objects.
1123 These properties are</para>
1127 <guilabel>Tipografía</guilabel> </para>
1128 <para>These controls are used to select font family and font size, and
1129 whether the font should bold or in italics.</para>
1133 <guilabel>Color</guilabel> </para>
1134 <para>This control selects the default text color.</para>
1138 <guilabel>Alineación</guilabel> </para>
1139 <para>These controls are used to select the default text alignment (left, center or right).</para>
1146 <guilabel>Línea</guilabel> </term>
1148 <para>Use these controls to set the default properties of lines and outlines of
1149 new objects. These properties are</para>
1153 <guilabel>Anchura</guilabel> </para>
1154 <para>This control selects the default line width.</para>
1158 <guilabel>Color</guilabel> </para>
1159 <para>This control selects the default line color.</para>
1166 <guilabel>Relleno</guilabel> </term>
1168 <para>Use these controls to set the default fill properties of
1169 new objects. These properties are</para>
1173 <guilabel>Color</guilabel> </para>
1174 <para>This control selects the default fill color.</para>
1186 <!-- ============= Document Merge Tutorial ================================== -->
1187 <sect1 id="glabels-merge-tutorial">
1188 <title>Document Merge Tutorial</title>
1190 <para>Document Merge (sometimes called "Mail Merge") is a powerful
1191 feature that allows a unique label or card to be printed for each
1192 record in an external data source. It is however, the most mis-understood
1193 feature of <application>gLabels</application>. The following examples
1194 will step through a couple of common tasks using the document merge
1197 <sect2 id="merge-ex1">
1198 <title>Example 1: Name Tags Using a CSV File</title>
1200 <para>In this example we are organizing an orientation party for the new
1201 crew members of our ship. We have a list of freshman crew members that we
1202 created in <application>gnumeric</application> and exported as the following
1203 CSV file. We could have created this file by using a text editor, but heck it
1204 is the 23rd century.</para>
1208 "Jim Kirk",Management,"SC937-0176 CEC"
1209 "Mr. Spock",Sciences,S179-276SP
1210 "Leonard McCoy",Medicine,unknown
1211 "Montgomery Scott",Engineering,SE-197-54T
1214 <para>In <application>gLabels</application> we have created a new <application>gLabels</application>
1215 document using the Avery 5395 "Name Badge Labels" template. Next we use the
1216 <menuchoice> <guimenu>Objects</guimenu>
1217 <guimenuitem>Merge Properties</guimenuitem> </menuchoice> menu item to display
1218 the <guilabel>merge properties</guilabel> dialog. We use this dialog to
1219 select the source type (in our case CSV) and the merge source (filename) as
1222 <!-- ==== Figure ==== -->
1223 <figure id="merge-ex1-1-fig">
1224 <title>Merge properties dialog</title>
1227 <imageobject><imagedata fileref="figures/merge-ex1-1.png" format="PNG"/>
1232 <!-- ==== End of Figure ==== -->
1234 <para>Before applying the merge source, we uncheck the first record since it is only
1235 column headers from our original <application>gnumeric</application> spreadsheet
1236 and would simply waste our first label. We could also unselect any other records
1237 that we didn't want to print a label for.</para>
1239 <para>We can also view each record in more detail by clicking on the appropriate
1240 expander (the little triangles) as shown. Once we are satisfied with the
1241 selections in this dialog we click <guibutton>OK</guibutton> to accept the
1244 <para>Now we start adding objects to our <application>gLabels</application> document as shown.</para>
1246 <!-- ==== Figure ==== -->
1247 <figure id="merge-ex1-2-fig">
1248 <title>Adding objects</title>
1251 <imageobject><imagedata fileref="figures/merge-ex1-2.png" format="PNG"/>
1256 <!-- ==== End of Figure ==== -->
1258 <para>In this example we have added three text objects and a barcode object. The
1259 first text object contains only simple literal text ("Hello, my name is"). The
1260 second text object contains a single merge field ("${1}") corresponding to the
1261 first field of a record (first column of a line) which contains the new crew
1262 member's full name. The third text field contains both literal text
1263 ("Department: ") followed by a single merge field ("${2}") corresponding to
1264 the second field or the crew member's department. The barcode object is
1265 configured to use field (or key) "3" which contains our crew member's
1266 starfleet serial number.</para>
1268 <para>Now we can print our name tags by selecting the
1269 <menuchoice> <guimenu>File</guimenu>
1270 <guimenuitem>Print</guimenuitem> </menuchoice> menu item. This will display
1271 print dialog as shown below.</para>
1273 <!-- ==== Figure ==== -->
1274 <figure id="merge-ex1-3-fig">
1275 <title>Printing name tags</title>
1278 <imageobject><imagedata fileref="figures/merge-ex1-3.png" format="PNG"/>
1283 <!-- ==== End of Figure ==== -->
1285 <para>Just to make sure our labels are going to look okay, we select the
1286 <guilabel>Print outlines</guilabel> option and click
1287 <guibutton>Print Preview</guibutton>. This will display a print preview dialog
1288 as shown below.</para>
1290 <!-- ==== Figure ==== -->
1291 <figure id="merge-ex1-4-fig">
1292 <title>Name tags preview</title>
1295 <imageobject><imagedata fileref="figures/merge-ex1-4.png" format="PNG"/>
1300 <!-- ==== End of Figure ==== -->
1302 <para>Everything looks good, so we can now load up our printer with
1303 the appropriate label stock, print our name tags and start beaming our guests
1308 <sect2 id="merge-ex2">
1309 <title>Example 2: Address Labels Using a CSV File</title>
1311 <para>In this example we are going to throw a party and need to print mailing
1312 address labels for our invitations. We have a list of our closest friends
1313 that we created in <application>gnumeric</application> and exported as the
1314 following CSV file. It should be noted that not everyone has a middle initial or
1315 a two line address.</para>
1318 LAST,FIRST,MI,ADDR1,ADDR2,CITY,STATE,ZIP
1320 Critter,Ess,S,"123 Faux St.",,Alexandria,VA,22310
1321 Doe,John,,"Apt 1X","451 Mystery St.",Trenton,NJ,08601
1322 Summers,Joyce,,"1630 Revello Dr",,Sunnydale,CA,95037
1323 McGarret,Steve,O,"404 Piikoi Street",,Honolulu,HI,96813
1324 Kramer,Cosmo,,"Apt 5B","129 W. 81 St.","New York",NY,10024-7207
1327 <para>In <application>gLabels</application> we have created a new <application>gLabels</application>
1328 document using the Avery 5512 "Address Labels" template. Next we use the
1329 <menuchoice> <guimenu>Objects</guimenu>
1330 <guimenuitem>Merge Properties</guimenuitem> </menuchoice> menu item to display
1331 the <guilabel>merge properties</guilabel> dialog. We use this dialog to
1332 select the source type (in our case CSV) and the merge source (filename) as
1335 <!-- ==== Figure ==== -->
1336 <figure id="merge-ex2-1-fig">
1337 <title>Merge properties dialog</title>
1340 <imageobject><imagedata fileref="figures/merge-ex2-1.png" format="PNG"/>
1345 <!-- ==== End of Figure ==== -->
1347 <para>Before applying the merge source, we uncheck the first record since it is only
1348 column headers from our original <application>gnumeric</application> spreadsheet
1349 and would simply waste our first label. We also unselect the second record
1350 which is empty (an artifact of our original spreadsheet). We could also unselect
1351 any other records that we didn't want to print a label for.</para>
1353 <para>We can also view each record in more detail by clicking on the appropriate
1354 expander (the little triangles) as shown. Once we are satisfied with the
1355 selections in this dialog we click <guibutton>OK</guibutton> to accept the
1358 <para>Now we start adding objects to our <application>gLabels</application> document as shown.</para>
1360 <!-- ==== Figure ==== -->
1361 <figure id="merge-ex2-2-fig">
1362 <title>Adding objects</title>
1365 <imageobject><imagedata fileref="figures/merge-ex2-2.png" format="PNG"/>
1370 <!-- ==== End of Figure ==== -->
1372 <para>In this example we have a single text object. This text object contains
1373 all of our merge fields organized on multiple lines as a mailing address.
1374 Notice that fields ${4} and ${5} (corresponding to ADDR1 and ADDR2) are each
1375 located with no other text on their own lines. When
1376 <application>gLabels</application> encounters a field as the only text on
1377 a line, it will not expand the line if the field is empty.</para>
1379 <para>Now we can print our address labels by selecting the
1380 <menuchoice> <guimenu>File</guimenu>
1381 <guimenuitem>Print</guimenuitem> </menuchoice> menu item. This will display
1382 print dialog as shown below.</para>
1384 <!-- ==== Figure ==== -->
1385 <figure id="merge-ex2-3-fig">
1386 <title>Printing address labels</title>
1389 <imageobject><imagedata fileref="figures/merge-ex2-3.png" format="PNG"/>
1394 <!-- ==== End of Figure ==== -->
1396 <para>Just to make sure our labels are going to look okay, we select the
1397 <guilabel>Print outlines</guilabel> option and click
1398 <guibutton>Print Preview</guibutton>. This will display a print preview dialog
1399 as shown below.</para>
1401 <!-- ==== Figure ==== -->
1402 <figure id="merge-ex2-4-fig">
1403 <title>Address labels preview</title>
1406 <imageobject><imagedata fileref="figures/merge-ex2-4.png" format="PNG"/>
1411 <!-- ==== End of Figure ==== -->
1413 <para>Everything looks good, so we can now load up our printer with
1414 the appropriate label stock, print our address labels and start mailing
1415 our party invitations.</para>
1419 <sect2 id="merge-ex3">
1420 <title>Example 3: Address Labels Using the <application>Evolution</application> Addressbook</title>
1422 <para>Our last party was a great success, and now we need to print mailing
1423 address labels for the invitations to a new one. To simplify this, we can use
1424 the <application>Evolution</application> addressbook, because the address
1425 data of all our friends is stored there.</para>
1428 <para>Depending on how your copy of <application>gLabels</application> was packaged, this option could be unavailable.
1429 Support for the <application>Evolution</application> addressbook will only be available
1430 if the <application>evolution-data-server</application> and its development files
1431 were present when <application>gLabels</application> was built. Please keep this in mind if you build <application>gLabels</application>
1432 directly from source.</para>
1434 <para>If the <application>gLabels</application> package from your distribution lacks this support,
1435 you may wish to contact the package maintainer or file a bug against the package
1436 to request it.</para>
1439 <para>In <application>glabels</application> we have created a new <application>gLabels</application>
1440 document using the Avery 5512 "Address Labels" template. Next we use the
1441 <menuchoice> <guimenu>Objects</guimenu>
1442 <guimenuitem>Merge Properties</guimenuitem></menuchoice> menu item to display
1443 the <guilabel>Merge properties</guilabel> dialog. We use this dialog to
1444 select the source type (in our case <guilabel>Data from default Evolution
1445 addressbook</guilabel>) as shown.</para>
1447 <!-- ==== Figure ==== -->
1448 <figure id="merge-ex3-1-fig">
1449 <title>Merge properties dialog</title>
1452 <imageobject><imagedata fileref="figures/merge-ex3-1.png" format="PNG"/>
1457 <!-- ==== End of Figure ==== -->
1459 <para>Once we have chosen <guilabel>Data from default Evolution addressbook
1460 </guilabel> as our merge source, we will get a full list of its content. Initially,
1461 all entries are checked. Assuming we were planning a really big party, we could
1462 leave this selection untouched (but let's keep our budget in mind). We will now select or
1463 unselect certain entries by clicking on the appropriate checkboxes, or we could use
1464 the <guibutton>Select all</guibutton> and <guibutton>Unselect all
1465 </guibutton> buttons to activate or deactivate all entries in the address book.</para>
1467 <para>We can also view each entry in more detail by clicking on the appropriate
1468 expander (the little triangles) as shown. Once we are satisfied with the
1469 selections in this dialog, we will click the <guibutton>OK</guibutton> button to
1470 accept the changes.</para>
1472 <para>Now we start adding objects to our glabels document as shown.</para>
1474 <!-- ==== Figure ==== -->
1475 <figure id="merge-ex3-2-fig">
1476 <title>Adding objects</title>
1479 <imageobject><imagedata fileref="figures/merge-ex3-2.png" format="PNG"/>
1484 <!-- ==== End of Figure ==== -->
1486 <para>In this example we have a single text object again. This text object contains
1487 all of our merge fields organized on multiple lines as a mailing address.</para>
1489 <para>Now we can print our address labels by selecting the
1490 <menuchoice> <guimenu>File</guimenu>
1491 <guimenuitem>Print</guimenuitem> </menuchoice> menu item. This will display
1492 the print dialog as shown below.</para>
1494 <!-- ==== Figure ==== -->
1495 <figure id="merge-ex3-3-fig">
1496 <title>Printing address labels</title>
1499 <imageobject><imagedata fileref="figures/merge-ex2-3.png" format="PNG"/>
1504 <!-- ==== End of Figure ==== -->
1506 <para>Just to make sure our labels are going to look okay, we select the
1507 <guilabel>Print outlines</guilabel> option and click
1508 <guibutton>Print Preview</guibutton>. This will display a print preview dialog
1509 as shown below.</para>
1511 <!-- ==== Figure ==== -->
1512 <figure id="merge-ex3-4-fig">
1513 <title>Address labels preview</title>
1516 <imageobject><imagedata fileref="figures/merge-ex2-4.png" format="PNG"/>
1521 <!-- ==== End of Figure ==== -->
1523 <para>Everything looks good, so we can now load up our printer with
1524 the appropriate label stock, print our address labels and start mailing
1525 our party invitations.</para>
1534 <!-- ============= Creating templates ================================== -->
1535 <sect1 id="glabels-manual-create-template">
1536 <title>Manually Creating New Templates</title>
1538 <para>Predefined templates are defined by XML files located in
1539 <filename>${prefix}/share/glabels/</filename>,
1540 where <filename>${prefix}</filename> is usually something like
1541 <filename>/usr/local</filename> or <filename>/usr</filename> depending
1542 on the configuration option <filename>prefix</filename>. <application>gLabels</application> will
1543 use all files of the form <filename>*-templates.xml</filename>
1544 or <filename>*.template</filename>, that it finds in
1545 <filename>${prefix}/share/glabels/</filename> and
1546 <filename>${HOME}/.glabels/</filename>.
1547 Additional templates can be added by creating additional
1548 <filename>*.template</filename> files in either of these directories.
1551 <para>The format for these files is defined in the DTD:
1552 <ulink url="http://glabels.sourceforge.net/doc/glabels-2.0.dtd.txt" type="http">glabels-2.2.dtd</ulink>. (This DTD also describes other
1553 XML formats used by <application>gLabels</application>.)</para>
1555 <sect2 id="template-assumptions">
1556 <title>Assumptions/caveats</title>
1559 <para>A sheet contains only one size of label or card (if a sheet
1560 contains more than one size of item, it can be split into
1561 multiple templates for multiple pass printing)</para>
1564 <para>Distances can be expressed in units of <emphasis>pt</emphasis>,
1565 <emphasis>in</emphasis>, <emphasis>mm</emphasis>,
1566 <emphasis>cm</emphasis>, or <emphasis>pc</emphasis>. For example:
1567 "<literal>1.0in</literal>" or "<literal>2.54cm</literal>". If no
1568 units are specified, computer points (<emphasis>pt</emphasis>) will
1569 be assumed (1 <emphasis>pt</emphasis> =
1570 1/72 <emphasis>in</emphasis> = 0.352778 <emphasis>mm</emphasis>).
1576 <sect2 id="template-file">
1577 <title>Template Files</title>
1580 <?xml version="1.0"?>
1581 <Glabels-templates>
1583 <replaceable>...templates...</replaceable>
1585 </Glabels-templates>
1590 <sect2 id="template-example">
1591 <title>Example Template</title>
1593 <Template brand="Avery" part="8160" size="US-Letter" description="Mailing Labels">
1594 <Label-rectangle id="0" width="189pt" height="72pt" round="5pt">
1595 <Markup-margin size="5pt"/>
1596 <Layout nx="3" ny="10" x0="11.25pt" y0="36pt" dx="200pt" dy="72pt"/>
1597 </Label-rectangle>
1598 <Alias brand="Avery" part="5160"/>
1599 <Alias brand="Avery" part="6233"/>
1604 <sect2 id="template-template-node">
1605 <title>Template Node</title>
1607 <para>A <emphasis>Template</emphasis> node describes a single stationary
1608 product. It must contain one instance of any type of Label node
1609 (<emphasis>Label-rectangle</emphasis>,
1610 <emphasis>Label-round</emphasis>, or <emphasis>Label-cd</emphasis>).
1611 This node can be followed by zero or more
1612 <emphasis>Alias</emphasis> nodes.</para>
1614 <informaltable frame="topbot">
1616 <colspec colname="col1"/>
1617 <colspec colname="col2"/>
1620 <entry colname="col1" colsep="0" valign="top">
1621 <para>Propiedad</para>
1623 <entry colname="col2" valign="top">
1624 <para>Descripción</para>
1630 <entry><para>brand</para></entry>
1632 <para>Brand or manufacturer of stationary product.
1637 <entry><para>part</para></entry>
1639 <para>Part number or name of stationary product.
1644 <entry><para>tamaño</para></entry>
1646 <para>Size of sheet. E.g., "US-Letter," "A4", ...</para>
1650 <entry><para>descripción</para></entry>
1652 <para>Description of stationary product. E.g,
1653 "Mailing Labels."</para>
1657 <entry><para>_description</para></entry>
1659 <para>Translatable description of stationary product.
1660 E.g, "Mailing Labels." (Only useful for predefined
1665 <entry><para>anchura</para></entry>
1667 <para>Page width. Only valid if size="Other"</para>
1671 <entry><para>altura</para></entry>
1673 <para>Page height. Only valid if size="Other"</para>
1682 <sect2 id="template-label-rectangle-node">
1683 <title>Label-rectangle Node</title>
1685 <para>A <emphasis>Label-rectangle</emphasis> node describes the
1686 dimensions of a single label or business card that is rectangular
1687 in shape (may have rounded edges).</para>
1689 <informaltable frame="topbot">
1691 <colspec colname="col1"/>
1692 <colspec colname="col2"/>
1695 <entry colname="col1" colsep="0" valign="top">
1696 <para>Propiedad</para>
1698 <entry colname="col2" valign="top">
1699 <para>Descripción</para>
1705 <entry><para>id</para></entry>
1707 <para>Reserved for future use. Should always be 0.</para>
1711 <entry><para>anchura</para></entry>
1712 <entry><para>Width of label/card</para></entry>
1715 <entry><para>altura</para></entry>
1716 <entry><para>Height of label/card</para></entry>
1719 <entry><para>redondo</para></entry>
1721 <para>Radius of corners. For items with square edges
1722 (business cards), the radius should be 0.</para>
1726 <entry><para>x_waste</para></entry>
1728 <para>Amount of horizontal waste (over-print) to allow. This is useful
1729 for minimizing alignment problems when using non-white
1730 backgrounds (e.g. images).</para>
1734 <entry><para>y_waste</para></entry>
1736 <para>Amount of vertical waste (over-print) to allow. This is useful
1737 for minimizing alignment problems when using non-white
1738 backgrounds (e.g. images).</para>
1745 <!-- ==== Figure ==== -->
1746 <figure id="template-label-fig">
1747 <title>Label-rectangle Parameters</title>
1750 <imageobject><imagedata fileref="figures/glabels-template-label.png" format="PNG"/>
1755 <!-- ==== End of Figure ==== -->
1759 <sect2 id="template-label-round-node">
1760 <title>Label-round Node</title>
1762 <para>A <emphasis>Label-round</emphasis> node describes the dimensions
1763 of a simple round label (not a CD).</para>
1765 <informaltable frame="topbot">
1767 <colspec colname="col1"/>
1768 <colspec colname="col2"/>
1771 <entry colname="col1" colsep="0" valign="top">
1772 <para>Propiedad</para>
1774 <entry colname="col2" valign="top">
1775 <para>Descripción</para>
1781 <entry><para>id</para></entry>
1783 <para>Reserved for future use. Should always be 0.</para>
1787 <entry><para>radius</para></entry>
1788 <entry><para>Radius (1/2 diameter) of label</para></entry>
1791 <entry><para>basura</para></entry>
1793 <para>Amount of waste (over-print) to allow. This is useful
1794 for minimizing alignment problems when using non-white
1795 backgrounds (e.g. images).</para>
1804 <sect2 id="template-label-cd-node">
1805 <title>Label-cd Node</title>
1807 <para>A <emphasis>Label-cd</emphasis> node describes the dimensions
1808 of a CD, DVD, or business card CD.</para>
1810 <informaltable frame="topbot">
1812 <colspec colname="col1"/>
1813 <colspec colname="col2"/>
1816 <entry colname="col1" colsep="0" valign="top">
1817 <para>Propiedad</para>
1819 <entry colname="col2" valign="top">
1820 <para>Descripción</para>
1826 <entry><para>id</para></entry>
1828 <para>Reserved for future use. Should always be 0.</para>
1832 <entry><para>radius</para></entry>
1833 <entry><para>Outer radius of label</para></entry>
1836 <entry><para>hole</para></entry>
1837 <entry><para>Radius of concentric hole</para></entry>
1840 <entry><para>anchura</para></entry>
1842 <para>If present, the label is clipped to the given width.
1843 (Useful for "business card CDs").</para>
1847 <entry><para>altura</para></entry>
1849 <para>If present, the label is clipped to the given height.
1850 (Useful for "business card CDs").</para>
1854 <entry><para>basura</para></entry>
1856 <para>Amount of waste (over-print) to allow. This is useful
1857 for minimizing alignment problems when using non-white
1858 backgrounds (e.g. images).</para>
1865 <!-- ==== Figure ==== -->
1866 <figure id="template-label-cd-fig">
1867 <title>CD Label Parameters</title>
1870 <imageobject><imagedata fileref="figures/glabels-template-cd.png" format="PNG"/>
1875 <!-- ==== End of Figure ==== -->
1879 <sect2 id="template-markup-margin-node">
1880 <title>Markup-margin Node</title>
1882 <para>A <emphasis>Markup-margin</emphasis> describes a margin along
1883 all edges of a label.</para>
1885 <informaltable frame="topbot">
1887 <colspec colname="col1"/>
1888 <colspec colname="col2"/>
1891 <entry colname="col1" colsep="0" valign="top">
1892 <para>Propiedad</para>
1894 <entry colname="col2" valign="top">
1895 <para>Descripción</para>
1901 <entry><para>tamaño</para></entry>
1903 <para>Size of the margin. I.e. the distance of the margin
1904 line from the edge of the card/label.</para>
1913 <sect2 id="template-markup-line-node">
1914 <title>Markup-line Node</title>
1916 <para>A <emphasis>Markup-line</emphasis> describes a markup line.</para>
1918 <informaltable frame="topbot">
1920 <colspec colname="col1"/>
1921 <colspec colname="col2"/>
1924 <entry colname="col1" colsep="0" valign="top">
1925 <para>Propiedad</para>
1927 <entry colname="col2" valign="top">
1928 <para>Descripción</para>
1934 <entry><para>x1</para></entry>
1936 <para>x coordinate of 1st endpoint of the line segment.</para>
1940 <entry><para>y1</para></entry>
1942 <para>y coordinate of 1st endpoint of the line segment.</para>
1946 <entry><para>x2</para></entry>
1948 <para>x coordinate of 2nd endpoint of the line segment.</para>
1952 <entry><para>y2</para></entry>
1954 <para>y coordinate of 2nd endpoint of the line segment.</para>
1963 <sect2 id="template-markup-circle-node">
1964 <title>Markup-circle Node</title>
1966 <para>A <emphasis>Markup-circle</emphasis> describes a markup circle.
1969 <informaltable frame="topbot">
1971 <colspec colname="col1"/>
1972 <colspec colname="col2"/>
1975 <entry colname="col1" colsep="0" valign="top">
1976 <para>Propiedad</para>
1978 <entry colname="col2" valign="top">
1979 <para>Descripción</para>
1985 <entry><para>x0</para></entry>
1987 <para>x coordinate of circle origin (center).</para>
1991 <entry><para>y0</para></entry>
1993 <para>y coordinate of circle origin (center).</para>
1997 <entry><para>radius</para></entry>
1998 <entry><para>Radius of circle.</para></entry>
2006 <sect2 id="template-markup-rect-node">
2007 <title>Markup-rect Node</title>
2009 <para>A <emphasis>Markup-rect</emphasis> describes a markup rectangle.
2012 <informaltable frame="topbot">
2014 <colspec colname="col1"/>
2015 <colspec colname="col2"/>
2018 <entry colname="col1" colsep="0" valign="top">
2019 <para>Propiedad</para>
2021 <entry colname="col2" valign="top">
2022 <para>Descripción</para>
2028 <entry><para>x1</para></entry>
2030 <para>x coordinate of upper left corner of rectangle.</para>
2034 <entry><para>y1</para></entry>
2036 <para>y coordinate of upper left corner of rectangle.</para>
2040 <entry><para>w</para></entry>
2042 <para>Width of rectangle.</para>
2046 <entry><para>h</para></entry>
2048 <para>Height of rectangle.</para>
2052 <entry><para>r</para></entry>
2053 <entry><para>Radius of rounded corners of rectangle.</para></entry>
2061 <sect2 id="template-layout-node">
2062 <title>Layout Node</title>
2064 <para>A label node may contain multiple <emphasis>Layout</emphasis>
2065 children. If labels are arranged in a simple grid pattern, only
2066 one layout is needed. However, if labels are arranged in multiple
2067 grids, such as a running bond pattern, multiple
2068 <emphasis>layout</emphasis> tags can be used. Note: a single label
2069 can always be treated as a grid of one.</para>
2071 <informaltable frame="topbot">
2073 <colspec colname="col1"/>
2074 <colspec colname="col2"/>
2077 <entry colname="col1" colsep="0" valign="top">
2078 <para>Propiedad</para>
2080 <entry colname="col2" valign="top">
2081 <para>Descripción</para>
2087 <entry><para>nx</para></entry>
2089 <para>Number of labels/cards across in the grid
2094 <entry><para>ny</para></entry>
2096 <para>Number of labels/cards up and down in the grid
2101 <entry><para>x0</para></entry>
2103 <para>Distance from left edge of sheet to the left edge of
2104 the left column of cards/labels in the layout.</para>
2108 <entry><para>y0</para></entry>
2110 <para>Distance from the top edge of sheet to the top edge of
2111 the top row of labels/cards in the layout.</para>
2115 <entry><para>dx</para></entry>
2116 <entry><para>Horizontal pitch of grid.</para></entry>
2119 <entry><para>dy</para></entry>
2120 <entry><para>Vertical pitch of grid.</para></entry>
2126 <!-- ==== Figure ==== -->
2127 <figure id="template-layout-fig">
2128 <title>Layout Parameters</title>
2131 <imageobject><imagedata fileref="figures/glabels-template-layout.png" format="PNG"/>
2136 <!-- ==== End of Figure ==== -->
2140 <sect2 id="template-alias-node">
2141 <title>Alias Node</title>
2143 <para>An <emphasis>Alias</emphasis> node provides the name of a
2144 product with the same size and layout characteristics as the
2145 parent template.</para>
2147 <informaltable frame="topbot">
2149 <colspec colname="col1"/>
2150 <colspec colname="col2"/>
2153 <entry colname="col1" colsep="0" valign="top">
2154 <para>Propiedad</para>
2156 <entry colname="col2" valign="top">
2157 <para>Descripción</para>
2163 <entry><para>brand</para></entry>
2165 <para>The brand or manufacturer of the equivalent product.</para>
2169 <entry><para>part</para></entry>
2171 <para>The part number or name of the equivalent product.</para>
2185 <!-- ============= Bugs ================================== -->
2186 <!-- This section is optional and is commented out by default.
2187 You can use it to describe known bugs and limitations of the
2188 program if there are any - please be frank and list all
2189 problems you know of.
2191 <sect1 id="mayapp-bugs">
2192 <title>Known Bugs and Limitations</title>
2200 <!-- ============= About ================================== -->
2201 <!-- This section contains info about the program (not docs), such as
2202 author's name(s), web page, license, feedback address. This
2203 section is optional: primary place for this info is "About.." box of
2204 the program. However, if you do wish to include this info in the
2205 manual, this is the place to put it. Alternatively, you can put this information in the title page.-->
2206 <sect1 id="glabels-about">
2207 <title>About <application>gLabels</application></title>
2208 <para> <application>gLabels</application> was written by Jim Evins
2209 (<email>evins@snaught.com</email>). To find more information about
2210 <application>gLabels</application>, please visit the
2211 <ulink url="http://glabels.sourceforge.net" type="http">gLabels Web
2212 page</ulink>. </para>
2214 To report a bug or make a suggestion regarding this application or
2215 this manual, follow the directions at the
2216 <ulink url="http://glabels.sourceforge.net/contact/" type="http"><application>gLabels</application> Contact Page</ulink>.
2219 <para>Este programa se distribuye bajo los términos de la Licencia Pública General GNU tal como la publica la Free Software Foundation; en cualquiera de las versiones 2 de la Licencia o (a su elección) cualquier versión posterior. Puede encontrar una copia de esta licencia en este <ulink url="ghelp:gpl" type="help">enlace</ulink>, o en el archivo COPYING incluido con el código fuente de este programa.</para>
projects / glabels / blob