2009-07-27 18:58:58 +02:00
|
|
|
== Welcome to Balder photo gallery
|
2009-05-22 14:13:46 +02:00
|
|
|
|
2009-07-06 16:12:39 +02:00
|
|
|
Made by Espen Antonsen.
|
2009-05-22 14:13:46 +02:00
|
|
|
|
2010-07-01 12:26:03 +02:00
|
|
|
Version 1.1
|
|
|
|
|
2009-07-27 18:58:58 +02:00
|
|
|
http://balderapp.com
|
|
|
|
|
2009-06-09 00:39:36 +02:00
|
|
|
== Features
|
|
|
|
|
2010-07-01 12:28:45 +02:00
|
|
|
* Stores photos to disk in folders or on S3 (can run from Heroku...yay)
|
2009-07-06 16:12:39 +02:00
|
|
|
* Create multiple thumbnails of custom sizes
|
|
|
|
* Read and writes EXIF/IPTC title, description and keywords
|
|
|
|
* Organize in albums (as events in iPhoto)
|
|
|
|
* Combine albums in collections (as albums in iPhoto)
|
2009-06-10 01:22:48 +02:00
|
|
|
* Upload multiple photos
|
2009-06-09 00:39:36 +02:00
|
|
|
* Tag photos. Can also tag albums (actually all photos in album is tagged)
|
2009-07-06 16:12:39 +02:00
|
|
|
* User management with roles and permissions
|
|
|
|
* Geo-location of albums & photos with Google Maps integration.
|
|
|
|
|
2009-07-27 19:16:17 +02:00
|
|
|
== License
|
|
|
|
|
|
|
|
Free for personal use. Contact me for commercial license.
|
|
|
|
|
2009-06-02 00:08:57 +02:00
|
|
|
== Requirements
|
2009-05-22 14:13:46 +02:00
|
|
|
|
2009-06-10 01:22:48 +02:00
|
|
|
Rails 2.3
|
2009-06-03 01:33:39 +02:00
|
|
|
|
2009-06-02 00:08:57 +02:00
|
|
|
Software
|
2010-07-01 12:26:03 +02:00
|
|
|
- RMagicK (required for Carrierwave resizing). Can also use ImageScience
|
|
|
|
Optional:
|
|
|
|
- ExifTool (required for Mini_EfixTool)
|
2009-05-22 14:13:46 +02:00
|
|
|
|
2009-06-02 00:08:57 +02:00
|
|
|
Ruby Gems
|
|
|
|
- AuthLogic
|
|
|
|
- Mime-Types
|
2010-07-01 12:26:03 +02:00
|
|
|
- Carrierwave
|
|
|
|
Optional:
|
|
|
|
- AWS/S3 (if saving to Amazon s3)
|
|
|
|
- Mini_Exiftool (to read exif info to database. See photo.rb model)
|
2009-06-09 00:39:36 +02:00
|
|
|
|
|
|
|
== Installation
|
|
|
|
|
2009-07-29 14:55:43 +02:00
|
|
|
1. Clone the project from GitHub or Gitorious:
|
|
|
|
GitHub: git clone git://github.com/espen/balder.git
|
|
|
|
Gitorious: git clone git://gitorious.org/gallery-without-a-name/gallery-without-a-name.git
|
2009-07-06 15:49:03 +02:00
|
|
|
2. install required software listed above
|
2009-07-29 14:55:43 +02:00
|
|
|
3. Copy settings file:
|
2009-07-06 15:53:23 +02:00
|
|
|
cp gallery/config/database.example.yml gallery/config/database.yml
|
|
|
|
cp gallery/config/settings.example.yml gallery/config/settings.yml
|
2009-07-29 14:55:43 +02:00
|
|
|
4. Create databsae user and edit settings files.
|
|
|
|
5. rake db:create
|
|
|
|
6. rake db:migrate
|
|
|
|
7. Start up the project with your preferred web-server
|
2009-07-06 15:49:03 +02:00
|
|
|
|
2009-07-06 16:12:39 +02:00
|
|
|
=== Optional: add photos directly to disk
|
2009-07-06 15:49:03 +02:00
|
|
|
|
|
|
|
The gallery has a web-based upload tool using Flash. Alternatively you can upload files directly by doing this:
|
|
|
|
|
2009-08-03 16:23:51 +02:00
|
|
|
Put photos in containing folders(albums) in the specified gallery folder.
|
|
|
|
Hierarchy of folders is not fully supported.
|
|
|
|
|
|
|
|
This format is recommended:
|
2009-06-09 00:39:36 +02:00
|
|
|
|
|
|
|
./ski weekend in hemsedal/snow.jpg
|
|
|
|
./ski weekend in hemsedal/afterski.jpg
|
|
|
|
./trip to iran/beautiful girls in tehran.jpg
|
|
|
|
./trip to iran/mosque in yazd.jpg
|
|
|
|
./trip to iran/powder snow in dizin.jpg
|
|
|
|
|
2009-07-29 14:55:43 +02:00
|
|
|
Every time you manually add photos to disk you must scan by visiting /photos/scan
|
2009-06-09 00:50:25 +02:00
|
|
|
|
2009-07-29 17:52:55 +02:00
|
|
|
In future releases the scan will be automated.
|
|
|
|
|
|
|
|
== Copyright and license info
|
|
|
|
|
2009-07-31 16:04:56 +02:00
|
|
|
This code is copyrighted by Espen Antonsen. The source code is available free under the GNU General Public License version 3 (GPLv3).
|
2009-07-29 17:52:55 +02:00
|
|
|
|
2009-07-31 16:04:56 +02:00
|
|
|
If the GPLv3 is not suitable for you please contact me for an alternative license for a fee.
|