[Rest2web-develop] build a file without embedded restindex

[G. M. <mi...@us...>]

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.

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