shingara / pictrails

A Web Photo Gallery, written with Rails 2.0. Pictrails can manage several photo galleries.

This URL has Read+Write access

shingara (author)
Tue Sep 30 15:23:15 -0700 2008
commit  bd5299cb735f204a90295ac45d868677bcb007d4
tree    aa1d4939e407846013459f3f47a0bac14b3326dc
parent  b03da38c032a2a0ac14771d747cd38707344f731
pictrails / README.txt
100644 89 lines (62 sloc) 2.919 kb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
h1. Pictrails
 
A Web Photo Gallery, written with Rails 2.1. Pictrails can manage several photo galleries.
 
h2. Features
 
 * Create several Galleries
 * Create Galleries like child of another Gallery
 * Add several pictures in a Gallery
 * Create a gallery with define a directory in same server of pictrails if the
   directory has several directories into, all of this directory are child of
   master Gallery
 * Admin interface with login to add/edit/delete Galleries and Pictures
 * Define the thumbnails and pictures size in settings interface
 * Delete the cache page in settings interface
 * Define the number of pictures by pagination Gallery
 * Define the number of gallery by pagination of Gallery's list
 * Define a list of tag for pictures
 * View a sidebar with all gallery in it tree
 * Navigate with a breadcrumb
 * View a cloud tag of all gallery
 * Navigate by tag
 * Comments on each pictures
 
h2. Requirements
 
Currently you need all of those things to get Pictrails to run:
 
 * Ruby On Rails 2.1.x
 * Ruby of 1.8.6 or greater
 * A database supported by Rails ActiveRecord (MySQL, DB2, SQLite3, ...)
 * Ruby drivers for your database (obviously out of the box with Rails)
 * Redcloth gem
 * A gem of an image-handling API like :
 ** ImageScience
 ** RMagick
 ** Mini-magick
 
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 actually consider like an Beta version, and is under development.
 
All contributions are welcome.
 
I suck in design, I know it and I am sorry but I will really be happy if anyone could
help me.
 
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 defects report.
 
h2. License
 
This code is free to use under the terms of the MIT license (provided with sources).