|
1 <% |
|
2 |
|
3 import os |
|
4 |
|
5 RELEASE_PATH = "/home/projects/degal/releases" |
|
6 RELEASE_URL = "http://projects.qmsk.net/degal/releases" |
|
7 |
|
8 # load release links |
|
9 releases = [] |
|
10 |
|
11 for filename in os.listdir(RELEASE_PATH) : |
|
12 if filename.startswith('.') : |
|
13 continue |
|
14 |
|
15 path = os.path.join(RELEASE_PATH, filename) |
|
16 url = "%s/%s" % (RELEASE_URL, filename) |
|
17 |
|
18 releases.append((filename, url)) |
|
19 |
|
20 releases.sort() |
|
21 |
|
22 %> |
|
23 |
|
24 <h1>Degal</h1> |
|
25 <h2>About</h2> |
|
26 <p> |
|
27 <strong>Degal</strong> is a HTML photo gallery script written in Python. |
|
28 </p> |
|
29 |
|
30 <h2>History</h2> |
|
31 <p> |
|
32 Degal was origionally based on a similar HTML gallery script called <a href="http://pajukanta.fi/projects/egal/">EGAL</a>, |
|
33 written by Santtu Pajukanta, rewritten to add more features such as support for sub-folders (!). |
|
34 </p> |
|
35 |
|
36 <p> |
|
37 Releases 0.1 - 0.2 remained fairly simplistic single-module scripts which were manageable, but development |
|
38 in the old SVN repository quickly split the code up into a package. At this point the packaging and |
|
39 structure quickly fell apart, with the resulting code and CGI scripts being barely useable by myself. |
|
40 </p> |
|
41 |
|
42 <p> |
|
43 In early summer 2009, I picked up development again, heavily refactoring the old svn code into a (hopefully) |
|
44 better structure. |
|
45 </p> |
|
46 |
|
47 <p> |
|
48 Currently, the only releases are still from the old first-generation era, but hopefully we should be seeing a |
|
49 third-generation release fairly soon :) |
|
50 </p> |
|
51 |
|
52 <h2>Features</h2> |
|
53 <ul> |
|
54 <li>Generate static per-folder/img .html files for a directory tree</li> |
|
55 <li>Generate thumbnail and preview versions of each image</li> |
|
56 </ul> |
|
57 |
|
58 <h2>Download</h2> |
|
59 <h3>Release versions</h3> |
|
60 <ul> |
|
61 % for filename, url in releases : |
|
62 <li><a href="${url}">${filename}</a></li> |
|
63 % endfor |
|
64 </ul> |
|
65 |
|
66 <h3>Development version</h3> |
|
67 <code>hg clone http://hg.qmsk.net/degal</code> |
|
68 |
|
69 <h2>Installation and usage (for release versions)</h2> |
|
70 <p>Extract the archive file and move these files and directories to where your images are:</p> |
|
71 <ul> |
|
72 <li>.htaccess</li> |
|
73 <li>degal.py</li> |
|
74 <li>utils.py</li> |
|
75 <li>shorturl.cgi</li> |
|
76 <li>style.css</li> |
|
77 <li>templates/</li> |
|
78 </ul> |
|
79 <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> |
|
80 <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> |
|
81 <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> |
|
82 <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> |
|
83 <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> |
|
84 |
|
85 |
|
86 <h2>Requirements</h2> |
|
87 <h3>Release version / Development core</h3> |
|
88 <ul> |
|
89 <li><a href="http://www.python.org/">Python</a> 2.5</li> |
|
90 <li><a href="http://www.pythonware.com/products/pil/">PIL</a> 1.1.6</li> |
|
91 </ul> |
|
92 |
|
93 <h3>Development optional</h3> |
|
94 <ul> |
|
95 <li><a href="http://tilloy.net/dev/pyexiv2/">pyexiv2</a></li> |
|
96 <li><a href="http://sourceforge.net/projects/exif-py">EXIFpy</a></li> |
|
97 </ul> |
|
98 |
|
99 <h2>Changelog</h2> |
|
100 <ul> |
|
101 <li> |
|
102 0.2 |
|
103 <ul> |
|
104 <li>Added ShortURL feature</li> |
|
105 <li>Added ability to specify a list of files to update on the command line</li> |
|
106 </ul> |
|
107 </li> |
|
108 </ul> |
|
109 |
|
110 <h2>Links</h2> |
|
111 <h3>Source Repository</h3> |
|
112 <p> |
|
113 Mercurial: <a href="http://hg.qmsk.net/degal">http://hg.qmsk.net/degal</a> |
|
114 </p> |
|
115 |
|
116 <h3>Example Gallery</h3> |
|
117 <p> |
|
118 <a href="http://photos.qmsk.net/">http://photos.qmsk.net/</a> |
|
119 </p> |