Changes between Version 1 and Version 2 of 0.12/TracLinks

Timestamp:

Feb 6, 2010, 7:48:28 PM (14 years ago)

Author:

Christian Boos

Comment:

reworked the #Overview

0.12/TracLinks

@@ -17 +17 @@
 and any other text fields explicitly marked as supporting WikiFormatting.
 
-Some examples:
- * Tickets: '''!#1''' or '''!ticket:1'''
- * Ticket comments: '''!comment:1:ticket:2''' 
- * Reports: '''!{1}''' or '''!report:1'''
- * Changesets: '''!r1''', '''![1]''', '''!changeset:1''' or (restricted) '''![1/trunk]''', '''!changeset:1/trunk'''
- * Revision log: '''!r1:3''', '''![1:3]''' or '''!log:@1:3''', '''!log:trunk@1:3''', '''![2:5/trunk]'''
- * Diffs (requires [trac:milestone:0.10 0.10]): '''!diff:@1:3''', '''!diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default''' or '''!diff:trunk/trac@3538//sandbox/vc-refactoring@3539'''
- * Wiki pages: '''!CamelCase''' or '''!wiki:CamelCase'''
- * Parent page: '''![..]'''
- * Milestones: '''!milestone:1.0'''
- * Attachment: '''!attachment:example.tgz''' (for current page attachment), '''!attachment:attachment.1073.diff:ticket:944''' (absolute path)
- * Files: '''!source:trunk/COPYING'''
- * A specific file revision: '''!source:/trunk/COPYING@200'''
- * A particular line of a specific file revision: '''!source:/trunk/COPYING@200#L25'''
-Display:
- * Tickets: #1 or ticket:1
- * Ticket comments: comment:1:ticket:2 
- * Reports: {1} or report:1
- * Changesets: r1, [1], changeset:1 or (restricted) [1/trunk], changeset:1/trunk
- * Revision log: r1:3, [1:3] or log:@1:3, log:trunk@1:3, [2:5/trunk]
- * Diffs (requires [milestone:0.10 0.10]): diff:@1:3, diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default or diff:trunk/trac@3538//sandbox/vc-refactoring@3539
- * Wiki pages: CamelCase or wiki:CamelCase
- * Parent page: [..]
- * Milestones: milestone:1.0
- * Attachment: attachment:example.tgz (for current page attachment), attachment:attachment.1073.diff:ticket:944 (absolute path)
- * Files: source:trunk/COPYING
- * A specific file revision: source:/trunk/COPYING@200
- * A particular line of a specific file revision: source:/trunk/COPYING@200#L25
+== Overview ==
+
+||= Wiki Markup =||= Display =||
+{{{#!td
+ Wiki pages :: `CamelCase` or `wiki:CamelCase`
+ Parent page :: `[..]`
+ Tickets :: `#1` or `ticket:1`
+ Ticket comments :: `comment:1:ticket:2`
+ Reports :: `{1}` or `report:1`
+ Changesets :: `r1`, `[1]`, `changeset:1` or (restricted) `[1/trunk]`, `changeset:1/trunk`
+ Revision log :: `r1:3`, `[1:3]` or `log:@1:3`, `log:trunk@1:3`, `[2:5/trunk]`
+ Diffs :: `diff:@1:3`, `diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default` 
+          or `diff:trunk/trac@3538//sandbox/vc-refactoring@3539`
+ Milestones :: `milestone:1.0`
+ Attachment :: `attachment:example.tgz` (for current page attachment), `attachment:attachment.1073.diff:ticket:944` (absolute path)
+ Files :: `source:trunk/COPYING`
+ A specific file revision :: `source:/trunk/COPYING@200`
+ A particular line of a specific file revision :: `source:/trunk/COPYING@200#L25`
+}}}
+{{{#!td
+ Wiki pages :: CamelCase or wiki:CamelCase
+ Parent page :: [..]
+ Tickets :: #1 or ticket:1
+ Ticket comments :: comment:1:ticket:2 
+ Reports :: {1} or report:1
+ Changesets :: r1, [1], changeset:1 or (restricted) [1/trunk], changeset:1/trunk
+ Revision log :: r1:3, [1:3] or log:@1:3, log:trunk@1:3, [2:5/trunk]
+ Diffs :: diff:@1:3, diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default 
+          or diff:trunk/trac@3538//sandbox/vc-refactoring@3539
+ Milestones :: milestone:1.0
+ Attachment :: attachment:example.tgz (for current page attachment), attachment:attachment.1073.diff:ticket:944 (absolute path)
+ Files :: source:trunk/COPYING
+ A specific file revision :: source:/trunk/COPYING@200
+ A particular line of a specific file revision :: source:/trunk/COPYING@200#L25
+}}}
 
 '''Note:''' The wiki:CamelCase form is rarely used, but it can be convenient to refer to
@@ -51 +58 @@
 to links to Wiki page names.
 
-Trac links using the full (non-shorthand) notation can also be given a custom
-link title like this:
-
+
+{{{#!table class=""
+|||| Trac links using the full (non-shorthand) notation can also be given a custom link title like this: ||
+{{{#!td
 {{{
 [ticket:1 This is a link to ticket number one].
 }}}
-
-Display: [ticket:1 This is a link to ticket number one].
-
-If the title is omitted, only the id (the part after the colon) is displayed:
-
+}}}
+{{{#!td
+[ticket:1 This is a link to ticket number one].
+}}}
+|--------------------------------------------------------------------------------------
+|||| If the title is omitted, only the id (the part after the colon) is displayed:  ||
+{{{#!td
 {{{
 [ticket:1]
 }}}
-
-Display: [ticket:1]
-
-`wiki` is the default if the namespace part of a full link is omitted (''since version 0.10''):
-
+}}}
+{{{#!td
+[ticket:1]
+}}}
+|--------------------------------------------------------------------------------------
+|||| `wiki` is the default if the namespace part of a full link is omitted:  || 
+{{{#!td
 {{{
 [SandBox the sandbox]
 }}}
-
-Display: [SandBox the sandbox]
+}}}
+{{{#!td
+[SandBox the sandbox]
+}}}
+|--------------------------------------------------------------------------------------
+|||| The short form ''realm:target'' can also be wrapped within a <...> pair, [[br]] which allow for arbitrary characters (i.e. anything but >)  ||
+{{{#!td
+{{{
+<wiki:Strange(page@!)>
+}}}
+}}}
+{{{#!td
+<wiki:Strange(page@!)>
+}}}
+}}}
 
 TracLinks are a very simple idea, but actually allow quite a complex network of information. In practice, it's very intuitive and simple to use, and we've found the "link trail" extremely helpful to better understand what's happening in a project or why a particular change was made.