Re: [Rest2web-develop] [python] build a file without embedded restindex

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

G. Milde wrote:
> Dear List,
>
> how can I specify the source of a file in the restindex.txt file?
>
> * if the restindex is embedded in a source file there is no need to
>   specify it.
>
> * for a restindex in restindex.txt, where the target already exists,
>   there is no need either.
>
> However, if there is a (restructured) text file I want rest2web to build but
> cannot include a restindex in, I have a problem.
>
>   

Hmmm... interesting usecase - but that is not the purpose of the 
restindex.txt file.

From:
http://www.voidspace.org.uk/python/rest2web/special_files.html#restindex-txt

restindex.txt
If you are only using rest2web to generate part of a website then you 
may want to include in your indexes pages that rest2web isn't building.

The restindex is only (currently) for files that rest2web *isn't* 
building - not an external way of specifying a restindex.

Note that the restindex can be embedded in a page inside a ReST comment 
- that way pages can still remain valid ReST files whilst having a 
restindex. Does that help?

Michael
http://www.manning.com/foord

> I would assume something like
>
>   restindex
>       crumb:  pylit.py
>       source: pylit.py.txt
>       build:  yes
>       target: pylit.py.html
>       file:   pylit.py
>   /restindex
>
> but there is no mention of a "souce" keyword for the restindex.
>
> My current workaround is to manually convert the txt to html with
> docutils and a restindex.txt like::
>
>   restindex
>       crumb: pylit.py
>       target: pylit.py.html
>       file: pylit.py
>       file: pylit.py.txt
>       file: pylit.py.html
>       
>       file: 99bottles.py
>       file: 99bottles.py.txt
>       file: 99bottles.py.html
>       # ... and 24 more files ...
>   /restindex
>       
>
> Background
> ----------
>
> in my rest2web built site ( http://pylit.berlios.de/ ) I have lot of
> examples of "literate python scripts" which are reStructured text with some
> special requiremens to be compatible with the pylit txt<->code converter.
>
> Especially, the first comment is considered to be the file header. See
> http://pylit.berlios.de/tutorial/index.html#file-headers for the rationale.
>   
>   
> Thanks
>
> Günter  
>
>
> -------------------------------------------------------------------------
> SF.Net email is sponsored by:
> Check out the new SourceForge.net Marketplace.
> It's the best place to buy or sell services
> for just about anything Open Source.
> http://ad.doubleclick.net/clk;164216239;13503038;w?http://sf.net/marketplace
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>
>