[ANN] rest2web 0.5.0 Final

[Fuzzyman]

At last `rest2web 0.5.0 Final
<http://www.voidspace.org.uk/python/rest2web/>`_ is released.

Quick download links:

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

This release has several bugfixes, as well as some interesting new
features, over previous releases.

Release Summary
=============

Important changes since the last release (0.5.0 Beta 1) include:

* All the standard `macros
<http://voidspace.org.uk/python/rest2web/macros.html>`_ are now
built-in. There is no need for a separate macro file if you are only
using the standard ones.
* A new 'skiperrors' config file / command line option. Errors in
processing a file can now be ignored and rest2web will attempt to
continue processing.
* A config file is no longer required in force mode. (The current
directory is used as the source directory and html output is put into a
subdirectory called 'html'.)
* The restindex and uservalues block may now be in a ReST comment. This
means that rest2web source documents with a restindex can still be
valid ReStructured Text documents.


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

**rest2web** is a tool for creating websites, parts of websites, and
project documentation.

It allows you to keep your site contents in `ReStructured Text
<http://docutils.sourceforge.net>`_ or {acro;HTML;HyperText Markup
Language}.

Using a flexible templating system, using embedded Python code for
unlimited flexibility and no new templating language to learn, it can
then output the HTML for your site.

**rest2web** is extremely flexible, with many optional features, making
it suitable for building all kinds of websites.

See the `main page <http://voidspace.org.uk/python/rest2web/>`_ for
links to some of the sites built with rest2web.


What's New ?
==========

You can find the full changelog: `here
<http://voidspace.org.uk/python/rest2web/reference/changelog.html#version-0-5-0-final-2006-10-11>`_.

Paths in the ``file`` keyword and in the config file now have '~'
expanded. This
means they can use paths relative to the user directory. (Plus the
'colorize' and
'include' macros.)

Added 'skiperrors' config file / command line option. Errors in
processing a file can now be
ignored and rest2web will attempt to continue processing.

Fixed bug where non-ascii uservalues would blow up.

There was a bug in handling tabs in embedded code. This has been fixed.

The macro system has been revamped. All the standard macros are now
built in
as default macros. The modules needed by the default macros are also
now built
into rest2web. You can still add your own macros, or override the
default ones,
by supplying an additional macros file.

``Macro Paths`` section added to the config file for configuring the
default
macros ``smiley`` and ``emoticon``.

The initial message printed by rest2web has been changed to ``INFO``
level, so
that it is not displayed by the ``-a`` and ``-w`` verbosity levels.

The namespace and uservalues for each page are now available to the
macros,
using global variables ``uservalues`` and ``namespace`` (dictionaries).
This
means you can write macros that are customised for individual pages.

A config file is no longer required in force mode. (The current
directory is
used as the source directory and html output is put into a subdirectory
called
'html'.)

The restindex and uservalues block may now be in a ReST comment. This
means
that rest2web source documents with a restindex can still be valid
ReStructured
Text documents.

Fixed imports in the gallery plugin. (Thanks to Steve Bethard.)

Changed over to use the latest version of
`StandOut <http://www.voidspace.org.uk/python/standout.html>`_.

rest2web now exits with an error code corresponding to the number of
warnings and errors generated.

Errors and warnings are now output on ``sys.stderr``.