Interested in Participating
Richard Wilbur
richard.wilbur at gmail.com
Fri Oct 6 17:37:00 BST 2006
On Thu, 2006-10-05 at 19:16 -0400, Aaron Bentley wrote:
> Richard Wilbur wrote:
>
> > I tried to make an internal link
> > from the Giving Back page to the anchor on the Installation page so we
> > could suggest they run from the source directory. I can't find
> > documentation that describes a syntax for an internal wiki link that
> > will actually show up as one on the Giving Back page. Maybe the
> > "#format rst" on the first line of the wiki source text for the page is
> > a clue?
>
> I wrote that in ReStructuredText, so we can reuse it for other outputs
> more easily.
>
> Here is the documentation:
> http://moinmoin.wikiwikiweb.de/HelpOnParsers/ReStructuredText
>
> Aaron
Aaron,
I like the format. Thanks for sending me the link.
I have a complaint about how MoinMoin parses the ReStructuredText that I
put in for an internal hyperlink to a different page with an anchor.
The documentation mentions several ways of structuring markup to call
out an internal hyperlink, of which probably the most elegant is the way
you entered it:
Installation_
Since I have need of a punctuation mark ('#') and want to still use the
simple label 'Installation' I found a recommendation on their mailing
list
http://thread.gmane.org/gmane.text.docutils.user/3014/focus=3014
which mentions the following format:
See `Installation <Installation#RunFromSourceDirectory>`_ for details.
When I enter this, MoinMoin creates HTML that says:
See <a class="nonexistent reference" href="/Installation%
23RunFromSourceDirectory">Installation</a> for details.
which looks fine in the Firefox link preview on the status bar at the
base of the window
('http://bazaar-vcs.org/Installation#RunFromSourceDirectory') but when I
select the link, the URL field gets 'http://bazaar-vcs.org/Installation%
23RunFromSourceDirectory' and redirects to a wiki non-existent topic
page.
However, if I manually type
http://bazaar-vcs.org/Installation#RunFromSourceDirectory in the URL
field and hit <enter> the browser behaves as desired taking me to the
RunFromSourceDirectory anchor in the Installation page.
The other side of this story is that if I bite the bullet and use markup
for an external link:
`Installation
<http://bazaar-vcs.org/Installation#RunFromSourceDirectory>`_
the MoinMoin parser leaves the '#' alone and it works as advertised.
The problem here is that it is not an external link and shouldn't need
that qualification--especially for non-HTML translations of this
documentation.
Sorry, that's quite a diatribe. The most frustrating thing is that the
recommendations from the ReStructuredText mailing list and documentation
don't have the desired effect.
I'm off in a few hours for the weekend. Guess I'll pursue this further
next week.
Thanks so much for the help,
Richard
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 191 bytes
Desc: This is a digitally signed message part
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20061006/9e998c20/attachment.pgp
More information about the bazaar
mailing list