| |
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 |