From: Andrea Fazzi <andrea.fazzi@...>
Date: 2008-08-10T17:09:09+09:00
Subject: [ANN] dokkit 0.4.4 released

Hi Folks,

dokkit 0.4.4 has been released!


1 Changes from version 0.4.3
============================

  * fixed a bug that prevented to use custom dokkit models; to get
    more information about custom models please refer to
    http://dokkit.rubyforge.org/models/models.html[1]
  * dokkit gem no longer depends on haml; if you want to use haml you
    have to install it
  * an error message is displayed when an output format is associated
    to a formatter that doesn't support it


2 What's dokkit?
================

dokkit is a document generator written in ruby that is suitable for
static websites generation too.

dokkit uses formatters like deplate[2] and maruku[3] to generate
documents in a large variety of output formats.

dokkit's features are:

  * a smart building system based on rake[4]
  * a templating system based on ERB[5]
  * a flexible configuration system based on YAML[6] that supports
    shared configuration files and 'in header' configuration
  * an extensible formatting system that uses deplate and maruku as
    built-in filters
  * convention over configuration: for example, you don't need to give
    the layout name to use if a layout with the same name of the
    processed document is found in doc/layouts folder
  * support for nested layouts
  * support for partials
  * support for caching    

With dokkit you can:

  * generate static websites
  * generate many types of documents in many formats (html, tex, plain
    text, etc.)
  * write your documents using a simple wiki syntax and get high
    quality latex output
  * generate different output formats from the same source document
  * use models to quickly generate the documents you want (static
    websites, reports, howtos, guides, presentations, etc.)
  * simply derive new documentation models from the existing ones
  * simply modify existing models to fit your needs

dokkit aims to be modular and extensible: you can add new formatters and
helpers and easily extend document functionalities.

See dokkit website[7] for further information, documentation and
tutorials.

Please, visit the google group[8] and feel free to send feedback and
suggestions!


3 Download/Installation
=======================

 From rubygems:

    sudo gem install dokkit

To grab the development version:

    svn co http://dokkit.rubyforge.org/svn/dokkit-core/trunk/


4 Usage
=======

    dokkit simple
    cd simple/
    rake

[1] http://dokkit.rubyforge.org/models/models.html
[2] http://deplate.sf.net/
[3] http://maruku.rubyforge.org/
[4] http://rake.rubyforge.org/
[5] http://www.ruby-doc.org/stdlib/libdoc/erb/rdoc/
[6] http://yaml4r.sourceforge.net/
[7] http://dokkit.rubyforge.org/
[8] http://groups.google.com/group/dokkit-forum