diff options
Diffstat (limited to 'templates/classic/default.xml')
| -rw-r--r-- | templates/classic/default.xml | 163 |
1 files changed, 163 insertions, 0 deletions
diff --git a/templates/classic/default.xml b/templates/classic/default.xml new file mode 100644 index 0000000..8cf709e --- /dev/null +++ b/templates/classic/default.xml @@ -0,0 +1,163 @@ +<?xml version="1.0" encoding="utf-8"?> +<design_setup version="2.0"> + + <!-- image size definitions --> + <image_sizes> + <!-- Every image size automatically corresponds to the <item> tag parameter + of the same name in album source files. E.g. image size named "hires" + would correspond to <item hires=".."> tags. Use the image size parameter + "tagname" to override that. --> + + <!-- "original", "preview" and "thumbnail" sizes are somewhat special here + in order to keep compatibility with previous versions. --> + + <!-- Meaning of "original" is shifted here from previous versions; + it's considered more like a bigger preview size for large screens now. + However it still serves the purpose of supplying metadata (EXIF etc.). --> + <!-- Corresponds with mandatory <item src> tag in album source file. --> + <!-- Note that the series of legacy <nofullsize> and <fullsize> tags control + this image size availability on the page. --> + <size name="original"> + <landscape w="1200" h="800" /> + <portrait w="1024" h="1024" /> + <quality value="97" /> + <!-- With the presence of the "no_resize" tag, no resizing will be done and + image file will be copied as is (this is a default for backwards + compatibility). --> + <no_resize /> + <!-- Normally an image is resized to the given dimensions from the original + image when an image is not supplied from the album XML file for the + particular image size. This tag tells the generator to use the fallback + image size instead when an image has not been supplied. Can be freely + combined with the <no_resize /> tags, in that case it only applies + to supplied images. --> + <!-- In case when the "original" size is not available due to the legacy + <nofullsize> tag present, the "preview" size will be used instead. --> + <fallback size="preview" /> + </size> + + <!-- The "preview" size is considered default and should be displayed + on a first visit. --> + <size name="preview" tagname="preview"> + <!-- Note that "preview" sizes can be further overriden by album legacy + <images> tag and also per-image by "width"/"height" <item> tag + attributes. Same goes for quality. --> + <landscape w="1067" h="600" /> + <portrait w="800" h="800" /> + <quality value="95" /> + <!-- Similar to the "original" size where the image has to be always supplied, + the image won't get resized only when an image file is supplied by the + <item preview="..."> tag. Otherwise this tag is ignored and image will + be resized from the "original" size (backwards compatibility). + This rule applies also for any other optional image sizes. --> + <no_resize /> + </size> + + <!-- Thumbnail section is mandatory. --> + <!-- The "type" attribute has to be set to "thumbnail" to be treated as such. --> + <!-- Note that thumbnail images are always resized even for custom supplied files. --> + <!-- An optional "style" attribute affects cropping: + * normal - image is resized to fit the dimension limits, maintaining + aspect ratio without any crop (default) + * squared - image is cropped to a squared size and resized to fit + * fixed - image is cropped to a specified dimension and cropped to + fit the specified aspect ratio + An optional album item <thumbnail crop> tags may affect the crop area. --> + <size name="thumbnail" type="thumbnail" style="normal"> + <landscape w="180" h="120" /> + <portrait w="120" h="180" /> + <square size="180" /> + <crop w="180" h="120" /> <!-- valid only for the "fixed" crop style --> + <quality value="80" /> + </size> + + <!-- Here you can define custom sizes which will be generated from the file + defined in <item src> tag. Currently, there's no way how to supply custom + sized images from album source file (might be changed in the future). --> + <size name="mobile"> + <landscape w="320" h="240" /> + <portrait w="240" h="320" /> + <quality value="90" /> + </size> + </image_sizes> + + <!-- Global support files, common files used by several themes. --> + <supplemental_files><![CDATA[ + ]]></supplemental_files> + + + <!-- particular design setup --> + <theme enabled="yes"> + <!-- Index pages may only contain thumbnails. When the <index> structure is + missing, album design will be used for both list of albums and list + of pictures. --> + <index> + <template>template_index.html</template> + <target_filename>index.html</target_filename> + <!-- specify thumbnail image size to be used here. --> + <thumbnail_size>thumbnail</thumbnail_size> + <!-- In case of a protected album, show special thumbnail (must be included + in supplemental_files). Comment out to use real thumbnail. --> + <protected_thumbnail>emblems-readonly_120.png</protected_thumbnail> + </index> + + <!-- Album definition is mandatory. --> + <album> + <template>template_album.html</template> + <target_filename>index.html</target_filename> + <!-- thumbnail_size is optional, omit it when thumbnails are not used on + album pages (will skip some tags substitution). --> + <thumbnail_size>thumbnail</thumbnail_size> + <!-- Just like thumbnail_size, also picture_size is optional, omit it + when images in their full sizes are not used on album pages. --> + <picture_size>preview</picture_size> + </album> + + <!-- When the <picture> structure is missing, no pages for the particular + images will be generated. Images are processed in either case, for + potential use within album pages. --> + <picture> + <template>template_picture.html</template> + <!-- '%s' will be replaced with actual picture filename --> + <target_filename>%s.html</target_filename> + <!-- which picture size to use --> + <picture_size>preview</picture_size> + </picture> + + <!-- support files for current theme --> + <!-- should include all used CSS styles, images, scripts... --> + <!-- subdirectories are allowed and will be mirrored to destination --> + <supplemental_files><![CDATA[ + styles.css + scripts-general.js + emblems-readonly_120.png + ]]></supplemental_files> + + <!-- User defines, used in theme templates. Value is optional, empty string + will be used if value was requested but not specified. Defines can either + act as block conditionals (combo "ifdef(DEFINE_NAME)" and "endif(DEFINE_NAME)") + or as a value constant (specify "value(DEFINE_NAME)" to retrieve the value). + For "ifdef" negation, use "ifndef" or "else". --> + <!-- Some defines are added during runtime and take priority over custom defines + here. This way you can define default values which would get eventually + overriden by the generator. --> + + <!-- image border style, overriden by <border style> tags from the album source file --> + <define name="BORDER_STYLE" value="border_single" /> + <!-- show EXIF table in single photo view (comment out to hide it) --> + <define name="SHOW_EXIF_TABLE" /> + <!-- show "Go Up..." links if not top-level --> + <define name="SHOW_GO_UP" /> + + <!-- Other defines set by the generator: + IS_ROOT - indicates whether the index/album page is a main (root) page + --> + </theme> + + <!-- Here you can define another theme, with different templates etc. + The purpose is to allow switching between them or as a result of + device capabilities autodetection. Don't forget to change target + filenames to avoid conflicts. --> + +</design_setup> + |