webgen 0.3.8 → 0.4.0

data/README

@@ -1,16 +1,14 @@
 webgen - a template based static website generator
 
-Copyright (C) 2004 Thomas Leitner
+Copyright (C) 2006 Thomas Leitner
 
 >>> The documentation for webgen is in the doc/src subdirectory. <<<
 
-You can build the documentation by
-invoking
+You can build the documentation by executing
  $ rake doc
 
-in the root of the package or by running webgen manually in the +doc+ directory:
- $ ruby -I../lib ../bin/webgen
+in the root of the package. This command will build the documentation and place it in doc/output.
 
-This documentation is actually the same as the one on webgen.rubyforge.org. When releasing a new
+This documentation is actually the same as the one on http://webgen.rubyforge.org. When releasing a new
 version of webgen, I run one of the above commands to create the pages and then only copy it to the
 website! :-)

data/Rakefile

@@ -24,6 +24,7 @@ begin
 rescue Exception
 end
 
+require 'fileutils'
 require 'rake/clean'
 require 'rake/packagetask'
 require 'rake/rdoctask'
@@ -32,7 +33,7 @@ require 'rake/testtask'
 # General actions  ##############################################################
 
 $:.push 'lib'
-require 'webgen/plugins/coreplugins/configuration'
+require 'webgen/config'
 
 PKG_NAME = "webgen"
 PKG_VERSION = Webgen::VERSION.join( '.' )
@@ -62,19 +63,164 @@ task :install => [:prepare] do
   ruby "setup.rb install"
 end
 
-
+CLEAN.exclude( 'doc/src/documentation/plugins/core' )
 task :clean do
   ruby "setup.rb clean"
 end
 
+desc "Creates the whole documentation"
+task :doc => [:rdoc, :webgen_doc]
 
-CLOBBER << "doc/output"
-desc "Builds the documentation"
-task :doc => [:rdoc] do
-  chdir 'doc' do
-    puts "\nGenerating online documentation..."
-    ruby %{-I../lib ../bin/webgen -V 2 }
+CLOBBER << "doc/examples"
+CLOBBER << "doc/src/examples/website_templates"
+CLOBBER << "doc/src/examples/website_styles"
+CLOBBER << "doc/src/examples/gallery_styles"
+CLOBBER << "doc/plugin/gallery"
+desc "Creates the files for the examples section of the docu"
+task :create_examples do
+  require 'webgen/website'
+
+  # website templates
+  data = {}
+  data[:dirname] = 'Website Templates'
+  data[:desc]= "h2. List of website templates
+
+The website templates open in an iframe when you use the menu items. Use the links provided below to
+open the website templates directly (fullscreen).
+
+Following is the list of all available website templates:
+"
+  data[:entries] = Webgen::WebSiteTemplate.entries
+  create_examples( 'website_templates', data, nil, 'default' )
+
+  # website styles
+  data = {}
+  data[:dirname] = 'Website Styles'
+  data[:desc]= "h2. List of website styles
+
+The website styles open in an iframe when you use the menu items. Use the links provided below to
+open the website styles directly (fullscreen).
+
+Following is the list of all available website styles:
+"
+  data[:entries] = Webgen::WebSiteStyle.entries
+  create_examples( 'website_styles', data, 'project', nil )
+
+  # gallery styles
+  Webgen::GalleryStyle.entries.each do |name, entry|
+    puts "Creating example files for gallery style '#{name}'..."
+    mkdir_p( "doc/plugin/gallery/#{name}" )
+    FileUtils.cp( entry.plugin_files, "doc/plugin/gallery/#{name}" )
+    base_dir = "doc/src/examples/gallery_styles/#{name}"
+    mkdir_p( base_dir )
+    entry.copy_to( base_dir )
+
+    additional = case name
+               when 'slides' then "layouter: slides\nthumbnailResizeMethod: :cropped"
+               else ''
+               end
+    File.open( File.join( base_dir, "#{name}.gallery" ), 'w+' ) do |f|
+      f.write("title: index
+images: ../../images/*
+imagesPerPage: 8
+mainPageMetaInfo:
+  inMenu: true
+#{additional}
+---
+../../images/image01.jpg:
+  title: Chinese Garden
+  description: This picture show the Chinese Garden located in the outskirts of Vienna (Austria).
+
+../../images/image02.jpg:
+  title: Goldenes Dach
+  description: This is the landmark of Innsbruck (Tyrol, Austria), called the 'Goldene Dach' (golden roof).
+
+../../images/image03.jpg:
+  title: Mountains in Innsbruck
+  description: A view from the <a href='http://www.nordpark.com'>NordPark</a> in Innsbruck.
+
+../../images/image04.jpg:
+  title: Kristallwelten 1
+  description: The entry to the 'Kristallwelten' of <a href='http://www.swarovski.com'>Swarovski</a> in Innsbruck.
+
+../../images/image05.jpg:
+  title: Kristallwelten 2
+  description: On the roof of the building.
+
+../../images/image06.jpg:
+  title: Kristallwelten 3
+  description: Some crystals.
+
+../../images/image07.jpg:
+  title: Minimundus 1
+  description: A french castle
+
+../../images/image08.jpg:
+  title: Minimundus 2
+  description: A small copy of the <a href=''>Sagrada Familia</a> of Barcelona.
+
+../../images/image09.jpg:
+  title: Minimundus 3
+  description: The Stephansdom in Vienna.
+
+../../images/image10.jpg:
+  title: Minimundus 4
+  description: Overview of Minimundus, a place with smaller versions of famous buildings.
+
+../../images/image11.jpg:
+  title: Velden
+  description: Photo from Velden, Wörtersee, Carinthia, Austria
+
+../../images/image12.jpg:
+  title: Stockholm 1
+  description: A 300-year-old ship, the Wasa, located in the Wasamuseet in Stockholm.
+
+../../images/image13.jpg:
+  title: Stockholm 2
+  description: A fort near Stockholm.
+
+../../images/image14.jpg:
+  title: Stockholm 3
+  description: Overview of Gamla Stan (old town centre of Stockholm)
+
+../../images/image15.jpg:
+  title: Stockholm 4
+  description: View from a bridge in the direction of Gamla Stan
+
+../../images/image16.jpg:
+  title: Zakynthos 1
+  description: An isle that looks like a turtle
+
+../../images/image17.jpg:
+  title: Zakynthos 2
+  description: The oldest olive tree of Zakynthos.
+
+../../images/image18.jpg:
+  title: Zakynthos 3
+  description: The Navagio ship wreck, very famous Greek tourist destination.
+")
+    end
   end
+
+  data = {}
+  data[:dirname] = 'Gallery Styles'
+  data[:desc]= "h2. List of gallery styles
+
+The gallery style example pages open in an iframe when you use the menu items. Use the links
+provided below to open the gallery style example pages directly (fullscreen).
+
+Following is the list of all available gallery styles:
+"
+  data[:entries] = Webgen::GalleryStyle.entries
+  create_example_index( "doc/src/examples/gallery_styles/index.page", data )
+
+end
+
+CLOBBER << "doc/output"
+desc "Generates the webgen documentation"
+task :webgen_doc => [:create_examples] do
+  puts "\nGenerating online documentation..."
+  ruby %{-Ilib bin/webgen -d doc -V 2 }
 end
 
 rd = Rake::RDocTask.new do |rdoc|
@@ -85,11 +231,8 @@ rd = Rake::RDocTask.new do |rdoc|
   rdoc.rdoc_files.include( 'lib/**/*.rb' )
 end
 
-CLOBBER << "test/webgen.log"
-task :test do |t|
-  chdir 'test' do
-    ruby "-I../lib -I. runtests.rb"
-  end
+task :test do
+  ruby "-Ilib -Itest test/runtests.rb"
 end
 
 # Developer tasks ##############################################################
@@ -103,12 +246,11 @@ PKG_FILES = FileList.new( [
                             'Rakefile',
                             'ChangeLog',
                             'VERSION',
-                            'install.rb',
-                            'bin/**/*',
+                            'bin/webgen',
                             'lib/**/*.rb',
                             'data/**/*',
                             'testsite/**/*',
-                            'tests/**/*',
+                            'test/**/*',
                             'doc/**/*'
                           ]) do |fl|
   fl.exclude( /\bsvn\b/ )
@@ -117,12 +259,6 @@ PKG_FILES = FileList.new( [
   fl.exclude( 'doc/output' )
 end
 
-task :package => [:gen_files, :create_gal_layout_pics] do
-  chdir 'pkg' do
-    sh "rpaadmin packport #{PKG_NAME}-#{PKG_VERSION}"
-  end
-end
-
 CLOBBER << "otherdata/web-for-gallery-pics/output"
 task :create_gal_layout_pics do
   chdir 'otherdata/web-for-gallery-pics' do
@@ -130,43 +266,18 @@ task :create_gal_layout_pics do
   end
 end
 
+CLOBBER << "ChangeLog"
 task :gen_changelog do
   sh "svn log -r HEAD:1 -v > ChangeLog"
 end
 
+CLOBBER << "VERSION"
 task :gen_version do
   puts "Generating VERSION file"
   File.open( 'VERSION', 'w+' ) do |file| file.write( PKG_VERSION + "\n" ) end
 end
 
-task :gen_installrb do
-  puts "Generating install.rb file"
-  File.open( 'install.rb', 'w+' ) do |file|
-    file.write "
-require 'rpa/install'
-
-class Install_#{PKG_NAME} < RPA::Install::FullInstaller
-  name '#{PKG_NAME}'
-  version '#{PKG_VERSION}-1'
-  classification Application
-  build do
-    installdocs %w[COPYING ChangeLog TODO]
-    installdocs 'docs'
-    installrdoc %w[README] + Dir['lib/**/*.rb']
-    installdata
-  end
-  description <<-EOF
-#{PKG_SUMMARY}
-
-#{PKG_DESCRIPTION}
-  EOF
-end
-"
-    end
-end
-
-task :gen_files => [:gen_changelog, :gen_version, :gen_installrb]
-CLOBBER << "ChangeLog" << "VERSION" << "install.rb"
+task :package => [:gen_changelog, :gen_version]
 
 Rake::PackageTask.new( PKG_NAME, PKG_VERSION ) do |p|
   p.need_tar = true
@@ -218,15 +329,6 @@ else
 
 end
 
-=begin
-desc "Creates a tag in the repository"
-task :tag do
-  repositoryPath = File.dirname( $1 ) if `svn info` =~ /^URL: (.*)$/
-  fail "Tag already created in repository " if /#{PKG_NAME}/ =~ `svn ls #{repositoryPath}/versions`
-  sh "svn cp -m 'Created version #{PKG_NAME}' #{repositoryPath}/trunk #{repositoryPath}/versions/#{PKG_NAME}"
-end
-=end
-
 desc "Upload documentation to homepage"
 task :uploaddoc => [:doc] do
   Dir.chdir('doc/output')
@@ -234,39 +336,55 @@ task :uploaddoc => [:doc] do
 end
 
 
-# Misc tasks ###################################################################
-
-
-def count_lines( filename )
-  lines = 0
-  codelines = 0
-  open( filename ) do |f|
-    f.each do |line|
-      lines += 1
-      next if line =~ /^\s*$/
-      next if line =~ /^\s*#/
-      codelines += 1
+# Helper methods ###################################################################
+
+def create_examples( dir_name, data, template = nil, style = nil )
+  base_dir = 'doc/examples'
+  src_dir = 'doc/src/examples'
+
+  mkdir_p( File.join( src_dir, dir_name ) )
+  mkdir_p( File.join( base_dir, dir_name ) )
+  data[:entries].sort.each do |name, entry|
+    dir = File.join( base_dir, dir_name, name )
+    files_mtime = entry.files.collect {|f| File.mtime( f ) }.max
+    dir_mtime = File.mtime( dir ) rescue Time.parse("1970-1-1")
+    if dir_mtime < files_mtime
+      puts "Creating example files for #{dir_name} '#{name}'..."
+      rm_rf( dir )
+      Webgen::WebSite.create_website( dir, template || name, style || name )
+      File.open( File.join( dir, 'config.yaml' ), 'w+' ) do |f|
+        f.write( "Core/Configuration: \n"+
+                 "  outDir: ../../../output/examples/#{dir_name}/#{name}" )
+      end
+      Webgen::WebSite.new( dir ).render
+    end
+    File.open( File.join( src_dir, dir_name, "#{name}.page" ), 'w+' ) do |f|
+      f.write("---
+title: #{name}
+inMenu: true
+--- content, html
+<object type='text/html' data='#{name}/index.html' width='100%' height='600px' />
+")
     end
   end
-  [lines, codelines]
+  create_example_index( File.join( src_dir, dir_name, "index.page" ), data )
 end
 
-
-def show_line( msg, lines, loc )
-  printf "%6s %6s   %s\n", lines.to_s, loc.to_s, msg
-end
-
-
-desc "Show statistics"
-task :statistics do
-  total_lines = 0
-  total_code = 0
-  show_line( "File Name", "Lines", "LOC" )
-  SRC_RB.each do |fn|
-    lines, codelines = count_lines fn
-    show_line( fn, lines, codelines )
-    total_lines += lines
-    total_code  += codelines
+def create_example_index( filename, data )
+  mkdir_p(  File.dirname( filename ) )
+  index = File.open( File.join( filename ), 'w+' )
+  index.puts("---
+title: Index
+directoryName: #{data[:dirname]}
+---
+#{data[:desc]}
+
+")
+  data[:entries].sort.each do |name, entry|
+    index.puts("* <a href='#{name}/index.html'>#{name}</a>\n\n")
+    entry.infos.sort.each do |info_name, info_value|
+      index.puts("  * *#{info_name.capitalize}*: #{info_value}")
+    end
   end
-  show_line( "Total", total_lines, total_code )
+  index.close
 end

data/TODO

@@ -1,32 +1,64 @@
 ---- CURRENT ----
 
-* BUG command clean does not delete all files (e.g. no resources, other files generated by plugins [source plugin])
-* show available styles and templates in docu and in online help (webgen help create)
-* think about plugin system, @@config etc - should work from within webgen-gui, not only once from webgen
-* make webgen source installation work with correct cmdparse version
-* FileCopyHandler#initialize not reentrant
-* make menu generation faster (for webgen: 5.2s without menus in template, 9.2s with menus!)
-* create tests for methods in webgen.rb
-* check if duplicate nodes are created??? by using a tag in a template
-* allow a template to use another template (templates as page description files?) (template2 uses template1)
-* use code generator to create test file with all tags and all tag parameter configurations
+* show error message when configuration file is invalid (Webgen::WebSite)
+* fix website styles menus to have a style for current menu item with <span> instead of <a>
+* add a common class to the menu element (either a or span, depending on Fil/DefaultFileHandler:linkToCurrentPage) for easier referencing in CSS styles (update menu CSS style afterwards for horiz-dd, vert-dd, ...)
+* add parameters startLevel, minLevels, maxLevels to horizontal menu style
+* make linking to image galleries possible by specifing the gallery file
+* change namespace of tag plugins from tags to tag
+* send bug report to rdoc maintainer (rdoc does not handle nested method defintions correctly)
+* make source installation work again (because of help forum entry)?
+* rethink plugin config handling (maybe all in a list which is traversed and stopped when one item returns a value)
+* extend usage of tags by allowing the following: {highlight: ruby}content to highlightasd {highlight} and add tag for syntax highlighting???
+* add listener which checks that after reading the tree no new nodes are created
+* if a meta info is not available on the current page, look for it in the template, then in the template of the template, aso.
+  -> not easily or not all possible
+* refactor menu style plugins so that indivdual parts of the menu can be overridden (by e.g. singleton methods)
+* search for TODO items
 
 ---- DOCU ----
 
-* examples for each type of plugins in extending webgen section
+* documentation: add a glossary (webgen, node, page file, gallery file, parameter, path pattern, plugin, ...)
+* document how to create gallery styles
+* documentation: add info about what webgen does during a run (read files, create nodes, write nodes)
+* documentation: add a page about YAML and basic use
+* documentation: add a resource reference file with the table of resources
+* document: check for consistent naming (page files, tags,...)
+* document homepage structure (where is plugin docu, api docu,...)
+* document tag @processOutput changed to @process_output
+* param values must not be changed during the run by a plugin!!!, see source code of DefaultTag for an example to override params nonetheless
+* document speed boost by precalculating node values (costs memory, saves runtime)
+* changed structure of blocks meta_info
+* provide a sample blog (with andreas04 style)
+* website_template/website_style/gallery_style -> README first infos are shown in help, after --- ignored for infos hash
+* files must not have spaces in their names!
+* all hooks are now lower case!!!
+* DefaultFileHandler#node_for_lang
+    - should return the node for the given lang if available
+    - default behaviour is to return node itself (useful for pics, stylesheets, ...)
+* DirectoryHandler#node_for_lang
+    - if no node in lang found, return default node, emit warning
+    - if node in lang found, return found node
+    - if no index file, return default node, emit warning
+* update copyright year in all files
+* examples for each type of plugins in extending webgen section -> better into API docs
 
 ---- FUTURE ----
 
+* remove duplicate code from file handler plugins' create_node method
+* add flag images for language bar which are (control through param) used instead of language abbr
+* allow resources to reference URLs???
+* allow following configuration file syntax:
+  if the key is of the form 'add <name>' then it is assumed that the default value for param name is an array or hash
+  and the given entries are added instead of overwriting the array/hash
+* google sitemap generator
+* blogging and rss handlers
 * Configuration:outDirectory should support FTP and SFTP protocols
-* refactor code sothat one source file can be used by 0..n processors
-* tag 'link' which provides a link to the file optionally showing an icon
-* parameter for including page icons in menus
-* parameter for setting the orderInfo of index pages so that they always appear as first entry
-* implement plugin which creates nodes for fragment identifiers (#info) in html
+* tag 'link' which provides a link to the file optionally showing an icon -> see mail
+* parameter for including page icons in menus (use key pageIcon in node meta info, if set use it in DefaultMenuStyle#menu_item_details)
 * include spell checker (ispell, aspell, MS Word OLE on Win32,...)
 * tag 'resume', uses xmlresume2x to provide HTML version of xml resume
 * multi-lingual picture/gallery files
-* include exif info for pictures
 
 ---- DONE ----
 
@@ -211,3 +243,129 @@ W do not allow two or more page files in the same language, print warn
 * adapt clidesc to cmdparse 2.0.0
 * webgen show config => output same info as on docu pages
 * test usage for en, deu, eng (ISO-639-2 codes)
+* rename Plugin.add_param to Plugin.param
+* rename ContentHandlers to ContentFormatters
+* how to use Node#resolve_node to resolve page nodes given like index.page (tree uses output names)???
+* think about plugin system, @@config etc - should work from within webgen-gui, not only once from webgen
+* FileCopyHandler#initialize not reentrant
+* allow a template to use another template (templates as page description files?) (template2 uses template1)
+* refactor code sothat one source file can be used by 0..n processors
+* implement plugin which creates nodes for fragment identifiers (#info) in html
+* Node#resolve_node: query part has to be removed from URL for this function to work correctly -> no, works with query part too!
+* ruby 1.8.2 (2004-11-06) [i386-mswin32]: bug in File.join: File.join('asdf', '/') -> 'asdf//' instead of 'asdf/' -> works with 1.8.4
+* BUG make tc_tags_executecommand work on windows (with windows echo command)
+* test on Windows with Ruby 1.8.4
+* make tests independent from RedCloth (overwrite default content converter for PageFileHandler)
+* rename tags/tags.rb to tags/tag_processor.rb
+* is metainfo orderInfo incorrectly named? sortInfo better? -> Node#order_info --> let this be orderInfo for now
+* test on windows after update to newest ruby version!
+* add test case for SmileyReplacer
+* implement system which allows to specify which files/types of files should be read in which order by FileHandler
+* renamed handle_extension, handle_path_pattern to register_extension and register_path_pattern
+* new semantics for param changehandler: if set, use it to set the new value (useful for updating hashs instead of overwriting) --> no changehandler anymore
+* ev. use change handler for not substituting PageHandler:defaultPageMetaData, but merging with old values --> no changehandler anymore
+* add object for main gallery page to galleryinfo object
+* depends_on accepts only strings
+* implement output backing file functionality
+* mail to comic site creator that nav links for gallery in main template now possible
+* Catch ERB errors
+* all nodes should be created through a FileHandler method (should be used by, e.g., GalleryFileHandler)
+  - method should have hooks before_create_node and after_create_node
+* plugin#param calls are expensive, use local variable if possible (eg. TemplateFileHandler#get_default_template)
+* use relocatable tag in gallery templates for page and image references
+* create tag block for substituting page blocks
+* add tests in page files to check if used language code is correct (use LanguageManager)
+* provide more hooks into system
+* add syntax highlighting to includefile tag, executecommand tag, and ev. others
+* relocatable: path has to be changed so that it has correct lang in it if it is a page node path or split in path + fragment and search for path, then get correct lang node, then search fragment
+* gallery layouts not with plugins, but with nested templates (one for each: main page, gallery pages, pictures page)
+  put a special GalleryInfo object in node.node_info[:ginfo] which holds all information about the gallery and
+  provides helper functions (next_pindex, next_gindex,...)
+  -> provide a command to copy provided gallery layout templates to a website dir (webgen use gallerylayout <name>)
+  -> "webgen use" can also be used for: webgen use style
+  -> then its possible to put navigational buttons outside of the {block: content}, namely in the super template
+     (see mail from comic site author)
+* new option for create command: -u --update-style-only (for only updating the style info) -> see above webgen use style
+* problem loading a website twice due to using require -> now loading site specific plugins into a module
+* use new scheme for plugin names which does not use the class name
+* add a few good opensource website styles (e.g. some from andreas viklund)
+* add CLI command plugins again
+* use Text::Format or something similar for formatting CLI output (e.g. webgen help create) -> using own simple formatter method
+* css styles should NOT do styling of content!!! only whats necessary to fulfill the job (eg. dropdown behaviour)
+* add parameter to vertical menu style: startLevel -> level at which menu should be started -> use it in andreas06/plain website style
+* print files copied by create and use commands!
+* andreas01 style bug: when no submenus, menu is moved down a little bit -> mail to a.viklund
+* partial menu: should only show menu level UNDER the current level (i.e. if a dir on top level selected, show pages in dir) -> use vertical style with startLevel dynamically set via ERB
+* add possibility to only update one file -> instead of whole site, one or more files can now be generated
+* eventually use two levels of info: one for infos that should be displayed normally and one for additional infos
+  - always displayed: node creation, node writing, thumbnail writing
+  --> not two info levels: the messages that are too verbose go into the debug level
+* add posibility to add attr=value pairs to links (in the #link_from method, use a meta_info prop link_attrs)
+* redo docu for webgen run command: Runs webgen, ie. generates the HTML files
+* BUG command clean does not delete all files (e.g. no resources, other files generated by plugins [source plugin]) -> no clean command anymore, maybe later again when caching of website nodes is possible
+* make webgen source installation work with correct cmdparse version -> installation via rubygem is the preferred way, and much easier
+* new configuration file syntax:
+  - should be ruby file -> still yaml for consistency (meta info in page file and backing file are yaml)
+  - should allow changing of parameters with opt. updater function -> not implemented
+  - should allow changing of file handler patterns -> not really useful (would be like changing the ext. of a OO.o
+* better system for setting default page meta data like default content format/block names etc -> see above
+* integrate xml builder for HTML/XML generation
+* file handler for rcss files (CSS files with ERB code) -> redo website style CSS files in rcss
+  not only rcss but any kind of preprocessed files, include param paths like copy handler,
+  strip the letter r from extension: default.rcss -> default.css, mytest.rtxt -> mytest.txt
+  -> handle this via copy handler, new param erbPaths -> are preprocessed with erb
+* remove SYNTAX_HIGHLIGHTING constant by using a method in manager which returns if an optional part is loaded
+* new CLI command for checking availability of add. libraries (opt. libraries should be wrapped by a special method load_optional_part() )
+  parameters: :name, :error_msg, :about, :needed_gems
+* new CLI command for checking configuration file
+* include exif info for pictures (use exif library from RAA) -> using exifr gem as it is available as gem and pure ruby!
+* pre-compile ERB templates -> should give a little speed boost -> which it does a little ;-)
+* Node#route_to can't handle '..'!!! -> now it can by using the pathname library
+* implement static menus, ie. if a file menu.yaml is in the website dir, use it instead of building menu trees
+  - file format simliar to page files, one block for a menu tree in one language, if menu trees for more than one
+    language then use more blocks with e.g. "--- de" separators, if no separator at beginning of file -> menu tree
+    for default language
+  - need to rethink the definition of a menu tree for static menus where categories do not need to be directories
+  -->> implemented, but differently: not menu.yaml, but 'static' menus are defined using the output backing mechanism
+* parameter for setting the orderInfo of index pages so that they always appear as first entry
+  -> no really useful, one can just set the orderInfo using the meta info backing file or in the index files themselves
+* optimize param_for_plugin by not using exception but return values (return [param_found, param_value])
+* optimize PluginManager#plugin_class_for_name (store plugin_classes as hash)
+* it seems that precalculating the param values and then using them does not boost the speed so much :-(
+* maybe: precalculate full_path, absolute_path, to_url when parent or path changed -> huge speed boost!!!
+* make website generation faster (webgen 0.3.8: ~6.5s, new webgen ~13.0s!)
+* adapt GalleryInfo object: add a general data object which holds general information about the gallery (imagesPerPage, thumbnailSize,...)
+  -> the general data object should be unique among all gallery info objects
+* document which plugin uses which resource (eg. menu plugins depend on webgen-css resource)
+* new plugin naming convention:
+  - Core/ - core plugins, File/ - file handler plugins, Tags/ - tag processors, Misc/ - misc plugins
+  - HtmlValidator/ - html validators, MenuStyle/ - menu styles, ContentConverter/ - content converters
+* document how plugin naming works (namespace/pluginname)
+* documentation: create an example section where gallery styles, website style, aso are showcased!
+* place a note about the spelling of webgen (all lowercase) somewhere very prominently
+* Coderay version 0.7.4.215 required at least
+* document how to build a menu with arbitrary section and menu items (also menu items under several different headings)
+* document default plugin name (derived from class name)
+* provide a sample for each website style on the webgen homepage
+* describe how path patterns work -> ri Dir.glob
+* file handlers which want to create a node that does already exist have to return the node
+* filehandler ignores hidden directories, ie. ones with a leading dot
+* depends_on only accepts strings
+* document new dependencies like builder and coderay and exifr
+* document on gallery style slides that collage/slide images are only created if they do not exist!
+* doucment that when using the slides gallery style there has to be an 'layouter: slides' entry in the gallery file!
+* documentation: put api specific documentation into RDOC, user specific docus on homepage
+* document install page: two sections (Download/Install) and refer to special windows install issues
+* document fields for plugin infos method
+* docoument new CLI commands (check config/libs, use gallery_style/website_style, ...)
+* loader.load_from_dir/load_from_file wraps the loaded classes in a module, load_from_block does not!
+* document that website styles have be edited and full demos are available on the given homepage
+* documentation: what else to say generally about file handlers?
+* documentation: plugin names should have the form namespace/namespace/.../name where namespace and name should only have alphanumeric chars
+* show available styles and templates in docu and in online help (webgen help create)
+* documentation: new meta info linkAttrs used in links: should be a hash of attribute-value pairs which will be added to a link to this page node
+* document linkAttrs meta info (eg. used for adding custom attributes to links, e.g. custom icons using css or accessibility features, use backing file for setting icons for directories)
+* the use commands only copy files, they do not delete files in the src dir
+* document that source directory is now always called src - no parameter anymore
+* document somewhere which objects are available when processing templates/pages files with ERB
+* document evaluation order of page files (first content converted from Textile/Markdown/... to HTML, then ERB, then tags)