git.sur5r.net Git - glabels/blob - help/pt_BR/merge-ex1.page

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <page xmlns="http://projectmallard.org/1.0/" xmlns:e="http://projectmallard.org/experimental/" type="guide" id="merge-ex1" xml:lang="pt-BR">
   3
   4   <info>
   5     <link type="guide" xref="merge#merge-ex"/>
   6     <revision pkgversion="3.0" version="0.1" date="2010-05-04" status="incomplete"/>
   7     <desc>
   8        Create name tags from a CSV file.
   9     </desc>
  10     <credit type="author">
  11       <name>Jim Evins</name>
  12       <email>evins@snaught.com</email>
  13     </credit>
  14     <credit type="author">
  15       <name>Mario Blättermann</name>
  16       <email>mario.blaettermann@gmail.com</email>
  17     </credit>
  18     <license>
  19       <p>Creative Commons Share Alike 3.0</p>
  20     </license>
  21   </info>
  22
  23     <title>Example 1: Name Tags</title>
  24
  25       <p>In this example we are organizing an orientation party for the new
  26         crew members of our ship.  We have a list of freshman crew members that we
  27         created in <app>gnumeric</app> and exported as the following
  28         CSV file.  We could have created this file by using a text editor, but heck it
  29         is the 23rd century.</p>
  30
  31       <code>
  32 Name,Department,SN
  33 "Jim Kirk",Management,"SC937-0176 CEC"
  34 "Mr. Spock",Sciences,S179-276SP
  35 "Leonard McCoy",Medicine,unknown
  36 "Montgomery Scott",Engineering,SE-197-54T
  37       </code>
  38
  39       <p>In <app>gLabels</app> we have created a new <app>glabels</app>
  40         document using the Avery 5395 "Name Badge Labels" template.  Next we use the
  41         <guiseq> <gui>Objects</gui>
  42         <gui>Merge Properties</gui> </guiseq> menu item to display
  43         the <gui>merge properties</gui> dialog.  We use this dialog to
  44         select the source type (in our case CSV with keys on line 1) and the merge
  45         source (filename) as shown.</p>
  46
  47       <!-- ==== Figure ==== -->
  48                 <media type="image" src="figures/merge-ex1-1.png" mime="image/png" style="right">
  49                 <p>Merge properties dialog</p>
  50                 </media>
  51       <!-- ==== End of Figure ==== -->
  52
  53       <p>We can also view each record in more detail by clicking on the appropriate
  54         expander (the little triangles) as shown.  Once we are satisfied with the
  55         selections in this dialog we click <gui>OK</gui> to accept the
  56         changes.</p>
  57
  58       <p>Now we start adding objects to our <app>glabels</app> document as shown.</p>
  59
  60       <!-- ==== Figure ==== -->
  61                 <media type="image" src="figures/merge-ex1-2.png" mime="image/png" style="right">
  62                 <p>Adicionando objetos</p>
  63                 </media>
  64       <!-- ==== End of Figure ==== -->
  65
  66       <p>In this example we have added three text objects and a barcode object.  The
  67         first text object contains only simple literal text ("Hello, my name is").  The
  68         second text object contains a single merge field ("${Name}") corresponding to the
  69         first field of a record (first column of a line) which contains the new crew
  70         member's full name.  The third text field contains both literal text
  71         ("Department: ") followed by a single merge field ("${Department}") corresponding to
  72         the second field or the crew member's department.  The barcode object is
  73         configured to use field (or key) "SN" which contains our crew member's
  74         starfleet serial number.</p>
  75
  76       <p>Now we can print our name tags by selecting the
  77         <guiseq> <gui>File</gui>
  78         <gui>Print</gui> </guiseq> menu item.  This will display
  79         print dialog as shown below.</p>
  80
  81       <!-- ==== Figure ==== -->
  82                 <media type="image" src="figures/merge-ex1-3.png" mime="image/png" style="right">
  83                 <p>Printing name tags</p>
  84                 </media>
  85       <!-- ==== End of Figure ==== -->
  86
  87       <p>Just to make sure our labels are going to look okay, we select the
  88         <gui>Print outlines</gui> option and click
  89         <gui>Print Preview</gui>.  This will display a print preview dialog
  90         as shown below.</p>
  91
  92       <!-- ==== Figure ==== -->
  93                 <media type="image" src="figures/merge-ex1-4.png" mime="image/png" style="right">
  94                 <p>Name tags preview</p>
  95                 </media>
  96       <!-- ==== End of Figure ==== -->
  97
  98       <p>Everything looks good, so we can now load up our printer with
  99         the appropriate label stock, print our name tags and start beaming our guests
 100         aboard.</p>
 101
 102
 103 </page>