RubyGems - webgen - Versions diffs - 0.3.8 → 0.4.0 - Mend

webgen 0.3.8 → 0.4.0

Files changed (618) hide show

@@ -1,56 +1,109 @@
+--- content, html
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="{lang:}">
   <head>
-    <title>webgen - static website generator - {title: }</title>
-    <link href="{resource: webgen-css}" rel="stylesheet" />
-    <link href="{relocatable: default.css}" rel="stylesheet" />
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>webgen - {title:}</title>
+    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
+    <meta name="description" content="webgen is used for generating static websites." />
     <meta name="Keywords" content="webgen, static web site generator, ruby, HTML, dynamic tags, plugin based, static web, web generator, site generator" />
+    <meta name="author" content="Thomas Leitner / Original design by Andreas Viklund - http://andreasviklund.com" />
+    <link rel="stylesheet" href="{relocatable: default.css}" type="text/css" media="screen" />
+    <link rel="stylesheet" href="{resource: {name: webgen-css, insert: :path}}" type="text/css" media="screen" />
   </head>
   <body>
-    <div id="all">
-      <div id="header">
-        <table>
-          <tr>
-            <td><img src="{resource: webgen-logo}" alt="Logo" title="Logo" /></td>
-            <td><h1>webgen<span style="font-size: 60%"> - template based static website generator</span></h1>
-            <p>The solution for your static website generation needs!</p></td>
-          </tr>
-        </table>
+    <div id="container">
+      <div id="sitename">
+        <a href="http://webgen.rubyforge.org">
+          <img src="{resource: webgen-logo}" alt="webgen logo" style="margin-top: 20px; padding-right: 10px; float: left"/>
+        </a>
+        <h1>webgen / static website generator</h1>
+        <h2>static website generation made easy!</h2>
       </div>
-      <div id="headerbar" class="bar">
-        <span class="left">Location: {breadcrumbTrail: }</span>
-        <span class="right">Language: {langbar: }</span>
-        <span class="right">Feedback: {wikilink: {rootURL: http://webgen.rubyforge.org/wiki/wiki.pl?, title: Click here}}</span>
-        <span class="right">{source: }</span>
-        <div style="clear:both"></div>
+      <div id="mainmenu">
+        {menu: {menuStyle: vertical, options: {startLevel: 1, maxLevels: 1}}}
       </div>
-      <div id="menu">Menu: {menu: {menuStyle: vertical-dropdown, options: {divClass: vert-dd-menu}}}</div>
-      <div id="quickmenu">Directory quick menu: {menu: {menuStyle: partial, options: {divClass: partial-menu}}}</div>
+      <div id="wrap">
-      <div id="body">
-        {content: }
-      </div>
+        <div id="leftside">
+          <% if node.level > 1 %>
+          <h1>Sub Menu</h1>
+          {menu: {menuStyle: vertical, options: {startLevel: 2, maxLevels: 3}}}
+          <% end %>
+          <% if node.node_info[:pagedata].blocks.has_key?( 'sidebar' ) %>
+            {block: sidebar}
+          <% end %>
+          <h1>Tips</h1>
+          <ul class="list">
+            <li>The <a href="{relocatable: /documentation/gettingstarted.en.page}">Getting Started</a> page contains everything one needs to get going with webgen!</li>
+            <li>Descriptions for plugins can be found in the <a href="{relocatable:documentation/plugins}">plugins  section</a></li>
+          </ul>
+        </div>
+        <div id="rightside">
+          <h1>Latest news</h1>
+          <p><strong>2007-01-05: </strong>
+            webgen 0.4.0 released! Major update to the core and plugins and many new features added!
+            <a href="{relocatable: news.en.page#news-2007-01-05}">More...</a>
+          </p>
+          <h1>Links</h1>
+          <ul class="linklist">
+            <li><a href="http://rubyforge.org/projects/webgen">webgen on Rubyforge</a></li>
+            <li><a href="http://rubyforge.org/frs/?group_id=296">webgen downloads</a></li>
+            <li><a href="{relocatable: api.html}">webgen API</a></li>
+            <li><a href="http://rubyinstaller.rubyforge.org/wiki/wiki.pl">Ruby Windows Installer</a></li>
+            <li><a href="http://www.ruby-lang.org">Ruby Homepage</a></li>
+          </ul>
+          <div class="center"><a href="http://webgen.rubyforge.org"><img src="{resource: webgen-generated}" alt="Generated by webgen"/></a></div>
+          <form action="https://www.paypal.com/cgi-bin/webscr" method="post"><div class="center" style="margin-top: 15px">
+            <input type="hidden" name="cmd" value="_s-xclick" />
+            <input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but04.gif" style="border:0px" name="submit" alt="Donate with PayPal!" />
+            <img alt="" style="border:0px" src="https://www.paypal.com/de_DE/i/scr/pixel.gif" width="1" height="1" />
+            <input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----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-----END PKCS7-----
+" />
+          </div></form>
+        </div>
+        <div id="navbar" class="content">
+          <span class="leftbox">Location: {breadcrumbTrail: } </span>
+          <span class="rightbox">Language: {langbar: }</span>
+          <span class="rightbox">Feedback: {wikilink: {rootURL: http://webgen.rubyforge.org/wiki/wiki.pl?, linkText: Click here}}</span>
+          <div style="clear: both">&nbsp;</div>
+        </div>
+        <div id="content" class="content">
+          <% if !node.node_info[:pagesections].empty? %>
+          <div id="inpage-menu">
+            <p style="text-align: center"><b>Page Menu</b></p>
+            {menu: {menuStyle: section}}
+          </div>
+          <% end %>
+          {block: content}
+        </div>
+        <div class="clearingdiv">&nbsp;</div>
-      <div id="footer" class="bar">
-        <a href="http://validator.w3.org/check?uri=referer"><img src="{resource: w3c-valid-xhtml11}" alt="Valid XHTML 1.1!" height="31" width="88" /></a>
-        <a href="http://jigsaw.w3.org/css-validator/check/referer"><img src="{resource: w3c-valid-css}" alt="Valid CSS!" height="31" width="88" /></a>
-        <a href="http://webgen.rubyforge.org"><img src="{resource: webgen-generated}" alt="Generated by webgen" height="31" width="88"/></a> on <b>{date: }</b>
       </div>
     </div>
-<!-- Start of StatCounter Code -->
-<script type="text/javascript">
-var sc_project=648325;
-var sc_partition=5;
-var sc_security="7d00de1e";
-var sc_invisible=1;
-</script>
-<script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script><noscript><div class="statcounter"><a class="statcounter" href="http://www.statcounter.com/"><img class="statcounter" src="http://c6.statcounter.com/counter.php?sc_project=648325&amp;java=0&amp;security=7d00de1e&amp;invisible=1" alt="free geoip" /></a></div></noscript>
-<!-- End of StatCounter Code -->
+    <div id="footer">&copy; 2006 Thomas Leitner | generated by <a href="http://webgen.rubyforge.org">webgen</a> | Design by <a href="http://andreasviklund.com">Andreas Viklund</a> / adapted by Thomas Leitner</div>
+    <!-- Start of StatCounter Code -->
+    <script type="text/javascript">
+      var sc_project=648325;
+      var sc_partition=5;
+      var sc_security="7d00de1e";
+      var sc_invisible=1;
+    </script>
+    <script type="text/javascript" src="http://www.statcounter.com/counter/counter_xhtml.js"></script><noscript><div class="statcounter"><a class="statcounter" href="http://www.statcounter.com/"><img class="statcounter" src="http://c6.statcounter.com/counter.php?sc_project=648325&amp;java=0&amp;security=7d00de1e&amp;invisible=1" alt="free geoip" /></a></div></noscript>
+    <!-- End of StatCounter Code -->
   </body>
 </html>

data/doc/src/documentation/extending_webgen.page CHANGED

@@ -1,7 +1,6 @@
 ---
 title: Extending webgen
 inMenu: true
-orderInfo: 21
 ---
 h2. Extending webgen
@@ -22,7 +21,7 @@ a string.
 h3. Normal plugins (new tags, file handlers, etc)
 As webgen is plugin-based, it can be extended very easily. A simple example is shown in the
-<a href="{relocatable: gettingstarted.page#simple-plugin}">Getting Started</a> guide.
+<a href="{relocatable: gettingstarted.page#website-plugin}">Getting Started</a> guide.
 If you want more sophisticated examples of plugins, have a look at webgen itself and the plugins
 that get shipped with it. They can be found in the directory @lib/webgen/plugins/@!

data/doc/src/documentation/gettingstarted.page CHANGED

@@ -1,53 +1,167 @@
 ---
 title: Getting Started
 inMenu: true
-orderInfo: 10
 ---
-h1. Getting Started with webgen
+h1(#basics). Basics
-h2. The Needed Directories
-webgen utilizes the following directories. These directories are in the direcctory in which the
-webgen command is issued.
+h2(#directories). The Needed Directories
-* @src@: The source directory in which all the source files for the website are.
+webgen needs a special directory structure so that it can work correctly. Basically, you have a
+website directory under which the following directories have to be:
+* @src@: The source directory in which all the source files for the website are. The name of this
+  directory cannot be changed!
 * @output@: This directory is created, if it does not exist, when webgen is run. All the output
-            files are put into this directory
+  files are put into this directory. The name of this directory and its location can be customized
+  using the parameter {param: Core/Configuration:outDir}.
+* @plugin@: The extension directory. You can put self-written plugins into this directory so that
+  they can be used by webgen. All <notextile><tt>*.rb</tt></notextile> files in this directory and
+  its subdirectories are loaded as plugins. The name of this directory can't be customized, too!
-* @log@: If the logging mechanism is configured to write the log messages to files, this is the
-         directory where the log files will be. It will be created if it does not exist.
+The directory in which these directories are in is called the *website directory*.
-* @plugin@: The extension directory. You can put self-written plugins into this directory so that
-            they can be used by webgen. All <tt>*.rb</tt> files in this directory and its
-            subdirectories are loaded as plugins.
-h2. Create basic website structure
+h2(#cmdline). The @webgen@ Command
-And now, let's make a website!
+The executable for webgen is called... webgen ;-) It uses a command style syntax (like Subversion's
+@svn@ or Rubygem's @gem@ commands) through the "cmdparse":http://cmdparse.rubyforge.org library. To
+get an overview of the possible commands run
+<pre>
+  $ webgen help
+</pre>
-First, you need to create the basic directories. You can let webgen do this:
+This will output something like this:
 <pre>
-~ > webgen create sample_site
+Usage: webgen [options] COMMAND [options] [COMMAND [options] ...] [args]
+Available commands:
+  check          Checks things like validity of the config file or the availability of optional libraries
+    config         Checks the validity of the configuration and outputs the used options (=default command)
+    libs           Checks the availability of optional libraries used by plugins
+  create         Creates the basic directories and files for webgen.
+  help           Provide help for individual commands
+  run            Runs webgen, ie. generates the HTML files (=default command)
+  show           Shows various information
+    config         Shows information like the parameters for all or the matched plugins
+    plugins        Shows the available plugins
+  use            Changes the used website or gallery styles
+    gallery_style  Changes the used gallery style
+    website_style  Changes the used website style
+  version        Show the version of the program
+Global options:
+    -d, --directory DIR              The website directory, if none specified, current directory is used.
+    -V, --verbosity LEVEL            The verbosity level (0-3)
+    -h, --help                       Show help
+    -v, --version                    Show the version of the program
+</pre>
+As you can see, webgen supports many commands, from checking the validity of the configuration and
+the available libraries to displaying the configuration values. However, the main command is the
+@run@ command which does the actual website generation. This command uses the current working
+directory as website directory if none was specified via the @-d@ option.
+For more information on how the commands work have a look at the
+"cmdparse":http://cmdparse.rubyforge.org documentation!
+h2(#config). Configuration
+webgen provides a default configuration out of the box. If you can live with that, you do not need
+to write any configuration files. Because most people cannot, you can use your own configuration
+file. The configuration file has to be written in YAML and is called @config.yaml@. webgen assumes
+it to be in the website directory.
+Each plugin can specify parameters which can be configured through the configuration file. You can
+display a list of all available parameters by running
+<pre>
+  $ webgen show config
+</pre>
+(This information is also provided on this website, have a look at the
+<a href="{relocatable: plugins}">plugins section</a>!)
+The list shows sorted by the plugin name the current values and the default values for each
+parameter. Each parameter can be overridden in the configuration file by specifing the plugin name
+as top level key and each parameter and value as a key/value pair. Therefore a configuration file
+looks like this (this is the one for the webgen homepage):
+<pre class="webgen-file">{includeFile: ../../config.yaml}</pre>
+There is a special key for file handler plugins: @defaultMetaInfo@. It's value should be a hash with
+the default meta information for nodes created by the plugin. The value is used to update the
+correct part of the {param: Core/FileHandler:defaultMetaInfo} parameter *if and only if* no value
+for the {param: Core/FileHandler:defaultMetaInfo} parameter has been set in the configuration file!
+h1(#website-creation). Website Creation Tutorial
+This short tutorial shows you how to create a website with webgen.
+h2(#website-structure). Creating the Basic Directories
+First, you need to create the basic directories. You can either do this by hand or you can let
+webgen do this:
+<pre>
+  $ webgen create sample_site
 </pre>
 webgen created the @sample_site@ directory which holds all directories necessary for running webgen.
-So you can run webgen to create your website. Just change into the @sample_site@ directory and run
-webgen
+The @create@ command also accepts two options: one for a website template and one for a website
+style:
+* A *website template* defines a structure for your website. For example, the @project@ template
+  defines several pages including a features and about page.
+* A *website style* defines the look and feel of your website. webgen comes with some predefined
+  styles which you can use (most of them are converted open source web design styles).
+You can change the website style later by using the @use website_style@ command for @webgen@, for
+example:
 <pre>
-~ > cd sample_site
-~/sample_site > webgen
+  $ webgen use website_style default
 </pre>
+Existing files may be overwritten be this command (after asking). However, this command is not able
+to delete previously copied website style files, so you have to remove them yourself!
+Have a look at the <a href="{relocatable: /examples}">examples</a> sections to see demonstrations
+for all shipped website templates and styles!
+Now you can run webgen to create your website. There are two possibilities:
+* Either change into the @sample_site@ directory and run webgen there, like this
+  <pre>
+  $ cd sample_site
+  sample_site $ webgen
+  </pre>
+* Or you can run webgen like this
+  <pre>
+  $ webgen -d sample_site
+  </pre>
 Easy! webgen has parsed the @src@ directory and has created the HTML output. However, as we did not
 write any content yet, there is not much to see (only the default page). So let's do that now!
-h2. Add Content to the Website
+h2(#website-content). Adding Content to the Website
 When using the @create@ command, webgen does not only create the needed directories but it also
-provides you with some default files:
+provides you with some default files, you should have at least the following ones:
 * @src/default.template@: The default template for the new website.
 * @src/default.css@: The default css file for the new website.
@@ -65,24 +179,23 @@ inMenu: true
 This is a sample page with the title "{title:}" and it is in the menu!!!
 </pre>
-After that, run webgen in the @sample_site@ directory and then open @output/index.html@ to view your
-website.
+After that, run webgen and then open @output/index.html@ to view your website.
+Then just add page files and other content to your website and let it grow!
-Just add page files and other content to your website and let it grow!
+h2(#website-metainfo). Using Tags and Meta Information in Pages
-h2. Using Meta Information in Pages
 Meta information is specified at the beginning of a page file. Have a look at the
-<a href="{relocatable: plugins/filehandlers/page.page}">documentation</a> to see how that is done
-in detail!
+<a href="{relocatable: /documentation/references/webpage_format.page}">WebPage Format reference</a>
+to see how that is done in detail!
 We are now going to use meta information to customize our website! Open the file @default.template@
 and add this before the &lt;/body&gt; tag:
 <pre>
-  <div class="bar">
-    File last changed on \{filemdate: }!
-  </div>
+  File last changed on \{filemdate: }!
 </pre>
 The part @\{filemdate: }@ is called a tag. Tags are implemented using plugins and they can be used to
@@ -112,7 +225,9 @@ Run webgen and view the output! The tag @\{filemdate: }@ got substituted by the
 the meta information. As we have not put any meta information in the @index.page@ file, a warning is
 issued when webgen is run and no date is shown on the page!
-h2(#simple-plugin). Write a Simple Plugin
+h2(#website-plugin). Writing a Simple Plugin
 Because we are not quite happy with our basic file modification time tag, we are going to write a
 simple tag plugin.
@@ -120,21 +235,15 @@ simple tag plugin.
 Create the file @plugin/filemdate.rb@ with the following content:
 <pre>
-require 'webgen/plugins/tags/tags'
-module Tags
+class FileMDateTag < Tags::DefaultTag
-  class FileMDateTag < DefaultTag
+  infos( :name => 'Custom/FileMDate',
+         :summary => "Puts the modification time of the file on the page" )
-    summary "Puts the modification time of the file on the page"
-    depends_on 'Tags'
-    tag 'filemdate'
-    def process_tag( tag, node, refNode )
-      return File.mtime( node.recursive_value( 'src' ) ).to_s
-    end
+  register_tag 'filemdate'
+  def process_tag( tag, chain )
+    return File.mtime( chain.last.node_info[:src] ).to_s
   end
 end
@@ -145,3 +254,11 @@ encountered. We can now safely remove the @filemdate@ meta info from the file @h
 you can leave it there - it won't do any harm.
 Again, just run webgen and view the output!
+h2(#website-conclusio). Conclusion
+You have just created a simple static website using webgen. For further information on how to
+procede from here have a look at the <a href="{relocatable: plugins}">plugins section</a> and the
+other documentation.

data/doc/src/documentation/index.page CHANGED

@@ -3,22 +3,32 @@ directoryName: Documentation
 ---
 h2. Information
 p={font-size: 150%; color: red}. *!!! This documentation is for webgen {version: } !!!*
-The source files for this website are in the @doc/src@ directory of the webgen package. Have a look
-at them to see a real world example on how to use webgen!
+The source files for this website are in the @doc/src@ directory of the webgen distribution. Have a
+look at them to see a real world example on how to use webgen!
+h2. Spelling of the name "webgen"
+I often see that the name of the program is misspelled: WebGen, Webgen, WEBGEN, ... It is just
+*webgen*, all lower case!
 h2. Philosophy
 There are some things about webgen which I think are important to mention. It's about how webgen
 works and what you can expect when you start webgen.
 * <b>webgen runs till the end and does not stop on errors!</b>
   I did not like it when webgen stopped because there was an error in the configuration file or an
-  error in a page description file. So if something exceptional happens it is logged so that the
-  user can see what happened and a useful default alternative is used instead. For example, if no
-  default template was found in the source directory, a dummy template is used instead.
+  error in a page file. So if something exceptional happens it is logged so that the user can see
+  what happened and a useful default alternative is used instead. For example, if no default
+  template was found in the source directory, a dummy template is used instead.
   Therefore it is also not necessary to install the dependencies (although you would be wise to do
   it, so that you can use all the features of webgen). If a dependency is not found (e.g. RedCloth
@@ -35,26 +45,3 @@ works and what you can expect when you start webgen.
   informational and debug messages. For the normal user, the error and warning messages are
   important. Developers who extend webgen by writing a new plugin can use the informational and
   debug messages to see what is going on and to help them develop the plugin.
-h2. Configuration
-webgen provides a default configuration out of the box. If you can live with that, you do not need
-to write any configuration files. Because most people cannot, you can use your own configuration
-file. The configuration file has to be written in YAML and is called @config.yaml@. webgen searches
-in the current directory for the configuration file.
-If you want to get the configuration values you can run webgen like this
-<pre>
-  $ webgen show config
-</pre>
-(This information is also provided on this website, have a look at the
-<a href="{relocatable: plugins}">plugins section</a>!)
-The list shows sorted by the plugin name the current values and the default values for each
-parameter. Each parameter can be overridden in the configuration file by specifing the
-plugin name as top level key and each parameter and value as a key/value pair. A configuration file
-looks like this:
-<pre class="webgen-file">{includeFile: ../../config.yaml}</pre>