webgen 0.3.0 → 0.3.1

data/lib/webgen/plugins/filehandler/filecopy.rb

@@ -1,7 +1,7 @@
 #
 #--
 #
-# $Id: filecopy.rb 203 2005-02-21 18:42:04Z thomas $
+# $Id: filecopy.rb 210 2005-02-26 13:42:55Z thomas $
 #
 # webgen: template based static website generator
 # Copyright (C) 2004 Thomas Leitner
@@ -51,7 +51,9 @@ module FileHandlers
 
     # Copy the file to the destination directory if it has been modified.
     def write_node( node )
-      FileUtils.cp( node.recursive_value( 'src' ), node.recursive_value( 'dest' ) ) if Webgen::Plugin['FileHandler'].file_modified?( node )
+      if Webgen::Plugin['FileHandler'].file_modified?( node.recursive_value( 'src' ), node.recursive_value( 'dest' ) )
+        FileUtils.cp( node.recursive_value( 'src' ), node.recursive_value( 'dest' ) )
+      end
     end
 
   end

data/lib/webgen/plugins/filehandler/filehandler.rb

@@ -1,7 +1,7 @@
 #
 #--
 #
-# $Id: filehandler.rb 203 2005-02-21 18:42:04Z thomas $
+# $Id: filehandler.rb 222 2005-03-13 16:30:40Z thomas $
 #
 # webgen: template based static website generator
 # Copyright (C) 2004 Thomas Leitner
@@ -76,11 +76,9 @@ module FileHandlers
     end
 
 
-    # Returns true if the source file specified by +node+ has been modified since the last execution
+    # Returns true if the file +src+ is newer than +dest+ and therefore has been modified since the last execution
     # of webgen. The +mtime+ values for the source and destination files are used to find this out.
-    def file_modified?( node )
-      src = node.recursive_value( 'src' )
-      dest = node.recursive_value( 'dest' )
+    def file_modified?( src, dest )
       if File.exists?( dest ) && ( File.mtime( src ) < File.mtime( dest ) )
         self.logger.info { "File is up to date: <#{dest}>" }
         return false
@@ -130,12 +128,11 @@ module FileHandlers
 
       if @extensions.has_key?( :dir )
         node = @extensions[:dir].create_node( path, parent )
-        node['processor'] = @extensions[:dir]
 
         dispatch_msg( :DIR_NODE_CREATED, node )
 
         Dir[path + File::SEPARATOR + '{.*,*}'].delete_if do |name|
-          name =~ /#{File::SEPARATOR}.{1,2}$/ || \
+          name =~ /#{File::SEPARATOR}\.{1,2}$/ || \
           File.basename( name ) =~ Regexp.new( get_param( 'ignored' ).join( '|' ) )
         end.sort! do |a, b|
           if File.file?( a ) && File.directory?( b )
@@ -166,7 +163,7 @@ module FileHandlers
     summary "Base class of all file handler plugins"
 
     def initialize
-      extension( Webgen::Plugin.config[self.class.name].extension ) if Webgen::Plugin.config[self.class.name].extension
+      extension( Webgen::Plugin.config[self.class].extension ) if Webgen::Plugin.config[self.class].extension
     end
 
     # Register the file extension specified by a subclass.

data/lib/webgen/plugins/filehandler/{pagehandler/page.rb → page.rb}

@@ -1,7 +1,7 @@
 #
 #--
 #
-# $Id: page.rb 203 2005-02-21 18:42:04Z thomas $
+# $Id: page.rb 224 2005-03-16 15:26:33Z thomas $
 #
 # webgen: template based static website generator
 # Copyright (C) 2004 Thomas Leitner
@@ -48,15 +48,12 @@ module FileHandlers
     add_param 'defaultLangInFilename', false, \
     'If true, the output files for the default language will have the ' \
     'language in the file name like all other page files. If false, they won''t.'
-    add_param 'defaultContentFormat', 'textile', 'The default content format used in page files'
-    depends_on 'FileHandler'
-
-    attr_reader :formats
-
-    def initialize
-      super
-      @formats = Hash.new( ContentHandlers::ContentHandler.new )
-    end
+    add_param 'defaultContentFormat', 'textile', 'The default content format used in page files.'
+    add_param 'outputNameStyle', [:name, ['.', :lang], '.html'], 'Defines how the output name should be built. The correct name will be used for ' \
+    'the :name part and the file language will be used for the :lang part. If <defaultLangInFilename> is true, the :lang part or the subarray in which '\
+    'the :lang part was defined, will be omitted.'
+    add_param 'validator', 'xmllint', 'The validator for checking HTML files on their validness. Set to "" or nil to prevent checking.'
+    depends_on 'FileHandler', 'DefaultContentHandler'
 
     def create_node( srcName, parent )
       create_node_internally( parse_data( File.read( srcName ), srcName ), analyse_file_name( File.basename( srcName ) ), parent )
@@ -78,6 +75,11 @@ module FileHandlers
       File.open( node.recursive_value( 'dest' ), File::CREAT|File::TRUNC|File::RDWR ) do |file|
         file.write( outstring )
       end
+
+      validator = get_param( 'validator' )
+      unless validator.nil? || validator == ''
+        Webgen::Plugin['DefaultHTMLValidator'].get_validator( validator ).validate_file( node.recursive_value( 'dest' ) )
+      end
     end
 
     def page_node_exists?( basename, dirNode )
@@ -124,11 +126,12 @@ module FileHandlers
       else
         node = Node.new( pageNode )
         node.metainfo = data
-        node['src'] = analysed.srcName
-        node['dest'] = analysed.urlName
+        node['node:isLangNode'] = true
         node['lang'] ||= analysed.lang
         node['title'] ||= analysed.title
         node['menuOrder'] ||= analysed.menuOrder
+        node['src'] = analysed.srcName
+        node['dest'] = create_output_name( analysed, node.metainfo )
         node['processor'] = self
         pageNode.add_child( node )
       end
@@ -150,8 +153,12 @@ module FileHandlers
         end
         blocks.each {|b| b.gsub!( /^(\\+)(---\s*)$/ ) {|m| "\\" * ($1.length / 2) + $2 } }
         (options['blocks'] ||= [{'name'=>'content', 'format'=>get_param( 'defaultContentFormat' )}]).each do |blockdata|
+          if !blockdata.kind_of?( Hash ) || !blockdata['name'] || !blockdata['format']
+            self.logger.error { "Block meta information in <#{srcName}> invalid (#{blockdata.inspect})" }
+            next
+          end
           self.logger.debug { "Block '#{blockdata['name']}' formatted using '#{blockdata['format']}'" }
-          options[blockdata['name']] = @formats[blockdata['format']].format_content( blocks.shift || '' )
+          options[blockdata['name']] = Webgen::Plugin['DefaultContentHandler'].get_format( blockdata['format'] ).format_content( blocks.shift || '' )
         end
       end
       options
@@ -163,10 +170,10 @@ module FileHandlers
 
       self.logger.info { "Using default language for file <#{srcName}>" } if matchData[3].nil?
       analysed.lang      = matchData[3] || Webgen::Plugin['Configuration']['lang']
-      analysed.baseName  = matchData[2] + '.html'
+      analysed.baseName  = matchData[2] + '.page'
       analysed.srcName   = srcName
-      langPart = ( !get_param( 'defaultLangInFilename' ) && Webgen::Plugin['Configuration']['lang'] == analysed.lang ? '' : '.' + analysed.lang )
-      analysed.urlName   = matchData[2] + langPart + '.html'
+      analysed.useLangPart  = ( !get_param( 'defaultLangInFilename' ) && Webgen::Plugin['Configuration']['lang'] == analysed.lang ? false : true )
+      analysed.name      = matchData[2]
       analysed.menuOrder = matchData[1].to_i
       analysed.title     = matchData[2].tr('_-', ' ').capitalize
 
@@ -175,29 +182,38 @@ module FileHandlers
       analysed
     end
 
+    def create_output_name( analysed, data )
+      def process_array( array, analysed )
+        array.collect do |part|
+          case part
+          when String
+            part
+          when :name
+            analysed.name
+          when :lang
+            analysed.useLangPart ? analysed.lang : ''
+          when Array
+            part.include?( :lang ) && !analysed.useLangPart ? '' : process_array( part, analysed )
+          else
+            ''
+          end
+        end.join( '' )
+      end
+      process_array( data['outputNameStyle'] || get_param( 'outputNameStyle' ), analysed )
+    end
+
   end
 
 end
 
+module HTMLValidators
 
-module ContentHandlers
+  class HTMLValidator < Webgen::Plugin
 
-  class ContentHandler < Webgen::Plugin
-
-    VIRTUAL = true
-
-    summary "Base class for all page file content handlers"
-
-    # Register the format specified by a subclass.
-    def register_format( fmt )
-      self.logger.info { "Registering class #{self.class.name} for formatting '#{fmt}'" }
-      Webgen::Plugin['PageHandler'].formats[fmt] = self
-    end
+    summary "Base class for all HTML validators"
 
-    # Format the given +content+. Should be overridden in subclass!
-    def format_content( content )
-      self.logger.error { "Invalid content format specified, copying source verbatim!" }
-      content
+    # Should be overridden in subclass!
+    def validate_file( filename )
     end
 
   end

data/lib/webgen/plugins/filehandler/picturegallery.rb

@@ -1,7 +1,7 @@
 #
 #--
 #
-# $Id: picturegallery.rb 203 2005-02-21 18:42:04Z thomas $
+# $Id: picturegallery.rb 221 2005-03-12 17:14:11Z thomas $
 #
 # webgen: template based static website generator
 # Copyright (C) 2004 Thomas Leitner
@@ -22,7 +22,7 @@
 
 require 'webgen/plugins/filehandler/filehandler'
 require 'webgen/plugins/filehandler/directory'
-require 'webgen/plugins/filehandler/pagehandler/page'
+require 'webgen/plugins/filehandler/page'
 
 module FileHandlers
 
@@ -33,6 +33,7 @@ module FileHandlers
     add_param "picturesPerPage", 20, 'Number of picture per gallery page'
     add_param "picturePageInMenu", false, 'True if the picture pages should be in the menu'
     add_param "galleryPageInMenu", false, 'True if the gallery pages should be in the menu'
+    add_param "galleryMenuOrder", 50, 'The <menuOrder> metainfo for the first gallery page. The second gallery page gets this value plus one, and so on.'
     add_param "mainPageInMenu", true, 'True if the main page of the picture gallery should be in the menu'
     add_param "galleryPageTemplate", nil, 'The template for gallery pages. If nil or a not existing file is specified, the default template is used.'
     add_param "picturePageTemplate", nil, 'The template for picture pages. If nil or a not existing file is specified, the default template is used.'
@@ -50,8 +51,8 @@ module FileHandlers
         self.logger.error { "Could not parse gallery file <#{file}>, not creating gallery pages" }
         return
       end
-      path = File.dirname( file )
-      images = Dir[File.join( path, get_param( 'files' ))].collect {|i| i.sub( /#{path + File::SEPARATOR}/, '' ) }
+      @path = File.dirname( file )
+      images = Dir[File.join( @path, get_param( 'files' ))].collect {|i| i.sub( /#{@path + File::SEPARATOR}/, '' ) }
       self.logger.info { "Creating gallery for file <#{file}> with #{images.length} pictures" }
 
       create_gallery( images, parent )
@@ -72,64 +73,60 @@ module FileHandlers
       ( @filedata.has_key?( name ) ? @filedata[name] : super )
     end
 
-    def call_layouter( type, data )
-      content = self.send( type.to_s + "_page_" + get_param( 'layout' ), data )
-      "#{data.to_yaml}\n---\n#{content}"
+    def call_layouter( type, metainfo, *args )
+      content = Webgen::Plugin['DefaultGalleryLayouter'].get_layout( get_param( 'layout' ) ).send( type.to_s, *args )
+      "#{metainfo.to_yaml}\n---\n#{content}"
     end
 
     def create_gallery( images, parent )
-      nr_gallery_pages = (Float(images.length) / get_param( 'picturesPerPage' ) ).ceil
-      main = create_main_page( images )
-      main['galleries'] = create_gallery_pages( images )
+      main = create_main_page( images, parent )
+      main['galleries'] = create_gallery_pages( images, parent )
 
-      if nr_gallery_pages != 1
-        mainNode = Webgen::Plugin['PageHandler'].create_node_from_data( call_layouter( :main, main ), main['srcName'], parent )
+      if main['galleries'].length != 1
+        mainNode = Webgen::Plugin['PageHandler'].create_node_from_data( call_layouter( :main, main, main ), main['srcName'], parent )
         parent.add_child( mainNode )
       else
         main['galleries'][0]['title'] = main['title']
         main['galleries'][0]['inMenu'] = main['inMenu']
         main['galleries'][0].update( @filedata['mainPage'] || {} )
+        main['pageNotUsed'] = true
       end
 
-      main['galleries'].each do |gallery|
-        node = Webgen::Plugin['PageHandler'].create_node_from_data( call_layouter( :gallery, gallery ), gallery['link'], parent )
+      main['galleries'].each_with_index do |gallery, gIndex|
+        node = Webgen::Plugin['PageHandler'].create_node_from_data( call_layouter( :gallery, gallery, main, gIndex ), gallery['srcName'], parent )
         parent.add_child( node )
-        gallery['imageList'].each do |image|
-          node = Webgen::Plugin['PageHandler'].create_node_from_data( call_layouter( :picture, image ), image['srcName'], parent )
+        gallery['imageList'].each_with_index do |image, iIndex|
+          node = Webgen::Plugin['PageHandler'].create_node_from_data( call_layouter( :picture, image, main, gIndex, iIndex ), image['srcName'], parent )
           parent.add_child( node )
         end
       end
     end
 
-    def create_main_page( images )
+    def create_main_page( images, parent )
       main = {}
       main['title'] = get_param( 'title' )
       main['inMenu'] = get_param( 'mainPageInMenu' )
       main['template'] = get_param( 'mainPageTemplate' )
       main['srcName'] = gallery_file_name( main['title'] )
+      main['blocks'] = [{'name'=>'content', 'format'=>'html'}]
       main.update( @filedata['mainPage'] || {} )
       main
     end
 
-    def create_gallery_pages( images )
+    def create_gallery_pages( images, parent )
       galleries = []
       picsPerPage = get_param( 'picturesPerPage' )
       0.step( images.length - 1, picsPerPage ) do |i|
-        data = Hash.new
+        data = (@filedata['galleryPages'] || {}).dup
 
-        data['template'] = get_param( 'galleryPageTemplate' )
-        data['inMenu'] = get_param( 'galleryPageInMenu' )
+        data['blocks'] ||= [{'name'=>'content', 'format'=>'html'}]
+        data['template'] ||= get_param( 'galleryPageTemplate' )
+        data['inMenu'] ||= get_param( 'galleryPageInMenu' )
         data['number'] = i/picsPerPage + 1
+        data['menuOrder'] = get_param( 'galleryMenuOrder' ) + data['number']
         data['title'] = gallery_title( data['number'] )
-        data['link'] = gallery_file_name( data['title'] )
-        data['prevGalleryNumber'] = ( i == 0 ? nil : data['number'] - 1 )
-        data['prevGalleryTitle'] = gallery_title( data['prevGalleryNumber'] )
-        data['prevGalleryLink'] = gallery_file_name( data['prevGalleryTitle'] )
-        data['nextGalleryNumber']= ( images.length <= i + picsPerPage ? nil : data['number'] + 1 )
-        data['nextGalleryTitle'] = gallery_title( data['nextGalleryNumber'] )
-        data['nextGalleryLink'] = gallery_file_name( data['nextGalleryTitle'] )
-        data['images'] = images[i..(i + picsPerPage - 1)]
-        data['imageList'] = create_picture_pages( data['images'] )
+        data['srcName'] = gallery_file_name( data['title'] )
+        data['imageList'] = create_picture_pages( images[i..(i + picsPerPage - 1)], parent )
 
         galleries << data
       end
@@ -144,51 +141,73 @@ module FileHandlers
       ( title.nil? ? nil : title.tr( ' .', '_' ) + '.html' )
     end
 
-    def create_picture_pages( images )
+    def create_picture_pages( images, parent )
       imageList = []
       images.each do |image|
-        imageData = @filedata[image] || {}
+        imageData = (@filedata[image] || {}).dup
 
+        imageData['blocks'] ||= [{'name'=>'content', 'format'=>'html'}]
         imageData['title'] ||= "Picture #{File.basename( image )}"
         imageData['description'] ||= ''
-        imageData['inMenu'] = get_param( 'picturePageInMenu' )
-        imageData['template'] = get_param( 'picturePageTemplate' )
+        imageData['inMenu'] ||= get_param( 'picturePageInMenu' )
+        imageData['template'] ||= get_param( 'picturePageTemplate' )
         imageData['imageFilename'] = image
         imageData['srcName'] = File.basename( image ).tr( ' .', '_' ) + '.html'
+        imageData['thumbnail'] ||= get_thumbnail( imageData, parent )
 
         imageList << imageData
       end
       imageList
     end
 
-    def main_page_default( data )
-      "
-#{data['galleries'].collect {|g| "<img src='#{g['images'][0]}' width='100' height='100' alt='#{g['title']}' /> \"#{g['title']}\":#{g['link']}"}.join( "\n\n" )}
-"
+    def get_thumbnail( imageData, parent )
+      imageData['imageFilename']
     end
 
-    def gallery_page_default( data )
-      "
-<div class=\"webgen-gallery\">
+  end
+
+  # Try to use RMagick as thumbnail creator
+  begin
+    require 'RMagick'
+
+    class PictureGalleryFileHandler
 
-#{data['imageList'].collect {|i| "<img src='#{i['imageFilename']}' width='100' height='100' alt='#{i['title']}'/> \"#{i['title']}\":#{i['srcName']}" }.join( "\n\n" )}
+      def get_thumbnail( imageData, parent )
+        p_node = Webgen::Plugin['DirHandler'].recursive_create_path( File.dirname( imageData['imageFilename'] ), parent )
+        node = Webgen::Plugin['ThumbnailWriter'].create_node( File.join( @path, imageData['imageFilename'] ), p_node )
+        p_node.add_child( node )
+
+        File.dirname( imageData['imageFilename'] ) + '/' + node['dest']
+      end
 
-</div>
-"
     end
 
-    def picture_page_default( data )
-      "
-<div class=\"webgen-picture\">
+    class ThumbnailWriter < DefaultHandler
 
-<img src='#{data['imageFilename']}' alt='#{data['title']}' />
+      summary "Writes out thumbnails with RMagick"
+      add_param "thumbnailSize", "100x100", "The size of the thumbnails"
 
-</div>
+      def create_node( file, parent )
+        node = Node.new( parent )
+        node['title'] = node['src'] = node['dest'] = 'tn_' + File.basename( file )
+        node['tn:imageFile'] = file
+        node['processor'] = self
+        node
+      end
+
+      def write_node( node )
+        if Webgen::Plugin['FileHandler'].file_modified?( node['tn:imageFile'], node.recursive_value( 'dest' ) )
+          self.logger.info {"Creating thumbnail <#{node.recursive_value('dest')}> from <#{node['tn:imageFile']}>"}
+          image = Magick::ImageList.new( node['tn:imageFile'] )
+          image.change_geometry( get_param( 'thumbnailSize' ) ) {|c,r,i| i.resize!( c, r )}
+          image.write( node.recursive_value( 'dest' ) )
+        end
+      end
 
-{description: }
-"
     end
 
+  rescue LoadError => e
+    self.logger.warn { "Could not load RMagick, creation of thumbnails not available" }
   end
 
 end

data/lib/webgen/plugins/gallerylayouter/defaultgallerylayouter.rb

@@ -0,0 +1,152 @@
+#
+#--
+#
+# $Id: defaultgallerylayouter.rb 220 2005-03-12 15:41:05Z thomas $
+#
+# webgen: template based static website generator
+# Copyright (C) 2004 Thomas Leitner
+#
+# This program is free software; you can redistribute it and/or modify it under the terms of the GNU
+# General Public License as published by the Free Software Foundation; either version 2 of the
+# License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without
+# even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along with this program; if not,
+# write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+#
+#++
+#
+
+module PictureGalleryLayouter
+
+  class DefaultGalleryLayouter < Webgen::Plugin
+
+    summary "Base class for all Picture Gallery Layouters and, at the same time, default layouter"
+
+    define_handler 'layout'
+
+    register_layout 'default'
+
+    # Returns the thumbnail img tag for the given +image+.
+    def thumbnail_tag_for_image( image )
+      if image['thumbnail'] != image['imageFilename']
+        "<img src='#{image['thumbnail']}' alt='#{image['title']}' />"
+      else
+        "<img src='#{image['imageFilename']}' width='100' height='100' alt='#{image['title']}'/>"
+      end
+    end
+
+    # Returns the gallery index of the previous gallery, if it exists, or +nil+ otherwise.
+    def prev_gallery( data, gIndex )
+      gIndex != 0 ? gIndex - 1 : nil
+    end
+
+    # Returns the gallery index of the next gallery, if it exists, or +nil+ otherwise.
+    def next_gallery( data, gIndex )
+      gIndex != data['galleries'].length - 1 ? gIndex + 1 : nil
+    end
+
+    # Returns the gallery and image indices of the previous picture, if it exists, or +nil+ otherwise.
+    def prev_picture( data, gIndex, iIndex )
+      result = nil
+      if gIndex != 0 || iIndex != 0
+        if iIndex == 0
+          gIndex -= 1
+          iIndex = data['galleries'][gIndex]['imageList'].length - 1
+        else
+          iIndex -= 1
+        end
+        result = [gIndex, iIndex]
+      end
+      return result
+    end
+
+    # Returns the gallery and image indices of the next picture, if it exists, or +nil+ otherwise.
+    def next_picture( data, gIndex, iIndex )
+      result = nil
+      if gIndex != data['galleries'].length - 1 || iIndex != data['galleries'][gIndex]['imageList'].length - 1
+        if iIndex == data['galleries'][gIndex]['imageList'].length - 1
+          gIndex += 1
+          iIndex = 0
+        else
+          iIndex += 1
+        end
+        result = [gIndex, iIndex]
+      end
+      return result
+    end
+
+    # Should be overwritten by subclasses! +data+ is the data structure which holds all information
+    # about the gallery.
+    def main( data )
+      s = "
+<h2>#{data['title']}</h2>
+<div class=\"webgen-gallery\">
+<table>
+"
+      0.step( data['galleries'].length - 1, 5 ) do |i|
+        s += "<tr>"
+        s += data['galleries'][i...i+5].collect {|g| "<td><a href=\"#{g['srcName']}\">#{thumbnail_tag_for_image( g['imageList'][0] )}<br />#{g['title']}</a></td>"}.join( "\n" )
+        s += "</tr>"
+      end
+      s += "</table></div>"
+    end
+
+    # Should be overwritten by subclasses! +data+ is the data structure which holds all information
+    # about the gallery. +gIndex+ is the index of the current gallery.
+    def gallery( data, gIndex )
+
+      s = "
+<h2>#{data['galleries'][gIndex]['title']}</h2>
+<div class=\"webgen-gallery\">
+"
+
+      s += "<a href=\"#{data['srcName']}\">^&nbsp;#{data['title']}&nbsp;^</a><br />" unless data['pageNotUsed']
+      prevIndex = prev_gallery( data, gIndex )
+      nextIndex = next_gallery( data, gIndex )
+      s += "<a href=\"#{data['galleries'][prevIndex]['srcName']}\">&lt;&nbsp;#{data['galleries'][prevIndex]['title']}</a>" unless prevIndex.nil?
+      s += "&nbsp;&mdash;&nbsp;" unless prevIndex.nil? || nextIndex.nil?
+      s += "<a href=\"#{data['galleries'][nextIndex]['srcName']}\">#{data['galleries'][nextIndex]['title']}&nbsp;&gt;</a>" unless nextIndex.nil?
+      s += "<br />"
+
+      s += "<table>"
+      0.step( data['galleries'][gIndex]['imageList'].length - 1, 5 ) do |i|
+        s += "<tr>"
+        s += data['galleries'][gIndex]['imageList'][i...i+5].collect {|i| "<td><a href=\"#{i['srcName']}\">#{thumbnail_tag_for_image( i )}<br />#{i['title']}</a></td>"}.join( "\n" )
+        s += "</tr>"
+      end
+      s += "</table></div>"
+    end
+
+    # Should be overwritten by subclasses! +data+ is the data structure which holds all information
+    # about the gallery. +gIndex+ is the index of the current gallery. +iIndex+ is the index of the
+    # current image.
+    def picture( data, gIndex, iIndex )
+      s = "
+<h2>#{data['galleries'][gIndex]['imageList'][iIndex]['title']}</h2>
+<div class=\"webgen-picture\">
+"
+      s += "<a href=\"#{data['galleries'][gIndex]['srcName']}\">^&nbsp;#{data['galleries'][gIndex]['title']}&nbsp;^</a><br />"
+      prevGIndex, prevIIndex = prev_picture( data, gIndex, iIndex )
+      nextGIndex, nextIIndex = next_picture( data, gIndex, iIndex )
+      s += "<a href=\"#{data['galleries'][prevGIndex]['imageList'][prevIIndex]['srcName']}\">" \
+      "&lt;&nbsp;#{data['galleries'][prevGIndex]['imageList'][prevIIndex]['title']}</a>" unless prevGIndex.nil?
+      s += "&nbsp;&mdash;&nbsp;" unless prevGIndex.nil? || nextGIndex.nil?
+      s += "<a href=\"#{data['galleries'][nextGIndex]['imageList'][nextIIndex]['srcName']}\">" \
+      "#{data['galleries'][nextGIndex]['imageList'][nextIIndex]['title']}&nbsp;&gt;</a>" unless nextGIndex.nil?
+      s += "<br />"
+
+      s += "
+<img src='#{data['galleries'][gIndex]['imageList'][iIndex]['imageFilename']}' alt='#{data['galleries'][gIndex]['imageList'][iIndex]['title']}' />
+
+<p>{description: }</p>
+</div>
+"
+    end
+
+  end
+
+end