NOTICE: Activity in this repository has stalled. For continued development of Photog! please visit @konrul's fork or checkout the complete rewrite in Python
Photog! turns a directory tree of source images into a photography website with nested albums of chronologically sorted photographs. It is created by Jaap Joris Vens who uses it for his personal photography website. Photog also has it's own website with detailed installation instructions, online manual pages, and nice fonts.
Photog! is written in Perl and packaged as a regular Perl module. The stable branch of Photog!'s repository always contains the latest release. Here are the installation instructions:
- ImageMagick: It's best to install this using your operating
system package manager, e.g.,
[apt-get|yum|brew|pacman|apt-cyg] install imagemagick.
$ cpan Photography::Website
This will fetch and build all dependencies and install Photog! to your
$HOME/perl5 directory. To install Photog! system-wide, prepend
sudo to the above command. Instead of fetching from CPAN, t's also
possible to run cpan . inside the source directory.
$ perl Makefile.PL
$ make
$ sudo make install
This works like you'd expect, but beware that you'll have to install all the dependencies yourself.
This module is maintained using Dist::Zilla, which builds the module distributions and pushes them to the 'stable' branch. Dist::Zilla can also be used for installing the module from the original source code (which lives in the master branch).
$ git clone https://github.com/rtts/photog.git
$ git checkout master
$ dzil install
To generate a photography website using the default settings, simply
cd to your Pictures directory and execute photog with the
destination directory as its argument:
cd ~/Pictures
photog ~/public_html
That's it! Your website's main page should now be available in
$HOME/public_html/index.html. Go have a look!
The documentation of Photog! is available after installation as a collection of Unix-style manual pages. The available manpages are:
-
photog-- An overview of the command-line interface and an introduction to configuration and customization. -
Photography::Website-- Describes the interface and the inner workings of the Photography::Website Perl module. -
Photography::Website::Configure-- A comprehensive list of all configuration options and their default values.