This documentation is for the repository version of webgen and therefore may state features that are not available in the latest released version.
-
The documentation for the latest released 0.5.x version can be found here. This documentation can also be generated locally by running
rake htmldoc
in the root directory of the weben distribution. -
If you are looking for the documentation of the 0.4.x series, it can be found here.
If you don’t find an answer to your questions in the documentation, there are also:
- forums hosted on Rubyforge
- mailing lists hosted on Rubyforge (the
webgen-users
mailing list is mirrored to the webgen-users google group) - the IRC channel
#webgen
on Freenode where I can be found whenever I’m online.
User Documentation
Depending on whether you are new to webgen, you want more information about a specific topic or read a reference, go to one of the following pages:
-
Getting Started Guide: If you are new to webgen, this should be your first read. It explains the usage of the CLI command and how to create your first website with webgen.
-
Manual: Detailed information about how webgen works can be found here. After reading the Getting Started Guide, this should be the next read. Have a look at the section headers to get a quick overview of what can be found here.
-
FAQ: If you want to do something with webgen, but you don’t know how, this page is exactly for you. It provides answers to frequently asked questions and HowTos. If you have a question which you think should be added, just mail me.
-
Upgrade information: This document provides some information on upgrading a website from the 0.4.x to the 0.5.x series.
Following is a list of all the reference documentation of webgen:
-
Extensions Documentation: Detailed information on every usage related extension class (source handlers, tags, content processors, …)
-
Webgen Page Format: Information about/Specification of the format used, for example, by page and template files
-
Meta Information Reference: Descriptions for every meta information key that is used by webgen.
-
Configuration Options Reference: Overview of all configuration options.
-
Website Styles Reference: Previews of all website styles that ship with webgen.
Developer Documentation
webgen makes it easy to extend its functionality by writing simple extension classes. All information about how to do this is provided in the API documentation. You will also find examples for all existing extension types there.