Changes between Version 1 and Version 2 of TracLinks

Timestamp:

Mar 28, 2008, 2:16:35 PM (17 years ago)

Author:

trac

Comment:

--

TracLinks

@@ -1 +1 @@
 = Trac Links =
+[[TracGuideToc]]
+
 TracLinks are a fundamental feature of Trac, because they allow easy hyperlinking between the various entities in the system—such as tickets, reports, changesets, Wiki pages, milestones, and source files—from anywhere WikiFormatting is used.
 
@@ -10 +12 @@
  * Ticket comments: '''!comment:ticket:1:2''' 
  * Reports: '''!{1}''' or '''!report:1'''
- * Changesets: '''!r1''', '''![1]''', '''!changeset:1''' or (restricted) '''![1/trunk]''', '''!changeset:1/trunk'''
+ * Changesets: '''!r1''', '''![1]''', '''!changeset:1''' or (restricted) '''![1/trunk]''', '''!changeset:1/trunk''', '''![2:5/trunk]'''
  * Revision log: '''!r1:3''', '''![1:3]''' or '''!log:@1:3''', '''!log:trunk@1:3'''
  * 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'''
@@ -23 +25 @@
  * Ticket comments: comment:ticket:1:2 
  * Reports: {1} or report:1
- * Changesets: r1, [1], changeset:1, or (restricted) [1/trunk], changeset:1/trunk
+ * Changesets: r1, [1], changeset:1, or (restricted) [1/trunk], changeset:1/trunk, [2:5/trunk]
  * Revision log: r1:3, [1:3] or log:@1:3, log:trunk@1:3
  * 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
@@ -47 +49 @@
 Display: [ticket:1 This is a link to ticket number one].
 
-If the title is be omitted, only the id (the part after the colon) is displayed:
+If the title is omitted, only the id (the part after the colon) is displayed:
 
 {{{
@@ -77 +79 @@
 
 The default behavior for a source:/some/path link is to open the directory browser 
-if the path points to a directory and otherwise open the log view. 
-It's also possible to link directly to a specific revision of a file like this: source:/some/file@123 
-or like this to link to the latest revision: source:/some/file@latest.
-If the revision is specified, one can even link to a specific line number: source:/some/file@123#L10 
+if the path points to a directory and otherwise open the log view.
+
+It's also possible to link directly to a specific revision of a file like this:
+ - `source:/some/file@123` - link to the file's revision 123
+ - `source:/some/file@head` - link explicitly to the latest revision of the file
+
+If the revision is specified, one can even link to a specific line number:
+ - `source:/some/file@123#L10`
+ - `source:/tag/0.10@head#L10`
+
+Finally, one can also highlight an arbitrary set of lines:
+ - `source:/some/file@123:10-20,100,103#L99` - highlight lines 10 to 20, and lines 100 and 103.
+''(since 0.11)''
+
+== export: links ==
+
+To force the download of a file in the repository, as opposed to displaying it in the browser, use the `export` link.  Several forms are available:
+ * `export:/some/file` - get the HEAD revision of the specified file
+ * `export:123:/some/file` - get revision 123 of the specified file
+ * `export:/some/file@123` - get revision 123 of the specified file
+
+This can be very useful for displaying HTML documentation with correct stylesheets and images, in case that has been checked in the repository.
+
+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`.
 
 == search: and query: links ==