Changes between Initial Version and Version 1 of WikiRestructuredTextLinks

Timestamp:

Sep 19, 2006, 12:41:32 AM (19 years ago)

Author:

trac

Comment:

--

WikiRestructuredTextLinks

@@ +1 @@
+= TracLinks in reStructuredText =
+
+This document is for testing the ``..trac::`` directive. The page is written like
+
+{{{
+{{{
+#!rst 
+
+Examples
+...
+...
+
+}}}
+}}}
+
+
+This is a list of example uses of the ''trac'' directive, providing use of TracLinks in WikiRestructuredText.
+Note that not all that functionality has been merged yet. The patch attached to #801 provides all of these.
+
+
+{{{
+#!rst
+
+Examples
+--------
+
+trac role
+=========
+Syntax is \`link\`\:trac: or :trac:\`link\`, and could be put anywhere in the text. 'link' has the same format as explain for the ``.. trac::`` directive below.
+
+``In the middle of my text `WikiFormatting`:trac: see!!!!`` 
+   In the middle of my text `WikiFormatting`:trac: see!!!!
+
+or
+
+``In the middle of my text :trac:`WikiFormatting` see!!!!`` 
+   In the middle of my text :trac:`WikiFormatting` see!!!!
+
+
+wiki
+====
+``.. trac:: WikiFormatting``
+        .. trac:: WikiFormatting
+
+``.. trac:: wiki:WikiFormatting``
+       .. trac:: wiki:WikiFormatting
+
+``.. trac:: wiki:WikiFormatting WikiFormatting``
+        .. trac:: wiki:WikiFormatting WikiFormatting
+
+``.. trac:: wiki:WikiFormatting LinkText``
+        .. trac:: wiki:WikiFormatting LinkText
+
+tickets
+=======
+
+``.. trac:: #1``
+        .. trac:: #1
+``.. trac:: #1 ticket one``
+        .. trac:: #1 ticket one
+``.. trac:: ticket:1``
+        .. trac:: ticket:1
+``.. trac:: ticket:1 ticket one``
+        .. trac:: ticket:1 ticket one
+
+reports
+=======
+
+``.. trac:: {1}``
+        .. trac:: {1}
+``.. trac:: {1} report one``
+        .. trac:: {1} report one
+``.. trac:: report:1``
+        .. trac:: report:1
+``.. trac:: report:1 report one``
+        .. trac:: report:1 report one
+
+changesets
+==========
+
+``.. trac:: [42]``
+        .. trac:: [42]
+``.. trac:: [42] changeset 42``
+        .. trac:: [42] changeset 42
+``.. trac:: changeset:42``
+        .. trac:: changeset:42
+``.. trac:: changeset:42 changeset 42``
+        .. trac:: changeset:42 changeset 42
+``.. trac:: foo``
+        .. trac:: foo
+
+files
+=====
+
+``.. trac:: browser:/trunk/trac``
+        .. trac:: browser:/trunk/trac
+
+The leading ``/`` can be omitted...
+
+``.. trac:: repos:trunk/trac trunk/trac``
+        .. trac:: repos:trunk/trac trunk/trac
+``.. trac:: source:trunk/trac Trac source code``
+        .. trac:: source:trunk/trac Trac source code
+
+``.. trac:: browser:trunk/README``
+        .. trac:: browser:trunk/README
+``.. trac:: repos:trunk/README trunk/README``
+        .. trac:: repos:trunk/README trunk/README
+``.. trac:: source:trunk/README README in trunk``
+        .. trac:: source:trunk/README README in trunk
+
+Note that if ``hoo`` is a file, the link targets its revision log. In order to see the file's content, you need to specify the revision explicitely, like here:
+
+``.. trac:: browser:/trunk/README#latest latest of trunk/README``
+        .. trac:: browser:/trunk/README#latest latest of trunk/README
+``.. trac:: repos:trunk/README#42 trunk/README in rev 42``
+        .. trac:: repos:trunk/README#42 trunk/README in rev 42
+}}}
+
+----
+See also: WikiRestructuredTextLinks, TracLinks