Installation > prometheum directories
At this point you are probably asking yourself where the images live on the file system and how they are organized into albums? Albums are represented as directories, and images as files inside these directories. There is also a directory which contains all the albums. Lastly, the Prometheum application auto-generates thumbnails of various sizes, and another directory must exist to contain these.
Example
An example should help to clarify this. Lets say that you went to a raging party last night and took a picture of Jon making a fool of himself. Today, you took a trip to the beach with Jane and got a shot of a pot belly pig rolling in the sand and a turtle. Lets assume that you want to create an album for the party and another one for the beach and would like to store this data in your home directory located at /home/dorfmeister. The directory structure would be as follows:
/home/dorfmeister/
prometheum/
albums/
beach_with_Jane/
pot_belly_pig_rolling_in_the_sand.jpg
sea_turtle.jpg
raging_party/
jon_making_a_fool_of_himself.jpg
thumbnails/
As you can see in the example above, the prometheum directory contains the "albums" and "thumbnails" directories. We will cover the "albums" directory, then move on the "thumbnails" directory. Within the "albums" directory exist all of the albums which are themselves represented as directories. There are only two albums here, named "beach_with_Jane" and "raging_party". The "beach_with_Jane" album contains two images, one of the pig and the other of the sea turtle. The "raging_party" album contains only one image of Jon making a fool of himself. Now for an explanation of the "thumbnails" directory. This directory will contain all the images which Prometheum auto-generates, and you need not know the details of how it is organized, but rather only that it exists. The application will automatically create subdirectories of "thumbnails" for each album and place the resized versions of each image (of the respective album) there. Again, you need to create this directory, but it is not important beyond that.
Notes
- Please note that album and thumbnail directories need not be peers on the file system. As you will see in the configuration section below, the full path of each must be specified and consequently they can both be arbitrary directories on the filesystem. Again, the example above is simply the suggested layout.
- At least one album must exist in the albums directory for the application to boot.
So what directories do I need to create to get started?
There are only two primary directories you need to create to get started: the album and thumbnails directories. Per the note above, these can be anywhere on the file system, but I recommend the directory structure from the example. Keep the full paths of each of the directories handy for use in the configuration section below. There must also be at least one album in the albums directory (so technically speaking you need to create 3 directories).
|