sandbox/simonb/inline_target.txt

   1 .. Note:: This functionality has been implemented as `embedded URIs
   2    <http://docutils.sf.net/spec/rst/reStructuredText.html#embedded-uris>`_.
   3
   4
   5 Sample usage of inline targets
   6 ------------------------------
   7
   8 Here is some sample text, that tests an syntax for inline targets.
   9 There has been a lot of discussion starting here__
  10 __<http://mail.python.org/pipermail/doc-sig/2002-June/002648.html>
  11
  12 This just has been an anonymous reference, that immediately got resolved.
  13 Please note, that this can be mixed freely__ with "real" anonymous__
  14 links__ __<http://www.gimp.org> and the inlined target will always__
  15 be assigned to the anonymous link immediately in front of it.
  16
  17 regular anonymous links should not be disturbed. They should get resolved
  18 without noticing that there has been an immediately resolved one inbetween.
  19
  20  __ anonlink1.html
  21  __ anonlink2.html
  22  __ anonlink3.html
  23
  24 As a not yet discussed feature I have the equivalent construct for named
  25 links. this example_ _<http://example.com> shows how this works. You can refer
  26 a second time to example_ as usual.
  27
  28 I wonder what happenes here__
  29  __ <here.html>
  30
  31 Of course you can `add links to multiple words`__ __<multiple.html>.
  32 So `the implementation`_ is kind of consistent with the usual link
  33 syntax. I am not sure if the added space and the doubling of the
  34 underscores is worth it just to avoid long words.
  35 It introduces a lot of line noise. Changing this in `the
  36 implementation`_ _<file:/home/simon/ST/docutils/parsers/rst/states.py>
  37 should be fairly trivial: I'd guess that adjsuting te regex in two places
  38 would do the trick.
  39
  40 Some real use: Bookmark lists:
  41
  42 - `Cool Modifications`__ __<http://metku.net/>
  43 - `Cool Image Manipulation`__ __<http://www.gimp.org>
  44 - `Cool Homepage`__ __<http://www.home.unix-ag.org/simon/>
  45 - `Cool Comics`__ __<http://www.nichtlustig.de/>
  46 - `something with a Cool long URL`__ __<http://something.
  47   with.a-cool.long.url/plus additional_newlines.and/
  48   spaces#and_a/fragment_identifier>