Task library to manage a webgen website.

It is assumed that you have already used the ‘webgen’ command to create the website directory for the site.

Basics

  require 'webgen/webgentask'

  Webgen::WebgenTask.new

Attributes

The attributes available in the new block are:

directory

the root directory of the webgen site (default Dir.pwd)

config

the config block for setting additional configuration options

clobber_outdir

remove webgens output directory on clobber (default false)

Tasks Provided

The tasks provided are :

webgen

render the webgen website

clobber_webgen

remove all the files created during generation

Integrate webgen in other project

To integrate webgen tasks in another project you can use rake namespaces. For example assuming webgen’s site directory is webgen under the main project directory use the following code fragment in project Rakefile:

  require 'webgen/webgentask'

  namespace :dev do
    Webgen::WebgenTask.new do |site|
      site.directory = File.join(Dir.pwd, "webgen")
      site.clobber_outdir = true
      site.config_block = lambda |config|
        config['website.lang'] = 'de'
      end
    end
  end

  task :clobber => ['dev:clobber_webgen']

This will create the following tasks:

• dev:webgen

• dev:clobber_webgen

and add dev:clobber_webgen to the main clobber task.

     # File lib/webgen/webgentask.rb, line 114
114:     def initialize(name = 'webgen')
115:       @name           = name
116:       @directory      = Dir.pwd
117:       @clobber_outdir = false
118:       @config_block   = nil
119: 
120:       yield self if block_given?
121: 
122:       define
123:     end