h1. Pictrails

A Web Photo Gallery, written with Rails 2.1. 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

h2. Requirements

Currently you need all of those things to get Pictrails to run:

 * Ruby On Rails 2.1.x or greater
 * Ruby 1.8.7 (Rails 2 is not yet ruby 1.9 compatible)
 * A database supported by Rails ActiveRecord (MySQL, PostgreSQL, SQLite3, ...)
 * Ruby drivers for your database
 * A gem of an image-handling API like :
 ** 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
 * 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 or any other archive:

 * Extract sources and replace all in the old folder
 * Stop the server
 * Migrate your database: <kbd>rake db:migrate</kbd>
 * Start the server in production mode : <kbd>ruby script/server -e production</kbd>

h2. Demo Website

A demo website of Pictrails is available to the "demo of pictrails":http://pictrails.shingara.fr

The "admin part":http://pictrails.shingara.fr/admin has like login/pass : admin/pictrails

h2. Information about this project

Pictrails is still in beta, and is under development.

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/shingara/pictrails.git</kbd>

After a clone you need update the submodule :

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

A "redmine development platform":http://dev.shingara.fr/projects/show/3 is
used. Feel free to post your feature requests and bug reports.

h2. License

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