From: Jim Evins Date: Tue, 14 Jun 2005 03:11:04 +0000 (+0000) Subject: 2005-06-13 Jim Evins X-Git-Tag: glabels-2_3_0~412 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=4e3e2f3a70c4670eb2dc905aafa743efa546c404;p=glabels 2005-06-13 Jim Evins * help/C/figures/merge-ex1-1.png: * help/C/figures/merge-ex1-2.png: * help/C/figures/merge-ex1-3.png: * help/C/figures/merge-ex1-4.png: * help/C/figures/merge-ex2-1.png: * help/C/figures/merge-ex2-2.png: * help/C/figures/merge-ex2-3.png: * help/C/figures/merge-ex2-4.png: Added figures for document merge tutorial. * help/C/glabels.xml: Added document merge tutorial. git-svn-id: https://glabels.svn.sourceforge.net/svnroot/glabels/trunk@538 f5e0f49d-192f-0410-a22d-a8d8700d0965 --- diff --git a/glabels2/ChangeLog b/glabels2/ChangeLog index 79be45ee..fdf4c7f4 100644 --- a/glabels2/ChangeLog +++ b/glabels2/ChangeLog @@ -1,10 +1,24 @@ -2005-05-19 Jim Evins,,, +2005-06-13 Jim Evins + + * help/C/figures/merge-ex1-1.png: + * help/C/figures/merge-ex1-2.png: + * help/C/figures/merge-ex1-3.png: + * help/C/figures/merge-ex1-4.png: + * help/C/figures/merge-ex2-1.png: + * help/C/figures/merge-ex2-2.png: + * help/C/figures/merge-ex2-3.png: + * help/C/figures/merge-ex2-4.png: + Added figures for document merge tutorial. + * help/C/glabels.xml: + Added document merge tutorial. - reviewed by: +2005-05-19 Jim Evins * data/glade/merge-properties-dialog.glade: + Fixed irregular spacing. * src/merge-properties-dialog.c: (gl_merge_properties_dialog_init), (gl_merge_properties_dialog_construct): + Set outer padding and remove separator. 2005-05-18 Jim Evins diff --git a/glabels2/help/C/figures/merge-ex1-1.png b/glabels2/help/C/figures/merge-ex1-1.png new file mode 100644 index 00000000..f8673c1d Binary files /dev/null and b/glabels2/help/C/figures/merge-ex1-1.png differ diff --git a/glabels2/help/C/figures/merge-ex1-2.png b/glabels2/help/C/figures/merge-ex1-2.png new file mode 100644 index 00000000..a87675aa Binary files /dev/null and b/glabels2/help/C/figures/merge-ex1-2.png differ diff --git a/glabels2/help/C/figures/merge-ex1-3.png b/glabels2/help/C/figures/merge-ex1-3.png new file mode 100644 index 00000000..f31ecafe Binary files /dev/null and b/glabels2/help/C/figures/merge-ex1-3.png differ diff --git a/glabels2/help/C/figures/merge-ex1-4.png b/glabels2/help/C/figures/merge-ex1-4.png new file mode 100644 index 00000000..71e11864 Binary files /dev/null and b/glabels2/help/C/figures/merge-ex1-4.png differ diff --git a/glabels2/help/C/figures/merge-ex2-1.png b/glabels2/help/C/figures/merge-ex2-1.png new file mode 100644 index 00000000..1c64ed76 Binary files /dev/null and b/glabels2/help/C/figures/merge-ex2-1.png differ diff --git a/glabels2/help/C/figures/merge-ex2-2.png b/glabels2/help/C/figures/merge-ex2-2.png new file mode 100644 index 00000000..e1d8f2af Binary files /dev/null and b/glabels2/help/C/figures/merge-ex2-2.png differ diff --git a/glabels2/help/C/figures/merge-ex2-3.png b/glabels2/help/C/figures/merge-ex2-3.png new file mode 100644 index 00000000..baac803a Binary files /dev/null and b/glabels2/help/C/figures/merge-ex2-3.png differ diff --git a/glabels2/help/C/figures/merge-ex2-4.png b/glabels2/help/C/figures/merge-ex2-4.png new file mode 100644 index 00000000..e51489d9 Binary files /dev/null and b/glabels2/help/C/figures/merge-ex2-4.png differ diff --git a/glabels2/help/C/glabels.xml b/glabels2/help/C/glabels.xml index 53bbae87..17664eea 100644 --- a/glabels2/help/C/glabels.xml +++ b/glabels2/help/C/glabels.xml @@ -1045,6 +1045,10 @@ from each record for field keys in the all text, barcode, and image objects. + See for a detailed + tutorial on the document merge feature. + + @@ -1205,6 +1209,252 @@ + + + Document Merge Tutorial + + Document Merge (sometimes called "Mail Merge") is a powerful + feature that allows a unique label or card to be printed for each + record in an external data source. It is however, the most mis-understood + feature of glabels. The following examples + will step through a couple of common tasks using the document merge + feature. + + + Example 1: Name Tags + + In this example we are organizing an orientation party for the new + crew members of our ship. We have a list of freshman crew members that we + created in gnumeric and exported as the following + CSV file. We could have created this file by using a text editor, but heck it + is the 23rd century. + + +Name,Department,SN +"Jim Kirk",Management,"SC937-0176 CEC" +"Mr. Spock",Sciences,S179-276SP +"Leonard McCoy",Medicine,unknown +"Montgomery Scott",Engineering,SE-197-54T + + + In glabels we have created a new glabels + document using the Avery 5395 "Name Badge Labels" template. Next we use the + Objects + Merge Properties menu item to display + the merge properties dialog. We use this dialog to + select the source type (in our case CSV) and the merge source (filename) as + shown. + + +
+ Merge properties dialog + + + + + + +
+ + + Before applying the merge source, we uncheck the first record since it is only + column headers from our original gnumeric spreadsheet + and would simply waste our first label. We could also unselect any other records + that we didn't want to print a label for. + + We can also view each record in more detail by clicking on the appropriate + expander (the little triangles) as shown. Once we are satisfied with the + selections in this dialog we click OK to accept the + changes. + + Now we start adding objects to our glabels document as shown. + + +
+ Adding objects + + + + + + +
+ + + In this example we have added three text objects and a barcode object. The + first text object contains only simple literal text ("Hello, my name is"). The + second text object contains a single merge field ("${1}") corresponding to the + first field of a record (first column of a line) which contains the new crew + member's full name. The third text field contains both literal text + ("Department: ") followed by a single merge field ("${2}") corresponding to + the second field or the crew member's department. The barcode object is + configured to use field (or key) "3" which contains our crew member's + starfleet serial number. + + Now we can print our name tags by selecting the + File + Print menu item. This will display + print dialog as shown below. + + +
+ Printing name tags + + + + + + +
+ + + Just to make sure our labels are going to look okay, we select the + Print outlines option and click + Print Preview. This will display a print preview dialog + as shown below. + + +
+ Name tags preview + + + + + + +
+ + + Everything looks good, so we can now load up our printer with + the appropriate label stock, print our name tags and start beaming our guests + aboard. + + + + + Example 2: Address Labels + + In this example we are going to throw a party and need to print mailing + address labels for our invitations. We have a list of our closest friends + that we created in gnumeric and exported as the + following CSV file. It should be noted that not everyone has a middle initial or + a two line address. + + +LAST,FIRST,MI,ADDR1,ADDR2,CITY,STATE,ZIP +,,,,,,, +Critter,Ess,S,"123 Faux St.",,Alexandria,VA,22310 +Doe,John,,"Apt 1X","451 Mystery St.",Trenton,NJ,08601 +Summers,Joyce,,"1630 Revello Dr",,Sunnydale,CA,95037 +McGarret,Steve,O,"404 Piikoi Street",,Honolulu,HI,96813 +Kramer,Cosmo,,"Apt 5B","129 W. 81 St.",Manhatten,NY,10024-7207 + + + In glabels we have created a new glabels + document using the Avery 5512 "Address Labels" template. Next we use the + Objects + Merge Properties menu item to display + the merge properties dialog. We use this dialog to + select the source type (in our case CSV) and the merge source (filename) as + shown. + + +
+ Merge properties dialog + + + + + + +
+ + + Before applying the merge source, we uncheck the first record since it is only + column headers from our original gnumeric spreadsheet + and would simply waste our first label. We also unselect the second record + which is empty (an artifact of our original spreadsheet). We could also unselect + any other records that we didn't want to print a label for. + + We can also view each record in more detail by clicking on the appropriate + expander (the little triangles) as shown. Once we are satisfied with the + selections in this dialog we click OK to accept the + changes. + + Now we start adding objects to our glabels document as shown. + + +
+ Adding objects + + + + + + +
+ + + In this example we have a single text object. This text object contains + all of our merge fields organized on multiple lines as a mailing address. + Notice that fields ${4} and ${5} (corresponding to ADDR1 and ADDR2) are each + located with no other text on their own lines. When + glabels encounters a field as the only text on + a line, it will not expand the line if the field is empty. + + Now we can print our address labels by selecting the + File + Print menu item. This will display + print dialog as shown below. + + +
+ Printing name tags + + + + + + +
+ + + Just to make sure our labels are going to look okay, we select the + Print outlines option and click + Print Preview. This will display a print preview dialog + as shown below. + + +
+ Name tags preview + + + + + + +
+ + + Everything looks good, so we can now load up our printer with + the appropriate label stock, print our address labels and start mailing + our party invitations. + + + + + + + + Manually Creating New Templates