terom@53: <%
terom@53: 
terom@53: import os
terom@53: 
terom@53: RELEASE_PATH = "/home/projects/degal/releases"
terom@53: RELEASE_URL = "http://projects.qmsk.net/degal/releases"
terom@53: 
terom@53: # load release links
terom@53: releases = []
terom@53: 
terom@53: for filename in os.listdir(RELEASE_PATH) :
terom@53:     if filename.startswith('.') :
terom@53:         continue
terom@53: 
terom@53:     path = os.path.join(RELEASE_PATH, filename)
terom@53:     url = "%s/%s" % (RELEASE_URL, filename)
terom@53: 
terom@53:     releases.append((filename, url))
terom@53: 
terom@53: releases.sort()
terom@53: 
terom@53: %>
terom@53: 
terom@53: <h1>Degal</h1>
terom@53:     <h2>About</h2>
terom@53:         <p>
terom@53:             <strong>Degal</strong> is a HTML photo gallery script written in Python.
terom@53:         </p>
terom@53:     
terom@53:     <h2>History</h2>
terom@53:         <p>
terom@55:             Degal was originally based on a similar HTML gallery script called <a href="http://pajukanta.fi/projects/egal/">EGAL</a>,
terom@53:             written by Santtu Pajukanta, rewritten to add more features such as support for sub-folders (!).
terom@53:         </p>
terom@53: 
terom@53:         <p>
terom@53:             Releases 0.1 - 0.2 remained fairly simplistic single-module scripts which were manageable, but development
terom@53:             in the old SVN repository quickly split the code up into a package. At this point the packaging and
terom@53:             structure quickly fell apart, with the resulting code and CGI scripts being barely useable by myself.
terom@53:         </p>
terom@53: 
terom@53:         <p>
terom@53:             In early summer 2009, I picked up development again, heavily refactoring the old svn code into a (hopefully)
terom@53:             better structure.
terom@53:         </p>
terom@53: 
terom@53:         <p>
terom@53:             Currently, the only releases are still from the old first-generation era, but hopefully we should be seeing a
terom@53:             third-generation release fairly soon :)
terom@53:         </p>
terom@53:     
terom@53:     <h2>Features</h2>
terom@53:         <ul>
terom@53:             <li>Generate static per-folder/img .html files for a directory tree</li>
terom@53:             <li>Generate thumbnail and preview versions of each image</li>
terom@53:         </ul>
terom@53:  
terom@53:     <h2>Download</h2>
terom@53:         <h3>Release versions</h3>
terom@53:             <ul>
terom@53:             % for filename, url in releases :
terom@53:                 <li><a href="${url}">${filename}</a></li>
terom@53:             % endfor
terom@53:             </ul>
terom@53:             
terom@53:         <h3>Development version</h3>
terom@53:             <code>hg clone http://hg.qmsk.net/degal</code>
terom@53:     
terom@53:     <h2>Installation and usage (for release versions)</h2>
terom@53:         <p>Extract the archive file and move these files and directories to where your images are:</p>
terom@53:         <ul>
terom@53:             <li>.htaccess</li>
terom@53:             <li>degal.py</li>
terom@53:             <li>utils.py</li>
terom@53:             <li>shorturl.cgi</li>
terom@53:             <li>style.css</li>
terom@53:             <li>templates/</li>
terom@53:         </ul>
terom@53:         <p>If you wish to use ShortURLs and run DeGAL with mod_userdir, you may need to modify the .htaccess to set the RewriteBase.</p>
terom@53:         <p>If you now execute degal.py on the command line, it will scan through your images, create thumbnails, preview images, as well as generate the HTML gallery pages.</p>
terom@53:         <p>Gallery (directory) titles may optionaly be specified in a file called title.txt in each directory. If present, it should contain a short title that will be used for all links to that gallery. You may also add a longer description (after the title, seperated by three dashes, ---, extra whitespace will be stripped away) which will be shown on the directory's index page.</p>
terom@53:         <p>The same may be done for induvidual images (replace the file extension with .txt, i.e. DSC0001.jpg becomes DSC0001.txt) whereupon the URL for the image will use a simplified version of the image's title.</p>
terom@53:         <p>It is also possible to specify a list of directories/files to index as command-line arguments to degal.py, in which case it will only process those files. Note that a directory index will only be updated if the directory itself is included in the filter.</p>
terom@53:         
terom@53:    
terom@53:     <h2>Requirements</h2>
terom@53:         <h3>Release version / Development core</h3>
terom@53:             <ul>
terom@53:                 <li><a href="http://www.python.org/">Python</a> 2.5</li>
terom@53:                 <li><a href="http://www.pythonware.com/products/pil/">PIL</a> 1.1.6</li>
terom@53:             </ul>
terom@53: 
terom@53:         <h3>Development optional</h3>
terom@53:             <ul>
terom@53:                 <li><a href="http://tilloy.net/dev/pyexiv2/">pyexiv2</a></li>
terom@53:                 <li><a href="http://sourceforge.net/projects/exif-py">EXIFpy</a></li>
terom@53:             </ul>
terom@53:     
terom@53:     <h2>Changelog</h2>
terom@53:         <ul>
terom@53:             <li>
terom@53:                 0.2
terom@53:                 <ul>
terom@53:                     <li>Added ShortURL feature</li>
terom@53:                     <li>Added ability to specify a list of files to update on the command line</li>
terom@53:                 </ul>
terom@53:             </li>
terom@53:         </ul>
terom@53: 
terom@53:     <h2>Links</h2>
terom@53:         <h3>Source Repository</h3>
terom@53:             <p>
terom@53:                 Mercurial: <a href="http://hg.qmsk.net/degal">http://hg.qmsk.net/degal</a>
terom@53:             </p>
terom@53:             
terom@53:         <h3>Example Gallery</h3>
terom@53:             <p>
terom@53:                 <a href="http://photos.qmsk.net/">http://photos.qmsk.net/</a>
terom@53:             </p>