[Docutils-users] Rest2web - 0.5.0 Beta 1

[Michael F. <fuz...@vo...>]

Hello all,

After five months there is finally a new release of `rest2web 
<http://www.voidspace.org.uk/python/rest2web/>`_. This is **0.5.0 Beta 1**.

There are an awful lot of changes and improvements, but there shouldn't 
be any backward compatibility issues with previous versions.

* `rest2web 0.5.0Beta1 zip 
<http://www.voidspace.org.uk/cgi-bin/voidspace/downman.py?file=rest2web-0.5.0beta1.zip>`_
* `rest2web 0.5.0Beta1 tar.gz 
<http://www.voidspace.org.uk/cgi-bin/voidspace/downman.py?file=rest2web-0.5.0beta1.tar.gz>`_

One of the best changes, is the addition of a new `Quickstart Guide 
<http://www.voidspace.org.uk/python/rest2web/quickstart.html>`_ by 
*Andrew Ittner*.

What is rest2web ?
=============

**rest2web** is a tool that generates html files for websites, parts of 
websites, or project documentation. It allows you to keep your page 
content in `ReST <http://docutils.sourceforge.net>`_ format, and has a 
simple but flexible templating system.

It can automatically build index pages, 'breadcrumbs' and sidebars for 
your site. By providing access to a data-structures that represents your 
site (for example `indextree and thispage 
<http://www.voidspace.org.uk/python/rest2web/reference/indextree.html>`_), 
you can easily build in extra functionality.


What's New in 0.5.0 ?
===============

See the announcement for the full changelog :

    http://www.voidspace.org.uk/python/weblog/arch_d7_2006_08_05.shtml#e413

As you can see a *lot* has changed. I will try to summarise the most 
important changes first :

* Addition of 'Quickstart Guide'
* rest2web can now build a site from just a directory of ReST documents; 
no need tosupply *restindexes* or index pages if you don't want to {sm;:-)}
* Global uservalues (effectively variables available in every page) can 
be set in the `Config File 
<http://www.voidspace.org.uk/python/rest2web/config_file.html>`_ or at 
the command line
* Lots of new `command line options 
<http://www.voidspace.org.uk/python/rest2web/command_line.html>`_ 
available, including setting verbosity levels (make rest2web quieter !)
* New `Standard Functions 
<http://www.voidspace.org.uk/python/rest2web/functions.html>`_, 
especially 'include' for better customisation of templates (e.g. for 
defining a different footer for some directories)
* More information available in the namespace and indextree (source 
filename, target filename, full url etc)

Plus a host of bugfixes and minor improvements.

All the best,

Fuzzyman
http://www.voidspace.org.uk/python/index.shtml