README - photo-imp in Photo Imp

Photo Imp
=========

Photo Imp displays the photos in a directory using the PrettyPhoto javascript
library.
Main page: http://aurelien.bompard.org/projects/photo-imp
Development page: http://gitorious.org/photo-imp
Demo: http://aurelien.bompard.org/photos/

Usage:
- copy the "config.default.ini" file to "config.ini" and edit it if necessary.
- upload this directory to your web server, for example in the
  "/photo-imp" path. This path will be called "indexer directory".
- create another directory on your web server for your galleries. It will be
  called "gallery directory".
- create a .htaccess file in your gallery directory with the following
  content :
    Options +Indexes
    DirectoryIndex /photo-imp/index.php
  where "/photo-imp" is the URL of your indexer directory.

You're done setting up the indexer. Now, fill the contents of your
top gallery directory :
- use the provided python script to generate a gallery folder
  from one of your picture directories. This script requires ImageMagick and
  ffmpeg if you have videos, and can be run on your desktop computer (not the
  server). Use the "--help" option for usage information.
- upload this folder to your web server, in your top gallery 
  directory

That's all you have to do. You can customise the album title, the
album date and the pictures title in the generated _infos.ini file,
for example :
    [general]
    title = Joe's birthday
    date = Wednesday, October 31 2007
    [joe-bday-2007_01.jpg]
    title = Birthday cake
    [joe-bday-2007_02.jpg]
    title = Presents
    [joe-bday-2007_03.jpg]
    title = "Escape with quotes when you have special chars !"

Supported formats are JPEG, GIF, PNG, and AVI for movies. The videos
will be converted to FLV (open format, readable with Gnash).

Credits:
- PrettyPhoto is licensed under CC-BY 2.5 and available from:
  http://www.no-margin-for-errors.com/projects/prettyPhoto-jquery-lightbox-clone
- The FLV player is licenced under CC-BY-SA and MPL 1.1 and available from:
  http://flv-player.net


Copyright (C) 2008 Aurelien Bompard <aurelien@bompard.org>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 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 Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

1	Photo Imp
2	=========
3
4	Photo Imp displays the photos in a directory using the PrettyPhoto javascript
5	library.
6	Main page: http://aurelien.bompard.org/projects/photo-imp
7	Development page: http://gitorious.org/photo-imp
8	Demo: http://aurelien.bompard.org/photos/
9
10	Usage:
11	- copy the "config.default.ini" file to "config.ini" and edit it if necessary.
12	- upload this directory to your web server, for example in the
13	"/photo-imp" path. This path will be called "indexer directory".
14	- create another directory on your web server for your galleries. It will be
15	called "gallery directory".
16	- create a .htaccess file in your gallery directory with the following
17	content :
18	Options +Indexes
19	DirectoryIndex /photo-imp/index.php
20	where "/photo-imp" is the URL of your indexer directory.
21
22	You're done setting up the indexer. Now, fill the contents of your
23	top gallery directory :
24	- use the provided python script to generate a gallery folder
25	from one of your picture directories. This script requires ImageMagick and
26	ffmpeg if you have videos, and can be run on your desktop computer (not the
27	server). Use the "--help" option for usage information.
28	- upload this folder to your web server, in your top gallery
29	directory
30
31	That's all you have to do. You can customise the album title, the
32	album date and the pictures title in the generated _infos.ini file,
33	for example :
34	[general]
35	title = Joe's birthday
36	date = Wednesday, October 31 2007
37	[joe-bday-2007_01.jpg]
38	title = Birthday cake
39	[joe-bday-2007_02.jpg]
40	title = Presents
41	[joe-bday-2007_03.jpg]
42	title = "Escape with quotes when you have special chars !"
43
44	Supported formats are JPEG, GIF, PNG, and AVI for movies. The videos
45	will be converted to FLV (open format, readable with Gnash).
46
47	Credits:
48	- PrettyPhoto is licensed under CC-BY 2.5 and available from:
49	http://www.no-margin-for-errors.com/projects/prettyPhoto-jquery-lightbox-clone
50	- The FLV player is licenced under CC-BY-SA and MPL 1.1 and available from:
51	http://flv-player.net
52
53
54	Copyright (C) 2008 Aurelien Bompard <aurelien@bompard.org>
55
56	This program is free software: you can redistribute it and/or modify
57	it under the terms of the GNU Affero General Public License as
58	published by the Free Software Foundation, either version 3 of the
59	License, or (at your option) any later version.
60
61	This program is distributed in the hope that it will be useful,
62	but WITHOUT ANY WARRANTY; without even the implied warranty of
63	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
64	GNU Affero General Public License for more details.
65
66	You should have received a copy of the GNU Affero General Public License
67	along with this program. If not, see <http://www.gnu.org/licenses/>.

Gitorious