--- zoph-0.7.5.orig/bin/zophExport.pl +++ zoph-0.7.5/bin/zophExport.pl @@ -153,7 +153,7 @@ exit(1); } -print "zophExport.pl $version\n"; +print "zophExport $version\n"; # do it export(); @@ -168,8 +168,8 @@ # sub printUsage { print - "zophExport.pl $version\n" . - "Usage: zophExport.pl --dir
Name Last modified Size Description +
+ Parent Directory 15-Aug-2005 14:32 - + CHANGES 15-Aug-2005 22:10 1k + INSTALL 15-Aug-2005 22:20 1k + LICENSE 15-Aug-2005 13:58 18k + Makefile 15-Aug-2005 22:20 1k + _README 15-Aug-2005 13:58 1k + addgrpphoto.sh 15-Aug-2005 22:10 1k + en_load_photos 15-Aug-2005 13:58 1k + fr_load_photos 15-Aug-2005 22:35 1k + load_photos 15-Aug-2005 23:39 14k + load_photos_V1.4 15-Aug-2005 13:58 11k + load_photos_V1.5 15-Aug-2005 13:58 12k + load_photos_V1.6 15-Aug-2005 23:39 14k +
+ load_photos is a bash interactive front-end to zophImport, the photo + loader of zoph, web based photos album. + <URL:http://zoph.sourceforge.net/demo/zoph.php> + + It permit to everyone to load photos in the family album, as so as + to use all zophImport options. + + load_photos use qiv to display images, exiftran to fix them as portrait, + jhead to extract and keep exif informations, gimp to tidy photos, + at to make in backround the (so) long importation work. + + load_photos is I10n (Internationalized) in, at time, + (I think bad) English and French. + + syntax: load_photos --help + + installation: see INSTALL ++ --- zoph-0.7.5.orig/debian/contrib/load_photos/load_photos +++ zoph-0.7.5/debian/contrib/load_photos/load_photos @@ -0,0 +1,585 @@ +#!/bin/bash + +#V 1.6 +# front-end to zophImport +# Copyright (C) 2005, Thomas HARDING. thomas.harding@laposte.net +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# +#
Zoph automatically creates thumbnails and medium sized ('mid') images during import. To influence this proces, you can edit the following parameters:
The options in this section have a matching setting in ZophImport. These have to be set the same.
The options in this section have a matching setting in ZophImport.pl. These have to be set the same.
The options in this section have a matching setting in ZophImport. These have to be set the same.
The options in this section have a matching setting in ZophImport.pl. These have to be set the same.
Because Perl does not like it when the last assignment of the file is negative.
- -Or some other directory in your PATH.
A man page for zophImport.pl is in the man/ directory. Copy this to somewhere in your manpath, /usr/local/man/man1 for example.
+A man page for zophImport is in the man/ directory. Copy this to somewhere in your manpath, /usr/local/man/man1 for example.
Try hitting http://localhost/zoph/logon.php. You should be presented with the logon screen. Log in using "admin" for user and "admin" for password.
--- zoph-0.7.5.orig/docs/upgrading.html +++ zoph-0.7.5/docs/upgrading.html @@ -208,7 +208,7 @@As of v0.7, you can set some defaults for zophImport.pl from .zophrc. The example file zophrc.sample has been updated with these settings:
+As of v0.7, you can set some defaults for zophImport from .zophrc. The example file zophrc.sample has been updated with these settings:
$datedDirs = 0; $copy = 0; @@ -216,7 +216,7 @@ $verbose = 0; $resolveSymlinks = 0;-
zophImport.pl now has an option to resolve symlinks during import. For more details, see Using the commandline tools
+zophImport now has an option to resolve symlinks during import. For more details, see Using the commandline tools
Copy php/* to the location of your installation. Make sure to also copy the php/lang subdirectory.
@@ -258,7 +258,7 @@As of v0.6, no settings need to be made in zophImport.pl and <zophExport.pl, it is replaced by a settings file .zophrc in the home directory of the user that runs these scripts. An example file called zophrc.sample is included with Zoph:
+As of v0.6, no settings need to be made in zophImport and <zophExport, it is replaced by a settings file .zophrc in the home directory of the user that runs these scripts. An example file called zophrc.sample is included with Zoph:
#----------------------------------------- # Configuration file for Zoph @@ -387,7 +387,7 @@Updating configuration
A number of configuration items have been added since v0.3.3. You can use the list below to update your current configuration file, or simply use the one in the distribution and change it to your needs.
-Set DB_PREFIX to a prefix for each tablename, see db update for details. Suggested is to use 'zoph_', as this will be the default in future releases. Make sure $db_prefix in zophImport.pl and zophExport.pl matches this setting.
+Set DB_PREFIX to a prefix for each tablename, see db update for details. Suggested is to use 'zoph_', as this will be the default in future releases. Make sure $db_prefix in zophImport and zophExport matches this setting.
Much of the style information has been removed from the HTML code and is now in a separate CSS file. Please set CSS_SHEET to 'css.php' to load the CSS file.
You can now choose the authentication method used by zoph; set $VALIDATOR accordingly. Possible choices:
'default_validate':
@@ -436,7 +436,7 @@Another new feature is the addition of a pref to let photo descriptions appear under the thumbnails. The MAX_THUMB_DESC config sets the maximum number of characters to display.
A New Export Script
-You'll find a new perl script in this release, bin/zophExport.pl, which can be used to create static html galleries of your photos. See the manual for more info.
+You'll find a new perl script in this release, bin/zophExport, which can be used to create static html galleries of your photos. See the manual for more info.
Zoph 0.3.1 -> 0.3.2 Upgrade
If you are upgrading from a version previous to 0.3.1, please run the older database updates first.
@@ -451,7 +451,7 @@Updating the Templates
Copy over php/* to the location of your installation. Make sure to also copy the php/lang subdirectory as there are additions to the language files. Also included in this release are the htmlized docs, in the php/docs/ directory, if you want them.
There are two new additions to config.inc.php: a VERSION variable and the DEFAULT_SHOW_ALL setting. The DEFAULT_SHOW_ALL setting makes all people or places shown by default when you visit the people or places pages. If you don't have hundreds of records this is probably more convenient than defaulting to 'a'. It is enabled by default.
-That's it for this release, but I'll mention one bug fix for a problem a few users may have noticed: if you used zophImport.pl to load images that were on a different filesystem than your images directory, everything would apparently work but the original images would not be copied. You might not have even noticed the images were missing unless you tried to view the full sized images in your browser. This release fixes this problem and makes sure other sorts of silent failure won't occur.
+That's it for this release, but I'll mention one bug fix for a problem a few users may have noticed: if you used zophImport to load images that were on a different filesystem than your images directory, everything would apparently work but the original images would not be copied. You might not have even noticed the images were missing unless you tried to view the full sized images in your browser. This release fixes this problem and makes sure other sorts of silent failure won't occur.
Zoph 0.3 -> 0.3.1 Upgrade
If you are upgrading from a version less than 0.3, please run the previous database updates first.
@@ -489,12 +489,12 @@In versions of Zoph prior to 0.3, thumbnails were generated as the same file type as the original image (a jpeg image would have jpeg thumbnails, a gif image gif thumbnails, etc). As it may be desirable to instead have all thumbnails be the same type (there probably is no need, for example, to create uncompressed tiff thumbnails of tiff images), Zoph 0.3 allows you to specify that all thumbnails should be of the same type.
If all your images are the same type or if you don't mind having different sorts of thumbnails, you can skip this.
The default settings maintain compatibility with previous versions. If you would like to switch to a single thumbnail format, do the following:
-In zophImport.pl
+In zophImport
In config.inc.php set MIXED_THUMBNAILS and THUMB_EXTENSION to the same values as zophImport.pl.
+In config.inc.php set MIXED_THUMBNAILS and THUMB_EXTENSION to the same values as zophImport.
If you make this change and have previously generated thumbnails with an extension different from THUMB_EXTENSION, you will need to regenerate the old thumbnails. A command like the following can take care of that (this one finds gifs and makes jpgs):
> find images/ -name "thumb_*.gif" -o -name "mid_*.gif" | perl -nle '$old = $_; s/\.(\w+)$/.jpg/; $cmd = "convert $old $_"; print $cmd; system($cmd);' --- zoph-0.7.5.orig/docs/using_the_commandline_tools.html +++ zoph-0.7.5/docs/using_the_commandline_tools.html @@ -17,7 +17,7 @@Contents
This section describes the command line Perl importer. The next one talks about the web based importer.
@@ -72,7 +72,7 @@> ls ~/incoming DCP_0155.JPG -> zophImport.pl --path dc280 --datedDirs ~/incoming/*.JPG +> zophImport --path dc280 --datedDirs ~/incoming/*.JPG
The --path flag tells the importer I want the photos to be put in the dc280 directory. The --datedDirs flag means that the photo should be put in a subdirectory based on the date field found in the photos Exif header. After running the script:
@@ -81,13 +81,13 @@ > ls dc280/2002.03.14 DCP_0155.JPG mid thumb-
The mid/ and thumb/ directories hold images scaled down to 120 and 480 pixels respectively. If you wonder why zophImport.pl takes so long to import photos it is because it is creating these two smaller images (using ImageMagick's convert utility).
+The mid/ and thumb/ directories hold images scaled down to 120 and 480 pixels respectively. If you wonder why zophImport takes so long to import photos it is because it is creating these two smaller images (using ImageMagick's convert utility).
What if you don't want to use dated directories to store your images? Here is an alternative way:
> pwd /home/jgeiger/photos > mkdir christmas_2001 -> zophImport.pl --path christmas_2001 ~/incoming/*.JPG +> zophImport --path christmas_2001 ~/incoming/*.JPG > ls christmas_2001 DCP_0155.JPG mid thumb@@ -95,7 +95,7 @@
> mkdir christmas_2001 > mv ~/incoming/*.JPG christmas_2001/ -> zophImport.pl christmas_2001/*.JPG +> zophImport christmas_2001/*.JPG
By not specifying a path, the importer uses the path that the photos are currently in.
Whatever way you import photos, make sure you run the script from within your photos directory (as specified by IMAGE_DIR). The importer needs to be able to correctly extract the relative path to the photos from here to be stored in the database.
@@ -106,12 +106,12 @@> pwd /home/jgeiger/photos -> zophImport.pl --path dc280 --datedDirs --photographer "Jason Geiger" --location "Jason's Apartment" --album "Zoph Tutorial" ~/incoming/*.JPG +> zophImport --path dc280 --datedDirs --photographer "Jason Geiger" --location "Jason's Apartment" --album "Zoph Tutorial" ~/incoming/*.JPG
To use the --photographer, --location and --album parameters, corresponding records must have been previously created in Zoph. So first create a person/place/album/category using the web interface, then import using them.
What if you made a mistake, or remembered a piece of information you want to add? Pass the --update parameter so that the photos will not be inserted again:
-> zophImport.pl --update --field rating=5 --field description="This is part of the zoph tutorial" dc280/2002.03.14/*.JPG +> zophImport --update --field rating=5 --field description="This is part of the zoph tutorial" dc280/2002.03.14/*.JPG
This will set the rating and description for all the photos I just imported. To set any of the fields found in the photos table (such as rating, title, description, etc), use the --field NAME=VALUE flag.
For more info and examples about the importer, see the section at the end of this document.
@@ -120,7 +120,7 @@It is not uncommon to make a mistake while loading images so that when you view the ui you see a bunch of broken images. This most likely due to an invalid path. To check, edit one of the images in Zoph and click on "show additional attributes" at the bottom. Then you should be able to see the path info. It should always be the case that WEB_IMAGE_PATH (or IMAGE_PATH) + the photo's path field + the photo's name reflects the photo's location.
You can use the importer to correct the paths for broken images:
-> zophImport.pl --update --path 'dc280/2002.03.14' dc280/2002.03.14/*.JPG +> zophImport --update --path 'dc280/2002.03.14' dc280/2002.03.14/*.JPG
If you still see broken images, check the permissions on the files and directories.
@@ -170,44 +170,44 @@Below are a couple more examples.
Adding a list of people to a photo (if there are many people it is often faster to do this using the importer rather than through the web ui):
-> zophImport.pl --update --people "Jason Geiger, Virginia Wolfe" dc280/2002.03.14/DCP_0155.JPG +> zophImport --update --people "Jason Geiger, Virginia Wolfe" dc280/2002.03.14/DCP_0155.JPG
People should be listed left to right, front to back. These people must already be the database. If one of the names could not be found the importer will complain.
Updating all the photos in a directory:
-> find dc280/ -iname "*.jpg" -maxdepth 2 | xargs zophImport.pl --updateSize +> find dc280/ -iname "*.jpg" -maxdepth 2 | xargs zophImport --updateSize
You may want to use the --updateSize option like above if you had rotated or resized a bunch of images and wanted to get the correct dimensions into zoph. Specifying a maxdepth prevents the thumbnails from being included.
Starting in version 0.3 of the importer you can also update photos based on their photo_ids rather than names. Say you notice couple sequences of of your photos have an incorrect location. You can see the photo_id for a photos in the url and it may be simpler to update based on that rather than by passing the file names:
-> zophImport.pl --update --useIds --location "Yuka's House" 1562-1571 1580-1585 +> zophImport --update --useIds --location "Yuka's House" 1562-1571 1580-1585-
As of version 0.7, you can influence the way zophImport.pl handles symbolic links.
+As of version 0.7, you can influence the way zophImport handles symbolic links.
For example, you have the following files IMG_0001.JPG, IMG_0002.JPG, both taken 01-01-2007 and LNK_0002.JPG, which is a symlink to IMG_0002.JPG.
If you would import these files with
-zophImport.pl --datedDirs IMG_0001.JPG LNK_0002.JPG +zophImport --datedDirs IMG_0001.JPG LNK_0002.JPG
You would have two files in 2007.01.01: IMG_0001.JPG and LNK_0002.JPG - both will be "normal" files. You will also have IMG_0002.JPG, still in it's old location.
If you would import these files with
-zophImport.pl --datedDirs --resolveSymlinks IMG_0001.JPG LNK_0002.JPG +zophImport --datedDirs --resolveSymlinks IMG_0001.JPG LNK_0002.JPG
You would have two files in 2007.01.01: IMG_0001.JPG and IMG_0002.JPG - both will be "normal" files. You will also have IMG_0002.JPG, still in it's old location.
Based on a suggestion from Alan Shutko, in version 0.3.1 of zophImport.pl I added +profile "*" to the calls to convert. (And in 0.3.3 I commented out this since for some users multiple thumbnails were being generated for an image. I did not see this problem, maybe it was a shell expansion issue. For most people it probably works so you may want to re-enable this feature.)
+Based on a suggestion from Alan Shutko, in version 0.3.1 of zophImport I added +profile "*" to the calls to convert. (And in 0.3.3 I commented out this since for some users multiple thumbnails were being generated for an image. I did not see this problem, maybe it was a shell expansion issue. For most people it probably works so you may want to re-enable this feature.)
From http://www.imagemagick.org/www/convert.html:
"The '+profile "*"' removes any ICM, EXIF, IPTC, or other profiles that might be present in the input and aren't needed in the thumbnail."
This can result in a significant reduction in file sizes. If you do wish to preserve the profiles, remove this argument to convert.
Also, if you wish to regenerate your thumbnails after this change to save space, you can run a command like this from your image directory:
-> find . -iname "*.jpg" -a -not -name "mid_*" -a -not -name "thumb_*" | xargs zophImport.pl --update --thumbnails +> find . -iname "*.jpg" -a -not -name "mid_*" -a -not -name "thumb_*" | xargs zophImport --update --thumbnails- -
Zoph is a dynamic sort of application tied closely to the database. But sometimes you want static html files of your photos to burn to a cd or whatnot. Zoph includes a perl script, zophExport.pl, that lets you easily create static galleries.
-There are numerous programs whose focus is to generate these sorts of static photo albums. Though I included a very simple built-in static album generator, zophExport.pl is primarily intended to be used with other scripts. Currently two such programs are supported:
+ +Zoph is a dynamic sort of application tied closely to the database. But sometimes you want static html files of your photos to burn to a cd or whatnot. Zoph includes a perl script, zophExport, that lets you easily create static galleries.
+There are numerous programs whose focus is to generate these sorts of static photo albums. Though I included a very simple built-in static album generator, zophExport is primarily intended to be used with other scripts. Currently two such programs are supported:
Here is a command that creates an export for use with the album program:
-> zophExport.pl --dir "~/Winter Pics" --format album --category Snow +> zophExport --dir "~/Winter Pics" --format album --category Snow-
After the exporter finishes it's up to you to run album. zophExport.pl prints out an example command to run album which you can copy and run as is or update with your own options.
-In this simple example all photos placed in the Snow category are exported. Within the "Winter Pics" directory zophExport.pl will have created a directory structure mirroring the album structure in Zoph for the selected photos.
+After the exporter finishes it's up to you to run album. zophExport prints out an example command to run album which you can copy and run as is or update with your own options.
+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.
There are only two required arguments: the directory to export to (--dir) which will be created if it does not exist, and the format of the export (--format) which currently must be either "zoph", "album" or "bins".
Fields to search by are specified in the same was as in zophImport.pl. For example, you can say
+Fields to search by are specified in the same was as in zophImport. For example, you can say
-> zophExport.pl --dir "~/My Album" --format album --album "Boston Trip" --photographer "Jason Geiger" --field rating=5 +> 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). You can disable this by passing --nosubalbums. The same goes for categories (use --nosubcategories to disable). Most fields match using the equals operator. Two exceptions are rating (which defaults to >=) and description (which defaults to like).
-You can probably do most things you want by using this system, especially since you can run zophExport.pl multiple times with different parameters, and even edit the results by hand if you wish, before you run album or bins to generate the galleries.
+You can probably do most things you want by using this system, especially since you can run zophExport multiple times with different parameters, and even edit the results by hand if you wish, before you run album or bins to generate the galleries.
But if you have a particularly complicated query you want to run you can just pass it in directly using the --sql argument. Your query must select * from the photos table, other than that it can be anything. If you pass a sql statement any other constraint arguments are ignored. Make sure to only pass select statements, the script does no checking to make sure you aren't deleting all your data
-Here's a tip if you run a complicated search within Zoph and then want to export only those photos. After you get to the results page open up config.inc.php and set DEBUG to 2. Then reload the results page and you should see two sql queries at the top of the page. Copy the first (the count query) and replace "count(distinct ph.photo_id)" with "ph.*", append "order by ph.date asc, ph.time asc" and pass this to zophExport.pl using the --sql argument.
+Here's a tip if you run a complicated search within Zoph and then want to export only those photos. After you get to the results page open up config.inc.php and set DEBUG to 2. Then reload the results page and you should see two sql queries at the top of the page. Copy the first (the count query) and replace "count(distinct ph.photo_id)" with "ph.*", append "order by ph.date asc, ph.time asc" and pass this to zophExport using the --sql argument.
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.
+By default zophExport 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).
The exporter can translate field labels using the same language files that Zoph uses. Pass --lang /path/to/php/lang/file to enable this option.
By default the exporter creates directories to mirror the structure of the albums in which the exported photos appear. To disable this and have all the photos appear directly under the export dir use the --noalbumdirs flag.
The exporter contains the ability to generate a very simple static gallery. To use the simple exporter, pass --format zoph to zophExport.pl.
+The exporter contains the ability to generate a very simple static gallery. To use the simple exporter, pass --format zoph to zophExport.
There are two advantages to this format. The first is that it requires no additional software. The second is speed. The simple format is much much faster simply because it uses the thumbnails already generated by Zoph whereas album and BINS generate their own. Someone could probably alter album or BINS so that they could reuse the thumbnails.
-There's not really any elegant way to change the appearance of the gallery generated by this exporter. To do so you probably would want to edit zophExport.pl. It wouldn't be too difficult to add css support but I didn't. I only wanted to spend so much time reinventing the wheel.
+There's not really any elegant way to change the appearance of the gallery generated by this exporter. To do so you probably would want to edit zophExport. It wouldn't be too difficult to add css support but I didn't. I only wanted to spend so much time reinventing the wheel.
album is written by David Ljung Madison. http://marginalhacks.com/Hacks/album/
album is a single perl script which requires nothing more than you already have from using Zoph (ImageMagick and Image::Size). A debian package is available.
-To use album, specify --format album to zophExport.pl. The exporter will create a captions.txt file in each directory that contains images.
+To use album, specify --format album to zophExport. The exporter will create a captions.txt file in each directory that contains images.
Album is themeable and a number of themes are available from the website. I'd recommend you download a different theme, or create your own, simply because the default theme displays all of the info about a photo on the thumbnails page which can be quite a bit if you include descriptions and exif data. You specify a theme by passing -theme /path/to/theme/dir to album.
BINS is written by Jerome Sautret, based on SWIGS, written by Brendan McMahan, which was in turn based on IDS by John Moose. http://bins.sautret.org/
BINS consists of three perl scripts: an exporter and two image/album description editors. A debian package is available. BINS requires a number of perl modules which you can get from CPAN if you need to.
-To use BINS, specify --format bins to zophExport.pl. The exporter will create an image.jpg.xml file for each photo and an album.xml file in each directory.
-BINS takes a source directory and a target directory. zophExport.pl will create the target directory based on the --dir you specify. It will also append ".tmp" to the target directory name and create another directory to which it will copy the images from Zoph and which will act as the source dir for BINS. You can remove this temp dir after BINS finishes. You can set the source and target directory to the same dir in BINS but you can only run BINS against that directory once, after that it will start creating thumbnails of the thumbnails, etc.
+To use BINS, specify --format bins to zophExport. The exporter will create an image.jpg.xml file for each photo and an album.xml file in each directory.
+BINS takes a source directory and a target directory. zophExport will create the target directory based on the --dir you specify. It will also append ".tmp" to the target directory name and create another directory to which it will copy the images from Zoph and which will act as the source dir for BINS. You can remove this temp dir after BINS finishes. You can set the source and target directory to the same dir in BINS but you can only run BINS against that directory once, after that it will start creating thumbnails of the thumbnails, etc.
You can create a config xml file for BINS to use. I found it useful to set the defaultSize parameter to 0 (default to small images).
--- zoph-0.7.5.orig/docs/using_the_webinterface.html +++ zoph-0.7.5/docs/using_the_webinterface.html @@ -139,7 +139,7 @@The web based importer is a new template in Zoph 0.3 that provides an alternative to the command line importer, zophImport.pl. This template does not yet contain all the functionality of zophImport.pl.
+The web based importer is a new template in Zoph 0.3 that provides an alternative to the command line importer, zophImport. This template does not yet contain all the functionality of zophImport.
To use the importer, at least one of CLIENT_WEB_IMPORT and SERVER_WEB_IMPORT must be set to 1 in config.inc.php and you must be logged in as either an admin or a user that has been granted permission to import.
Enable CLIENT_WEB_IMPORT to upload files through the web-interface using a 'browse' button, and enable SERVER_WEB_IMPORT to import files through the web-interface for files that are already on the server. CLIENT_WEB_IMPORT and SERVER_WEB_IMPORT may be both activated.
If you are going to be importing directories of photos you will probably need to increase the size of max_execution_time in php.ini. The default is 30 seconds but you will probably need this to be a couple minutes or more, depending on how many images you import and how fast your computer is.