webgen 0.3.8 → 0.4.0

data/doc/src/index.page

@@ -3,9 +3,16 @@ title: HomePage
 inMenu: true
 directoryName: webgen
 ---
-h2. Welcome
+h2. About _webgen_
 
-... to the homepage of _*webgen*_, a template based static website generator.
+webgen is used to generate web pages from page and template files. You create one or more template
+files in which you define the layout of your page and where the content should go. After that you
+create page files in which you only define the content.
+
+When webgen is run it combines the template with each of the page files and generates the HTML
+output files. During this process special tags are substituted so that, for example, a menu is
+generated. Actually, this website was generated with webgen and, for example, the menu that you can
+see was created dynamically. For more information look at the documentation!
 
 This whole site was generated with webgen and provides an online demonstration of its features.
 Choose from the menu what you want to see from or know about webgen!
@@ -16,105 +23,10 @@ can "report it here!":http://rubyforge.org/tracker/?atid=1207&group_id=296&func=
 are "forums":http://rubyforge.org/forum/?group_id=296 and a "mailing
 list":http://rubyforge.org/mail/?group_id=296 available if you have any questions!
 
-h2. News
-
-<b>29.12.2005 - webgen 0.3.8 release!!!</b>
-
-Bug fix release
-
-<b>27.11.2005 - webgen 0.3.7 released!!!</b>
-
-Major changes:
-
-* Now using cmdparse version 2.0.0!
-* %{color:red}Attention%: For unified naming in reference to image galleries, I have removed all occurences of the word "picture" from the code and documentation and replaced it with "image". Therefore you may need to adapt your code, especially custom gallery layouters!
-* %{color:red}Attention%: Many documentation and library files have been renamed for better consistency! Custom plugins may have to be adapted!
-* <b>New <a href="{relocatable: /documentation/webgen_gallery_editor.page}">application</a></b> for managing image galleries (only alpha quality currently!)
-* Smileys are now optionally replaced with emoticons (<notextile>:-) ;-) :'-( 8-)</notextile>, several different emoticon packs available) -> see <a href="{relocatable: documentation/plugins/miscplugins/smileyreplacer.page}">SmileyReplacer</a>
-* <a href="{relocatable: documentation/extending_webgen.page}">Site specific commands</a> (used in command line processing) can now be used
-* New plugin <a href="{relocatable: documentation/plugins/tags/download.page}">Download Tag</a> for nice download links
-* New parameters: <a href="{relocatable: documentation/plugins/filehandlers/page.page}">PageFileHandler:defaultPageMetaData</a>, <a href="{relocatable: documentation/plugins/tags/sitemap.page}">SitemapTag:honorInMenu</a>
-* Removed parameters: PageFileHandler:useERB, PageFileHandler:defaultContentFormat
-* Renamed tag <b>navbar</b> to <b>breadcrumbTrail</b>
-* Images in image galleries can now be ordered by specifying the @orderInfo@ meta information
-* The use of directory index files is now optional: by setting the parameter <a href="{relocatable: documentation/plugins/filehandlers/directoryhandler.page}">DirectoryHandler:indexFile</a> to nil directory index files are not used
-* Languages can now be specified using 2-char ISO-639-1 codes or 3-char ISO-639-2 codes
-* Now there is a link (next to the wiki link) to the source of each page unless the page was programmatically generated.
-
-<b>24.06.2005 - webgen 0.3.5 released!!!</b>
-
-Major changes:
-
-* Now using cmdparse version 1.0.3!
-* New CLI command "clean" for deleting the generated or all files from the output directory
-* Restructured menu tag -> five different menu styles now available (see <a href="{relocatable: documentation/plugins/menustyles}">Menu Styles</a>)
-* New plugin <a href="{relocatable: documentation/plugins/coreplugins/resourcemanager.page}">ResourceManager</a> for defining resources
-* New plugin <a href="{relocatable: documentation/plugins/tags/resource.page}">Resource Tag</a> for accessing resources
-* Pages files can now be referenced in @relocatable@ tag and backing files with a standardified name (see <a href="{relocatable: documentation/plugins/filehandlers/page.page#naming}">here</a>), despite an eventually self defined naming scheme
-* New parameters: <a href="{relocatable: documentation/plugins/tags/langbar.page}">LangbarTag:showOwnLang</a>
-* Changed paramters: <a href="{relocatable: documentation/plugins/filehandlers/page.page}">PageFileHandler:validator</a> (now deactivated by default)
-* Fixed bugs
-
-<b>12.05.2005 - webgen 0.3.4 released!!!</b>
-
-Major changes:
-
-* FileHandler now uses path patterns and/or extensions for determining which files to process !
-* ERB (embedded ruby) can now be used in templates and page files (see <a href="{relocatable: documentation/plugins/filehandlers/page.page}">PageFileHandler</a>)!
-* Relocatable tag now accepts complex URIs (URIs with query and fragment part, absolute URIs)
-* Changed meta info name *menuOrder* to *orderInfo* (e.g. used for specifying order information for menus) -- you have to adapt your page and backing files!!!
-* New parameters: <a href="{relocatable: documentation/plugins/filehandlers/page.page}">PageFileHandler:useERB</a>
-* Changed parameters: <a href="{relocatable: documentation/plugins/filehandlers}">FileHandler:ignorePaths</a>, <a href="{relocatable: documentation/plugins/filehandlers/copy.page}">CopyFileHandler:paths</a>
-* New page describing meta information items used by plugins
-* Fixed bugs
-
-<b>21.04.2005 - webgen 0.3.3 released!!!</b>
-
-Major changes:
-
-* New command line interface based on "CommandParser":http://cmdparse.rubyforge.org
-* Now you can let webgen create the basic directories and files by executing @webgen create my_site@
-* New logging plugin lets you have more control over logging and log files
-* Now each website can have a plugin directory
-* New parameters for: <a href="{relocatable: documentation/plugins/tags/wikilink.page}">wikilink</a>
-* Changed format of backing files -> have a look at the <a href="{relocatable: documentation/plugins/filehandlers/backing.page}">documentation</a>!
-* Removed obsolete Extension Loader plugin
-* Fixed bugs
-
-
-<b>17.03.2005 - webgen 0.3.2 released!!!</b>
-
-Bug fix release for bug #1637 and other bugs
-
-
-<b>16.03.2005 - webgen 0.3.1 released!!!</b>
-
-Major changes:
-
-* Better DefaultLayouter for image galleries (<a href="{relocatable: Screenshots_1.page}">online demo</a>)
-* Output names for page files now customizable (see <a href="{relocatable: documentation/plugins/filehandlers/page.page}">PageFileHandler</a>)
-* On-the-fly creation of thumbnails for images with RMagick
-* New tags: <a href="{relocatable: documentation/plugins/tags/sitemap.page}">sitemap</a>
-* Tag @lang@ renamed, new name @langbar@!
-* New parameters for @menu@ tag
-* Automatic checking of HTML files on their validness
-* Fixed bugs
-
-
-<b>21.02.2005 - webgen 0.3.0 released!!!</b>
-
-Major changes:
-
-* Textile, Markdown, RDOC and HTML as content format supported!!!
-* New tags: <a href="{relocatable: documentation/plugins/tags/wikilink.page}">wikilink</a>
-* Improved plugin system
-* On-the-fly creation of new tags
-* Fixed bugs
-* Improved online documentation: pages on file handlers and tags now show parameters and other
-  additional info
-* Added comprehensive test suite
-* and more...
 
-h2. And so ...
+h2. Author
 
-... have fun!
+* *Thomas Leitner*
+* Web: "http://webgen.rubyforge.org":http://webgen.rubyforge.org
+* e-Mail: "t_leitner@gmx.at":mailto:t_leitner@gmx.at
+* GPG Key-Id: 0xD942E7F6

data/doc/src/news.page

@@ -0,0 +1,154 @@
+---
+title: News
+inMenu: true
+---
+h2. News
+
+
+h3(#news-2007-01-05). 05.01.2007 - webgen 0.4.0
+
+
+This is a major release with many updates to the webgen core, the plugins and the documentation.
+Plugins written for prior version won't work with this one anymore. However, changing them to work
+again is easy. As an upgrade guide is currently not available have a look at webgen plugins and the
+API documentation to see how to do upgrade plugins.
+
+Major changes:
+
+* New website layout :-)
+* webgen now includes many <a href="{relocatable: examples/website_styles}">website styles</a> which can be used out of the box!
+* Template files have the same format as page files now and can be nested!
+* Speed-up through caching of node information
+* New and cool gallery style
+* New content converter plugin ({plugin: ContentConverter/XmlBuilder})
+* New plugin for syntax highlighting ({plugin: Misc/SyntaxHighlighter})
+* Many changes to the core (plugin system revised, webgen can now be used from other Ruby applications directly, faster node resolution, hooks are now spelled with only lowercase letters, ...)
+* Structure of meta information @blocks@ changed
+* New meta information @linkAttrs@ for setting additional attributes on links
+* Handling and structure of meta information backing file changed
+* Evaluation of page files changed (first converted to HTML, then ERB, then webgen tags)
+* "Static" menus now available
+* New sub-commands for the webgen command
+* Gallery editor application deprecated.
+* Many tests have been added.
+* Documentation on the homepage as well as the API documentation is now more complete
+* Fixed many bugs
+* *Many other changes*
+
+For detailed information have a look at the ChangeLog file included in the webgen distribution!
+
+*Upcoming features:*
+
+* More documentation
+* Blogging plugins
+* RSS generation plugins
+
+
+h3(#news-2005-12-29). 29.12.2005 - webgen 0.3.8
+
+
+Bug fix release
+
+
+h3(#news-2005-11-27). 27.11.2005 - webgen 0.3.7
+
+
+Major changes:
+
+* Now using cmdparse version 2.0.0!
+* %{color:red}Attention%: For unified naming in reference to image galleries, I have removed all occurences of the word "picture" from the code and documentation and replaced it with "image". Therefore you may need to adapt your code, especially custom gallery layouters!
+* %{color:red}Attention%: Many documentation and library files have been renamed for better consistency! Custom plugins may have to be adapted!
+* New application for managing image galleries (only alpha quality currently!)
+* Smileys are now optionally replaced with emoticons (<notextile>:-) ;-) :'-( 8-)</notextile>, several different emoticon packs available) -> see {plugin: Misc/SmileyReplacer}
+* <a href="{relocatable: documentation/extending_webgen.page}">Site specific commands</a> (used in command line processing) can now be used
+* New plugin {plugin: Tag/Download} for nice download links
+* New parameters: PageFileHandler:defaultPageMetaData, SitemapTag:honorInMenu
+* Removed parameters: PageFileHandler:useERB, PageFileHandler:defaultContentFormat
+* Renamed tag <b>navbar</b> to <b>breadcrumbTrail</b>
+* Images in image galleries can now be ordered by specifying the @orderInfo@ meta information
+* The use of directory index files is now optional: by setting the parameter File/DirectoryHandler:indexFile to nil directory index files are not used
+* Languages can now be specified using 2-char ISO-639-1 codes or 3-char ISO-639-2 codes
+* Now there is a link (next to the wiki link) to the source of each page unless the page was programmatically generated.
+
+
+h3(#news-2005-06-24). 24.06.2005 - webgen 0.3.5
+
+
+Major changes:
+
+* Now using cmdparse version 1.0.3!
+* New CLI command "clean" for deleting the generated or all files from the output directory
+* Restructured menu tag -> five different menu styles now available (see {plugin: MenuStyle})
+* New plugin {plugin: Core/ResourceManager} for defining resources
+* New plugin {plugin: Tag/Resource} for accessing resources
+* Pages files can now be referenced in @relocatable@ tag and backing files with a standardified name, despite an eventually self defined naming scheme
+* New parameters: LangbarTag:showOwnLang
+* Changed paramters: PageFileHandler:validator (now deactivated by default)
+* Fixed bugs
+
+
+h3(#news-2005-05-12). 12.05.2005 - webgen 0.3.4
+
+
+Major changes:
+
+* FileHandler now uses path patterns and/or extensions for determining which files to process !
+* ERB (embedded ruby) can now be used in templates and page files !
+* Relocatable tag now accepts complex URIs (URIs with query and fragment part, absolute URIs)
+* Changed meta info name *menuOrder* to *orderInfo* (e.g. used for specifying order information for menus) -- you have to adapt your page and backing files!!!
+* New parameters: PageFileHandler:useERB
+* Changed parameters: FileHandler:ignorePaths, CopyFileHandler:paths
+* New page describing meta information items used by plugins
+* Fixed bugs
+
+
+h3(#news-2005-04-21). 21.04.2005 - webgen 0.3.3
+
+
+Major changes:
+
+* New command line interface based on "CommandParser":http://cmdparse.rubyforge.org
+* Now you can let webgen create the basic directories and files by executing @webgen create my_site@
+* New logging plugin lets you have more control over logging and log files
+* Now each website can have a plugin directory
+* New parameters for: Tag/WikiLink
+* Changed format of backing files -> have a look at the documentation
+* Removed obsolete Extension Loader plugin
+* Fixed bugs
+
+
+h3(#news-2005-03-17). 17.03.2005 - webgen 0.3.2
+
+
+Bug fix release for bug #1637 and other bugs
+
+
+h3(#news-2005-03-16). 16.03.2005 - webgen 0.3.1
+
+
+Major changes:
+
+* Better DefaultLayouter for image galleries
+* Output names for page files now customizable (see {plugin: File/PageHandler})
+* On-the-fly creation of thumbnails for images with RMagick
+* New tags: {plugin: Tag/Sitemap}
+* Tag @lang@ renamed, new name @langbar@!
+* New parameters for @menu@ tag
+* Automatic checking of HTML files on their validness
+* Fixed bugs
+
+
+h3(#news-2005-02-21). 21.02.2005 - webgen 0.3.0
+
+
+Major changes:
+
+* Textile, Markdown, RDOC and HTML as content format supported!!!
+* New tags: {plugin: Tag/WikiLink}
+* Improved plugin system
+* On-the-fly creation of new tags
+* Fixed bugs
+* Improved online documentation: pages on file handlers and tags now show parameters and other
+  additional info
+* Added comprehensive test suite
+* and more...

data/doc/src/plugin.template

@@ -0,0 +1,10 @@
+--- content, textile
+h1. General Information
+
+<notextile>
+
+{describe: <%= node['plugin'] %>}
+
+{block: content}
+
+</notextile>

data/lib/webgen/cli.rb

@@ -0,0 +1,427 @@
+#
+#--
+#
+# $Id: cli.rb 579 2007-01-04 20:48:43Z 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
+#
+#++
+#
+
+require 'rbconfig'
+require 'fileutils'
+require 'cmdparse'
+require 'webgen/website'
+
+module Webgen
+
+  class Color
+
+    @@colors = {:bold => [0, 1], :green => [0, 32], :lblue => [1, 34], :lred => [1, 31], :reset => [0, 0]}
+
+    def self.colorify
+      @@colors.each do |color, values|
+        module_eval <<-EOF
+        def Color.#{color.to_s}( text = nil )
+          "\e[#{values[0]};#{values[1]}m" + (text.nil? ? '' : text + self.reset)
+        end
+        EOF
+      end
+    end
+
+    def self.method_missing( id, text = nil )
+      text.to_s
+    end
+
+  end
+
+
+  class CliUtils
+
+    def self.format( content, indent = 0, width = 100 )
+      content ||= ''
+      return [content] if content.length + indent <= width
+      lines = []
+      while content.length + indent > width
+        index = content[0..(width-indent-1)].rindex(' ')
+        lines << (lines.empty? ? '' : ' '*indent) + content[0..index]
+        content = content[index+1..-1]
+      end
+      lines << ' '*indent + content unless content.strip.empty?
+      lines
+    end
+
+    def self.headline( text, indent = 2 )
+      ' '*indent + "#{Color.bold( text )}"
+    end
+
+    def self.section( text, ljustlength = 0, indent = 4, color = :green )
+      ' '*indent + "#{Color.send( color, text )}".ljust( ljustlength - indent + Color.send( color ).length + Color.reset.length )
+    end
+
+    def self.dirinfo_output( opts, name, dirinfo )
+      ljust = 15 + opts.summary_indent.length
+      opts.separator CliUtils.section( 'Name', ljust, opts.summary_indent.length + 2 ) + "#{Color.lred( name )}"
+
+      dirinfo.infos.sort.each do |name, value|
+        desc = CliUtils.format( value, ljust )
+        opts.separator CliUtils.section( name.capitalize, ljust, opts.summary_indent.length + 2 ) + desc.shift
+        desc.each {|line| opts.separator line}
+      end
+      opts.separator ''
+    end
+
+  end
+
+
+  class CreateCommand < CmdParse::Command
+
+    def initialize
+      super( 'create', false )
+      self.short_desc = "Creates the basic directories and files for webgen."
+      self.description = CliUtils.format( "\nIf the global verbosity level is set to 0 or 1, the created files are listed." )
+      self.options = CmdParse::OptionParserWrapper.new do |opts|
+        opts.separator "Options:"
+        opts.on( '-t', '--template TEMPLATE', Webgen::WebSiteTemplate.entries.keys, 'Specify the template which should be used' ) {|@template|}
+        opts.on( '-s', '--style STYLE', Webgen::WebSiteStyle.entries.keys, 'Specify the style which should be used' ) {|@style|}
+        opts.separator ""
+        opts.separator "Arguments:"
+        opts.separator opts.summary_indent + "DIR: the base directory for the website"
+        opts.separator ""
+        opts.separator "Available templates and styles:"
+        opts.separator ""
+        opts.separator opts.summary_indent + "#{Color.bold( 'Templates' )}"
+        Webgen::WebSiteTemplate.entries.sort.each {|name, entry| CliUtils.dirinfo_output( opts, name, entry ) }
+        opts.separator opts.summary_indent + "#{Color.bold( 'Styles' )}"
+        Webgen::WebSiteStyle.entries.sort.each {|name, entry| CliUtils.dirinfo_output( opts, name, entry ) }
+      end
+      @template = 'default'
+      @style = 'default'
+    end
+
+    def usage
+      "Usage: #{commandparser.program_name} [global options] create [options] DIR"
+    end
+
+    def execute( args )
+      if args.length == 0
+        raise OptionParser::MissingArgument.new( 'DIR' )
+      else
+        files = Webgen::WebSite.create_website( args[0], @template, @style )
+        if (0..1) === commandparser.verbosity
+          puts "The following files were created:"
+          puts files.collect {|f| "- " + f }.join("\n")
+        end
+      end
+    end
+
+  end
+
+  class UseCommand < CmdParse::Command
+
+    def initialize( cmdparser )
+      super( 'use', true )
+      self.short_desc = "Changes the used website or gallery styles"
+
+      @force = false
+      self.options = CmdParse::OptionParserWrapper.new do |opts|
+        opts.separator "Options:"
+        opts.on( '-f', '--[no-]force', 'If specified, existing files are overwritten without asking.' ) {|@force|}
+      end
+
+      # Use website style command.
+      useWebsiteStyle = CmdParse::Command.new( 'website_style', false )
+      useWebsiteStyle.short_desc = "Changes the used website style"
+      useWebsiteStyle.description =
+        CliUtils.format("\nCopies the style files for the website style STYLE to the website " +
+                        "directory defined by the global directory option, overwritting existing " +
+                        "files. If the global verbosity level is set to 0 or 1, the copied files are listed.")
+      useWebsiteStyle.options = CmdParse::OptionParserWrapper.new do |opts|
+        opts.separator "Available styles:"
+        opts.separator ""
+        Webgen::WebSiteStyle.entries.sort.each {|name, entry| CliUtils.dirinfo_output( opts, name, entry ) }
+      end
+      def useWebsiteStyle.usage
+        "Usage: #{commandparser.program_name} [global options] use website_style STYLE"
+      end
+      useWebsiteStyle.set_execution_block do |args|
+        if args.length == 0
+          raise OptionParser::MissingArgument.new( 'STYLE' )
+        else
+          if @force || ask_overwrite
+            files = Webgen::WebSite.use_website_style( cmdparser.directory, args[0] )
+            if (0..1) === cmdparser.verbosity
+              puts "The following files were created or overwritten:"
+              puts files.collect {|f| "- " + f }.join("\n")
+            end
+          end
+        end
+      end
+      self.add_command( useWebsiteStyle )
+
+      # Use gallery style command.
+      useGalleryStyle = CmdParse::Command.new( 'gallery_style', false )
+      useGalleryStyle.short_desc = "Changes the used gallery style"
+      useGalleryStyle.description =
+        CliUtils.format("\nCopies the gallery templates for the gallery style STYLE to the website " +
+                        "directory defined by the global directory option, overwritting existing files. " +
+                        "If the global verbosity level is set to 0 or 1, the copied files are listed.")
+      useGalleryStyle.options = CmdParse::OptionParserWrapper.new do |opts|
+        opts.separator "Available styles:"
+        opts.separator ""
+        Webgen::GalleryStyle.entries.sort.each {|name, entry| CliUtils.dirinfo_output( opts, name, entry ) }
+      end
+      def useGalleryStyle.usage
+        "Usage: #{commandparser.program_name} [global options] use gallery_style STYLE"
+      end
+      useGalleryStyle.set_execution_block do |args|
+        if args.length == 0
+          raise OptionParser::MissingArgument.new( 'STYLE' )
+        else
+          if @force || ask_overwrite
+            files = Webgen::WebSite.use_gallery_style( cmdparser.directory, args[0] )
+            if (0..1) === cmdparser.verbosity
+              puts "The following files were created or overwritten:"
+              puts files.collect {|f| "- " + f }.join("\n")
+            end
+          end
+        end
+      end
+      self.add_command( useGalleryStyle )
+    end
+
+    #######
+    private
+    #######
+
+    def ask_overwrite
+      printf "Existing files may get overwritten, procede (yes/no)? : "
+      $stdin.gets =~ /y|yes/
+    end
+
+  end
+
+
+  class ShowCommand < CmdParse::Command
+
+    def initialize( cmdparser )
+      super( 'show', true )
+      self.short_desc = "Shows various information"
+
+      # Show plugins command
+      showPlugins = CmdParse::Command.new( 'plugins', false )
+      showPlugins.short_desc = "Shows the available plugins"
+      showPlugins.set_execution_block do |args|
+        puts "List of loaded plugins:"
+        headers = Hash.new {|h,k| h[k] = (k.nil? ? "Other Plugins" : k.gsub(/([A-Z][a-z])/, ' \1').strip) }
+
+        header = ''
+        cmdparser.website.manager.plugin_classes.sort {|a, b| a.plugin_name <=> b.plugin_name }.each do |plugin|
+          newHeader = headers[plugin.plugin_name[/^.*?(?=\/)/]]
+          unless newHeader == header
+            puts "\n" + CliUtils.headline( newHeader )
+            header = newHeader
+          end
+          puts CliUtils.section( plugin.plugin_name[/\w+$/], 33 ) + CliUtils.format( plugin.config.infos[:summary], 33 ).join("\n")
+        end
+      end
+      self.add_command( showPlugins )
+
+      # Show config command
+      showConfig = CmdParse::Command.new( 'config', false )
+      showConfig.short_desc = "Shows information like the parameters for all or the matched plugins"
+      showConfig.description =
+        CliUtils.format( "\nIf no argument is provided, all plugins and their information are listed. If " +
+                         "an argument is specified, all plugin names that match the argument are listed." ).join("\n")
+      showConfig.set_execution_block do |args|
+        puts "List of plugin informations:"
+        puts
+
+        cmdparser.website.manager.plugins.sort {|a, b| a[0] <=> b[0] }.each do |name, plugin|
+          next if args.length > 0 && /#{args[0]}/i !~ name
+
+          config = plugin.class.config
+          puts CliUtils.headline( name )
+          ljust = 25
+
+          puts CliUtils.section( 'Summary', ljust ) + CliUtils.format( config.infos[:summary], ljust ).join("\n") if config.infos[:summary]
+          puts CliUtils.section( 'Author', ljust ) + CliUtils.format( config.infos[:author], ljust ).join("\n") if config.infos[:author]
+          puts CliUtils.section( 'Description', ljust ) + CliUtils.format( config.infos[:description], ljust ).join("\n") if config.infos[:description]
+          puts CliUtils.section( 'Tag names', ljust ) + plugin.tags.join(", ") if plugin.respond_to?( :tags )
+          puts CliUtils.section( 'Handles paths', ljust ) + plugin.path_patterns.collect {|r,f| f}.inspect if plugin.respond_to?( :path_patterns )
+          puts CliUtils.section( 'Dependencies', ljust ) + config.dependencies.join(', ') if !config.dependencies.empty?
+
+          if !config.params.empty?
+            puts "\n" + CliUtils.section( 'Parameters' )
+            config.params.sort.each do |name, item|
+              print "\n" + CliUtils.section( 'Parameter', ljust, 6 )
+              puts Color.lred( item.name ) + ": " + Color.lblue( plugin.instance_eval {param( name )}.inspect ) +
+                " (" + item.default.inspect + ")"
+              puts CliUtils.section( 'Description', ljust, 6 ) + CliUtils.format( item.description, ljust ).join("\n")
+            end
+          end
+
+          otherinfos = config.infos.select {|k,v| ![:name, :author, :summary, :description, :tags, :path_patterns].include?( k ) }
+          puts "\n" +CliUtils.section( 'Other Information' ) unless otherinfos.empty?
+          otherinfos.each {|name, value| puts CliUtils.section( name.to_s.tr('_', ' '), ljust, 6 ) + value.inspect }
+
+          puts
+        end
+      end
+      self.add_command( showConfig )
+    end
+
+  end
+
+
+  class CheckCommand < CmdParse::Command
+
+    def initialize( cmdparser )
+      super( 'check', true )
+      self.short_desc = "Checks things like validity of the config file or the availability of optional libraries"
+
+      # Check configuration file command
+      checkConfig = CmdParse::Command.new( 'config', false )
+      checkConfig.short_desc = "Checks the validity of the configuration and outputs the used options"
+      checkConfig.set_execution_block do |args|
+        begin
+          if File.exists?( File.join( cmdparser.directory, 'config.yaml' ) )
+            print CliUtils.section( "Checking configuration file syntax...", 50, 0, :bold )
+            config_file = ConfigurationFile.new( File.join( cmdparser.directory, 'config.yaml' ) )
+            puts Color.green( 'OK' )
+
+            puts CliUtils.section( "Checking parameters...", 0, 0, :bold )
+            config_file.config.each do |plugin_name, params|
+              params.each do |param_name, value|
+                print CliUtils.section( "#{plugin_name}:#{param_name}", 50, 2, :reset )
+                if cmdparser.website.manager.plugin_class_for_name( plugin_name ).nil?
+                  puts Color.lred( 'NOT OK' ) + ': no such plugin'
+                else
+                  begin
+                    cmdparser.website.manager.param_for_plugin( plugin_name, param_name )
+                    puts Color.green( 'OK' )
+                  rescue PluginParamNotFound => e
+                    puts Color.lred( 'NOT OK' ) + ': no such parameter'
+                  end
+                end
+              end
+            end
+          else
+            print CliUtils.section( "No configuration file found!", 50, 0, :bold )
+          end
+        rescue ConfigurationFileInvalid => e
+          puts Color.lred( 'NOT OK' ) + ': ' + e.message
+        end
+      end
+      self.add_command( checkConfig, true )
+
+      # Check optional libraries
+      checkLibs = CmdParse::Command.new( 'libs', false )
+      checkLibs.short_desc = "Checks the availability of optional libraries used by plugins"
+      checkLibs.set_execution_block do |args|
+        puts CliUtils.format( "List of optional libraries (the info line specifies which functionality will be available " +
+                              "if the needed gems are installed):" ).join("\n")
+        puts
+
+        cmdparser.website.manager.plugin_loaders.each do |loader|
+          loader.optional_parts.sort.each do |name, options|
+            puts CliUtils.headline( name )
+            puts CliUtils.section( 'Info', 25 ) + CliUtils.format( options[:info], 25 ).join("\n")
+            puts CliUtils.section( 'Needed gems', 25 ) + options[:needed_gems].join( ', ' )
+            puts CliUtils.section( 'Loaded', 25 ) + ( options[:loaded] ? Color.green( 'yes' ) : Color.lred( 'no' ) )
+            puts CliUtils.section( 'Error message', 25 ) + CliUtils.format( options[:error_msg], 25 ).join("\n") unless options[:loaded]
+            puts
+          end
+        end
+      end
+      self.add_command( checkLibs )
+    end
+
+  end
+
+
+  class CommandParser < CmdParse::CommandParser
+
+    VERBOSITY_UNUSED = -1
+
+    attr_reader :directory
+    attr_reader :website
+    attr_reader :verbosity
+    attr_reader :config_file
+
+    def initialize
+      super( true )
+      @directory = Dir.pwd
+      @verbosity = VERBOSITY_UNUSED
+
+      self.program_name = "webgen"
+      self.program_version = Webgen::VERSION
+      self.options = CmdParse::OptionParserWrapper.new do |opts|
+        opts.separator "Global options:"
+        opts.on( "--directory DIR", "-d", String, "The website directory, if none specified, current directory is used." ) {|@directory|}
+        opts.on( "--verbosity LEVEL", "-V", Integer, "The verbosity level (0-3)" ) {|@verbosity|}
+      end
+
+      # Run command
+      run = CmdParse::Command.new( 'run', false )
+      run.short_desc = "Runs webgen, ie. generates the HTML files"
+      run.description = CliUtils.format("\nWith no arguments, renders the whole site. If file names are " +
+                                        "specified (don't include the path/to/src/ part), only those are rendered." )
+      run.set_execution_block do |args|
+        @website.render( args )
+      end
+      self.add_command( run, true )
+
+      self.add_command( CreateCommand.new )
+      self.add_command( ShowCommand.new( self ) )
+      self.add_command( UseCommand.new( self ) )
+      self.add_command( CmdParse::HelpCommand.new )
+      self.add_command( CmdParse::VersionCommand.new )
+      self.add_command( CheckCommand.new( self ) )
+    end
+
+    def param_for_plugin( plugin_name, param )
+      if [plugin_name, param] == ['Core/Configuration', 'loggerLevel'] && @verbosity != VERBOSITY_UNUSED
+        @verbosity
+      elsif @config_file
+        @config_file.param_for_plugin( plugin_name, param )
+      else
+        Webgen::PluginParamValueNotFound
+      end
+    end
+
+    def parse( argv = ARGV )
+      super do |level, cmd_name|
+        if level == 0
+          @config_file = Webgen::WebSite.load_config_file( @directory )
+          @website = Webgen::WebSite.new( @directory, self )
+          @website.manager.init
+          @website.manager.plugins.
+            each {|name,plugin| self.add_command( plugin ) if plugin.kind_of?( Webgen::CommandPlugin ) }
+        end
+      end
+    end
+
+  end
+
+
+  # Main program for the webgen CLI.
+  def self.cli_main
+    Color.colorify if $stdout.isatty && !Config::CONFIG['arch'].include?( 'mswin32' )
+    cmdparser = CommandParser.new
+    cmdparser.parse
+  end
+
+end