60 lines
2 KiB
Text
60 lines
2 KiB
Text
|
|
|
|
Configuration
|
|
=============
|
|
|
|
A (hidden) file exists in each album directory, holding information
|
|
about each image and each sub-album. For both images and albums the key is the
|
|
filename and the order in which each is listed determines the ordering
|
|
in the album. Common to both we have the following attributes:
|
|
|
|
- Caption, a text fragment explaining what's in the picture/album.
|
|
|
|
Special to images additional attributes stored are:
|
|
|
|
- Rotation (floating point number)
|
|
|
|
- Mask, represented by the four border sizes; top, left, bottom,
|
|
right. All floating point.
|
|
|
|
- Thumbnail mask. Same as above, but applies to thumbnail images.
|
|
As these are very small there may be a need to focus on a detail
|
|
of the original image to have a visual cue about the subject of
|
|
the photo.
|
|
|
|
For albums the additional attributes are:
|
|
|
|
- Cover picture, the picture (or album) representing the album as a
|
|
whole for the purpose of a thumbnail.
|
|
|
|
|
|
Web Interface
|
|
=============
|
|
|
|
The theory of operation is that the directory holding all the
|
|
subdirectories with albums maps to a webapp. The URLs accepted by the
|
|
webapp reflect the directory structure of the photo directories, but
|
|
adds some twists to make it possible to represent thumbnails, medium
|
|
sized images and large images in addition to the album pages
|
|
themselves. URLs for the albums are:
|
|
|
|
/album/index-num.html
|
|
|
|
There is a configuration switch indicating how many thumbnails to
|
|
show per album page. This makes "num" in index-num.html represent the
|
|
associated subset of images. There are also one picture per page
|
|
pages. These have the pattern:
|
|
|
|
/album/filename.html
|
|
|
|
The individual pictures are accessed with URLs like the following:
|
|
|
|
/album/.../size/filename.ext
|
|
|
|
In this URL size has to be one of the following: "thumb", "medium",
|
|
"large". The (global?) configuration determines the actual size
|
|
constraints for each of the sizes. Only certain file extentions are
|
|
supported. Notably "jpeg" and "png". "html" can not be allowed as it
|
|
would destroy the page per picture setup.
|
|
|
|
|