lazygal.conf(5)

1LAZYGAL.CONF(5)                                                LAZYGAL.CONF(5)
2
3
4

NAME

6       lazygal.conf  -  Configuration  file  for lazygal, a static web gallery
7       generator.
8

FORMAT DESCRIPTION

10       lazygal is configured using JSON files.  The format looks like this:
11
12              {
13                  "sectionname": {
14                      "variable"     : "string value ",
15                      "boolean"      : false,
16                      "list"         : ["foo", "bar"],
17                      "dictionary"  : {
18                          "key1": "value1",
19                          "key2": "value2"
20                      }
21                  },
22                  "othersection": {
23                      "foo"          : "bar"
24                  }
25              }
26
27       This format is the preferred way to configure LAZYGAL.
28

LEGACY FORMAT DESCRIPTION (INI)

30       The configuration file can also be an INI like file.  The format  looks
31       like this:
32
33              [sectionname]
34              variable = string value
35              boolean = Yes
36              list = foo, bar
37              dictionary = key1=value1, key2=value2
38
39              [othersection]
40              foo = bar
41
42       In  this INI format, boolean values can be conveniently set in the fol‐
43       lowing ways:
44
45       • For True: 1, yes, true, and on.
46
47       • For False: 0, no, false, and off.
48
49       Please    refer    to    the    python    ConfigParser    documentation
50       (http://docs.python.org/library/configparser.html) for more information
51       on the file format.
52

runtime section

54       The runtime defines the runtime parameters.
55
56       quiet  Boolean.  Same as --quiet  in  LAZYGAL  if  True.   (default  is
57              False).
58
59       debug  Boolean.  Same as --debug in LAZYGAL if True (default is False).
60
61       check-all-dirs
62              Boolean.  Same as --check-all-dirs in LAZYGAL if True.  (default
63              is False).
64

global section

66       The global defines the global parameters.  Those  parameters  apply  to
67       all the sub-galleries.
68
69       output-directory
70              Same  as --output-directory=DEST_DIR in LAZYGAL (default is cur‐
71              rent directory).
72
73       clean-destination
74              Boolean.  Same as --clean-destination in LAZYGAL if True.
75
76       preserve
77              Same as --preserve=PATTERN in LAZYGAL.  Multiple values  may  be
78              separated by commas.
79
80       exclude
81              Same  as  --exclude=PATTERN  in LAZYGAL.  Multiple values may be
82              separated by commas.
83
84       dir-flattening-depth
85              Same as --dir-flattening-depth=LEVEL in LAZYGAL.
86
87       puburl Same as --puburl=PUB_URL in LAZYGAL.
88
89       theme  Same as --theme=THEME in LAZYGAL.
90

webgal section

92       The webgal defines the parameters for a web-gallery.
93
94       default-style
95              Same as --default-style=DEFAULT_STYLE in LAZYGAL.
96
97       webalbumpic-bg
98              Same as --webalbum-pic-bg=WEBALBUMPIC_BG in LAZYGAL.
99
100       webalbumpic-type
101              Same as --webalbum-pic-type=WEBALBUMPIC_BG in LAZYGAL.   If  you
102              set  this  to  'tidy' you may also consider setting webalbumpic-
103              size (see below) to something smaller than the default 200x150.
104
105       webalbumpic-size
106              Size of picture mash-up representing galleries, eg.  200x150.
107
108       image-size
109              Same as --image-size=IMAGE_SIZE in LAZYGAL.  Syntax in the  con‐
110              fig file can be either of the following equivalent forms:
111
112                     "image-size": [
113                         {"name": "small", "defs": "800x600", "default": true},
114                         {"name": "medium", "defs": "1024x768"}
115                     ]
116
117              or with implicit default as first entry:
118
119                     "image-size": {
120                         "small" : "800x600",
121                         "medium": "1024x768"
122                     }
123
124       thumbnail-size
125              Same as --thumbnail-size=THUMBNAIL_SIZE in LAZYGAL.
126
127       video-size
128              Size of videos, eg.  0x0.  Refer to the IMAGE RESIZE DESCRIPTION
129              section for more information on the available syntax.
130
131              In addition, size can be the name of a previously  declared  im‐
132              age-size.
133
134       thumbs-per-page
135              Same as --thumbs-per-page=THUMBS_PER_PAGE in LAZYGAL.
136
137       sort-medias
138              Same as --pic-sort-by=ORDER in LAZYGAL.
139
140       sort-subgals
141              Same as --subgal-sort-by=ORDER in LAZYGAL.
142
143       original
144              Boolean.   Same  as  --original  in  LAZYGAL if True (default is
145              False).
146
147       original-baseurl
148              Same as --orig-base=RELATIVE_PATH in LAZYGAL.
149
150       original-symlink
151              Boolean.  Same as --orig-symlink in LAZYGAL if True (default  is
152              False).
153
154       dirzip Same as --make-dir-zip in LAZYGAL if True (default is False).
155
156       jpeg-quality
157              Same as --quality=QUALITY in LAZYGAL.
158
159       jpeg-optimize
160              Boolean.   Run  an  extra  optimization  pass for each generated
161              thumbnail if True, the default.
162
163       jpeg-progressive
164              Generate progressive JPEG images if True, the default.
165
166       publish-metadata
167              Publish image metadata if True, the default: copy original image
168              metadata in reduced picture, and include some information in the
169              image page.
170
171       filter-by-tag
172              Same as --filter-by-tag=TAG in LAZYGAL.
173

template-vars section

175       The template-vars defines the custom template variables.  The variables
176       and their value are listed in this section.
177
178       For  instance,  $footer is a template variable in the default template.
179       Its value can be defined with this configuration file:
180
181              {
182                  "template-vars": {
183                      "footer": "<p>All pics are copyright 2011 me</p>"
184                  }
185              }
186

AUTHOR

191       This manual page was written for the DEBIAN system (but may be used  by
192       others).   Permission is granted to copy, distribute and/or modify this
193       document under the terms of the GNU General Public License,  Version  2
194       any later version published by the Free Software Foundation.
195
196       On  Debian systems, the complete text of the GNU General Public License
197       can be found in /usr/share/common-licenses/GPL.
198

AUTHORS

200       Alexandre Rossi.
201
202
203
204                                                               LAZYGAL.CONF(5)