1LAZYGAL.CONF(5) LAZYGAL.CONF(5)
2
3
4
6 lazygal.conf - Configuration file for lazygal, a static web gallery
7 generator.
8
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
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
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
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
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
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
188 lazygal(1)
189
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
200 Alexandre Rossi.
201
202
203
204 LAZYGAL.CONF(5)