From: Chris G <cl...@is...> - 2010-10-30 17:08:19
|
I have some reStructuredText pages which I used to display by converting 'on the fly' to HTML using a small wrapper script and docutils' rst2html. Many of these pages have links to other pages in the same directory which just used xxxxxxxx_ to refer to a page called xxxxxxxx in the same directory. There is no explicit _xxxxxxxx: http://xxx.yyy.zzz/xxxxxxxx line in the referring page. The referred to pages have top-level headings which match the xxxxxxxx and the file names (as noted above) also match. However I'm a little confused as to how this works, there are other things going on in the wrapper script (it creates a menu of pages available at the current level for example) and it could be that it's this which makes these links work. Should it be possible to refer to a separate reStructuredText page with just a xxxxxxxx_ reference? On thinking about it I'm pretty sure the answer is no and that it must be some (fortuitous!) consequence of my wrapper script that's making it work. So, presumably, I'll need to add some _xxxxxxxx: http://xxx.yyy.zzz/xxxxxxxx lines. -- Chris Green |
From: David G. <go...@py...> - 2010-10-30 19:59:17
|
On Sat, Oct 30, 2010 at 12:53, Chris G <cl...@is...> wrote: > Should it be possible to refer to a separate reStructuredText page with > just a xxxxxxxx_ reference? No, I don't think so, but without examples I'm only guessing. If it is working for you, I'd really like to see an example, because (IIUC) what you're describing shouldn't work at all. For the details of the hyperlink mechanism, see http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#hyperlink-references http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#hyperlink-targets An overview here: http://docutils.sourceforge.net/docs/user/rst/quickref.html#hyperlink-targets -- David Goodger <http://python.net/~goodger> |
From: Chris G <cl...@is...> - 2010-10-31 10:55:26
|
On Sat, Oct 30, 2010 at 03:59:10PM -0400, David Goodger wrote: > On Sat, Oct 30, 2010 at 12:53, Chris G <cl...@is...> wrote: > > Should it be possible to refer to a separate reStructuredText page with > > just a xxxxxxxx_ reference? > > No, I don't think so, but without examples I'm only guessing. If it is > working for you, I'd really like to see an example, because (IIUC) > what you're describing shouldn't work at all. > > For the details of the hyperlink mechanism, see > http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#hyperlink-references > http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#hyperlink-targets > > An overview here: > http://docutils.sourceforge.net/docs/user/rst/quickref.html#hyperlink-targets > As I hinted at the end of my question I *think* the reason it works where I was originally doing it is the menu system that the wrapper script adds. Let me clarify a little. The .rst files are in a hierarchy and I use the apache2 ExtFilterDefine and setOutputFilter directives so that .rst files are automatically fed through my wrapper script and rst2html. The wrapper script generates a menu which shows a hierarchical tree of links down through the directory tree to the level of the currently displayed .rst file. It's this which makes my xxxxxxxx_ links work 'automagically' because the menu has the full `xxxxxxxx <xxxxxxx>`_ syntax. It's just so long since I wrote it that I'd forgotten all about the menu generation and was wondering why all the links were broken when I used the .rst files somwehere else without the autmatic menus. -- Chris Green |