Changes between Version 1 and Version 2 of TracLinks


Ignore:
Timestamp:
06/03/10 15:59:46 (14 years ago)
Author:
zeiss
Comment:

Importing pages from "/var/lib/svn/trac/etsicheck2" using ​WikiImport plugin.

Legend:

Unmodified
Added
Removed
Modified

  • TracLinks

    v1 v2  
    1919Some examples: 
    2020 * Tickets: '''!#1''' or '''!ticket:1''' 
    21  * Ticket comments: '''!comment:1:ticket:2'''  
     21 * Ticket comments: '''!comment:ticket:1:2'''  
    2222 * 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''' 
     23 * Changesets: '''!r1''', '''![1]''', '''!changeset:1''' or (restricted) '''![1/trunk]''', '''!changeset:1/trunk''', '''![2:5/trunk]''' 
     24 * Revision log: '''!r1:3''', '''![1:3]''' or '''!log:@1:3''', '''!log:trunk@1:3''' 
     25 * 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''' 
    2626 * Wiki pages: '''!CamelCase''' or '''!wiki:CamelCase''' 
    2727 * Parent page: '''![..]''' 
    2828 * Milestones: '''!milestone:1.0''' 
    29  * Attachment: '''!attachment:example.tgz''' (for current page attachment), '''!attachment:attachment.1073.diff:ticket:944'''  
    30 (absolute path) 
     29 * Attachment: '''!attachment:ticket:944:attachment.1073.diff''' 
    3130 * Files: '''!source:trunk/COPYING''' 
    3231 * A specific file revision: '''!source:/trunk/COPYING@200''' 
    … …  
    3433Display: 
    3534 * Tickets: #1 or ticket:1 
    36  * Ticket comments: comment:1:ticket:2  
     35 * Ticket comments: comment:ticket:1:2  
    3736 * Reports: {1} or report:1 
    38  * Changesets: r1, [1], changeset:1 or (restricted) [1/trunk], changeset:1/trunk 
    39  * Revision log: r1:3, [1:3] or log:@1:3, log:trunk@1:3, [2:5/trunk] 
    40  * 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 
     37 * Changesets: r1, [1], changeset:1, or (restricted) [1/trunk], changeset:1/trunk, [2:5/trunk] 
     38 * Revision log: r1:3, [1:3] or log:@1:3, log:trunk@1:3 
     39 * Diffs (requires [milestone:0.10 0.10]): diff:@20:30, diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default or diff:trunk/trac@3538//sandbox/vc-refactoring/trac@3539 
    4140 * Wiki pages: CamelCase or wiki:CamelCase 
    42  * Parent page: [..] 
     41 * Parent page: '''[..]''' 
    4342 * Milestones: milestone:1.0 
    44  * Attachment: attachment:example.tgz (for current page attachment), attachment:attachment.1073.diff:ticket:944  
    45 (absolute path) 
     43 * Attachment: attachment:ticket:944:attachment.1073.diff 
    4644 * Files: source:trunk/COPYING 
    4745 * A specific file revision: source:/trunk/COPYING@200 
    … …  
    9492Hint: when you move your mouse over the title of a section, a '¶' character will be displayed. This is a link to that specific section and you can use this to copy the `#...` part inside a relative link to an anchor. 
    9593 
    96 To create a link to a [trac:SubWiki SubWiki]-page just use a '/': 
     94To create a link to a SubWiki-page just use a '/': 
    9795{{{ 
    9896 WikiPage/SubWikiPage or ./SubWikiPage 
    9997}}} 
    10098 
    101 To link from a [trac:SubWiki SubWiki] page to a parent, simply use a '..': 
     99To link from a SubWiki page to a parent, simply use a '..': 
    102100{{{ 
    103101  [..] 
    104102}}} 
    105103 
    106 To link from a [trac:SubWiki SubWiki] page to a sibling page, use a '../': 
     104To link from a SubWiki page to a sibling page, use a '../': 
    107105{{{ 
    108106  [../Sibling see next sibling] 
    … …  
    137135}}} 
    138136 
    139 Display: [/newticket newticket] [/ home] 
     137Display: [../newticket newticket][[comment(FIXME that's the 0.10 syntax)]] [/ home] 
    140138 
    141139To link to another location on the server (outside the project), use the '//location' link syntax (''Changed in 0.11''): 
    … …  
    155153 * !attachment:'the file.txt' or 
    156154 * !attachment:"the file.txt"  
    157  * !attachment:"the file.txt:ticket:123"  
     155 * !attachment:"ticket:123:the file.txt"  
    158156 
    159157=== Escaping Links === 
    … …  
    187185The link syntax for attachments is as follows: 
    188186 * !attachment:the_file.txt creates a link to the attachment the_file.txt of the current object 
    189  * !attachment:the_file.txt:wiki:MyPage creates a link to the attachment the_file.txt of the !MyPage wiki page 
    190  * !attachment:the_file.txt:ticket:753 creates a link to the attachment the_file.txt of the ticket 753 
    191  
    192 Note that the older way, putting the filename at the end, is still supported: !attachment:ticket:753:the_file.txt. 
    193  
    194 If you'd like to create a direct link to the content of the attached file instead of a link to the attachment page, simply use `raw-attachment:` instead of `attachment:`. 
    195  
    196 This can be useful for pointing directly to an HTML document, for example. Note that for this use case, you'd have to allow the web browser to render the content by setting `[attachment] render_unsafe_content = yes` (see TracIni#attachment-section). Caveat: only do that in environments for which you're 100% confident you can trust the people who are able to attach files, as otherwise this would open up your site to [wikipedia:Cross-site_scripting cross-site scripting] attacks. 
    197  
    198 See also [#export:links]. 
    199  
    200 === comment: links === 
    201  
    202 When you're inside a given tickets, you can simply write e.g. !comment:3 to link to the third change comment. 
    203 It's also possible to link to a comment of a specific ticket from anywhere using one of the following syntax: 
    204  - !comment:3:ticket:123  
    205  - !ticket:123#comment:3 (note that you can't write !#123#!comment:3!) 
     187 * !attachment:wiki:MyPage:the_file.txt creates a link to the attachment the_file.txt of the !MyPage wiki page 
     188 * !attachment:ticket:753:the_file.txt creates a link to the attachment the_file.txt of the ticket 753 
    206189 
    207190=== query: links === 
    … …  
    263246 * `export:/some/file@123` - get revision 123 of the specified file 
    264247 
    265 This can be very useful for displaying XML or HTML documentation with correct stylesheets and images, in case that has been checked in into the repository. Note that for this use case, you'd have to allow the web browser to render the content by setting `[browser] render_unsafe_content = yes` (see TracIni#browser-section), otherwise Trac will force the files to be downloaded as attachments for security concerns.  
    266  
    267 If the path is to a directory in the repository instead of a specific file, the source browser will be used to display the directory (identical to the result of `source:/some/dir`). 
     248This can be very useful for displaying HTML documentation with correct stylesheets and images, in case that has been checked in the repository. 
     249 
     250If the path is to a directory in the repository instead of a specific file, the source browser will be used to display the directory (identical to the result of `source:/some/dir`. 
    268251 
    269252==== log: links ====