h1. Pictrails

A Web Photo Gallery, written with Rails 2.3.3 and Ruby 1.9. Pictrails can manage several photo galleries.

h2. Features

 * Photo-blog like front page based on any gallery or customizable by selecting any picture from any gallery
 * Create several galleries
 * Add several pictures in a gallery
 * Import pictures into a new gallery from a directory in same server of Pictrails
 * Show EXIF information from the picture
 * Download original photo
 * Admin interface with login to add/edit/delete galleries, pictures, manage settings, and users
 ** Define the thumbnails and pictures size in settings interface
 ** Delete the cache page in settings interface
 ** Define the number of pictures per page in a gallery
 ** Define the number of galleries per page
 ** Enable/Disable Showing of EXIF info and download original photo
 ** Regenerate thumbnails and shown pictures based on new dimensions (BROKEN CURRENTLY)

h2. Requirements

 * Ruby On Rails 2.3.3
 * Ruby 1.9.1 or greater
 * A database supported by Rails ActiveRecord (MySQL, PostgreSQL, SQLite3, ...)
 * Ruby drivers for your database
 * A gem of an image-handling API:
 ** ImageScience - preferred
 ** RMagick
 * The mini_exiftool gem and dependancies
 ** exitftool - http://www.sno.phy.queensu.ca/~phil/exiftool

h2. Installing

With the tar.gz or any other archive:

 * Extract sources to a folder
 * If running from Git clone, run:
 ** git submodule init
 ** git submodule update
 * Create a database.yml file in the config directory. You can copy the database.yml.example
 * Create your databases: <kbd>rake db:create:all</kbd>
 * Migrate your database: <kbd>rake db:migrate</kbd>
 * Start the server in production mode : <kbd>ruby script/server -e production</kbd>

h2. Updating

With the tar.gz, any other archive or git clone:

 * Extract sources into a new location
 * Copy from the old location
 ** RAILS_ROOT/temp_photos
 ** RAILS_ROOT/original_photos
 ** RAILS_ROOT/public/pictrails_thumbnails
 ** RAILS_ROOT/config/database.yml
 ** RAILS_ROOT/db/production.sqlite3
 * If running from a new Git clone, run:
 ** git submodule init
 ** git submodule update
 * Migrate your database: <kbd>rake db:migrate</kbd>
 * Start the server in production mode : <kbd>ruby script/server -e production</kbd>

h2. Demo Website

I'm currently running this fork of Pictrails at http://benallenphoto.com

h2. Information about this project

Pictrails is still in beta, is under development, and likely always will be :-)

All contributions are welcome. 

If you want to contribute, all work is made under a Git repository. You can clone the 
source with the following command :

<kbd>git clone git://github.com/unilogic/pictrails.git</kbd>

After a clone you need update the submodule :

<kbd>git submodule init</kbd>
<kbd>git submodule update</kbd>

h2. License

This code is free to use under the terms of the MIT license (provided with sources).