git.sur5r.net Git - glabels/blob - help/C/merge-ex3.page

   1 <page xmlns="http://projectmallard.org/1.0/"
   2       xmlns:e="http://projectmallard.org/experimental/"
   3       type="guide"
   4       id="merge-ex3">
   5
   6   <info>
   7     <link type="guide" xref="merge#merge-ex"/>
   8     <revision pkgversion="3.0" version="0.1" date="2010-05-04" status="incomplete"/>
   9     <desc>
  10        Create address labels from the <app>Evolution</app> address book entries.
  11     </desc>
  12     <credit type="author">
  13       <name>Jim Evins</name>
  14       <email>evins@snaught.com</email>
  15     </credit>
  16     <credit type="author">
  17       <name>Mario Blättermann</name>
  18       <email>mario.blaettermann@gmail.com</email>
  19     </credit>
  20     <license>
  21       <p>Creative Commons Share Alike 3.0</p>
  22     </license>
  23   </info>
  24
  25     <title>Example 3: Address Labels Using the <app>Evolution</app> Addressbook</title>
  26
  27       <p>Our last party was a great success, and now we need to print mailing
  28         address labels for the invitations to a new one. To simplify this, we can use
  29         the <app>Evolution</app> addressbook, because the address
  30         data of all our friends is stored there.</p>
  31
  32       <note>
  33         <p>Depending on how your copy of <app>gLabels</app> was packaged, this option could be unavailable.
  34           Support for the <app>Evolution</app> addressbook will only be available
  35           if the <app>evolution-data-server</app> and its development files
  36           were present when <app>gLabels</app> was built. Please keep this in mind if you build <app>gLabels</app>
  37           directly from source.</p>
  38
  39         <p>If the <app>gLabels</app> package from your distribution lacks this support,
  40           you may wish to contact the package maintainer or file a bug against the package
  41           to request it.</p>
  42       </note>
  43
  44       <p>In <app>glabels</app> we have created a new <app>gLabels</app>
  45         document using the Avery 5512 "Address Labels" template. Next we use the
  46         <guiseq> <gui>Objects</gui>
  47         <gui>Merge Properties</gui></guiseq> menu item to display
  48         the <gui>Merge properties</gui> dialog. We use this dialog to
  49         select the source type (in our case <gui>Data from default Evolution
  50         addressbook</gui>) as shown.</p>
  51
  52       <!-- ==== Figure ==== -->
  53                 <media type="image" src="figures/merge-ex3-1.png" mime="image/png" style="right">
  54                 <p>Merge properties dialog</p>
  55                 </media>
  56       <!-- ==== End of Figure ==== -->
  57
  58       <p>Once we have chosen <gui>Data from default Evolution addressbook
  59         </gui> as our merge source, we will get a full list of its content. Initially,
  60         all entries are checked. Assuming we were planning a really big party, we could
  61         leave this selection untouched (but let's keep our budget in mind). We will now select or
  62         unselect certain entries by clicking on the appropriate checkboxes, or we could use
  63         the <gui>Select all</gui> and <gui>Unselect all
  64         </gui> buttons to activate or deactivate all entries in the address book.</p>
  65
  66       <p>We can also view each entry in more detail by clicking on the appropriate
  67         expander (the little triangles) as shown. Once we are satisfied with the
  68         selections in this dialog, we will click the <gui>OK</gui> button to
  69         accept the changes.</p>
  70
  71       <p>Now we start adding objects to our <app>glabels</app> document as shown.</p>
  72
  73       <!-- ==== Figure ==== -->
  74                 <media type="image" src="figures/merge-ex3-2.png" mime="image/png" style="right">
  75                 <p>Adding objects</p>
  76                 </media>
  77       <!-- ==== End of Figure ==== -->
  78
  79       <p>In this example we have a single text object again. This text object contains
  80         all of our merge fields organized on multiple lines as a mailing address.</p>
  81
  82       <p>Now we can print our address labels by selecting the
  83         <guiseq> <gui>File</gui>
  84         <gui>Print</gui> </guiseq> menu item. This will display
  85         the print dialog as shown below.</p>
  86
  87       <!-- ==== Figure ==== -->
  88                 <media type="image" src="figures/merge-ex3-3.png" mime="image/png" style="right">
  89                 <p>Printing address labels</p>
  90                 </media>
  91       <!-- ==== End of Figure ==== -->
  92
  93       <p>Just to make sure our labels are going to look okay, we select the
  94         <gui>Print outlines</gui> option and click
  95         <gui>Print Preview</gui>. This will display a print preview dialog
  96         as shown below.</p>
  97
  98       <!-- ==== Figure ==== -->
  99                 <media type="image" src="figures/merge-ex3-4.png" mime="image/png" style="right">
 100                 <p>Addess labels preview</p>
 101                 </media>
 102       <!-- ==== End of Figure ==== -->
 103
 104       <p>Everything looks good, so we can now load up our printer with
 105         the appropriate label stock, print our address labels and start mailing
 106         our party invitations.</p>
 107
 108
 109 </page>