summaryrefslogtreecommitdiff
path: root/docutils/docs/user/rst/quickref.html
diff options
context:
space:
mode:
Diffstat (limited to 'docutils/docs/user/rst/quickref.html')
-rw-r--r--docutils/docs/user/rst/quickref.html26
1 files changed, 24 insertions, 2 deletions
diff --git a/docutils/docs/user/rst/quickref.html b/docutils/docs/user/rst/quickref.html
index cdda16c68..fdb9a8adb 100644
--- a/docutils/docs/user/rst/quickref.html
+++ b/docutils/docs/user/rst/quickref.html
@@ -1070,8 +1070,8 @@ A transition marker is a horizontal line
<td>
<table width="100%">
<tr bgcolor="#99CCFF"><td><em>Fold-in form</em>
- <tr><td>Indirect hyperlinks, like
- <a href="http://www.python.org">Python</a>.
+ <tr><td>External hyperlinks, like
+ <a href="http://www.python.org/">Python</a>.
</table>
<tr valign="top">
<td>
@@ -1094,6 +1094,28 @@ A&nbsp;transition&nbsp;marker&nbsp;is&nbsp;a&nbsp;horizontal&nbsp;line
printed documents, where the link needs to be presented explicitly, for
example as a footnote.
+ <p>reStructuredText also provides for <b>embedded URIs</b> (<a
+ href="../../ref/rst/restructuredtext.html#embedded-uris">details</a>),
+ a convenience at the expense of readability. A hyperlink
+ reference may directly embed a target URI inline, within angle
+ brackets. The following is exactly equivalent to the example above:
+
+ <p><table border="1" width="100%" bgcolor="#ffffcc" cellpadding="3">
+ <thead>
+ <tr align="left" bgcolor="#99CCFF">
+ <th width="50%">Plain text
+ <th width="50%">Typical result
+ </thead>
+ <tbody>
+
+ <tr valign="top">
+ <td rowspan="2">
+ <samp>External&nbsp;hyperlinks,&nbsp;like&nbsp;`Python
+<br>&lt;http://www.python.org/&gt;`_.</samp>
+ <td>External hyperlinks, like
+ <a href="http://www.python.org/">Python</a>.
+ </table>
+
<h4><a href="#contents" name="internal-hyperlink-targets" class="backref"
>Internal Hyperlink Targets</a></h4>