README -> README.md: markdown
This commit is contained in:
parent
0af713b765
commit
309adafd48
112
README
112
README
|
@ -1,112 +0,0 @@
|
||||||
== Welcome to Balder photo gallery
|
|
||||||
|
|
||||||
Made by Espen Antonsen.
|
|
||||||
|
|
||||||
Version 1.2.3 for Rails 3.2. See the rails2 branch for previous version.
|
|
||||||
|
|
||||||
http://balderapp.com
|
|
||||||
|
|
||||||
== Features
|
|
||||||
|
|
||||||
* Stores photos to disk in folders or on S3 (can run from Heroku...yay)
|
|
||||||
* 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)
|
|
||||||
* Upload multiple photos
|
|
||||||
* Tag photos. Can also tag albums (actually all photos in album is tagged)
|
|
||||||
* User management with roles and permissions
|
|
||||||
* Geo-location of albums & photos with Google Maps integration.
|
|
||||||
|
|
||||||
== Requirements
|
|
||||||
|
|
||||||
Rails 3.2
|
|
||||||
|
|
||||||
Software
|
|
||||||
Default:
|
|
||||||
- ExifTool (required for Mini_EfixTool). Can be disabled. Default is to read EXIF tags but not write them to the file when database is updated as writing EXIF is slow. To enable just uncomment exif_write in photo.rb
|
|
||||||
Can be installed from: http://www.sno.phy.queensu.ca/~phil/exiftool/
|
|
||||||
- ImageMagicK. Carrierwave can use either RMagicK or MiniMagicK (default). To change resize option the correct gem must be used (specified in Gemfile) and change included setting for Carrierwave in file_uploader.rb
|
|
||||||
Can be installed from: http://www.imagemagick.org
|
|
||||||
Optional:
|
|
||||||
- ImageScience which requires FreeImage. Can be installed from: http://sourceforge.net/projects/freeimage/
|
|
||||||
|
|
||||||
Ruby Gems: See Gemfile
|
|
||||||
|
|
||||||
== Configuration
|
|
||||||
|
|
||||||
config/balder.rb has the following adjustable settings:
|
|
||||||
|
|
||||||
STORAGE_PATH Relative path to where the photos are stored. Default: uploads
|
|
||||||
Under the specified path two folders are used. "files" for original files and "thumbs" for generated thumbnails.
|
|
||||||
This can be adjusted in app/uploaders/file_uploader.rb
|
|
||||||
PRIVATE Require visitors to have a user and authenticate before viewing photos.
|
|
||||||
TITLE Title of site
|
|
||||||
HEROKU To be used on heroku.com. This will adjust carrierwave to save to Heroku's tmp area.
|
|
||||||
S3_KEY For saving files to Amazon S3 (required for Heroku)
|
|
||||||
S3_SECRET For saving files to Amazon S3 (required for Heroku)
|
|
||||||
S3_BUCKET For saving files to Amazon S3 (required for Heroku)
|
|
||||||
|
|
||||||
As these are environment variables you can easily add them to Heroku:
|
|
||||||
http://devcenter.heroku.com/articles/config-vars#rack_env_rails_env_merb_env
|
|
||||||
For a brief introduction to how to set up Balder on Heroku see:
|
|
||||||
http://blog.inspired.no/rails-photo-gallery-balder-on-heroku-and-s3-726
|
|
||||||
|
|
||||||
== Installation
|
|
||||||
|
|
||||||
1. Clone the project from GitHub or Gitorious:
|
|
||||||
GitHub: git clone git://github.com/espen/balder.git
|
|
||||||
2. Install required software listed above
|
|
||||||
3. 'bundle install' to install required gems.
|
|
||||||
4. Adjust the settings in balder.rb or as Heroku config variables (See configuration above)
|
|
||||||
5. Copy database file (not needed when hosting on Heroku):
|
|
||||||
cp config/database.example.yml config/database.yml
|
|
||||||
6. Create database user and edit database file. (unless on Heroku or using SQLite3)
|
|
||||||
7. rake db:create
|
|
||||||
8. rake db:migrate
|
|
||||||
9. Start up the project with your preferred web-server
|
|
||||||
|
|
||||||
=== Optional: add photos directly to disk
|
|
||||||
|
|
||||||
The gallery has a web-based upload tool. Alternatively you can upload files directly to the upload folder. This means you can import an existing folder based photo collection to Balder.
|
|
||||||
|
|
||||||
Put photos in containing folders(albums) in the specified gallery folder.
|
|
||||||
Hierarchy of folders is not fully supported.
|
|
||||||
|
|
||||||
This format is recommended:
|
|
||||||
|
|
||||||
./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
|
|
||||||
|
|
||||||
Every time you manually add photos to disk you must scan by visiting /photos/scan or run ScanFiles.Scan(false) from the console.
|
|
||||||
|
|
||||||
== Version history
|
|
||||||
|
|
||||||
1.2.3
|
|
||||||
- Rails 1.2.3
|
|
||||||
|
|
||||||
1.2.2
|
|
||||||
- Rails 3.1
|
|
||||||
|
|
||||||
1.2.1
|
|
||||||
- Using plupupload instead of uploadify for non-flash upload options. Can now use html5, normal form, silverlight, gears and browserplus for photo upload.
|
|
||||||
|
|
||||||
1.2.0
|
|
||||||
- New storage path: "/uploads/files/" instead of "/uploads/". Make sure you move your photos or adjust the storage path.
|
|
||||||
|
|
||||||
== TODO
|
|
||||||
|
|
||||||
- Testing...
|
|
||||||
|
|
||||||
== IDEAS
|
|
||||||
- Themes
|
|
||||||
- Improved UX
|
|
||||||
- Mobile/Tablet friendly display using CSS media queries
|
|
||||||
Patches welcome!
|
|
||||||
|
|
||||||
== Copyright and license info
|
|
||||||
|
|
||||||
This code is copyrighted by Espen Antonsen. The source code is available free under the MIT License.
|
|
156
README.md
Normal file
156
README.md
Normal file
|
@ -0,0 +1,156 @@
|
||||||
|
Welcome to Balder photo gallery
|
||||||
|
===============================
|
||||||
|
|
||||||
|
Made by Espen Antonsen.
|
||||||
|
|
||||||
|
Version 1.2.3 for Rails 3.2. See the rails2 branch for previous version.
|
||||||
|
|
||||||
|
[http://balderapp.com](http://balderapp.com)
|
||||||
|
|
||||||
|
Features
|
||||||
|
========
|
||||||
|
|
||||||
|
* Stores photos to disk in folders or on S3 (can run from Heroku...yay)
|
||||||
|
* 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)
|
||||||
|
* Upload multiple photos
|
||||||
|
* Tag photos. Can also tag albums (actually all photos in album is tagged)
|
||||||
|
* User management with roles and permissions
|
||||||
|
* Geo-location of albums & photos with Google Maps integration.
|
||||||
|
|
||||||
|
Requirements
|
||||||
|
============
|
||||||
|
|
||||||
|
Rails 3.2
|
||||||
|
|
||||||
|
Software
|
||||||
|
|
||||||
|
Default:
|
||||||
|
|
||||||
|
- **[ExifTool]** (required for *Mini_EfixTool*). Can be disabled. Default is to read EXIF tags but not write them to the file when database is updated as writing EXIF is slow. To enable just uncomment `exif_write in photo.rb`
|
||||||
|
- **[ImageMagicK]**. *Carrierwave* can use either *RMagicK* or *MiniMagicK* (default). To change resize option the correct gem must be used (specified in Gemfile) and change included setting for Carrierwave in `file_uploader.rb`
|
||||||
|
Optional:
|
||||||
|
- *ImageScience* which requires **[FreeImage]**.
|
||||||
|
|
||||||
|
Ruby Gems: See `Gemfile`
|
||||||
|
|
||||||
|
Configuration {#configuration}
|
||||||
|
=============
|
||||||
|
|
||||||
|
`config/balder.rb` has the following adjustable settings:
|
||||||
|
|
||||||
|
STORAGE_PATH
|
||||||
|
: Relative path to where the photos are stored. Default: uploads
|
||||||
|
Under the specified path two folders are used. "files" for original files and "thumbs" for generated thumbnails.
|
||||||
|
This can be adjusted in app/uploaders/file_uploader.rb
|
||||||
|
PRIVATE
|
||||||
|
|
||||||
|
: Require visitors to have a user and authenticate before viewing photos.
|
||||||
|
|
||||||
|
TITLE
|
||||||
|
: Title of site
|
||||||
|
|
||||||
|
HEROKU
|
||||||
|
: To be used on heroku.com. This will adjust carrierwave to save to Heroku's tmp area.
|
||||||
|
|
||||||
|
S3_KEY
|
||||||
|
: For saving files to Amazon S3 (required for Heroku)
|
||||||
|
|
||||||
|
S3_SECRET
|
||||||
|
: For saving files to Amazon S3 (required for Heroku)
|
||||||
|
|
||||||
|
S3_BUCKET
|
||||||
|
: For saving files to Amazon S3 (required for Heroku)
|
||||||
|
|
||||||
|
As these are environment variables you can easily add them to Heroku:
|
||||||
|
http://devcenter.heroku.com/articles/config-vars#rack_env_rails_env_merb_env
|
||||||
|
For a brief introduction to how to set up Balder on Heroku see:
|
||||||
|
http://blog.inspired.no/rails-photo-gallery-balder-on-heroku-and-s3-726
|
||||||
|
|
||||||
|
Installation
|
||||||
|
============
|
||||||
|
|
||||||
|
1. Clone the project from GitHub or Gitorious:
|
||||||
|
|
||||||
|
git clone git://github.com/espen/balder.git # GitHup
|
||||||
|
|
||||||
|
2. Install required software listed above
|
||||||
|
3. `bundle install` to install required gems.
|
||||||
|
4. Adjust the settings in `balder.rb` or as Heroku config variables (See [configuration above](#configuration))
|
||||||
|
5. Copy database file (not needed when hosting on Heroku):
|
||||||
|
|
||||||
|
cp config/database.example.yml config/database.yml
|
||||||
|
|
||||||
|
6. Create database user and edit database file. (unless on Heroku or using SQLite3)
|
||||||
|
|
||||||
|
7. Create database:
|
||||||
|
|
||||||
|
rake db:create
|
||||||
|
|
||||||
|
8. Migrate database schema:
|
||||||
|
|
||||||
|
rake db:migrate
|
||||||
|
|
||||||
|
9. Start up the project with your preferred web-server
|
||||||
|
For example:
|
||||||
|
|
||||||
|
rails start # or:
|
||||||
|
passenger start
|
||||||
|
|
||||||
|
Optional: add photos directly to disk
|
||||||
|
-------------------------------------
|
||||||
|
|
||||||
|
The gallery has a web-based upload tool. Alternatively you can upload files directly to the upload folder. This means you can import an existing folder based photo collection to Balder.
|
||||||
|
|
||||||
|
Put photos in containing folders(albums) in the specified gallery folder.
|
||||||
|
Hierarchy of folders is not fully supported.
|
||||||
|
|
||||||
|
This format is recommended:
|
||||||
|
|
||||||
|
./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
|
||||||
|
|
||||||
|
Every time you manually add photos to disk you must scan by visiting `/photos/scan` or run `ScanFiles.Scan(false)` from the console.
|
||||||
|
|
||||||
|
Version history
|
||||||
|
===============
|
||||||
|
|
||||||
|
v1.2.3
|
||||||
|
: Rails 1.2.3
|
||||||
|
|
||||||
|
v1.2.2
|
||||||
|
: Rails 3.1
|
||||||
|
|
||||||
|
v1.2.1
|
||||||
|
: Using plupupload instead of uploadify for non-flash upload options. Can now use html5, normal form, silverlight, gears and browserplus for photo upload.
|
||||||
|
|
||||||
|
v1.2.0
|
||||||
|
: New storage path: `/uploads/files/` instead of `/uploads/`. Make sure you move your photos or adjust the storage path.
|
||||||
|
|
||||||
|
TODO
|
||||||
|
====
|
||||||
|
|
||||||
|
- Testing...
|
||||||
|
|
||||||
|
IDEAS
|
||||||
|
=====
|
||||||
|
|
||||||
|
- Themes
|
||||||
|
- Improved UX
|
||||||
|
- Mobile/Tablet friendly display using CSS media queries
|
||||||
|
Patches welcome!
|
||||||
|
|
||||||
|
Copyright and license info
|
||||||
|
==========================
|
||||||
|
|
||||||
|
This code is copyrighted by Espen Antonsen.
|
||||||
|
The source code is available free under the MIT License.
|
||||||
|
|
||||||
|
[ImageMagicK]: http://www.imagemagick.org
|
||||||
|
[ExifTool]: http://www.sno.phy.queensu.ca/~phil/exiftool/
|
||||||
|
[FreeImage]: http://sourceforge.net/projects/freeimage/
|
Loading…
Reference in a new issue