From: Jim Evins Date: Wed, 4 Nov 2009 03:41:09 +0000 (-0500) Subject: Updated documentation for 2.2.6 X-Git-Tag: glabels-2_2_6~11 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=d0777b14a00530d90dab29e85aabad7b6ff57b67;p=glabels Updated documentation for 2.2.6 - Added an example for doing document merge from evolution data server. (Mario Blättermann) - Updated most screenshots to 2.2.6 with Clearlooks theme. - Minor corrections --- diff --git a/.gitignore b/.gitignore new file mode 100644 index 00000000..0ed79a13 --- /dev/null +++ b/.gitignore @@ -0,0 +1,84 @@ +# +# General ignore patterns +# +*.o +*.lo +*.la +.deps +.libs +Makefile +Makefile.in +Makefile.in.in + +# +# Explicit files and patterns +# +/aclocal.m4 +/autom4te.cache +/config.guess +/config.h +/config.h.in +/config.log +/config.status +/config.sub +/configure +/depcomp +/glabels.spec +/gnome-doc-utils.make +/gtk-doc.make +/install-sh +/intltool-extract.in +/intltool-merge.in +/intltool-update.in +/libtool +/ltmain.sh +/missing +/mkinstalldirs +/omf.make +/stamp-h1 +/xmldocs.make + +/libglabels/libglabels.pc + +/src/marshal.[ch] +/src/stock-pixmaps/stockpixbufs.h +/src/glabels +/src/glabels-batch +/src/mygal/e-marshal.[ch] + +/data/desktop/glabels.desktop +/data/mime/glabels.keys +/data/mime/glabels.xml + +/po/.intltool-merge-cache +/po/*.gmo +/po/POTFILES +/po/stamp-it +/po/glabels.pot + +/help/glabels-*.omf +/help/*/.xml2po.mo +/help/*/glabels.xml +!/help/C/glabels.xml + +/docs/libglabels/*.stamp +/docs/libglabels/xml/ +/docs/libglabels/html/ +/docs/libglabels/libglabels-decl.txt +/docs/libglabels/libglabels-undeclared.txt +/docs/libglabels/libglabels-unused.txt +/docs/libglabels/libglabels.args +/docs/libglabels/libglabels.hierarchy +/docs/libglabels/libglabels.interfaces +/docs/libglabels/libglabels.prerequisites +/docs/libglabels/libglabels.signals + +# +# Ignore artifacts from editors, patching, etc. +# +*~ +*.bak +.*.swp +*.orig +*.rej +*.patch diff --git a/help/C/figures/main-window-empty.png b/help/C/figures/main-window-empty.png index 305bd609..94a2ab4e 100644 Binary files a/help/C/figures/main-window-empty.png and b/help/C/figures/main-window-empty.png differ diff --git a/help/C/figures/merge-ex1-1.png b/help/C/figures/merge-ex1-1.png index f8673c1d..72221b95 100644 Binary files a/help/C/figures/merge-ex1-1.png and b/help/C/figures/merge-ex1-1.png differ diff --git a/help/C/figures/merge-ex1-2.png b/help/C/figures/merge-ex1-2.png index a87675aa..37ea403c 100644 Binary files a/help/C/figures/merge-ex1-2.png and b/help/C/figures/merge-ex1-2.png differ diff --git a/help/C/figures/merge-ex1-3.png b/help/C/figures/merge-ex1-3.png index f31ecafe..ede4240a 100644 Binary files a/help/C/figures/merge-ex1-3.png and b/help/C/figures/merge-ex1-3.png differ diff --git a/help/C/figures/merge-ex1-4.png b/help/C/figures/merge-ex1-4.png index 71e11864..808aef68 100644 Binary files a/help/C/figures/merge-ex1-4.png and b/help/C/figures/merge-ex1-4.png differ diff --git a/help/C/figures/merge-ex2-1.png b/help/C/figures/merge-ex2-1.png index 1c64ed76..a41e3d67 100644 Binary files a/help/C/figures/merge-ex2-1.png and b/help/C/figures/merge-ex2-1.png differ diff --git a/help/C/figures/merge-ex2-2.png b/help/C/figures/merge-ex2-2.png index e1d8f2af..5de11e0b 100644 Binary files a/help/C/figures/merge-ex2-2.png and b/help/C/figures/merge-ex2-2.png differ diff --git a/help/C/figures/merge-ex2-3.png b/help/C/figures/merge-ex2-3.png index baac803a..c222d9cd 100644 Binary files a/help/C/figures/merge-ex2-3.png and b/help/C/figures/merge-ex2-3.png differ diff --git a/help/C/figures/merge-ex2-4.png b/help/C/figures/merge-ex2-4.png index 62d750c6..73996dd9 100644 Binary files a/help/C/figures/merge-ex2-4.png and b/help/C/figures/merge-ex2-4.png differ diff --git a/help/C/figures/merge-ex3-1.png b/help/C/figures/merge-ex3-1.png new file mode 100644 index 00000000..0ef304ff Binary files /dev/null and b/help/C/figures/merge-ex3-1.png differ diff --git a/help/C/figures/merge-ex3-2.png b/help/C/figures/merge-ex3-2.png new file mode 100644 index 00000000..b66fcfc4 Binary files /dev/null and b/help/C/figures/merge-ex3-2.png differ diff --git a/help/C/figures/object-editor-sidebar.png b/help/C/figures/object-editor-sidebar.png index f0624a26..1c414263 100644 Binary files a/help/C/figures/object-editor-sidebar.png and b/help/C/figures/object-editor-sidebar.png differ diff --git a/help/C/figures/print-copies.png b/help/C/figures/print-copies.png index d34d03c9..029add80 100644 Binary files a/help/C/figures/print-copies.png and b/help/C/figures/print-copies.png differ diff --git a/help/C/figures/print-merge.png b/help/C/figures/print-merge.png index de654d09..86f2e929 100644 Binary files a/help/C/figures/print-merge.png and b/help/C/figures/print-merge.png differ diff --git a/help/C/glabels.xml b/help/C/glabels.xml index 648dbecb..8e17cb3d 100644 --- a/help/C/glabels.xml +++ b/help/C/glabels.xml @@ -2,8 +2,8 @@ - - + + gLabels"> - gLabels Manual V&manrevision; - &date; + gLabels Manual V2.2.6 + October 2009 + + Mario Blättermann + mariobl@gnome.org + + Jim Evins + + + + gLabels Manual V2.2 + December 2007 Jim Evins evins@snaught.com @@ -425,7 +435,7 @@ Print control (Simple) - For simple labels or cards (no document merge), the job + For simple labels or cards (no document merge), the labels tabbed section contains the following copy controls. @@ -457,7 +467,7 @@ For labels or cards using the document merge (also known - as "mail merge") capability, the job tabbed section contains + as "mail merge") capability, the labels tabbed section contains the following merge controls instead of copy controls. @@ -1188,7 +1198,7 @@ feature. - Example 1: Name Tags + Example 1: Name Tags Using a CSV File 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 @@ -1303,7 +1313,7 @@ Name,Department,SN - Example 2: Address Labels + Example 2: Address Labels Using a CSV File 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 @@ -1417,6 +1427,120 @@ Kramer,Cosmo,,"Apt 5B","129 W. 81 St.","New York",NY,10024-7207 + + Example 3: Address Labels Using the <application>Evolution</application> Addressbook + + Our last party was a great success, and now we need to print mailing + address labels for the invitations to a new one. To simplify this, we can use + the Evolution addressbook, because the address + data of all our friends is stored there. + + + Depending on how your copy of &app; was packaged, this option could be unavailable. + Support for the Evolution addressbook will only be available + if the evolution-data-server and its development files + were present when &app; was built. Please keep this in mind if you build &app; + directly from source. + + If the &app; package from your distribution lacks this support, + you may wish to contact the package maintainer or file a bug against the package + to request it. + + + In glabels we have created a new &app; + 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 Data from default Evolution + addressbook) as shown. + + +
+ Merge properties dialog + + + + + + +
+ + + Once we have chosen Data from default Evolution addressbook + as our merge source, we will get a full list of its content. Initially, + all entries are checked. Assuming we were planning a really big party, we could + leave this selection untouched (but let's keep our budget in mind). We will now select or + unselect certain entries by clicking on the appropriate checkboxes, or we could use + the Select all and Unselect all + buttons to activate or deactivate all entries in the address book. + + We can also view each entry 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 will click the OK button 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 again. This text object contains + all of our merge fields organized on multiple lines as a mailing address. + + Now we can print our address labels by selecting the + File + Print menu item. This will display + the print dialog as shown below. + + +
+ Printing address labels + + + + + + +
+ + + 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. + + +
+ Address labels 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. + + + diff --git a/help/Makefile.am b/help/Makefile.am index 708fb593..1d72e504 100644 --- a/help/Makefile.am +++ b/help/Makefile.am @@ -17,6 +17,8 @@ DOC_FIGURES = figures/glabels-template-cd.png \ figures/merge-ex2-2.png \ figures/merge-ex2-3.png \ figures/merge-ex2-4.png \ + figures/merge-ex3-1.png \ + figures/merge-ex3-2.png \ figures/object-editor-sidebar.png \ figures/print-copies.png \ figures/print-merge.png