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``.