rest2web-develop

[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] 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/

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

[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

[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