rest2web-develop

[Rest2web-develop] Test Version of rest2web 0.5.0 alpha

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

{ran_emo} There is now a new test version of `rest2web <http://www.voidspace.org.uk/python/rest2web/>`_ available :

   `rest2web 0.5.0 alpha <http://www.voidspace.org.uk/rest2web-0.5.0alpha.zip>`_

This has lots of new features available, but because of internet problems I haven't been able to update the subversion repository yet. There is still a lot of work to do (including documenting the features), but some of the new ideas need further development and I'm sure there will be bugs to fix.

Most of these features have been added in response to user requests. The main change is that **rest2web** can now build sites *without* needing restindexes, templates or index files. This allows you to generate a site just from a bunch of `ReST <http://docutils.sourceforge.net>`_ files. {sm;:!:}

The new features already added (since 0.4.0 alpha) include :

Can build a site with no index pages, no template and no restindexes.
(The ``force`` option.)

Allow passing of global uservalues at the command line and in the config file.
(Command line uservalues override config file ones.)

A ``--template-file=`` command line option. This overrides the top level ``template`` specified in the restindex and allows you to have different templates for the same site, e.g. for building different online versions and documentation versions.

The ``final_encoding`` should never be ``utf8`` (not recognised by browsers) - should be ``utf-8`` instead. (Now automatically handled.)

Added and documented ``initialheaderlevel``.

``file`` keyword - should only copy if the file has changed (checks timestamp and size, copies timestamp with file).

File keyword was broken if used outside an index file.

Gallery chokes on ``thumb.db`` and animated jpgs. (Now skips all non image files
and any image files it can't handle.)

Deleted ``urlpath`` from rest2web because it is now in pythonutils.

Implement levels of verbosity. These now work. {sm;:oops:}

A global set of uservalues from the config file. Overrideable in individual
pages. (Including ``__encoding__`` special value.)

Fix rendering of uservalues from ReST to HTML. Uservalues in ReST format should now use ``<* ... *>`` and ``<$ ... $>`` in pages instead of ``<% ... %>`` and ``<# ... #>``.

Add uservalues to the namespace.

Added ``modtimeiso``.

Added ``formattime`` standard function.

Made the namespace/uservalues available in the macros.

Made namespace/uservalues values available to the functions. This isn't yet used but will allow for some more interesting standard functions.

Removed the two ``<br />`` from ``listend`` in the standard function ``minibar``.

Added ``wrapper_class`` to ``print_details``.

Added ``os`` and ``sys`` to namespace.

The default crumb for index pages (if no ``page-title`` specified) is the filename,
minus the extension, turned to title case.

--------------

There are still various things to add before 0.5.0 becomes final, but **rest2web** is shaping up well.

You can see which command line options have been added by typing ``r2w.py -h`` at the command line.

Re: [Rest2web-develop] Test Version of rest2web 0.5.0 alpha

[V. <gae...@no...>]

    Hi Michael,

	Sorry for the slow reply, I have been away last week.

    rest2web keeps making me really happy. I want to enhance it by
adding some standard functions we discussed before for file management.
I see that you have made the namespace available to the functions. This
allows me to use the "Processor.target" to achieve my goals. Good !
Something will come out of this, I am just taking my time to be sure of
what I want.

    Recently I have wanted to use the 'colorize' macro to display a file
in the same directory than the rest source file. I have not been able to
point to this file with something else than a absolute path. This seems
to me quite ugly. Is there a way around this ?

--=20
    Ga=EBl

Re: [Rest2web-develop] Test Version of rest2web 0.5.0 alpha

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

Gaël Varoquaux wrote:
>     Hi Michael,
>
> 	Sorry for the slow reply, I have been away last week.
>
>     rest2web keeps making me really happy. I want to enhance it by
> adding some standard functions we discussed before for file management.
> I see that you have made the namespace available to the functions. This
> allows me to use the "Processor.target" to achieve my goals. Good !
> Something will come out of this, I am just taking my time to be sure of
> what I want.
>
>     Recently I have wanted to use the 'colorize' macro to display a file
> in the same directory than the rest source file. I have not been able to
> point to this file with something else than a absolute path. This seems
> to me quite ugly. Is there a way around this ?
>   
What I need to do is add a relative path to the source file (and 
directory) and a relative path to the target source file (and directory) 
in the namespace. You would then be able to use these within macros and 
functions.

This is pretty near the top of the list, as well as being easy to do. :-)

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

Re: [Rest2web-develop] Test Version of rest2web 0.5.0 alpha

[V. <gae...@no...>]

On Tue, Apr 25, 2006 at 11:27:25PM +0100, Michael Foord wrote:
> What I need to do is add a relative path to the source file (and=20
> directory) and a relative path to the target source file (and directory=
)=20
> in the namespace. You would then be able to use these within macros and=
=20
> functions.

    Good, well I need to keep playing with rest2web to find out how I
use it, and how I want to implement macros/functions. Unfortunately I
have little time for that so it isn't moving forward quickly, but I'll
keep you informed.

--=20
    Ga=EBl

Re: [Rest2web-develop] Test Version of rest2web 0.5.0 alpha

[Marc <Ma...@ro...>]

On Sat, 22 Apr 2006 05:03:00 -0700 (PDT) fuz...@vo... wrote:

> {ran_emo} There is now a new test version of `rest2web <http://www.voidspace.org.uk/python/rest2web/>`_ available :
> 
>    `rest2web 0.5.0 alpha <http://www.voidspace.org.uk/rest2web-0.5.0alpha.zip>`_
> 
> This has lots of new features available, but because of internet problems I haven't been able to update the subversion repository yet. There is still a lot of work to do (including documenting the features), but some of the new ideas need further development and I'm sure there will be bugs to fix.
> 
> Most of these features have been added in response to user requests. The main change is that **rest2web** can now build sites without needing restindexes, templates or index files. This allows you to generate a site just from a bunch of `ReST <http://docutils.sourceforge.net>`_ files. {sm;:!:}
> 
> The new features already added (since 0.4.0 alpha) include :
> 
> Can build a site with no index pages, no template and no restindexes.
> (The ``force`` option.)
> 
> Allow passing of global uservalues at the command line and in the config file.
> (Command line uservalues override config file ones.)
> 
> A ``--template-file=`` command line option. This overrides the top level ``template`` specified in the restindex and allows you to have different templates for the same site, e.g. for building different online versions and documentation versions.
> 
> The ``final_encoding`` should never be ``utf8`` (not recognised by browsers) - should be ``utf-8`` instead. (Now automatically handled.)
> 
> Added and documented ``initialheaderlevel``.
> 
> ``file`` keyword - should only copy if the file has changed (checks timestamp and size, copies timestamp with file).
> 
> File keyword was broken if used outside an index file.
> 
> Gallery chokes on ``thumb.db`` and animated jpgs. (Now skips all non image files
> and any image files it can't handle.)
> 
> Deleted ``urlpath`` from rest2web because it is now in pythonutils.
> 
> Implement levels of verbosity. These now work. {sm;:oops:}
> 
> A global set of uservalues from the config file. Overrideable in individual
> pages. (Including ``__encoding__`` special value.)
> 
> Fix rendering of uservalues from ReST to HTML. Uservalues in ReST format should now use ``<* ... *>`` and ``<$ ... $>`` in pages instead of ``<% ... %>`` and ``<# ... #>``.
> 
> Add uservalues to the namespace.
> 
> Added ``modtimeiso``.
> 
> Added ``formattime`` standard function.
> 
> Made the namespace/uservalues available in the macros.
> 
> Made namespace/uservalues values available to the functions. This isn't yet used but will allow for some more interesting standard functions.
> 
> Removed the two ``<br />`` from ``listend`` in the standard function ``minibar``.
> 
> Added ``wrapper_class`` to ``print_details``.
> 
> Added ``os`` and ``sys`` to namespace.
> 
> The default crumb for index pages (if no ``page-title`` specified) is the filename,
> minus the extension, turned to title case.
> 
> --------------
> 
> There are still various things to add before 0.5.0 becomes final, but **rest2web** is shaping up well.
> 
> You can see which command line options have been added by typing ``r2w.py -h`` at the command line.

Hi,

This works as well as version 4 on my site.  So I have no regression to report.

Just FYI,
Marc