Provided by: zoph_0.8.0.1-1_all bug

NAME

       zophExport - Export images from zoph to static albums

SYNTAX

       zophExport  [--help]  --dir  dir  --format  zoph|album|bins  [--album "album"] [--category
       "category [, category]"] [--photographer  "first_name  last_name"]  [--people  "first_name
       last_name  [,  first_name  last_name]"] [--location ["place_title"] [--field name="value"]
       [--sql    sql_statement]     [--lang     file]     [--[no]albumdirs]     [--[no]subalbums]
       [--[no]subcategories]       [--[no]showdate]       [--[no]showtitle]      [--[no]showview]
       [--[no]showpeople] [--[no]showphotographer]  [--[no]showlocation]  [--[no]showdescription]
       [--[no]showexif] [--[no]showfooter]

DESCRIPTION

       zophExport  is  the  command  line exporter for the zoph (Zoph Organizes PHotos) web photo
       management system.  Specify the destination of the export using --dir and  the  format  of
       the  export  using  --format.   The format must be one of "zoph", "album", or "bins".  The
       zoph format creates a gallery using  a  simple,  built-in  generator.   The  album  format
       creates  an  export  compatible with the album program,  the bins format creates an export
       compatible with the bins program.
       Photos can appear in multiple albums and categories, and  multiple  people  can  be  in  a
       photo. To handle this, you can either pass a comma separated list or set the flag multiple
       times. Actually, you can use a comma separated list for categories and people but not  for
       albums  (since  I realized that I have many albums with commas in their names and have yet
       to build an escape mechanism).
       The exporter creates static albums in various formats to be used  on  webhosting  services
       where  you  don't  have MySQL, when you don't want all your pictures to be published or to
       burn them onto a CD for offline-browsing. Multiple options are  ANDed,  cutting  down  the
       resulting  set  of  images.  The set can be increased again by running zophExport multiple
       times. SQL hackers can select images by arbitrary SQL statements and finally  the  set  of
       images can be modified manually before transfer to the web host or CD.
       Most  fields match using the equals operator. Two exceptions are rating (which defaults to
       >=) and description (which defaults to like).

OPTIONS

       The `"' around arguments are needed to prevent breaking up around whitespace or the  shell
       interpreting special characters. If an album e.g. is called hugo you can omit them.

       --help

              lists all supported options and quits

       --dir dir

              toplevel directory for exported hierarchy

       --format zoph|album|bins

              the  format to use: zoph is a very simple yet quick built-in format (the thumbnails
              don't have to be calculated, no additional software needed), album for David  Ljung
              Madisons  "Album"  script  (http://marginalhacks.com/Hacks/album/  )  and  bins for
              Jérôme Sautrets "bins" script (http://bins.sautret.org/ ); both  are  available  as
              Debian packages

       --album "album"

              select the album(s) to export

       --category "category [, category]"

              select the category(s) to export

       --photographer "first_name last_name"

              select the photographer whose pictures should be exported

       --people "first_name last_name [, first_name last_name]"

              select pictures by the people being shown

       --location "place_title"

              select pictures by location being shown

       --field name="value"

              select  pictures  by  its field name; common fields are title (text, 64 chars max),
              view (text, 64 chars max), description (text), rating  (1..10)  or  level  (1..10);
              possible fields are from the MySQL database, table photos;

       --sql sql_statement

              select pictures by self-defined SQL statement

       --lang file

              The  exporter  can  translate  field labels using the same language files that Zoph
              uses. Pass --lang /usr/share/zoph/lang/XX to enable this option.

       The following options can be used with or without "no" prepended. The default behaviour is
       without "no", explained is the option when used with "no".

       --[no]albumdirs

              By  default  the exporter creates directories to mirror the structure of the albums
              in which the exported photos appear. Use this flag to disable  this  and  have  all
              images exported into the given directory dir.

       --[no]subalbums

              don't export subalbums below the selected one

       --[no]subcategories

              don't export subcategories below the selected one

       By default zophExport.pl will export everything about your photos except the last modified
       time, the rating and the albums or categories in which the photo appears.  To prevent  the
       display   of   a   particular   field,  use  the  --noshowFIELD  argument.   For  example:
       --noshowlocation or --noshowdescription. Passing --noshowexif prevents any exif info  from
       being shown. (Note, however, that the BINS program extracts exif info on its own).

       --[no]showdate

              don't export the date

       --[no]showtitle

              don't export the title

       --[no]showview

              don't export the view

       --[no]showpeople

              don't export the people's names

       --[no]showphotographer

              don't export the photographer's name

       --[no]showlocation

              don't export the location

       --[no]showdescription

              don't export the description

       --[no]showexif

              don't export the Exif data

       --[no]showfooter

              don't show a footer

EXAMPLES

              zophExport --dir "~/Winter Pics" --format album --category Snow

       In  this  simple  example all photos placed in the Snow category are exported.  Within the
       "Winter Pics" directory zophExport will have created a directory structure  mirroring  the
       album structure in Zoph for the selected photos.

              zophExport  --dir  "~/My Album" --format album --album "Boston Trip" --photographer
              "Jason Geiger" --field rating=5

       Only photos I took on my trip to Boston that I rated 5  or  more  would  be  exported.  By
       default  subalbums  of  an album are automatically included (so my "Duck Tour" subalbum is
       also exported).

CONFIGURATION FILE

       Configuration for both zophImport.pl and zophExport.pl are stored in $HOME\.   zophrc.  An
       example  file  is  included with Zoph.  The following settings need to be made in order to
       make zophImport.pl and zophEx port.pl work:

       $db_host:

              Hostname or IP address of your MySQL server.

       $db_name:

              Name of the database.

       $db_user:

              Username Zoph should use to log on to the MySQL server.

       $db_pass:

              Password Zoph should use.

       $db_prefix:

              Prefix to include before each tablename (in order to enable  sharing  of  the  Zoph
              database  with  other apps - for example if you have a limitted number of databases
              with your hosting account).

       $image_dir:

              Location of your photos. Make sure it ends with /.  Note that these settings should
              have a matching entry in config.inc.php.

AUTHORS

       zoph  was  written  by Jason Geiger <zoph@nother.net> and is now maintained by Jeroen Roos
       <zoph@roosnet.demon.nl>

       this manpage was created by Edelhard Becker <becker@edelhard.de>  and  updated  by  Jeroen
       Roos <zoph@roosnet.demon.nl>

SEE ALSO

       zophImport(1), http://localhost/doc/zoph/manual.html, http://en.wikibooks.org/wiki/Zoph
       http://marginalhacks.com/Hacks/album/
       http://bins.sautret.org/