Mercurial > bins

comparison binsrc @ 0:a84c32f131df 1.1.29

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import vendor version
author Peter Gervai <grin@grin.hu>
date Wed, 15 Oct 2008 23:28:56 +0200
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:a84c32f131df
1 <?xml version="1.0" encoding="UTF-8"?><!-- -*-xml-*- -->
2
3 <!--
4
5 This is the BINS configuration file. See http://bins.sautret.org for
6 more information about BINS.
7
8 You can edit these parameters to personalize all the generated HTML
9 albums. You can also put these parameters (when it makes sense) in the
10 album (album.xml) or image (image_name.jpg.xml for example)
11 description files, in the <bins> section of these files, to
12 personalize only some album, sub-album or image pages.
13
14 Note that you may have to "touch" the original image (or erase the
15 destination one) in order to regenerate scaled or thumbnail pictures
16 if you modify some parameters like previewMaxHeight, previewMaxWidth
17 or jpegQuality.
18
19 -->
20
21 <bins>
22
23 <!--####################### single parameters ########################-->
24
25 <!-- name of the template style to use -->
26 <parameter name="templateStyle">
27 swigs
28 </parameter>
29
30 <!-- Set this to your home page. This is used for the leave button
31 in some templates. -->
32 <parameter name="homeURL">
33 /
34 </parameter>
35
36 <!-- Put here the e-mail address of the album-maintainer. If this is
37 set, you will get a mail-icon in your views that links to this
38 address. Only in joi templates for now. -->
39 <parameter name="feedbackMail">
40 </parameter>
41
42 <!-- name of the color style to use. This option is deprecated, in
43 favor of alternate stylesheets and the customStyleSheet parameter.
44 -->
45 <parameter name="colorStyle">
46 blue
47 </parameter>
48
49 <!-- If set to 1, preview-thumbnails will be shown in the
50 album-tree-page. This works only with joi templates for now. -->
51 <parameter name="treePreview">
52 1
53 </parameter>
54
55 <!-- If set to 0 next/prev-Links will be hidden if the actual page
56 is the last/first Thumbnailpage -->
57 <parameter name="thumbnailPageCycling">
58 0
59 </parameter>
60
61 <!-- If set to 1 the path in the imageview contains the number of
62 the current image -->
63 <parameter name="pathImgNum">
64 1
65 </parameter>
66
67 <!-- If set to 0 next/prev-Links will be hidden if the actual page
68 is the last/first Imagepage -->
69 <parameter name="imagePageCycling">
70 0
71 </parameter>
72
73 <!-- If set to 1 the path contains icons -->
74 <parameter name="pathShowIcon">
75 1
76 </parameter>
77
78 <!-- If set to 1, and album desciption is not set, no message will
79 be displayed (instead of the "No long/short description available"
80 one). -->
81 <parameter name="emptyAlbumDesc">
82 1
83 </parameter>
84
85 <!-- Set this to the image that should be displayed as the
86 background of the album-pages. The Image will be copied to the
87 static-files directory. This works only with joi templates for
88 now.-->
89 <parameter name="backgroundImage">
90 </parameter>
91
92 <!-- Set this to the CSS file that should be used as the stylesheet
93 for the album pages. The CSS file will be copied to the static
94 files directory. This only works for templates using CSS. -->
95 <parameter name="customStyleSheet">
96 </parameter>
97
98 <!-- If set to 1, the image with the name given in backgroundImage
99 will be excluded from the current directory. -->
100 <parameter name="excludeBackgroundImage">
101 1
102 </parameter>
103
104 <!-- If set to 1, write exif data found in the image file to the
105 image desc file. -->
106 <parameter name="addExifToDescFile">
107 1
108 </parameter>
109
110 <!-- If set to 1, do NOT copy exif data found in the source images to
111 any of the generated resized images. Setting this option can yield
112 significant space savings, especially for thumbnail and imagelist
113 pages. -->
114 <parameter name="deExifyImages">
115 0
116 </parameter>
117
118 <!-- If set to 1, add empty description fields in the <description>
119 section when the image description file is created to ease later
120 editing with a text editor -->
121 <parameter name="createEmptyDescFields">
122 1
123 </parameter>
124
125 <!-- Specify the format of date strings; this accepts all formats
126 supported by date(1). -->
127 <parameter name="dateString">
128 %c
129 </parameter>
130
131 <!-- Put here a comma separated list of keywords. If one of these
132 keywords is found in the "ignore" field in the <description> section
133 of a album.xml, then this sub-album will be hidden, i.e. it will be
134 generated but not linked anywhere. Note that it may still be found
135 via the search engine. You can also use the -n command line option.
136 -->
137 <parameter name="hidden">
138 hidden
139 </parameter>
140
141 <!-- Put here a comma separated list of keywords. If one of these
142 keywords is found in the "ignore" field in the <description> section
143 of an album.xml, then this sub-album will be ignored, i.e. it
144 will not be processed. You can also use the -i command line option.
145 -->
146 <parameter name="ignore">
147 ignore
148 </parameter>
149
150 <!-- Quality of scaled jpegs (lower number = more compression,
151 lower quality) in 1-100 range. -->
152 <parameter name="jpegQuality">
153 75
154 </parameter>
155
156 <!-- whether to convert generated jpegs to progressive using
157 jpegtran (if available). Can be never, always, or smaller (if the
158 progressified file is smaller than the baseline). -->
159 <parameter name="jpegProgressify">
160 smaller
161 </parameter>
162
163 <!-- Should the title be displayed on top on the thumbnail in the
164 thumbnails page ? (1 = yes, 0 = no)-->
165 <parameter name="titleOnThumbnail">
166 1
167 </parameter>
168
169 <!-- Are we reversing sorting order for pictures or directories ?
170 0=none, 1=dirs, 2=pix, 3=both
171 (see also -r command line option -->
172 <parameter name="reverseOrder">
173 0
174 </parameter>
175
176 <!-- Size to use when user clicks directly on the thumbnail in the
177 thumbnails page instead of one of the size names. 0 is the first
178 size (Small in the default config), 1 the second (Medium), and so
179 on. The different sizes are parameterized in the <sizes> section
180 below. Set this value to -1 if you don't want the thumbnail to
181 be clickable. -->
182 <parameter name="defaultSize">
183 1
184 </parameter>
185
186 <!-- Display thumbnails on the Image List page ? -->
187 <parameter name="thumbnailInImageList">
188 1
189 </parameter>
190
191 <!-- If set to 1, display the current album thumbnail in sub-albums
192 page if it has pictures, with links to the thumbnails page. -->
193 <parameter name="albumThumbInSubAlbumPage">
194 1
195 </parameter>
196
197 <!-- If set to 1, generate a page with all thumbnails in the album
198 and sub-albums. This is deactivated because it is an alpha feature
199 which doesn't seem to work properly. -->
200 <parameter name="allThumbnailsPage">
201 0
202 </parameter>
203
204 <!-- Width of the border of the thumbnail's image in the thumbnails
205 page, in pixels. 0 means no border. -->
206 <parameter name="borderOnThumbnails">
207 0
208 </parameter>
209
210 <!-- If 1, add a background color to the thumbnail's cell in the
211 thumbnails page so that if the top and bottom borders are wider than
212 the image (for example, if it is in portrait mode), instead of
213 spilling over, there is a border around the whole picture. -->
214 <parameter name="thumbnailBackground">
215 0
216 </parameter>
217
218 <!-- Number of thumbnails displayed in each page in an album. -->
219 <parameter name="numThumbsPerPage">
220 16
221 </parameter>
222
223 <!-- Number of thumbnails displayed in each row in an album. -->
224 <parameter name="thumbsPerRow">
225 4
226 </parameter>
227
228 <!-- Max Thumbnail width -->
229 <parameter name="previewMaxWidth">
230 150
231 </parameter>
232
233 <!-- Max thumbnail height -->
234 <parameter name="previewMaxHeight">
235 150
236 </parameter>
237
238 <!-- If set to 1, display thumbnails close to the previous and next
239 link at the bottom of the image page -->
240 <parameter name="thumbPrevNext">
241 1
242 </parameter>
243
244 <!-- Do we rotate images if the Orientation Exif tag is found ? If
245 set to 'original', the original image is rotated the first time, and
246 then it is left untouched (unless the Orientation field in its desc
247 file is modified manually). If set to 'destination', this is all the
248 scaled images and thumnails that are rotated. This is less
249 efficient, but the original images are preserved. If set to 'none',
250 no rotation is performed. -->
251 <parameter name="rotateImages">
252 destination
253 </parameter>
254
255 <!-- If set to 1, bins tries to use the jpegtran program to rotate
256 JPEG images if it is available. jpegtran is faster and lossless,
257 but some versions fail to perform rotation correctly, so it is
258 deactivated in default config. If set to 0 or if jpegtran is not
259 found, mogrify (from ImageMagick) is used. -->
260 <parameter name="rotateWithJpegtran">
261 0
262 </parameter>
263
264 <!-- What method should be used to create scaled pictures and
265 thumbnails ? Can be either scale or sample. sample is faster, scale
266 is better. -->
267 <parameter name="scaleMethod">
268 scale
269 </parameter>
270
271 <!-- What to do if the source image is smaller than the size of the
272 generated image. If set to "enlarge" the generated image is
273 enlarged to the requested size. If set to "original" the generate
274 image is the same size as the original image. If set to "skip" do
275 not generate any image. -->
276 <parameter name="whenSrcSmaller">
277 enlarge
278 </parameter>
279
280 <!-- If set to 1, we scale the picture even if destination size is
281 the same as the original picture, if set to 0, the original image is
282 just copied if the size is correct. -->
283 <parameter name="scaleIfSameSize">
284 0
285 </parameter>
286
287 <!-- If set to 1, we link the picture instead of copying it if
288 possible (i.e. scaleIfSameSize is set to 0 and destination image
289 doesn't have to be rotated : rotateImages is set to original or
290 none, or orientation is already correct). Warning : if
291 whenSrcSmaller is set to enlarge, original image can be modified.
292 -->
293 <parameter name="linkInsteadOfCopy">
294 0
295 </parameter>
296
297 <!-- If set to 1, we use a relative path for the link if
298 linkInsteadOfCopy is set to 1. -->
299 <parameter name="linkRelative">
300 1
301 </parameter>
302
303 <!-- If the number of sub albums is greater, generate a short sub
304 album page instead of the long one. -->
305 <parameter name="maxAlbumsForLongSubAlbum">
306 40
307 </parameter>
308
309 <!-- If set to 1, numbers preceding the album title, followed by an
310 underscore, are stripped. If this parameter is set, then prefix
311 ordering numbers on directories are removed. For example, if one
312 has directories may, june, and august, they can be renamed 0_may,
313 1_june, and 2_august and they will appear in the album in the
314 correct order. This can be overridden by the -p command line
315 option.-->
316 <parameter name="stripDirPrefix">
317 1
318 </parameter>
319
320 <!-- Don't perform rotation on files matching this regexp -->
321 <parameter name="noRotation">
322 _Orig$
323 </parameter>
324
325 <!-- exclude directories that match this regexp (if set). -->
326 <parameter name="excludeDirs">
327 ^(CVS|RCS)$
328 </parameter>
329
330 <!-- exclude image files that match this regexp (if set). -->
331 <parameter name="excludeFiles">
332 </parameter>
333
334 <!-- If set to 1, generated HTML code is cleaned up to reduce the
335 size of pages and thus speed up browsing. This reduces the size of
336 HTML BINS files by about 30%. See HTML::Clean(3) to know how
337 optimizations are performed. -->
338 <parameter name="compactHTML">
339 1
340 </parameter>
341
342 <!-- If set to 1, add some javascript code in image pages to
343 preload the next image of the same size when the current one is loaded,
344 to speed up the album browsing. -->
345 <parameter name="javaScriptPreloadImage">
346 1
347 </parameter>
348
349 <!-- If set to 1, add some javascript code in thumbnails pages to
350 preload thumbnails of the next page when the current one is loaded, to
351 speed up the album browsing. -->
352 <parameter name="javaScriptPreloadThumbs">
353 1
354 </parameter>
355
356
357 <!-- If 1, generate a search page. Images can be searched on
358 description fields set in the searchFields parameter. -->
359 <parameter name="searchEngine">
360 1
361 </parameter>
362
363 <!-- Maximum results returned by the search engine. Note that if
364 this number is too high, it can hang the browser. -->
365 <parameter name="searchLimit">
366 50
367 </parameter>
368
369 <!-- Space separated list of description field names used by the
370 search engine, if searchEngine is set to 1. -->
371 <parameter name="searchFields">
372 title description people location event comment
373 </parameter>
374
375 <!-- If 1, create an Apache .htaccess file in the root dir of the
376 album with the encoding charset bound to html and htm files. This is
377 a parameter global for the album, it can't be set in album.xml. -->
378 <parameter name="createHtaccess">
379 1
380 </parameter>
381
382 <!-- If set to 1, read permissions on images will be set, to ensure
383 http deamon will be able to read them. -->
384 <parameter name="updateOriginalPerms">
385 1
386 </parameter>
387
388 <!--######################## Size parameters ##########################-->
389
390 <!-- you can change here the number of scaled images that will be
391 generated for each image in the albums, as well as their names and
392 sizes. The size can be a percentage of the original picture (a
393 number followed by % character, with no space) or an absolute size in
394 pixels. You can set any number of <size> tags (well, at least
395 one...). -->
396 <sizes>
397 <size name="Small" shortname="Sm" height="40%" width="40%"/>
398 <size name="Medium" shortname="Med" height="60%" width="60%"/>
399 <size name="Large" shortname="Lg" height="100%" width="100%"/>
400 </sizes>
401
402 <!--####################### Color parameters #########################-->
403
404 <!-- these are the colors to use for HTML generation. You can also
405 use these tags in the <bins> section of album or image description
406 files, even just some of the <color> tags (in this case, this will
407 just change the corresponding item color for that album/picture).
408 -->
409 <colors style="blue">
410 <color name="PAGE_BACK">
411 #FFFFFF
412 </color>
413 <color name="PAGE_TITLE">
414 #000000
415 </color>
416 <color name="MAINBAR_BACK">
417 #000077
418 </color>
419 <color name="MAINBAR_TITLE">
420 #FFFFFF
421 </color>
422 <color name="MAINBAR_LINK">
423 #EEDD82
424 </color>
425 <color name="MAINBAR_CURRENTPAGE">
426 #D2D2D2
427 </color>
428 <color name="SUBBAR_BACK">
429 #6060AF
430 </color>
431 <color name="SUBBAR_LINK">
432 #EEDD82
433 </color>
434 <color name="SUBBAR_CURRENTPAGE">
435 #FFFFFF
436 </color>
437 <color name="SUBBAR_TITLE">
438 #FFFFFF
439 </color>
440 </colors>
441 <colors style="green">
442 <color name="PAGE_BACK">
443 #FFFFFF
444 </color>
445 <color name="PAGE_TITLE">
446 #000000
447 </color>
448 <color name="MAINBAR_BACK">
449 #90A080
450 </color>
451 <color name="MAINBAR_TITLE">
452 #FFFFFF
453 </color>
454 <color name="MAINBAR_LINK">
455 #000082
456 </color>
457 <color name="MAINBAR_CURRENTPAGE">
458 #000000
459 </color>
460 <color name="SUBBAR_BACK">
461 #A8B898
462 </color>
463 <color name="SUBBAR_LINK">
464 #0000A0
465 </color>
466 <color name="SUBBAR_CURRENTPAGE">
467 #000000
468 </color>
469 <color name="SUBBAR_TITLE">
470 #FFFFFF
471 </color>
472 </colors>
473 <colors style="ivory">
474 <color name="PAGE_BACK">
475 #8B7E66
476 </color>
477 <color name="PAGE_TITLE">
478 #FFFFFF
479 </color>
480 <color name="MAINBAR_BACK">
481 #FFFFF0
482 </color>
483 <color name="MAINBAR_TITLE">
484 #8B4513
485 </color>
486 <color name="MAINBAR_LINK">
487 #CD853F
488 </color>
489 <color name="MAINBAR_CURRENTPAGE">
490 #000000
491 </color>
492 <color name="SUBBAR_BACK">
493 #FFEBCD
494 </color>
495 <color name="SUBBAR_LINK">
496 #8B8682
497 </color>
498 <color name="SUBBAR_CURRENTPAGE">
499 #000000
500 </color>
501 <color name="SUBBAR_TITLE">
502 #8B795E
503 </color>
504 </colors>
505 <colors style="pink">
506 <color name="PAGE_BACK">
507 #FFC0CB
508 </color>
509 <color name="MAINBAR_BACK">
510 #B03060
511 </color>
512 <color name="MAINBAR_TITLE">
513 #FFFFFF
514 </color>
515 <color name="MAINBAR_LINK">
516 #FFBBFF
517 </color>
518 <color name="MAINBAR_CURRENTPAGE">
519 #000000
520 </color>
521 <color name="SUBBAR_BACK">
522 #FF69B4
523 </color>
524 <color name="SUBBAR_LINK">
525 #FFBBFF
526 </color>
527 <color name="SUBBAR_CURRENTPAGE">
528 #000000
529 </color>
530 <color name="SUBBAR_TITLE">
531 #FFFFFF
532 </color>
533 </colors>
534 </bins>