Asp Forum - [ANN] dokkit 0.4.4 released

Andrea Fazzi

8/10/2008 8:09:00 AM

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.ruby...models/m...[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.ruby...svn/dokkit-c...

4 Usage
=======

dokkit simple
cd simple/
rake

[1] http://dokkit.ruby...models/m...
[2] http://depla...
[3] http://maruku.ruby...
[4] http://rake.ruby...
[5] http://www.ruby-doc.org/stdlib/libdoc...
[6] http://yaml4r.source...
[7] http://dokkit.ruby...
[8] http://groups.google.com/group/do...

comp.lang.ruby

[ANN] dokkit 0.4.4 released

Andrea Fazzi

x Login to ForumsZone