[Rest2web-develop] At Last....

[<mi...@pc...>]

{emo;paper} I've finally managed to spend some time on rest2web__ - and productive time it was too.

I've just checked in the changes to SVN__. Since the last release the following changes have now been made. They're not yet documented because I'm refactoring the documentation substantially.

The changes *include* :

.. contents::

file keyword
------------

You can now specify files to be copied from the source directory to your build directory (the ``file`` keyword in your restindex, which can be used multiple times). Paths are relative to the source file and will always be copied into the same directory as the *target* file.

section-pages
-------------

You can now specify the order that pages appear in the sections and the ``indextree`` data structure. This is the ``section-pages`` keyword. 

It takes a comma separated list as the argument. The first one must be the section followed by a list of pages. You use the filename (minus the '.txt') to specify a page. You don't have to list all the pages - but including a page that doesn't exist will raise an error.

To specify the default section do : ::

    section-pages: ,page1, page2, page3

tags
----

There is a new tags keyword - which takes a comma separated list. Currently this is just put into the namespace. I'm using it for the ``meta keywords`` in my template - but will eventually build a plugin that creates tag clouds for pages.

bugfixes
--------

Over the weekend I found and squashed four bugs. All of these were discovered in the process of making the updates. They were all bugs in obscure places - but nasty enough if they ever bit you. Note that this means that the arguments taken by the ``print_crumbs`` function has changed (it still has sensible defaults though).

* Fixed bug where some restindex options from one section could leak into another.
* Fixed bug where having ``include: No`` for an index page would cause a crash.
* Fixed bug where subsections with a different ``file-extension`` were broken.
* Bugfix (and change) to the ``print_crumbs`` function. It now takes an 'item' value - this means the last item is also a list item.


__prune__
---------

Create a file called ``__prune__`` in a directory and it won't be scanned or included. This messes up auto-built indexes of course, but can be used to stop **rest2web** rebuilding certain parts of your site.


py2exe
------

Hmm.. I didn't actually do much here, but amidst all the changes (including moving to py2exe 0.6.3) - **rest2web** now builds and works using py2exe. The appropriate ``py2exe-setup.py`` is in SVN.



__ /python/rest2web
__ https://svn.rest2web.python-hosting.com