git.sur5r.net Git - glabels/blob - glabels2/README

   1 Copyright
   2 =========
   3
   4    gLabels - a GNOME-based label and business card creation program
   5
   6    Copyright (C) 2001-2003 Jim Evins
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 2 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program; if not, write to the Free Software
  20    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21
  22    For more details see the file COPYING.
  23
  24
  25
  26 What is gLabels
  27 ===============
  28
  29 gLabels is a small stand-alone program for creating labels and business
  30 cards using a laser or ink-jet printer.
  31
  32
  33 System Requirements
  34 ===================
  35
  36 GTK+-2.0.x
  37 LIBGNOMEUI-2.0.x
  38 LIBXML-2.4.x
  39 LIBGNOMEPRINT-2.2.x
  40 LIBGNOMEPRINTUI-2.2.x
  41 LIBGNOMECANVAS-2.0.x
  42
  43 All of these libraries are available as part of Gnome 2.2
  44
  45 Usage notes:
  46 ============
  47 gLabels is still in its early stages of development and thus lacks any
  48 "real" documentation.  Most folks have found it fairly easy to use, at
  49 least for its simple composition features.  Beginning with version 0.4.x,
  50 gLabels has a document-merge capability that might not be as intuitive
  51 as these other features.
  52
  53 The first step to performing a document merge is to prepare a source
  54 document that contains your merge data. This data could be mailing
  55 addresses or any other data that you wish to create unique labels or
  56 cards for.  Currently only a simple back-end for text files exists --
  57 others are planned.  The currently supported text-file format is very
  58 simple:  each line is a record; fields are delimited by tabs,
  59 commas, or colons; and newlines can be embedded into fields by using
  60 the "\n" entity.  This file could be created using any text editor or
  61 could be created by another program or script.
  62
  63 A label must then be configured to "point at" this data file.  This is
  64 accomplished with the "merge properties" dialog.  This dialog is used
  65 to select the exact data file format and file name (location).
  66
  67 Finally, once the label has been configured for a data file, field keys
  68 can be inserted into text and barcode objects in their property dialogs.
  69
  70 Now that your label is configured, gLabels will print a unique label for
  71 each record in your source document -- substituting fields from each
  72 record for field keys in the all text and barcode objects.
  73
  74 Beginning with 0.4.3, a simple CLI front-end called "glabels-batch" is
  75 provided to print previously created glabels files from a shell,
  76 other programs or scripts.  Do a "glabels-batch --help" for usage
  77 information.
  78
  79 Author and Acknowledgments:
  80 ===========================
  81
  82 See the AUTHORS file.
  83
  84
  85 Website
  86 =======
  87
  88 http://glabels.sourceforge.net/
  89