|
1 |
= TracLinks in reStructuredText = |
|
2 |
|
|
3 |
This document is for testing the ``..trac::`` directive. The page is written like |
|
4 |
|
|
5 |
{{{ |
|
6 |
{{{ |
|
7 |
#!rst |
|
8 |
|
|
9 |
Examples |
|
10 |
... |
|
11 |
... |
|
12 |
|
|
13 |
}}} |
|
14 |
}}} |
|
15 |
|
|
16 |
|
|
17 |
This is a list of example uses of the ''trac'' directive, providing use of TracLinks in WikiRestructuredText. |
|
18 |
Note that not all that functionality has been merged yet. The patch attached to #801 provides all of these. |
|
19 |
|
|
20 |
|
|
21 |
{{{ |
|
22 |
#!rst |
|
23 |
|
|
24 |
Examples |
|
25 |
-------- |
|
26 |
|
|
27 |
trac role |
|
28 |
========= |
|
29 |
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. |
|
30 |
|
|
31 |
``In the middle of my text `WikiFormatting`:trac: see!!!!`` |
|
32 |
In the middle of my text `WikiFormatting`:trac: see!!!! |
|
33 |
|
|
34 |
or |
|
35 |
|
|
36 |
``In the middle of my text :trac:`WikiFormatting` see!!!!`` |
|
37 |
In the middle of my text :trac:`WikiFormatting` see!!!! |
|
38 |
|
|
39 |
|
|
40 |
wiki |
|
41 |
==== |
|
42 |
``.. trac:: WikiFormatting`` |
|
43 |
.. trac:: WikiFormatting |
|
44 |
|
|
45 |
``.. trac:: wiki:WikiFormatting`` |
|
46 |
.. trac:: wiki:WikiFormatting |
|
47 |
|
|
48 |
``.. trac:: wiki:WikiFormatting WikiFormatting`` |
|
49 |
.. trac:: wiki:WikiFormatting WikiFormatting |
|
50 |
|
|
51 |
``.. trac:: wiki:WikiFormatting LinkText`` |
|
52 |
.. trac:: wiki:WikiFormatting LinkText |
|
53 |
|
|
54 |
tickets |
|
55 |
======= |
|
56 |
|
|
57 |
``.. trac:: #1`` |
|
58 |
.. trac:: #1 |
|
59 |
``.. trac:: #1 ticket one`` |
|
60 |
.. trac:: #1 ticket one |
|
61 |
``.. trac:: ticket:1`` |
|
62 |
.. trac:: ticket:1 |
|
63 |
``.. trac:: ticket:1 ticket one`` |
|
64 |
.. trac:: ticket:1 ticket one |
|
65 |
|
|
66 |
reports |
|
67 |
======= |
|
68 |
|
|
69 |
``.. trac:: {1}`` |
|
70 |
.. trac:: {1} |
|
71 |
``.. trac:: {1} report one`` |
|
72 |
.. trac:: {1} report one |
|
73 |
``.. trac:: report:1`` |
|
74 |
.. trac:: report:1 |
|
75 |
``.. trac:: report:1 report one`` |
|
76 |
.. trac:: report:1 report one |
|
77 |
|
|
78 |
changesets |
|
79 |
========== |
|
80 |
|
|
81 |
``.. trac:: [42]`` |
|
82 |
.. trac:: [42] |
|
83 |
``.. trac:: [42] changeset 42`` |
|
84 |
.. trac:: [42] changeset 42 |
|
85 |
``.. trac:: changeset:42`` |
|
86 |
.. trac:: changeset:42 |
|
87 |
``.. trac:: changeset:42 changeset 42`` |
|
88 |
.. trac:: changeset:42 changeset 42 |
|
89 |
``.. trac:: foo`` |
|
90 |
.. trac:: foo |
|
91 |
|
|
92 |
files |
|
93 |
===== |
|
94 |
|
|
95 |
``.. trac:: browser:/trunk/trac`` |
|
96 |
.. trac:: browser:/trunk/trac |
|
97 |
|
|
98 |
The leading ``/`` can be omitted... |
|
99 |
|
|
100 |
``.. trac:: repos:trunk/trac trunk/trac`` |
|
101 |
.. trac:: repos:trunk/trac trunk/trac |
|
102 |
``.. trac:: source:trunk/trac Trac source code`` |
|
103 |
.. trac:: source:trunk/trac Trac source code |
|
104 |
|
|
105 |
``.. trac:: browser:trunk/README`` |
|
106 |
.. trac:: browser:trunk/README |
|
107 |
``.. trac:: repos:trunk/README trunk/README`` |
|
108 |
.. trac:: repos:trunk/README trunk/README |
|
109 |
``.. trac:: source:trunk/README README in trunk`` |
|
110 |
.. trac:: source:trunk/README README in trunk |
|
111 |
|
|
112 |
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: |
|
113 |
|
|
114 |
``.. trac:: browser:/trunk/README#latest latest of trunk/README`` |
|
115 |
.. trac:: browser:/trunk/README#latest latest of trunk/README |
|
116 |
``.. trac:: repos:trunk/README#42 trunk/README in rev 42`` |
|
117 |
.. trac:: repos:trunk/README#42 trunk/README in rev 42 |
|
118 |
}}} |
|
119 |
|
|
120 |
---- |
|
121 |
See also: WikiRestructuredTextLinks, TracLinks |