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>

    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>