Girino Photo Album README file.

For the lazy ones: download here!!!

This project is a CGI set of files to easilly
manage photo albums. Very simple to use:
- Install both cgi files in some cgi enabled 
  server with perl installed. 
- Create a subdirectory under the one in which 
  the cgi's where installed, named "fotos" (this 
  name can be changed inside the scripts in the
  constants section).
- For each photo Album you wish to publish do 
  the following:
  - Create a subfolder for the Album.
  - Put inside it the photos with .jpg extension
  - create thumbnails for them and name them 
    with the name of the picture prefixed by "thumb-"
    (this can also be changed in the scripts 
    constants section).
  - copy one of the thumbnails to index.jpg so it
    will be displayed in the main page. DO NOT
    FORGET the index.jpg image. If it's not
    found in a folder, the album is not displayed
    in the index page.
  - Create an "index.txt" file containing the title
    or name for the album (in a single line). This
    is optional since it can be done with the 
    editing script.
  - for each image create a txt file with the same 
    name but with .txt extension instead of .jpg
    extension, containing the title or caption for
    the image file. This is also optional since 
    captions are optional, and can also be done 
    later using the editing tool.
- If you want to use the editing tool, give write
  permission to all the folder under the "foto"
  folder. The user that the CGI will run as must
  have write access to them. Do the same with the
  .txt files (titles and captions).
- Run it (access the url from where you installed it).

To Add a new album, just create a new subfolder under
the "fotos" folder and do the same steps as for the 
folders initially added. The folder will be recognized
automatically.

To create hidden albums: just name the folder with a
starting dot ("."). The script will recognize it as 
hidden and not display it automatically. To show the
hidden albums just add any query parameter to the 
script's url (as "?extras" for example). This is not
a secure solution, but is enough for this first
implementation. Further implementations will improve
security.

TODO:
- implement pagination in index and album indexes.
- improve security for hidden folders access
- use of stylesheets
- batch update of captions and titles in the editing tool
- caching of thumbnails
- update the readme

DONE:
- generation of thumbnails
- upload of albums using the editing tool.