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