rest2web-develop — A discussion list for rest2web development.

Re: [Rest2web-develop] Linking to document by filename

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

Stéfan van der Walt wrote:
> Hi,
>
> Thanks for the feedback!
>
> 2008/9/4 Michael Foord <fuz...@vo...>:
>   
>> The normal syntax is: `other page <otherpage.txt>`_ or `other page
>> <otherpage.html>`_
>>     
>
> I was confusing Sphinx's toctree mode with normal reST links; I now
> see that the syntax I used could never work.  It's a pity there is no
> mechanism to link to documents without using their extensions, though
> (I may want to rename the input from .txt to .rst later, or change the
> output from .html to .xhtml -- but that will break everything).
>
> Another question: is it difficult to add new directives for use with
> rest2web?  I am thinking of adding a "math" and a highlighted "source"
> tag.
>   

I use a rest2web macro for source highlighting. For questions on 
extending restructured text you'll need to ask on the docutils mailing list.

Michael

> Regards
> Stéfan
>
> -------------------------------------------------------------------------
> This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
> Build the coolest Linux based applications with Moblin SDK & win great prizes
> Grand prize is a trip for two to an Open Source event anywhere in the world
> http://moblin-contest.org/redirect.php?banner_id=100&url=/
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>   


-- 
http://www.ironpythoninaction.com/
http://www.voidspace.org.uk/
http://www.trypython.org/
http://www.ironpython.info/
http://www.theotherdelia.co.uk/
http://www.resolverhacks.net/

Re: [Rest2web-develop] Linking to document by filename

[S. v. d. W. <st...@su...>]

Hi,

Thanks for the feedback!

2008/9/4 Michael Foord <fuz...@vo...>:
> The normal syntax is: `other page <otherpage.txt>`_ or `other page
> <otherpage.html>`_

I was confusing Sphinx's toctree mode with normal reST links; I now
see that the syntax I used could never work.  It's a pity there is no
mechanism to link to documents without using their extensions, though
(I may want to rename the input from .txt to .rst later, or change the
output from .html to .xhtml -- but that will break everything).

Another question: is it difficult to add new directives for use with
rest2web?  I am thinking of adding a "math" and a highlighted "source"
tag.

Regards
Stéfan

Re: [Rest2web-develop] Linking to document by filename

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

On  4.09.08, Stéfan van der Walt wrote:
> Hi all,

> I am new to rest2web, and have a question re: hyperlinking, to which I
> could not find an answer on the mailing list archive.

> I would like to link to documents by their filename, i.e. if I have

> index.txt
> otherpage.txt

> then inside index.txt I'd like to write

> "please refer to `other page <otherpage>`_  ".  Is there currently a
> way to do this in rest2web, or would a patch for such functionality be
> considered?

How about::

  please refer to `other page <otherpage.html>`_ 
  
?

Günter  

Re: [Rest2web-develop] Linking to document by filename

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

Stéfan van der Walt wrote:
> Hi all,
>
> I am new to rest2web, and have a question re: hyperlinking, to which I
> could not find an answer on the mailing list archive.
>
> I would like to link to documents by their filename, i.e. if I have
>
> index.txt
> otherpage.txt
>
> then inside index.txt I'd like to write
>
> "please refer to `other page <otherpage>`_  ".  Is there currently a
> way to do this in rest2web, or would a patch for such functionality be
> considered?
>   

Linking is done using reST syntax from docutils: http://docutils.sf.net/

The normal syntax is: `other page <otherpage.txt>`_ or `other page 
<otherpage.html>`_

It's not *really* clear to me what change you are suggesting (if you 
miss off the extension what should actually be linked to?) - but I think 
changes to this would need to be done inside docutils and not inside 
rest2web.

All the best,

Michael
> Regards,
> Stéfan
>
> -------------------------------------------------------------------------
> This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
> Build the coolest Linux based applications with Moblin SDK & win great prizes
> Grand prize is a trip for two to an Open Source event anywhere in the world
> http://moblin-contest.org/redirect.php?banner_id=100&url=/
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>   


-- 
http://www.ironpythoninaction.com/
http://www.voidspace.org.uk/
http://www.trypython.org/
http://www.ironpython.info/
http://www.theotherdelia.co.uk/
http://www.resolverhacks.net/

[Rest2web-develop] Linking to document by filename

[S. v. d. W. <st...@su...>]

Hi all,

I am new to rest2web, and have a question re: hyperlinking, to which I
could not find an answer on the mailing list archive.

I would like to link to documents by their filename, i.e. if I have

index.txt
otherpage.txt

then inside index.txt I'd like to write

"please refer to `other page <otherpage>`_  ".  Is there currently a
way to do this in rest2web, or would a patch for such functionality be
considered?

Regards,
Stéfan

Re: [Rest2web-develop] processing uservalues as a test condition in a template

[Ben <bi...@ma...>]

 
> This code is being executed for a file that doesn't have the variable
> defined - i.e. stage.txt.
>    (snip)
> try:
>    localnavbar


Oh, yes, Michael, it was that simple! Thank you so much. it's perfectly
working now!
Many many many thanks.

 -- Ben

Re: [Rest2web-develop] processing uservalues as a test condition in a template

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

Ben wrote:
> Michael Foord wrote:
>   
>> if localnavbar == 'yes'
>>     
>
> Hi, Michael,
>
> Thank you for your email and have a good Easter holiday!
> I'm afraid I tried this syntax as well, and I get an error since the
> localnavbar doesn't seem to be defined [1].
>
> This is what I've put in 2 rest files header:
>     uservalues
>     localnavbar: yes
>     /uservalues
>
> (to let you know, about 30 other  files don't have this value defined,
> if it matters?)
>
>   
This code is being executed for a file that doesn't have the variable 
defined - i.e. stage.txt.

Is this in your template? If so it will be executed for every file.

You could get round this by putting something like the following 
*before* the code:

try:
    localnavbar
except NameError:
    localnavbar = 'no'

Michael

> and the error is:
>
> Processing indexfile.
> Guessing encoding. We guessed: UTF-8
> Building stage.html
> [err] Traceback (most recent call last):
> [err]   File "/usr/bin/r2w", line 170, in <module>
> [err]     count = main(options, config)
> [err]   File "/usr/bin/r2w", line 103, in main
> [err]     return processor.walk()
> [err]   File
> "/var/lib/python-support/python2.5/rest2web/restprocessor.py", line 468,
> in walk
> [err]     errorcheck = self.execute_safely(self.buildsection)
> [err]   File
> "/var/lib/python-support/python2.5/rest2web/restprocessor.py", line 218,
> in execute_safely
> [err]     val =  function(*args, **keywargs)
> [err]   File
> "/var/lib/python-support/python2.5/rest2web/restprocessor.py", line
> 1463, in buildsection
> [err]     thepage = render_well(temp_file, namespace,
> final_encoding=final_encoding)
> [err]   File
> "/var/lib/python-support/python2.5/rest2web/embedded_code.py", line 89,
> in render_well
> [err]     template = render(template, namespace,
> uservalues,final_encoding=final_encoding)
> [err]   File
> "/var/lib/python-support/python2.5/rest2web/embedded_code.py", line 72,
> in render
> [err]     value = fun(occ, namespace)
> [err]   File
> "/var/lib/python-support/python2.5/rest2web/embedded_code.py", line 142,
> in render_value_exec
> [err]     exec codeobj in namespace
> [err]   File "<string>", line 2, in <module>
> [err] NameError: name 'localnavbar' is not defined
> [err]
>
> (for your information, stage.txt does not have such a localnavbar value)
>
>  -- Ben
>
> [1] yes, I've tried again and I fixed the little typo in your example
> (ocalnavbar -> localnavbar).
>
> -------------------------------------------------------------------------
> This SF.net email is sponsored by: Microsoft
> Defy all challenges. Microsoft(R) Visual Studio 2008.
> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>   

Re: [Rest2web-develop] processing uservalues as a test condition in a template

[Ben <bi...@ma...>]

Michael Foord wrote:
> if localnavbar == 'yes'

Hi, Michael,

Thank you for your email and have a good Easter holiday!
I'm afraid I tried this syntax as well, and I get an error since the
localnavbar doesn't seem to be defined [1].

This is what I've put in 2 rest files header:
    uservalues
    localnavbar: yes
    /uservalues

(to let you know, about 30 other  files don't have this value defined,
if it matters?)

and the error is:

Processing indexfile.
Guessing encoding. We guessed: UTF-8
Building stage.html
[err] Traceback (most recent call last):
[err]   File "/usr/bin/r2w", line 170, in <module>
[err]     count = main(options, config)
[err]   File "/usr/bin/r2w", line 103, in main
[err]     return processor.walk()
[err]   File
"/var/lib/python-support/python2.5/rest2web/restprocessor.py", line 468,
in walk
[err]     errorcheck = self.execute_safely(self.buildsection)
[err]   File
"/var/lib/python-support/python2.5/rest2web/restprocessor.py", line 218,
in execute_safely
[err]     val =  function(*args, **keywargs)
[err]   File
"/var/lib/python-support/python2.5/rest2web/restprocessor.py", line
1463, in buildsection
[err]     thepage = render_well(temp_file, namespace,
final_encoding=final_encoding)
[err]   File
"/var/lib/python-support/python2.5/rest2web/embedded_code.py", line 89,
in render_well
[err]     template = render(template, namespace,
uservalues,final_encoding=final_encoding)
[err]   File
"/var/lib/python-support/python2.5/rest2web/embedded_code.py", line 72,
in render
[err]     value = fun(occ, namespace)
[err]   File
"/var/lib/python-support/python2.5/rest2web/embedded_code.py", line 142,
in render_value_exec
[err]     exec codeobj in namespace
[err]   File "<string>", line 2, in <module>
[err] NameError: name 'localnavbar' is not defined
[err]

(for your information, stage.txt does not have such a localnavbar value)

 -- Ben

[1] yes, I've tried again and I fixed the little typo in your example
(ocalnavbar -> localnavbar).

Re: [Rest2web-develop] processing uservalues as a test condition in a template

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

Hello Ben,

I think the syntax you want is something like:

<#
if ocalnavbar == 'yes':
    print_details(default_section, page_title='', item_wrapper='<div
    class="rightbox"><h2>Articles</h2><ul>%s</ul></div>',
   do_description=False)
else:
    print "<!-- nope -->"
#>

Michael

Ben wrote:
> Hello,
>
> First of all, thank you very much for rest2web, again and again, that's
> a great piece of software for maintaining websites with ReStructuredText!
>
> I'm afraid I've a very very silly question so I apologize in advance for
> such a request, however I'm a bit stuck.
>
> I've discovered that I actually can embedded some code in the
> ReStructured Text file, for instance, this syntax is valid and does what
> it has to do:
>
> --8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<--
>
> My ReST doc
> =============
>
> .. raw:: html
>
>    <# print_details(default_section, page_title='', item_wrapper='<div
> class="rightbox"><h2>Articles</h2><ul>%s</ul></div>',
> do_description=False) #>
>
> Some other stuff
> ----------------------------------
>
> --8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<--
>
>
> However, instead of adding this code in my (numerous!) ReST files and
> mix code and content, I would like to have a specific value for that
> (for instance, a value such as 'localnavbar: yes' in the local pages
> uservalues) and process the condition on the template side.
> And I'm afraid this is a bit too audacious for me, could someone give me
> a hand?
>
> In my template, I tried:
>
> --8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<--
>
> if <% localnavbar %>==yes:
>     print_details(default_section, page_title='', item_wrapper='<div 
>     class="rightbox"><h2>Articles</h2><ul>%s</ul></div>',
>    do_description=False)
> else:
>     print "<!-- nope -->"
> #>
>
> --8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<--
>
> r2w complains a lot about <% localnavbar %> as an invalid syntax. I
> monkey-like tried thispage['localnavbar'] etc. but without success. I
> think I'm clearly missing something from:
> http://www.voidspace.org.uk/python/rest2web/reference/uservalues.html
> but I cand find what!
>
> Any help would be much appreciated.
> Many thanks,
>
>   -- Ben
>
>
>
> -------------------------------------------------------------------------
> This SF.net email is sponsored by: Microsoft
> Defy all challenges. Microsoft(R) Visual Studio 2008.
> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>   

[Rest2web-develop] processing uservalues as a test condition in a template

[Ben <bi...@ma...>]

Hello,

First of all, thank you very much for rest2web, again and again, that's
a great piece of software for maintaining websites with ReStructuredText!

I'm afraid I've a very very silly question so I apologize in advance for
such a request, however I'm a bit stuck.

I've discovered that I actually can embedded some code in the
ReStructured Text file, for instance, this syntax is valid and does what
it has to do:

--8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<--

My ReST doc
=============

.. raw:: html

   <# print_details(default_section, page_title='', item_wrapper='<div
class="rightbox"><h2>Articles</h2><ul>%s</ul></div>',
do_description=False) #>

Some other stuff
----------------------------------

--8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<--


However, instead of adding this code in my (numerous!) ReST files and
mix code and content, I would like to have a specific value for that
(for instance, a value such as 'localnavbar: yes' in the local pages
uservalues) and process the condition on the template side.
And I'm afraid this is a bit too audacious for me, could someone give me
a hand?

In my template, I tried:

--8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<--

if <% localnavbar %>==yes:
    print_details(default_section, page_title='', item_wrapper='<div 
    class="rightbox"><h2>Articles</h2><ul>%s</ul></div>',
   do_description=False)
else:
    print "<!-- nope -->"
#>

--8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<----8<--

r2w complains a lot about <% localnavbar %> as an invalid syntax. I
monkey-like tried thispage['localnavbar'] etc. but without success. I
think I'm clearly missing something from:
http://www.voidspace.org.uk/python/rest2web/reference/uservalues.html
but I cand find what!

Any help would be much appreciated.
Many thanks,

  -- Ben

[Rest2web-develop] [wnpp] The maintained of rest2web is looking for adopters

[WNPP M. <lu...@de...>]

The maintainer of rest2web package in Debian is looking for people willing to adopt the package.

For more information, please read
<http://bugs.debian.org/470751>

(You are receiving this mail because you are subscribed to
rest2web on the Debian Package Tracking System.)

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

[Timo K. <Tim...@ko...>]

On Thu, Dec 20, 2007 at 11:22:57AM +0100, G. Milde wrote:
> Timo Kankare  wrote 2007-12-13 17:55
>  
> > Can you use the include directive? Something like
> > 
> > restindex
> > crumb: pylit.py
> > format: rest
> > target: pylit.py.html
> > /restindex
> > 
> > .. include:: pylit.py.txt
> 
> This should indeed work. However, I would need a "dummy" text file for
> every literate source example, so in the long run I'd prefer one of the
> above rest2web expansions.

Well, yes, extra files are needed...  I don't know if that is a
problem.  I like the possibility to add, move and remove pages without
maintaining central index file.  And with proper naming (like
pylit.py.index.txt) it would be easy to found index information.

Timppa

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

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

G. Milde wrote:
> [snipped and understood...]
>
>  
> Timo Kankare  wrote 2007-12-13 17:55
>  
>   
>> Can you use the include directive? Something like
>>
>> restindex
>> crumb: pylit.py
>> format: rest
>> target: pylit.py.html
>> /restindex
>>
>> .. include:: pylit.py.txt
>>     
>
> This should indeed work. However, I would need a "dummy" text file for
> every literate source example, so in the long run I'd prefer one of the
> above rest2web expansions.
>   

But given that you want to specify an explicit 'source: pylit.py.txt' 
don't you already have that text file?

That aside, patches welcomed... Modifying restindex.txt to allow the 
specifying of a source shouldn't be too hard but I doubt I will have 
time for a while. I have certainly noted the feature request though.

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



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

[Rest2web-develop] build a file without embedded restindex

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

Michael Foord wrote - 2007-12-13 13:59
> G. Milde wrote:
> > Dear List,
> >
> > However, if there is a (restructured) text file I want rest2web to
> > build but cannot include a restindex in, I have a problem.
 
> 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?

Unfortunately not, as the restriction is that this must be the *first*
comment in the rst file :-(

My examples are "literate code" that can be translated between code
format and text format (in both directions!). Not knowing about the
rest2web use of the first comment for a restindex, the PyLit_ converter
has its own special use of the leading comment in a text source file: 

in the text->code conversion a leading header is converted to code --
this means a restindex in the first comment would need to be valid
(Python-, say) code.

Why?

Text2Code.header_handler
~~~~~~~~~~~~~~~~~~~~~~~~

Sometimes code needs to remain on the first line(s) of the document to be
valid. The most common example is the "shebang" line that tells a POSIX
shell how to process an executable file::

  #!/usr/bin/env python
  
In Python, the special comment to indicate the encoding, e.g. 
``# -*- coding: iso-8859-1 -*-``, must occure before any other comment 
or code too.

If we want to keep the line numbers in sync for text and code source, the
reStructured Text markup for these header lines must start at the same line
as the first header line. Therfore, header lines could not be marked as
literal block (this would require the ``::`` and an empty line above the
code_block).

OTOH, a comment may start at the same line as the comment marker and it
includes subsequent indented lines. 

With a header converted to comment in the text source, the advantages

* line numbers are kept
* the "normal" code_block conversion rules (indent/unindent by
  `codeindent` apply
* greater flexibility: you can hide a repeating header in a project
  consisting of many source files.

set off the disadvantages

- it may come as surprise if a part of the file is not "printed",
- one more syntax element to learn for rst newbees to start with pylit,
  (however, starting from the code source, this will be auto-generated)


.. _PyLit: http://pylit.berlios.de/

IMO, there are several ways of reconciling PyLit and rest2web:

1. Lower the restrictions on the `restindex in rst comment`, e.g.:

   a) use the first restindex anywhere in any rst comment
     
      most flexible but maybe slow
   
   b) use a restindex if it starts at the same line as the comment
      indicator, i.e. scan the file for ``^\.\. +restindex`` lines.
     
      faster but more restrictive and not backwards compatible.
   
2. Add a `source` keyword to the restindex syntax to allow building a
   file from the restindex.txt, e.g. ::

      restindex
      source: pylit.py.txt
      build: yes
      target: pylit.py.html
      /restindex


3. (just for completeness) Allow commented restindices with comments
   other than rst, e.g. in a pylit.py.txt file::
   
      ..  #!/usr/bin/env python
        # -*- coding: iso-8859-1 -*-
        # 
        #  restindex
        #  source: pylit.py.txt
        #  build: yes
        #  target: pylit.py.html
        #  /restindex

   (not really feasible, as the comment indicator will vary for different
   source code languages...)


 
Timo Kankare  wrote 2007-12-13 17:55
 
> Can you use the include directive? Something like
> 
> restindex
> crumb: pylit.py
> format: rest
> target: pylit.py.html
> /restindex
> 
> .. include:: pylit.py.txt

This should indeed work. However, I would need a "dummy" text file for
every literate source example, so in the long run I'd prefer one of the
above rest2web expansions.

Thanks

Günter

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

[Timo K. <Tim...@ko...>]

On Thu, Dec 13, 2007 at 02:39:32PM +0100, G. Milde wrote:
> Dear List,
> 
> how can I specify the source of a file in the restindex.txt file?
> 
> 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.

Can you use include directive? Something like 

  restindex
      crumb:  pylit.py
      format: rest
      target: pylit.py.html
  /restindex

  .. include:: pylit.py.txt



Timppa

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

[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  

[Rest2web-develop] Bug#382717: status?

[martin f k. <ma...@de...>]

also sprach Touko Korpela <tko...@ph...> [2007.07.31.2252 +0200]:
> This bug is tagged fixed, maybe it should be closed?

It is kind of fixed but not completely, thus it's not closed. See my
last message to the report on 20 Aug 2006.

--=20
 .''`.   martin f. krafft <ma...@de...>
: :'  :  proud Debian developer, author, administrator, and user
`. `'`   http://people.debian.org/~madduck - http://debiansystem.info
  `-  Debian - when you have better things to do than fixing systems
=20
"micro$oft productivity software"
                              - see reductio ad absurdum, conclusions.

[Rest2web-develop] Bug#382717: status?

[Touko K. <tko...@ph...>]

This bug is tagged fixed, maybe it should be closed?

Re: [Rest2web-develop] All in one

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

Katja Süss wrote:

> Yes. Something like this
> http://plone.org/documentation/tutorial/borg/
> I'm writing course material.
>
Hello Katja,

I'm afraid that rest2web doesn't include a straightforward way of doing 
this.As rest2web sites are made up of ReST documents it is not 
immediately obvious how you could *generally* combine these to create an 
always valid single ReST document.

On the other hand, creating a one off script that combines them all into 
a single document *begfore* running rest2web shouldn't be too hard.

All the best,

Michael Foord
http://www.voidspace.org.uk/python/articles.shtml


> Fuzzyman schrieb:
>
>>Katja Süss wrote:
>>
>>  
>>
>>>Hi *
>>>I would like to have one page with all content for printing.
>>>Is this possible? 
>>> 
>>>
>>>    
>>>
>>With all what content ? The total of everything from the site ?
>>
>>Michael
>>http://www.voidspace.org.uk/python/articles.shtml
>>
>>
>>  
>>
>>>Regards Katja
>>>
>>>-------------------------------------------------------------------------
>>>This SF.net email is sponsored by: Splunk Inc.
>>>Still grepping through log files to find problems?  Stop.
>>>Now Search log events and configuration files using AJAX and a browser.
>>>Download your FREE copy of Splunk now >>  http://get.splunk.com/
>>>_______________________________________________
>>>Rest2web-develop mailing list
>>>Res...@li...
>>>https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>>>
>>> 
>>>
>>>    
>>>
>>
>>
>>-------------------------------------------------------------------------
>>This SF.net email is sponsored by: Splunk Inc.
>>Still grepping through log files to find problems?  Stop.
>>Now Search log events and configuration files using AJAX and a browser.
>>Download your FREE copy of Splunk now >>  http://get.splunk.com/
>>_______________________________________________
>>Rest2web-develop mailing list
>>Res...@li...
>>https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>>
>>  
>>
>
>------------------------------------------------------------------------
>
>-------------------------------------------------------------------------
>This SF.net email is sponsored by: Splunk Inc.
>Still grepping through log files to find problems?  Stop.
>Now Search log events and configuration files using AJAX and a browser.
>Download your FREE copy of Splunk now >>  http://get.splunk.com/
>
>------------------------------------------------------------------------
>
>_______________________________________________
>Rest2web-develop mailing list
>Res...@li...
>https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>  
>

Re: [Rest2web-develop] All in one

[<ks...@gm...>]

Yes. Something like this
http://plone.org/documentation/tutorial/borg/
I'm writing course material.

Fuzzyman schrieb:
> Katja Süss wrote:
>
>   
>> Hi *
>> I would like to have one page with all content for printing.
>> Is this possible? 
>>  
>>
>>     
> With all what content ? The total of everything from the site ?
>
> Michael
> http://www.voidspace.org.uk/python/articles.shtml
>
>
>   
>> Regards Katja
>>
>> -------------------------------------------------------------------------
>> This SF.net email is sponsored by: Splunk Inc.
>> Still grepping through log files to find problems?  Stop.
>> Now Search log events and configuration files using AJAX and a browser.
>> Download your FREE copy of Splunk now >>  http://get.splunk.com/
>> _______________________________________________
>> Rest2web-develop mailing list
>> Res...@li...
>> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>>
>>  
>>
>>     
>
>
> -------------------------------------------------------------------------
> This SF.net email is sponsored by: Splunk Inc.
> Still grepping through log files to find problems?  Stop.
> Now Search log events and configuration files using AJAX and a browser.
> Download your FREE copy of Splunk now >>  http://get.splunk.com/
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>
>   

Re: [Rest2web-develop] All in one

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

Katja Süss wrote:

>Hi *
>I would like to have one page with all content for printing.
>Is this possible? 
>  
>
With all what content ? The total of everything from the site ?

Michael
http://www.voidspace.org.uk/python/articles.shtml


>Regards Katja
>
>-------------------------------------------------------------------------
>This SF.net email is sponsored by: Splunk Inc.
>Still grepping through log files to find problems?  Stop.
>Now Search log events and configuration files using AJAX and a browser.
>Download your FREE copy of Splunk now >>  http://get.splunk.com/
>_______________________________________________
>Rest2web-develop mailing list
>Res...@li...
>https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>
>  
>

[Rest2web-develop] All in one

[<ks...@gm...>]

Hi *
I would like to have one page with all content for printing.
Is this possible? 
Regards Katja

[Rest2web-develop] rest2web 0.5.2~alpha+svn-r248-1 MIGRATED to testing

[Debian t. w. <no...@he...>]

FYI: The status of the rest2web source package
in Debian's testing distribution has changed.

  Previous version: 0.5.0.svn-r227-1
  Current version:  0.5.2~alpha+svn-r248-1

-- 
This email is automatically generated; he...@ma... is responsible.
See http://people.debian.org/~henning/trille/ for more information.

[Rest2web-develop] Accepted rest2web 0.5.2~alpha+svn-r248-1 (source all)

[<ma...@de...>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.7
Date: Tue, 10 Jul 2007 14:19:58 +0200
Source: rest2web
Binary: rest2web rest2web-doc
Architecture: source all
Version: 0.5.2~alpha+svn-r248-1
Distribution: unstable
Urgency: low
Maintainer: martin f. krafft <ma...@de...>
Changed-By: martin f. krafft <ma...@de...>
Description: 
 rest2web   - web site builder using ReStructured Text as basic content format
 rest2web-doc - documentation for rest2web
Closes: 399359
Changes: 
 rest2web (0.5.2~alpha+svn-r248-1) unstable; urgency=low
 .
   * New upstream commit
     - fixes odict and pathutils compatibility with Python 2.5 (closes: #399359).
Files: 
 391e8fe834fb82dbc32c4004eaa9000e 777 web extra rest2web_0.5.2~alpha+svn-r248-1.dsc
 a228f8251c12fc6342c6c34335dcebe9 2582853 web extra rest2web_0.5.2~alpha+svn-r248.orig.tar.gz
 857501c902ee25e8ea46305726a77a67 7245 web extra rest2web_0.5.2~alpha+svn-r248-1.diff.gz
 3f56d375777db7c172105db9206a889f 132694 web extra rest2web_0.5.2~alpha+svn-r248-1_all.deb
 ebfb854e03f01e2ce0c49b244cddcdac 2662710 doc extra rest2web-doc_0.5.2~alpha+svn-r248-1_all.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFGk3w8IgvIgzMMSnURAri4AKCl+Um9E8S27wdkixOuA3w5MPvVFgCeMmtJ
dnUC/WYqRkqo/pe1QAK7FaI=
=QHPv
-----END PGP SIGNATURE-----


Accepted:
rest2web-doc_0.5.2~alpha+svn-r248-1_all.deb
  to pool/main/r/rest2web/rest2web-doc_0.5.2~alpha+svn-r248-1_all.deb
rest2web_0.5.2~alpha+svn-r248-1.diff.gz
  to pool/main/r/rest2web/rest2web_0.5.2~alpha+svn-r248-1.diff.gz
rest2web_0.5.2~alpha+svn-r248-1.dsc
  to pool/main/r/rest2web/rest2web_0.5.2~alpha+svn-r248-1.dsc
rest2web_0.5.2~alpha+svn-r248-1_all.deb
  to pool/main/r/rest2web/rest2web_0.5.2~alpha+svn-r248-1_all.deb
rest2web_0.5.2~alpha+svn-r248.orig.tar.gz
  to pool/main/r/rest2web/rest2web_0.5.2~alpha+svn-r248.orig.tar.gz