Album - Photo gallery generator which has theme support

From NAS-Central Buffalo - The Linkstation Wiki

(Difference between revisions)
Jump to: navigation, search
m (Install Imagemagik)
m (Running Album)
Line 110: Line 110:
#[http://marginalhacks.com/Hacks/album/Docs/Section_2.html#Adding_some_EXIF_captions Adding some EXIF captions]
#[http://marginalhacks.com/Hacks/album/Docs/Section_2.html#Adding_some_EXIF_captions Adding some EXIF captions]
#[http://marginalhacks.com/Hacks/album/Docs/Section_2.html#Adding_more_albums Adding more albums]
#[http://marginalhacks.com/Hacks/album/Docs/Section_2.html#Adding_more_albums Adding more albums]
-
===Directory===
 
-
*You need a web directory to put themes and your photo  album. eg: <tt>/home/httpd/test</tt>  the URL will be: <font color=blue> <nowiki>http://myserver/test/</nowiki></font>
 
-
*First create a directory and put some images in it.
 
-
mkdir /home/httpd/test/Photos
 
-
 
-
===Adding captions and Hiding photos===
 
-
 
-
*Create a file <tt>/home/httpd/test/Photos/captions.txt</tt> with the following contents
 
-
(use the 'tab' key where you see "  [tab]  ")
 
-
 
-
There are a few ways to hide photos/files/directories, but we'll use
 
-
the captions file. 
 
-
(Try commenting out an image with '#' in captions.txt: You'll see that IMG_002.jpg is missing.)
 
-
*'''''captions.txt'''''
 
-
<pre>
 
-
IMG_001.jpg  [tab]  First image name
 
-
# IMG_002.jpg  [tab]  Second image
 
-
IMG_003.jpg  [tab]  Another image  [tab]  with a caption!
 
-
IMG_004.jpg  [tab]  Last image    [tab]  with another caption.
 
-
</pre>
 
-
 
-
*Now create a file with text in:
 
-
/home/httpd/test/Photos/header.txt
 
-
You'll see that text at the top of the page.
 
-
 
-
===Using A Theme===
 
-
<table align=right cellpadding=0 cellspacing=0>
 
-
<tr>
 
-
<td>
 
-
http://davepics.com/Theme_Album/tn/Dominatrix6.jpg
 
-
</td>
 
-
</tr>
 
-
<tr>
 
-
<td align=center>
 
-
<small>[http://davepics.com/Examples/Dominatrix6.html Dominatrix6]</small>
 
-
</td>
 
-
</tr>
 
-
</table>
 
-
*Use wget to get and install this theme
 
-
mkdir /home/httpd/Themes/
 
-
cd /home/httpd/Themes/
 
-
wget http://marginalhacks.com/Hacks/album/Themes/Dominatrix6.tar.gz
 
-
tar -xvzf Dominatrix6.tar.gz
 
-
rm Dominatrix6.tar.gz
 
-
*To use a theme, download the theme .tar or .zip and unpack it.
 
-
 
-
Themes are found according to the <tt>-theme_path</tt> setting, which is a list of places to look for themes.  Those paths need to be somewhere under the top of your web directory, but not inside a photo album directory.  It needs to be accessible from a web browser.
 
-
 
-
You can either move the theme into one of the <tt>theme_path</tt>-s that album is already using, or make a new one and specify it with the <tt>-theme_path</tt> option. 
 
-
 
-
===Medium images===
 
-
*Full resolution images are usually too big for a web album, so we'll use medium images on the image pages:
 
-
 
-
*Then call album with the <tt>-theme</tt> option, with or without <tt>-theme_path</tt>:
 
-
 
-
  album -medium 33% -theme Dominatrix6 /home/httpd/test/Photos
 
-
  album -medium 33% -theme Dominatrix6 -theme_path /home/httpd/Themes/ /home/httpd/test/Photos
 
-
 
-
 
-
===Adding more albums===
 
-
*Let's say we go on a trip to spain.  We take some photos and put them in:
 
-
  /home/httpd/test/Photos/Spain/
 
-
*Now run album again on the top level:
 
-
  album /home/httpd/test/Photos
 
-
This will fixup Photos so it now links to spain and will run album
 
-
on <tt>Spain/</tt> as well, with the same settings/theme, etc..
 
-
Now let's go on another trip, and we create:
 
-
  /home/httpd/test/Photos/Italy/
 
-
*We could run album on the top level:
 
-
  album /home/httpd/test/Photos
 
-
But that would rescan the Spain directory which hasn't changed.
 
-
Album usually won't generate any HTML or thumbnails unless it needs to,
 
-
but it can still waste time, especially as our albums get bigger.
 
-
*So we can tell it to just add the new directory:
 
-
album -add /home/httpd/test/Photos/Italy
 
-
This will fix the top index (in Photos) and generate the Italy album.
 
==References==
==References==
<references/>
<references/>
{{Stubs}}
{{Stubs}}

Revision as of 21:21, 7 September 2006

logo.jpg

Dominatrix6.jpg

181_thumb.gif

freshmeat.net: Screenshot of project album

Contents

What is it?

Album - [1] An HTML photo album generator that supports themes. It takes directories of images and creates all the thumbnails and HTML that you need.

Album is a perl script, which means you need to be comfortable with or prepared to use the command-line. If you just want a point-and-click, you may wish to look elsewhere. Features:

  • You can use themes to choose or redesign the album "look and feel."
  • Recursively descends directories to make a hierarchy of photo albums
  • EXIF support, Video thumbnails...
  • Has a plugin system that allows you to write perl code to alter the behavior of album.
  • Slideshows, transparent overlays, credit tags, easy captions, and endless features!

Look here for documentation: http://marginalhacks.com/Hacks/album/Docs/ [2]

There are a few photo gallery alternatives:

Requirements

Minimum Requirements

  1. Apache or Lighttpd or Thttpd
    1. Apache w/ PHP and MySQL Support (MIPSel)
    2. Apache HTTP server, installing
    3. Lighttpd with mysql and php (LLMP)
    4. Run a second instance of thttpd (on an alternate port)
  2. Perl and the script for MarginalHacks:Album[3]
  3. Imagemagick tools (specifically 'convert')

Optional Installation

  1. Themes[4]
  2. ffmpeg (for movie thumbnails)
  3. jhead (for reading EXIF info)[5]

Install Jhead

FreeLink

Skip ahead to #Install Album, apt-get will resolve all dependancies for you

OpenLink(PowerPC)

  1. Install Ipkg on the Linkstation (for end-users) and enable the NSLU2 Feed: Ipkg Package List: PowerPC
  2. Install jhead
wget http://www.sentex.net/~mwandel/jhead/jhead-latest.tar.gz
tar -xvzf jhead-latest.tar.gz
cd jhead-?.?
make
chmod chmod +x jhead 
cp jhead /usr/local/bin

http://www.sentex.net/~mwandel/jhead/jhead-2.5.tar.gz

Install Imagemagik

FreeLink

Skip ahead to #Install Album, apt-get will resolve all dependancies for you

OpenLink(PowerPC)

  1. Install Ipkg on the Linkstation (for end-users) and enable the NSLU2 Feed: Ipkg Package List: PowerPC
  2. Install imagemagick
ipkg install imagemagick

OpenLink (MIPSel)

 
WARNING!

Untested


  1. Install the Precompiled C development environment, running on the LS
  2. Install imagemagik from source.[6]

Download ImageMagick.tar.gz from ftp.imagemagick.org or its mirrors and unpack it with this command:

wget ftp://ftp.imagemagick.org/pub/ImageMagick/ImageMagick.tar.gz 
tar -xvzf ImageMagick.tar.gz

Next configure and compile ImageMagick:

 cd ImageMagick-6.?.?
 ./configure
 make

If ImageMagick configured and compiled without complaint, you are ready to install it on your system. You need to be root to install. To install, type:

 make install

Install Album

FreeLink

apt-get install album

OpenLink

 
WARNING!

Untested


  1. Install the Precompiled C development environment, running on the LS (to get Perl)
  2. Download and run Album:
wget http://marginalhacks.com/bin/album.tar.gz
tar -xvzf album.tar.gz
cd album-3.12
mkdir -p /usr/local/bin
cp album /usr/local/bin/
chmod 0755 /usr/local/bin/album

Running Album

The directions below should provide you with enough to get started. This all came from:

MarginalHacks/Album: MINI HOW-TO[7]

  1. Simple album
  2. Add captions
  3. Hiding Photos
  4. Using A Theme
  5. Medium images
  6. Adding some EXIF captions
  7. Adding more albums

References

  1. http://marginalhacks.com/Hacks/album/
  2. MarginalHacks Album Documentation
  3. http://marginalhacks.com/Hacks/album/Download.html MarginalHacks: Album Download
  4. Davepics.com - Snapshots of all Album themes
  5. jhead: Exif Jpeg header and thumbnail manipulator program
  6. ImageMagick: Install from Source
  7. marginalhacks.com Album Documentation: MINI HOW-TO
This article is currently a stub. You can help this Wiki by expanding it

. This template will categorize articles that include it into Category:Stubs.

Personal tools