rest2web-develop

[Rest2web-develop] Question about 'build' in restindex

[Eur I. C. G. <cl...@is...>]

I need some clarification of what 'build:' in the restindex does.

I can understand that when it's set to 'yes' then the file in which
the 'build: yes' is will be processed (using docutils) to create an
HTML version.  By default, thus, a file abcd.txt will be processed to
create a file abcd.html.

However I'm not clear what happens with 'build: no'.  If the file
abcd.txt has a restindex with 'build: no' does anything happen at all?
In the documentation it says "allows you to specify that a file is not
to be built, but should be included in the index."  So, this
apparently means that the index for the directory where the file
abcd.txt is will have a reference to 'abcd', but we haven't built
abcd.  Is this just so that if I want to include a pre-existing
abcd.html file I can create a corresponding abcd.txt with 'build: no'?

Going on from this I'm trying to understand what restindex.txt does
for me.  I can see that it would be useful to combine (say) the
abcd.txt, defg.txt and hijk.txt files that I would otherwise need to
create to add pre-existing abcd.html, defg.html and hijk.html files to
a rest2web index, is this what restindex.txt is for?  If so how can it
refer to multiple targets?  Does one do it as follows:-

    restindex
        target: abcd.html
    /restindex
    restindex
        target: defg.html
    /restindex
    restindex
        target: hijk.html
    /restindex

-- 
Chris Green

Re: [Rest2web-develop] Question about 'build' in restindex

[Eur I. C. G. <cl...@is...>]

On Fri, Mar 23, 2007 at 10:17:20AM +0000, Eur Ing Chris Green wrote:
[snip]
> Going on from this I'm trying to understand what restindex.txt does
> for me.  I can see that it would be useful to combine (say) the
> abcd.txt, defg.txt and hijk.txt files that I would otherwise need to
> create to add pre-existing abcd.html, defg.html and hijk.html files to
> a rest2web index, is this what restindex.txt is for?  If so how can it
> refer to multiple targets?  Does one do it as follows:-
> 
>     restindex
>         target: abcd.html
>     /restindex
>     restindex
>         target: defg.html
>     /restindex
>     restindex
>         target: hijk.html
>     /restindex
> 
Well I tried it and it works!  :-)

I think a little expnasion of the documentation might help here, it's
note clear (hence my original question) that the above is how to do
it.  It needs a little more of course, e.g. some 'crumb:' entries at
least.

Thinking onwards, what's to prevent allowing the same multiple
restindex entries in the index.txt file?  This would mean that all you
need in directories where all the HTML (and maybe other) files already
exist would be an index.txt file.

-- 
Chris Green

[Rest2web-develop] target: cannot take external values

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

also sprach Eur Ing Chris Green <cl...@is...> [2007.03.23.1139 +0100]:
> >     restindex
> >         target: abcd.html
> >     /restindex
> >     restindex
> >         target: defg.html
> >     /restindex
> >     restindex
> >         target: hijk.html
> >     /restindex
> >=20
> Well I tried it and it works!  :-)
>=20
> I think a little expnasion of the documentation might help here, it's
> note clear (hence my original question) that the above is how to do
> it.  It needs a little more of course, e.g. some 'crumb:' entries at
> least.

On a related note, I cannot do something like

  target: http://external.server.org/path/to/file

rest2web will replace http:// with http:/ and thus make the browser
treat the link as a relative link.

--=20
martin;              (greetings from the heart of the sun.)
  \____ echo mailto: !#^."<*>"|tr "<*> mailto:" net@madduck
=20
spamtraps: mad...@ma...
=20
stupidity management for the superuser
is a user space issue in unix systems.
                                                           -- alan cox

Re: [Rest2web-develop] target: cannot take external values

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

martin f krafft wrote:
> also sprach Eur Ing Chris Green <cl...@is...> [2007.03.23.1139 +0100]:
>   
>>>     restindex
>>>         target: abcd.html
>>>     /restindex
>>>     restindex
>>>         target: defg.html
>>>     /restindex
>>>     restindex
>>>         target: hijk.html
>>>     /restindex
>>>
>>>       
>> Well I tried it and it works!  :-)
>>
>> I think a little expnasion of the documentation might help here, it's
>> note clear (hence my original question) that the above is how to do
>> it.  It needs a little more of course, e.g. some 'crumb:' entries at
>> least.
>>     
>
> On a related note, I cannot do something like
>
>   target: http://external.server.org/path/to/file
>
> rest2web will replace http:// with http:/ and thus make the browser
> treat the link as a relative link.
>   

Sorry for the delayed reply.  That sounds like a bad bug. I'll track it 
down and fix it soon.

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

>   
> ------------------------------------------------------------------------
>
> -------------------------------------------------------------------------
> Take Surveys. Earn Cash. Influence the Future of IT
> Join SourceForge.net's Techsay panel and you'll get the chance to share your
> opinions on IT & business topics through brief surveys-and earn cash
> http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
> ------------------------------------------------------------------------
>
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>   

Re: [Rest2web-develop] target: cannot take external values

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

martin f krafft wrote:
> also sprach Eur Ing Chris Green <cl...@is...> [2007.03.23.1139 +0100]:
>   
>>>     restindex
>>>         target: abcd.html
>>>     /restindex
>>>     restindex
>>>         target: defg.html
>>>     /restindex
>>>     restindex
>>>         target: hijk.html
>>>     /restindex
>>>
>>>       
>> Well I tried it and it works!  :-)
>>
>> I think a little expnasion of the documentation might help here, it's
>> note clear (hence my original question) that the above is how to do
>> it.  It needs a little more of course, e.g. some 'crumb:' entries at
>> least.
>>     
>
> On a related note, I cannot do something like
>
>   target: http://external.server.org/path/to/file
>
> rest2web will replace http:// with http:/ and thus make the browser
> treat the link as a relative link.
>   

Sorry for the delayed reply.  That sounds like a bad bug. I'll track it
down and fix it soon.

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

>   
> ------------------------------------------------------------------------
>
> -------------------------------------------------------------------------
> Take Surveys. Earn Cash. Influence the Future of IT
> Join SourceForge.net's Techsay panel and you'll get the chance to share your
> opinions on IT & business topics through brief surveys-and earn cash
> http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
> ------------------------------------------------------------------------
>
> _______________________________________________
> Rest2web-develop mailing list
> Res...@li...
> https://lists.sourceforge.net/lists/listinfo/rest2web-develop
>   

Re: [Rest2web-develop] Question about 'build' in restindex

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

Eur Ing Chris Green wrote:
> On Fri, Mar 23, 2007 at 10:17:20AM +0000, Eur Ing Chris Green wrote:
> [snip]
>   
>> Going on from this I'm trying to understand what restindex.txt does
>> for me.  I can see that it would be useful to combine (say) the
>> abcd.txt, defg.txt and hijk.txt files that I would otherwise need to
>> create to add pre-existing abcd.html, defg.html and hijk.html files to
>> a rest2web index, is this what restindex.txt is for?  If so how can it
>> refer to multiple targets?  Does one do it as follows:-
>>
>>     restindex
>>         target: abcd.html
>>     /restindex
>>     restindex
>>         target: defg.html
>>     /restindex
>>     restindex
>>         target: hijk.html
>>     /restindex
>>
>>     
> Well I tried it and it works!  :-)
>
> I think a little expnasion of the documentation might help here, it's
> note clear (hence my original question) that the above is how to do
> it.  It needs a little more of course, e.g. some 'crumb:' entries at
> least.
>
> Thinking onwards, what's to prevent allowing the same multiple
> restindex entries in the index.txt file?  This would mean that all you
> need in directories where all the HTML (and maybe other) files already
> exist would be an index.txt file.
>   

Ok - it sounds like their is a need for better documentation here.

I note the request for multiple restindexes in the index page. This is 
not immediately straightforward - but should be possible.

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