49762e1a526e670d1dd77d2eab85dfd1e7df8583
[booh] / bin / booh
1 #!/usr/bin/ruby
2 #
3 #                         *  BOOH  *
4 #
5 # A.k.a `Best web-album Of the world, Or your money back, Humerus'.
6 #
7 # The acronyn sucks, however this is a tribute to Dragon Ball by
8 # Akira Toriyama, where the last enemy beaten by heroes of Dragon
9 # Ball is named "Boo". But there was already a free software project
10 # called Boo, so this one will be it "Booh". Or whatever.
11 #
12 #
13 # Copyright (c) 2004 Guillaume Cottenceau <gc3 at bluewin.ch>
14 #
15 # This software may be freely redistributed under the terms of the GNU
16 # public license version 2.
17 #
18 # You should have received a copy of the GNU General Public License
19 # along with this program; if not, write to the Free Software
20 # Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21
22 require 'getoptlong'
23 require 'gettext'
24 include GetText
25 require 'rexml/document'
26 include REXML
27
28 require 'booh/booh-lib'
29 require 'booh/html-merges'
30
31 #- bind text domain as soon as possible because some _() functions are called early to build data structures
32 bindtextdomain("booh")
33
34 #- options
35 $options = [
36     [ '--help',          '-h', GetoptLong::NO_ARGUMENT,       _("Get help message") ],
37
38     [ '--no-check',      '-n', GetoptLong::NO_ARGUMENT,       _("Don't check for needed external programs at startup") ],
39
40     [ '--source',        '-s', GetoptLong::REQUIRED_ARGUMENT, _("Directory which contains original images/videos as files or subdirs") ],
41     [ '--destination',   '-d', GetoptLong::REQUIRED_ARGUMENT, _("Directory which will contain the web-album") ],
42 #    [ '--clean',         '-c', GetoptLong::NO_ARGUMENT,       _("Clean destination directory") ],
43
44     [ '--theme',         '-t', GetoptLong::REQUIRED_ARGUMENT, _("Select HTML theme to use") ],
45     [ '--config',        '-C', GetoptLong::REQUIRED_ARGUMENT, _("File containing config listing images and videos within directories with captions") ],
46     [ '--config-skel',   '-k', GetoptLong::REQUIRED_ARGUMENT, _("Filename where the script will output a config skeleton") ],
47     [ '--merge-config',  '-M', GetoptLong::REQUIRED_ARGUMENT, _("File containing config listing, where to merge new images/videos from --source") ],
48
49     [ '--sizes',         '-S', GetoptLong::REQUIRED_ARGUMENT, _("Specify the list of images sizes to use instead of all specified in the theme (this is a comma-separated list)") ],
50
51     [ '--mproc',         '-m', GetoptLong::REQUIRED_ARGUMENT, _("Specify the number of processors for multi-processors machines") ],
52
53     [ '--for-gui',       '-g', GetoptLong::NO_ARGUMENT,       _("Do the minimum work to be able to see the album under the GUI (don't generate all thumbnails)") ],
54
55     [ '--verbose-level', '-v', GetoptLong::REQUIRED_ARGUMENT, _("Set max verbosity level (0: errors, 1: warnings, 2: important messages, 3: other messages)") ],
56 ]
57
58 #- default values for some globals 
59 $switches = []
60 $stdout.sync = true
61
62 def usage
63     puts _("Usage: %s [OPTION]...") % File.basename($0)
64     $options.each { |ary|
65         printf " %3s, %-15s %s\n", ary[1], ary[0], ary[3]
66     }
67 end
68
69 def handle_options
70     parser = GetoptLong.new
71     parser.set_options(*$options.collect { |ary| ary[0..2] })
72     begin
73         parser.each_option do |name, arg|
74             case name
75             when '--help'
76                 usage
77                 exit(0)
78
79             when '--no-check'
80                 $no_check = true
81
82             when '--source'
83                 $source = arg.sub(%r|/$|, '')
84                 if !File.directory?($source)
85                     die _("Argument to --source must be a directory")
86                 end
87             when '--destination'
88                 $dest = arg.sub(%r|/$|, '')
89                 if File.exists?($dest) && !File.directory?($dest)
90                     die _("If --destination exists, it must be a directory")
91                 end
92                 if $dest != make_dest_filename($dest)
93                     die _("Sorry, destination directory can't contain non simple alphanumeric characters.")
94                 end
95 #            when '--clean'
96 #                system("rm -rf #{$dest}")
97
98             when '--theme'
99                 $theme = arg
100             when '--config'
101                 if File.readable?(arg)
102                     $xmldoc = REXML::Document.new File.new(arg)
103                     $mode = 'use_config'
104                 else
105                     die _('Config file does not exist or is unreadable.')
106                 end
107             when '--config-skel'
108                 if File.exists?(arg)
109                     msg 1, _("Config skeleton file already exists, backuping to %s.backup") % arg
110                     File.rename(arg, "#{arg}.backup")
111                 end
112                 $config_writeto = arg
113                 $mode = 'gen_config'
114             when '--merge-config'
115                 if File.readable?(arg)
116                     msg 2, _("Merge config notice: backuping current config file to %s.backup") % arg
117                     $xmldoc = REXML::Document.new File.new(arg)
118                     File.rename(arg, "#{arg}.backup")
119                     $config_writeto = arg
120                     $mode = 'merge_config'
121                 else
122                     die _('Config file does not exist or is unreadable.')
123                 end
124
125             when '--sizes'
126                 $limit_sizes = arg
127
128             when '--mproc'
129                 $mproc = arg.to_i
130                 $pids = []
131
132             when '--for-gui'
133                 $forgui = true
134
135             when '--verbose-level'
136                 $verbose_level = arg.to_i
137
138             end
139         end
140     rescue
141         puts $!
142         usage
143         exit(1)
144     end
145
146     if !$source && $xmldoc
147         $source = $xmldoc.root.attributes['source']
148         $dest = $xmldoc.root.attributes['destination']
149         $theme = $xmldoc.root.attributes['theme']
150         $limit_sizes = $xmldoc.root.attributes['limit-sizes']
151     end
152
153     if !$source
154         die _("Missing --source or --config parameter.")
155     end
156     if !$dest
157         die _("Missing --destination parameter.")
158     end
159     if !$theme
160         $theme = 'simple'
161     end
162
163     select_theme($theme, $limit_sizes)
164
165     if !$xmldoc
166         additional_params = ''
167         if $limit_sizes
168             additional_params += "limit-sizes='#{$limit_sizes}'"
169         end
170         $xmldoc = Document.new "<booh version='#{$VERSION}' source='#{utf8($source)}' destination='#{utf8($dest)}' theme='#{$theme}' #{additional_params}/>"
171         $xmldoc << XMLDecl.new(XMLDecl::DEFAULT_VERSION, $CURRENT_CHARSET)
172         $mode = 'gen_config'
173     end
174
175 end
176
177 def read_config
178     $config = {}
179 end
180
181 def write_config
182 end
183
184 def check_installation
185     if $no_check
186         return
187     end
188     missing = %w(convert identify exif transcode mencoder).delete_if { |prg| system("which #{prg} >/dev/null 2>/dev/null") }
189     if missing != []
190         die _("The following programs are typically needed: `%s'. Re-run with --no-check if you're sure you're fine without them.") % missing.join(', ')
191     end
192 end
193
194 def replace_line(surround, keyword, line)
195     begin
196         contents = eval "$#{keyword}"
197         line.sub!(/#{surround}#{keyword}#{surround}/, contents)
198     rescue TypeError
199         die _("No `%s' found for substitution") % keyword
200     end
201 end
202
203 def build_html_skeletons
204     $html_images     = File.open("#{$FPATH}/themes/#{$theme}/skeleton_image.html").readlines
205     $html_thumbnails = File.open("#{$FPATH}/themes/#{$theme}/skeleton_thumbnails.html").readlines
206     $html_index      = File.open("#{$FPATH}/themes/#{$theme}/skeleton_index.html").readlines
207     for line in $html_images + $html_thumbnails + $html_index
208         while line =~ /~~~(\w+)~~~/
209             replace_line('~~~', $1, line)
210         end
211     end
212 end
213
214 def find_caption_value(xmldir, filename)
215     xmldir.elements["[@filename='#{utf8(filename)}']"].attributes['caption']
216 end
217
218 def find_captions(xmldir, images)
219     return images.collect { |img| find_caption_value(xmldir, img) }
220 end
221
222 #- stolen from CVSspam
223 def urlencode(text)
224   text.sub(/[^a-zA-Z0-9\-,.*_\/]/) do
225     "%#{sprintf('%2X', $&[0])}"
226   end
227 end
228
229 def html_reload_to_thumbnails
230     html_reload_to_thumbnails = $preferred_size_reloader.clone
231     html_reload_to_thumbnails.gsub!(/~~theme~~/, $theme)
232     html_reload_to_thumbnails.gsub!(/~~default_size~~/, $default_size['name'])
233     return html_reload_to_thumbnails
234 end
235
236 def discover_iterations(iterations, line)
237     if line =~ /~~iterate(\d)_open(_max(\d+))?~~/
238         for iter in iterations.values
239             if iter['open']
240                 iter['open'] = false
241                 iter['close_wait'] = $1.to_i
242             end
243         end
244         iterations[$1.to_i] = { 'open' => true, 'max' => $3, 'opening' => '', 'closing' => '' }
245         if $1.to_i == 1
246             line.sub!(/.*/, '~~thumbnails~~')
247         else
248             line.sub!(/.*/, '')
249         end
250     elsif line =~ /~~iterate(\d)_close~~/
251         iterations[$1.to_i]['open']  = false;
252         iterations[$1.to_i]['close'] = true;
253         line.sub!(/.*/, '')
254     else
255         for iter in iterations.values
256             if iter['open']
257                 iter['opening'] += line
258                 line.sub!(/.*/, '')
259             end
260             if !iter['close'] && iter['close_wait'] && iterations[iter['close_wait']]['close']
261                 iter['closing'] += line
262                 line.sub!(/.*/, '')
263             end
264         end
265     end
266 end
267
268 def reset_iterations(iterations)
269     for iter in iterations.values
270         iter['value'] = 1
271     end
272 end
273
274 def run_iterations(iterations)
275     html = ''
276     for level in iterations.keys.sort
277         if iterations[level]['value'] == 1 || level == iterations.keys.max
278             html += iterations[level]['opening']
279         end
280         iterations[level]['value'] += 1
281         if iterations[level]['max'] && iterations[level]['value'] > iterations[level]['max'].to_i
282             iterations[level]['value'] = 1
283             iterations[level-1]['value'] = 1
284             html += iterations[level-1]['closing']
285         end
286     end
287     return html
288 end
289
290 def close_iterations(iterations)
291     html = ''
292     for level in iterations.keys.sort.reverse
293         html += iterations[level]['closing']
294     end
295     return html
296 end
297
298 def img_element(fullpath)
299     if size = get_image_size(fullpath)
300         sizespec = 'width="${size[:x]}" height="${size[:y]}"'
301     else
302         sizespec = ''
303     end
304     return '<img src="' + File.basename(fullpath) + '" ' + sizespec + ' border="0"/>'
305 end
306
307 def size2js(name)
308     return name.gsub(/-/, '')
309 end
310
311 def substitute_html_sizes(html, sizeobj, type)
312     sizestrings = []
313     if $images_size.length > 1 || (type == 'image' && $limit_sizes =~ /original/)
314         for sizeobj2 in $images_size
315             if sizeobj != sizeobj2
316                 if type == 'thumbnails'
317                     sizestrings << '<a href="thumbnails-' + sizeobj2['name'] + '.html">' + sizename(sizeobj2['name']) + '</a>'
318                 else
319                     sizestrings << '<a id="link' + size2js(sizeobj2['name']) + '">' + sizename(sizeobj2['name']) + '</a>'
320                 end
321             else
322                 sizestrings << sizename(sizeobj2['name'])
323             end
324         end
325         if type == 'image' && $limit_sizes =~ /original/
326             sizestrings << '<a id="linkoriginal" target="newframe">' + sizename('original') + '</a>'
327         end
328     end
329     html.sub!(/~~sizes~~(.+)~~/) { sizestrings.join($1) }
330 end
331
332 def walk_source_dir
333
334     `find #{$source} -type d`.sort.each { |dir|
335         dir.chomp!
336         if dir =~ /'/
337             die _("Source directory or sub-directories can't contain a single-quote character, sorry.")
338         end
339
340         #- place xml document on proper node if exists, else create
341         xmldir = $xmldoc.elements["//dir[@path='#{utf8(dir)}']"]
342         if $mode == 'use_config'
343             if !xmldir
344                 next
345             end
346         else
347             if $mode == 'gen_config' || ($mode == 'merge_config' && !xmldir)
348                 #- add the <dir..> element if necessary
349                 parent = File.dirname(dir)
350                 xmldir = $xmldoc.elements["//dir[@path='#{utf8(parent)}']"]
351                 if !xmldir
352                     xmldir = $xmldoc.root
353                 end
354                 xmldir = xmldir.add_element 'dir', { 'path' => utf8(dir) }
355             end
356         end
357
358         #- read images/videos entries from config or from directories depending on mode
359         entries = []
360         if $mode == 'use_config'
361             msg 2, _("Handling %s from config list...") % dir
362             xmldir.elements.each { |element|
363                 if %w(image video).include?(element.name)
364                     entries << from_utf8(element.attributes['filename'])
365                 end
366             }
367         else
368             msg 2, _("Examining %s...") % dir
369             entries = Dir.entries(dir).sort
370             #- populate config in case of gen_config, add new files in case of merge_config
371             for file in entries
372                 type = entry2type(file)
373                 if type && !xmldir.elements["#{type}[@filename='#{utf8(file)}']"]
374                     xmldir.add_element type, { "filename" => utf8(file), "caption" => utf8(file.sub(/\.[^\.]+$/, '')[0..17]) }
375                 end
376             end
377             if $mode == 'merge_config'
378                 #- cleanup removed files from config and reread entries from config to get proper ordering
379                 entries = []
380                 xmldir.elements.each { |element|
381                     fullpath = "#{dir}/#{from_utf8(element.attributes['filename'])}"
382                     if %w(image video).include?(element.name)
383                         if !File.readable?(fullpath)
384                             msg 1, _("Config merge: removing %s from config; use the backup file to retrieve caption info if this was a mistake") % fullpath
385                             xmldir.delete(element)
386                         else
387                             entries << from_utf8(element.attributes['filename'])
388                         end
389                     end
390                 }
391             end
392         end
393         images = entries.find_all { |e| entry2type(e) == 'image' }
394         msg 3, _("\t%s images") % images.length
395         videos = entries.find_all { |e| entry2type(e) == 'video' }
396         msg 3, _("\t%s videos") % videos.length
397
398         dest_dir = make_dest_filename(dir.sub(/^#{Regexp.quote($source)}/, $dest))
399         system("mkdir -p '#{dest_dir}'")
400
401         #- pass through if there are no images and videos
402         if images.size == 0 && videos.size == 0
403             next
404         end
405
406         msg 2, _("Outputting in %s...") % dest_dir
407
408         #- populate data structure with sizes from theme
409         for sizeobj in $images_size
410             fullscreen_images ||= {}
411             fullscreen_images[sizeobj['name']] = []
412             thumbnail_images ||= {}
413             thumbnail_images[sizeobj['name']] = []
414             thumbnail_videos ||= {}
415             thumbnail_videos[sizeobj['name']] = []
416         end
417         if $limit_sizes =~ /original/
418             fullscreen_images['original'] = []
419         end
420
421         images.size >= 1 and msg 3, _("\tcreating images thumbnails...")
422
423         #- create thumbnails for images
424         images.each { |img|
425             base_dest_img = dest_dir + '/' + make_dest_filename(img.sub(/\.[^\.]+$/, ''))
426             if $forgui
427                 thumbnail_dest_img = base_dest_img + "-#{$default_size['thumbnails']}.jpg"
428                 gen_thumbnails_element("#{dir}/#{img}", xmldir, true, [ { 'filename' => thumbnail_dest_img, 'size' => $default_size['thumbnails'] } ])
429             else
430                 for sizeobj in $images_size
431                     size_fullscreen = sizeobj['fullscreen']
432                     size_thumbnails = sizeobj['thumbnails']
433                     fullscreen_dest_img = base_dest_img + "-#{size_fullscreen}.jpg"
434                     thumbnail_dest_img  = base_dest_img + "-#{size_thumbnails}.jpg"
435                     fullscreen_images[sizeobj['name']] << File.basename(fullscreen_dest_img)
436                     thumbnail_images[sizeobj['name']]  << File.basename(thumbnail_dest_img)
437                     gen_thumbnails_element("#{dir}/#{img}", xmldir, true, [ { 'filename' => fullscreen_dest_img, 'size' => size_fullscreen },
438                                                                             { 'filename' => thumbnail_dest_img, 'size' => size_thumbnails } ])
439                 end
440                 if $limit_sizes =~ /original/
441                     fullscreen_images['original'] << img
442                 end
443                 destimg = "#{dest_dir}/#{img}"
444                 if $limit_sizes =~ /original/ && !File.exists?(destimg)
445                     psys("cp '#{dir}/#{img}' '#{destimg}'")
446                 end
447             end
448         }
449
450         videos.size >= 1 and msg 3, _("\tcreating videos thumbnails...")
451
452         #- create thumbnails for videos
453         videos.each { |video|
454             thumbnail_ok = true
455             if $forgui
456                 thumbnail_dest_img = dest_dir + '/' + make_dest_filename(video.sub(/\.[^\.]+$/, '')) + "-#{$default_size['thumbnails']}.jpg"
457                 thumbnail_ok &&= gen_thumbnails_element("#{dir}/#{video}", xmldir, true, [ { 'filename' => thumbnail_dest_img, 'size' => $default_size['thumbnails'] } ])
458             else
459                 for sizeobj in $images_size
460                     size_thumbnails = sizeobj['thumbnails']
461                     thumbnail_dest_img = dest_dir + '/' + make_dest_filename(video.sub(/\.[^\.]+$/, '')) + "-#{size_thumbnails}.jpg"
462                     thumbnail_videos[sizeobj['name']] << File.basename(thumbnail_dest_img)
463                     thumbnail_ok &&= gen_thumbnails_element("#{dir}/#{video}", xmldir, true, [ { 'filename' => thumbnail_dest_img, 'size' => size_thumbnails } ])
464                 end
465             end
466             destvideo = "#{dest_dir}/#{video}"
467             if !File.exists?(destvideo)
468                 psys("cp '#{dir}/#{video}' '#{destvideo}'")
469             end
470             #- cleanup temp
471             system("rm -f #{dest_dir}/screenshot.jpg000000.jpg")
472         }
473
474         if !$forgui
475             #- copy any resource file that goes with the theme (css, images..)
476             for entry in Dir.entries("#{$FPATH}/themes/#{$theme}")
477                 if !%w(. .. skeleton_image.html skeleton_thumbnails.html skeleton_index.html metadata CVS).include?(entry)
478                     if !File.exists?("#{dest_dir}/#{entry}")
479                         psys("cp '#{$FPATH}/themes/#{$theme}/#{entry}' '#{dest_dir}'")
480                     end
481                 end
482             end
483
484             msg 3, _("\tgenerating HTML pages...")
485             
486             #- generate thumbnails.html (page with thumbnails)
487             for sizeobj in $images_size
488                 html = $html_thumbnails.collect { |l| l.clone }
489                 iterations = {}
490                 for i in html
491                     i.sub!(/~~run_slideshow~~/, images.size <= 1 ? '' : '<a href="image-' + sizeobj['name'] + '.html?run_slideshow">' + utf8(_('Run slideshow!')) + '</a>')
492                     i.sub!(/~~title~~/, xmldir.attributes['thumbnails-caption'] || utf8(File.basename(dir)))
493                     substitute_html_sizes(i, sizeobj, 'thumbnails')
494                     discover_iterations(iterations, i)
495                 end
496                 html_thumbnails = ''
497                 reset_iterations(iterations)
498                 for file in entries
499                     type = images.include?(file) ? 'image' : videos.include?(file) ? 'video' : nil
500                     if type
501                         html_thumbnails += run_iterations(iterations)
502                         if type == 'image'
503                             index = images.index(file)
504                             html_thumbnails.gsub!(/~~image_iteration~~/,
505                                                   '<a href="image-' + size2js(sizeobj['name']) + '.html?current=' + fullscreen_images[sizeobj['name']][index] +
506                                                       '" name="' + fullscreen_images[sizeobj['name']][index] + '">' +
507                                                       img_element("#{dest_dir}/#{thumbnail_images[sizeobj['name']][index]}") + '</a>')
508                             html_thumbnails.gsub!(/~~caption_iteration~~/,
509                                                   find_caption_value(xmldir, images[index]) || utf8(images[index]))
510                             html_thumbnails.gsub!(/~~ifimage\?~~(.+?)~~fi~~/) { $1 }
511                             html_thumbnails.gsub!(/~~ifvideo\?~~(.+?)~~fi~~/, '')
512                         elsif type == 'video'
513                             index = videos.index(file)
514                             if File.exists?("#{dest_dir}/#{thumbnail_videos[sizeobj['name']][index]}")
515                                 html_thumbnails.gsub!(/~~image_iteration~~/,
516                                                       '<a href="' + videos[index] + '">' + img_element("#{dest_dir}/#{thumbnail_videos[sizeobj['name']][index]}") + '</a>')
517                             else
518                                 html_thumbnails.gsub!(/~~image_iteration~~/,
519                                                       '<a href="' + videos[index] + '">' + utf8(_("(no preview)")) + '</a>')
520                             end
521                             html_thumbnails.gsub!(/~~caption_iteration~~/,
522                                                   find_caption_value(xmldir, videos[index]) || utf8(videos[index]))
523                             html_thumbnails.gsub!(/~~ifimage\?~~(.+?)~~fi~~/, '')
524                             html_thumbnails.gsub!(/~~ifvideo\?~~(.+?)~~fi~~/) { $1 }
525                         end
526                     end
527                 end
528                 html_thumbnails += close_iterations(iterations)
529                 for i in html
530                     i.sub!(/~~thumbnails~~/, html_thumbnails)
531                     i.gsub!(/~~theme~~/, $theme)
532                     i.gsub!(/~~current_size~~/, sizeobj['name'])
533                 end
534                 ios = File.open("#{dest_dir}/thumbnails-#{sizeobj['name']}.html", "w")
535                 ios.write(html)
536                 ios.close
537             end
538
539             #- generate "main" thumbnails.html page that will reload to correct size thanks to cookie
540             ios = File.open("#{dest_dir}/thumbnails.html", "w")
541             ios.write(html_reload_to_thumbnails)
542             ios.close
543
544             #- generate image.html (page with fullscreen images)
545             if images.size > 0
546                 captions4js = find_captions(xmldir, images).collect { |e| e ? '"' + e.gsub('"', '\"' ) + '"' : '""' }.join(', ')
547                 for sizeobj in $images_size
548                     html = $html_images.collect { |l| l.clone }
549                     images4js = fullscreen_images[sizeobj['name']].collect { |e| "\"#{e}\"" }.join(', ')
550                     otherimages4js = ''
551                     othersizes = []
552                     all_images_sizes = $limit_sizes =~ /original/ ? $images_size + [ { 'name' => 'original' } ] : $images_size
553                     for sizeobj2 in all_images_sizes
554                         if sizeobj != sizeobj2
555                             otherimages4js += "var images_#{size2js(sizeobj2['name'])} = new Array(" + fullscreen_images[sizeobj2['name']].collect { |e| "\"#{e}\"" }.join(', ') + ")\n"
556                             othersizes << "\"#{size2js(sizeobj2['name'])}\""
557                         end
558                     end
559                     for i in html
560                         i.gsub!(/~~images~~/, images4js)
561                         i.gsub!(/~~other_images~~/, otherimages4js)
562                         i.gsub!(/~~other_sizes~~/, othersizes.join(', '))
563                         i.gsub!(/~~captions~~/, captions4js)
564                         i.gsub!(/~~title~~/, xmldir.attributes['thumbnails-caption'] || utf8(File.basename(dir)))
565                         i.gsub!(/~~thumbnails~~/, '<a href="thumbnails-' + sizeobj['name'] + '.html" id="thumbnails">' + utf8(_('Return to thumbnails')) + '</a>')
566                         i.gsub!(/~~theme~~/, $theme)
567                         i.gsub!(/~~current_size~~/, sizeobj['name'])
568                         substitute_html_sizes(i, sizeobj, 'image')
569                     end
570                     ios = File.open("#{dest_dir}/image-#{size2js(sizeobj['name'])}.html", "w")
571                     ios.write(html)
572                     ios.close
573                 end
574             end
575         end
576     }
577
578     msg 3, ''
579
580     #- add attributes to <dir..> elements needing so
581     if $mode != 'use_config'
582         msg 3, _("\tfixating configuration file...")
583         $xmldoc.elements.each('//dir') { |element|
584             path = captionpath = element.attributes['path']
585             descendant_element = element.elements['descendant::image'] || element.elements['descendant::video']
586             if !descendant_element
587                 msg 3, _("\t\tremoving %s, no element in it") % path
588                 element.remove  #- means we have a directory with nothing interesting in it
589             else
590                 captionfile = "#{descendant_element.parent.attributes['path']}/#{descendant_element.attributes['filename']}"
591                 basename = File.basename(path)
592                 if element.elements['dir']
593                     if !element.attributes['subdirs-caption']
594                         element.add_attribute('subdirs-caption', basename)
595                     end
596                     if !element.attributes['subdirs-captionfile']
597                         element.add_attribute('subdirs-captionfile', captionfile)
598                     end
599                 end
600                 if element.elements['image'] || element.elements['video']
601                     if !element.attributes['thumbnails-caption']
602                         element.add_attribute('thumbnails-caption', basename)
603                     end
604                     if !element.attributes['thumbnails-captionfile']
605                         element.add_attribute('thumbnails-captionfile', captionfile)
606                     end
607                 end
608             end
609         }
610     end
611
612     #- write down to disk config if necessary
613     if $config_writeto
614         ios = File.open($config_writeto, "w")
615         $xmldoc.write(ios, 0)
616         ios.close
617     end
618
619     if $forgui
620         msg 3, _(" completed necessary stuff for GUI, exiting.")
621         return
622     end
623
624     #- second pass to create index.html files
625     msg 3, _("\trescanning directories to generate all `index.html' files...")
626
627     `find #{$source} -type d`.each { |dir|
628         dir.chomp!
629         xmldir = $xmldoc.elements["//dir[@path='#{utf8(dir)}']"]
630         if !xmldir
631             next
632         end
633         dest_dir = make_dest_filename(dir.sub(/^#{Regexp.quote($source)}/, $dest))
634
635         if xmldir.elements['dir']
636             html = $html_index.collect { |l| l.clone }
637             iterations = {}
638             for i in html
639                 caption = xmldir.attributes['subdirs-caption']
640                 i.gsub!(/~~title~~/, caption)
641                 if xmldir.parent.name == 'dir'
642                     nav = ''
643                     path = '..'
644                     parent = xmldir.parent
645                     while parent.name == 'dir'
646                         parentcaption = parent.attributes['subdirs-caption']
647                         nav = "<a href='#{path}/index.html'>#{parentcaption}</a> #{utf8(_(" > "))} #{nav}"
648                         path += '/..'
649                         parent = parent.parent
650                     end
651                     i.gsub!(/~~ifnavigation\?~~(.+?)~~fi~~/) { $1 }
652                     i.gsub!(/~~navigation~~/, nav + caption)
653                 else
654                     i.gsub!(/~~ifnavigation\?~~(.+?)~~fi~~/, '')
655                 end
656                 discover_iterations(iterations, i)
657             end
658             
659             html_index = ''
660             reset_iterations(iterations)
661             
662             #- deal with "current" album (directs to "thumbnails" page)
663             if xmldir.attributes['thumbnails-caption']
664                 thumbnail = "#{dest_dir}/thumbnails-thumbnail.jpg"
665                 gen_thumbnails_subdir(from_utf8(xmldir.attributes['thumbnails-captionfile']), xmldir, false,
666                                       [ { 'filename' => thumbnail, 'size' => $albums_thumbnail_size } ], 'thumbnails')
667                 html_index += run_iterations(iterations)
668                 html_index.gsub!(/~~image_iteration~~/, "<a href='thumbnails.html'>" + img_element(thumbnail) + '</a>')
669                 html_index.gsub!(/~~caption_iteration~~/, xmldir.attributes['thumbnails-caption'])
670             end
671             #- cleanup temp for videos
672             system("rm -f #{dest_dir}/screenshot.jpg000000.jpg")
673
674             #- deal with sub-albums (direct to subdirs/index.html pages)
675             xmldir.elements.each('dir') { |child|
676                 subdir = make_dest_filename(from_utf8(File.basename(child.attributes['path'])))
677                 thumbnail = "#{dest_dir}/thumbnails-#{subdir}.jpg"
678                 html_index += run_iterations(iterations)
679                 captionfile, caption = find_subalbum_caption_info(child)
680                 gen_thumbnails_subdir(captionfile, child, false,
681                                       [ { 'filename' => thumbnail, 'size' => $albums_thumbnail_size } ], find_subalbum_info_type(child))
682                 html_index.gsub!(/~~caption_iteration~~/, caption)
683                 html_index.gsub!(/~~image_iteration~~/, "<a href='#{make_dest_filename(subdir)}/index.html'>" + img_element(thumbnail) + '</a>')
684                 #- cleanup temp for videos
685                 system("rm -f #{dest_dir}/screenshot.jpg000000.jpg")
686             }
687
688             html_index += close_iterations(iterations)
689
690             for i in html
691                 i.gsub!(/~~thumbnails~~/, html_index)
692             end
693             
694         else
695             html = html_reload_to_thumbnails
696         end
697
698         ios = File.open("#{dest_dir}/index.html", "w")
699         ios.write(html)
700         ios.close
701
702         #- substitute "return to albums" correctly
703         `find '#{dest_dir}' -maxdepth 1 -name "thumbnails*.html"`.each { |thumbnails|
704             thumbnails.chomp!
705             contents = File.open(thumbnails.chomp).readlines
706             for i in contents
707                 if xmldir.elements['dir']
708                     i.sub!(/~~return_to_albums~~/, '<a href="index.html">' + utf8(_('Return to albums')) + '</a>')
709                 else
710                     if xmldir.parent.name == 'dir'
711                         i.sub!(/~~return_to_albums~~/, '<a href="../index.html">' + utf8(_('Return to albums')) + '</a>')
712                     else
713                         i.sub!(/~~return_to_albums~~/, '')
714                     end
715                 end
716             end
717             ios = File.open(thumbnails, "w")
718             ios.write(contents)
719             ios.close
720         }
721     }
722
723     msg 3, _(" all done.")
724 end
725
726 handle_options
727 read_config
728 check_installation
729
730 build_html_skeletons
731
732 walk_source_dir