pyctures 0.20

pyctures is a small web gallery written in Python that uses the web.py framework. It does not use any database and stores all the necessary data in the filesystem.
pyctures is published under the BOLA (Public Domain), so you can run the software anywhere, and do whatever you want with it.
Installation:
The installation procedure depends on the HTTP server youre using. What follows is a list of procedures for some common HTTP servers. If you use pyctures with something else, please let me know so I can add it here.
After youve completed the install, read the "Administration" file to learn how to manage your gallery.
Common procedure
1. Copy the "website" directory to a suitable place where you want to install
pyctures. It does not have to be inside your website, but has to be
readable by your webservers user.
2. Create a "config.py" file based on the "config.py.sample" file, and edit it
according to your configuration. A really important setting is the album
path, where all albums will be stored. It can be anywhere you want. Create
an admin user so you can create albums using the web interface.
3. Make sure the album path is writeable by the user who will run the pyctures
application. It usually is your web server user.
4. Install PIL from http://www.pythonware.com/products/pil/. The package name
for most distributions is "python-imaging" or just "imaging".
5. Install cheetah from http://www.cheetahtemplate.org/. The package name for
most distributions is "python-cheetah" or just "cheetah". You need at least
version 2.0-rc5.
No server (stand-alone)
pyctures can be run without any HTTP server by just executing
"./pyctures [PORT]" directly on the website directory. Its useful for
testing and small sites. I recommend that you test everything works this way
before integrating it into a webserver.
lighttpd
First of all, install "flup", from http://www.saddi.com/software/flup/.
Gentoo: Its not in portage, it sucks. Check
http://bugs.gentoo.org/show_bug.cgi?id=100784
Debian: apt-get install python-flup
Now, lets suppose youve installed pyctures in the "/var/www/pyctures"
directory, and want to publish it under the "/pics/" directory.
You need to add the following to /etc/lighttpd/mod_fastcgi.conf (or just
/etc/lighttpd/lighttpd.conf if you dont have the other file):
---------- 8< ---------- 8< ---------- 8< ---------- 8< ----------
fastcgi.server = (
"/pics" => ((
"socket" => "/tmp/fastcgi-pics.socket",
"max-procs" => 1,
"bin-path" => "/var/www/pyctures/pyctures"
))
)
---------- 8< ---------- 8< ---------- 8< ---------- 8< ----------
This is enough, but be aware that "http://mysite/pics" (note the missing
"/" at the end) will *not* be redirected to pyctures.
If you want to be able to refer to your pyctures root both as
"http://mysite/pics/" and "http://mysite/pics", you need to add the
following in the same file as before:
---------- 8< ---------- 8< ---------- 8< ---------- 8< ----------
url.redirect = (
"^/pics$" => "/pics/"
)
---------- 8< ---------- 8< ---------- 8< ---------- 8< ----------
And then create an empty file in your document root called "gallery",
otherwise lighttpd will think the path does not exist and return 404 before
doing the redirection.
Enhancements:
- This version implemented pagination, IE support, and automatic thumbnail regeneration on config changes.
- It also improved performance considerably, reduced the memory footprint, added Apache installation instructions, and included several other minor improvements.