Development

TracLinks (diff)

You must first sign up to be able to contribute.

Changes between Version 1 and Version 2 of TracLinks

Show
Ignore:
Author:
trac (IP: 127.0.0.1)
Timestamp:
11/24/05 20:19:33 (12 years ago)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracLinks

    v1 v2  
    1616 * Wiki pages: '''CamelCase''' or '''!wiki:CamelCase''' 
    1717 * Milestones: '''!milestone:1.0''' 
     18 * Attachment: '''!attachment:ticket:944:attachment.1073.diff''' 
    1819 * Files: '''!source:trunk/COPYING''' 
    1920 * A specific file revision: '''!source:/trunk/COPYING#200''' 
    2627 * Milestones: milestone:1.0 
    2728 * Files: source:trunk/COPYING 
     29 * Attachment: attachment:ticket:944:attachment.1073.diff 
    2830 * A specific file revision: source:/trunk/COPYING#200 
    2931 
    5153It might seem a simple enough concept at a glance, but actually allows 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. 
    5254 
     55== attachement: links == 
     56 
     57The link syntax for attachments is as follows: 
     58 * !attachment:the_file.txt creates a link to the attachment the_file.txt of the current object 
     59 * !attachment:wiki:MyPage:the_file.txt creates a link to the attachment the_file.txt of the !MyPage wiki page 
     60 * !attachment:ticket:753:the_file.txt creates a link to the attachment the_file.txt of the ticket 753 !attachment:wiki:MyPage:the_file.txt 
     61 
    5362== source: links == 
    54 The default behavior for a source:/some/path link is to open the directory browser if the path points 
    55 to a directory and otherwise open the log view. It's also possible to link directly to a specific 
    56 revision of a file like this: source:/some/file#123 or like this to link to the latest revision: 
    57 source:/some/file#latest. 
     63 
     64The default behavior for a source:/some/path link is to open the directory browser  
     65if the path points to a directory and otherwise open the log view.  
     66It's also possible to link directly to a specific revision of a file like this: source:/some/file@123  
     67or like this to link to the latest revision: source:/some/file@latest. 
     68If the revision is specified, one can even link to a specific line number: !source:/some/file@123#L10  
     69[[comment(TODO: remove the ! when Edgewall Trac is upgraded with the support for the line syntax)]] 
     70 
     71== Quoting space in TracLinks == 
     72 
     73The usual syntax for quoting space is: 
     74 
     75 * !attachment:'the file.txt' or 
     76 * !attachment:"the file.txt"  
    5877 
    5978== Where to use TracLinks ==