0
|
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> |