==============
Static Gallery
Static Web Gallery Generator using Jinja2 And PIL.
In the context of the application, a gallery is a directory with photos, the source is the parent directory
of the galleries. The destiny is the directory where the galleries will be copied and the html files generated.
Installation
You will need to install PIL and Jinja2 first:
$ pip install jinja2
$ pip install PIL
You can install it in a virtualenv, otherwise you will need to install it
as root if you don't change the root of the python package installation.
Use
It's really easy to change the design/styles of the gallery, you can create a jinja template for the menu
and a different one for the gallery, add them in the templates directory and later select them from the command-line
with the --template-gallery
and --template-menu
options.
You can run the server with --server
if you want to check easily template changes (or whatever you want).
This is the command line help:
usage: staticgallery [-h] [--template-gallery TEMPLATE_GALLERY]
[--template-menu TEMPLATE_MENU] [--src SRC] [--dst DST]
[--server] [--port PORT] [--reload]
Static Gallery Generator Options.
optional arguments:
-h, --help show this help message and exit
--template-gallery TEMPLATE_GALLERY
Choose the name of the template for the gallery
--template-menu TEMPLATE_MENU
Choose the template for the menu
--src SRC Source directory for the galleries
--dst DST Destiny where the web galleries will be generated
--server Executes a server
--port PORT Choose the port for the server, by default 8000
--reload Reload all galleries, even if they exist in the
destiny
Configuration
You can change the configuration easily just editing the file in $HOME/.staticgallery/config.cfg
too. By default you will need to configure the source of your image directory, the destiny is by default
~/.staticgallery/site
, but you can move it wherever you want.
Once you have your gallery generated you can see it using staticgallery --server --port 8080
and
redirecting your browser to http://localhost:8080
.
Have fun! :-D