Edgewall Software

Changes between Version 1 and Version 2 of 0.12/TracLinks


Ignore:
Timestamp:
Feb 6, 2010, 7:48:28 PM (10 years ago)
Author:
Christian Boos
Comment:

reworked the #Overview

Legend:

Unmodified
Added
Removed
Modified
  • 0.12/TracLinks

    v1 v2  
    1717and any other text fields explicitly marked as supporting WikiFormatting.
    1818
    19 Some examples:
    20  * Tickets: '''!#1''' or '''!ticket:1'''
    21  * Ticket comments: '''!comment:1:ticket:2'''
    22  * Reports: '''!{1}''' or '''!report:1'''
    23  * Changesets: '''!r1''', '''![1]''', '''!changeset:1''' or (restricted) '''![1/trunk]''', '''!changeset:1/trunk'''
    24  * Revision log: '''!r1:3''', '''![1:3]''' or '''!log:@1:3''', '''!log:trunk@1:3''', '''![2:5/trunk]'''
    25  * 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'''
    26  * Wiki pages: '''!CamelCase''' or '''!wiki:CamelCase'''
    27  * Parent page: '''![..]'''
    28  * Milestones: '''!milestone:1.0'''
    29  * Attachment: '''!attachment:example.tgz''' (for current page attachment), '''!attachment:attachment.1073.diff:ticket:944''' (absolute path)
    30  * Files: '''!source:trunk/COPYING'''
    31  * A specific file revision: '''!source:/trunk/COPYING@200'''
    32  * A particular line of a specific file revision: '''!source:/trunk/COPYING@200#L25'''
    33 Display:
    34  * Tickets: #1 or ticket:1
    35  * Ticket comments: comment:1:ticket:2
    36  * Reports: {1} or report:1
    37  * Changesets: r1, [1], changeset:1 or (restricted) [1/trunk], changeset:1/trunk
    38  * Revision log: r1:3, [1:3] or log:@1:3, log:trunk@1:3, [2:5/trunk]
    39  * 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
    40  * Wiki pages: CamelCase or wiki:CamelCase
    41  * Parent page: [..]
    42  * Milestones: milestone:1.0
    43  * Attachment: attachment:example.tgz (for current page attachment), attachment:attachment.1073.diff:ticket:944 (absolute path)
    44  * Files: source:trunk/COPYING
    45  * A specific file revision: source:/trunk/COPYING@200
    46  * A particular line of a specific file revision: source:/trunk/COPYING@200#L25
     19== Overview ==
     20
     21||= Wiki Markup =||= Display =||
     22{{{#!td
     23 Wiki pages :: `CamelCase` or `wiki:CamelCase`
     24 Parent page :: `[..]`
     25 Tickets :: `#1` or `ticket:1`
     26 Ticket comments :: `comment:1:ticket:2`
     27 Reports :: `{1}` or `report:1`
     28 Changesets :: `r1`, `[1]`, `changeset:1` or (restricted) `[1/trunk]`, `changeset:1/trunk`
     29 Revision log :: `r1:3`, `[1:3]` or `log:@1:3`, `log:trunk@1:3`, `[2:5/trunk]`
     30 Diffs :: `diff:@1:3`, `diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default`
     31          or `diff:trunk/trac@3538//sandbox/vc-refactoring@3539`
     32 Milestones :: `milestone:1.0`
     33 Attachment :: `attachment:example.tgz` (for current page attachment), `attachment:attachment.1073.diff:ticket:944` (absolute path)
     34 Files :: `source:trunk/COPYING`
     35 A specific file revision :: `source:/trunk/COPYING@200`
     36 A particular line of a specific file revision :: `source:/trunk/COPYING@200#L25`
     37}}}
     38{{{#!td
     39 Wiki pages :: CamelCase or wiki:CamelCase
     40 Parent page :: [..]
     41 Tickets :: #1 or ticket:1
     42 Ticket comments :: comment:1:ticket:2
     43 Reports :: {1} or report:1
     44 Changesets :: r1, [1], changeset:1 or (restricted) [1/trunk], changeset:1/trunk
     45 Revision log :: r1:3, [1:3] or log:@1:3, log:trunk@1:3, [2:5/trunk]
     46 Diffs :: diff:@1:3, diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default
     47          or diff:trunk/trac@3538//sandbox/vc-refactoring@3539
     48 Milestones :: milestone:1.0
     49 Attachment :: attachment:example.tgz (for current page attachment), attachment:attachment.1073.diff:ticket:944 (absolute path)
     50 Files :: source:trunk/COPYING
     51 A specific file revision :: source:/trunk/COPYING@200
     52 A particular line of a specific file revision :: source:/trunk/COPYING@200#L25
     53}}}
    4754
    4855'''Note:''' The wiki:CamelCase form is rarely used, but it can be convenient to refer to
     
    5158to links to Wiki page names.
    5259
    53 Trac links using the full (non-shorthand) notation can also be given a custom
    54 link title like this:
    55 
     60
     61{{{#!table class=""
     62|||| Trac links using the full (non-shorthand) notation can also be given a custom link title like this: ||
     63{{{#!td
    5664{{{
    5765[ticket:1 This is a link to ticket number one].
    5866}}}
    59 
    60 Display: [ticket:1 This is a link to ticket number one].
    61 
    62 If the title is omitted, only the id (the part after the colon) is displayed:
    63 
     67}}}
     68{{{#!td
     69[ticket:1 This is a link to ticket number one].
     70}}}
     71|--------------------------------------------------------------------------------------
     72|||| If the title is omitted, only the id (the part after the colon) is displayed:  ||
     73{{{#!td
    6474{{{
    6575[ticket:1]
    6676}}}
    67 
    68 Display: [ticket:1]
    69 
    70 `wiki` is the default if the namespace part of a full link is omitted (''since version 0.10''):
    71 
     77}}}
     78{{{#!td
     79[ticket:1]
     80}}}
     81|--------------------------------------------------------------------------------------
     82|||| `wiki` is the default if the namespace part of a full link is omitted:  ||
     83{{{#!td
    7284{{{
    7385[SandBox the sandbox]
    7486}}}
    75 
    76 Display: [SandBox the sandbox]
     87}}}
     88{{{#!td
     89[SandBox the sandbox]
     90}}}
     91|--------------------------------------------------------------------------------------
     92|||| The short form ''realm:target'' can also be wrapped within a <...> pair, [[br]] which allow for arbitrary characters (i.e. anything but >)  ||
     93{{{#!td
     94{{{
     95<wiki:Strange(page@!)>
     96}}}
     97}}}
     98{{{#!td
     99<wiki:Strange(page@!)>
     100}}}
     101}}}
    77102
    78103TracLinks 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.