DrProject Links¶

DrProjectLinks are a very fundamental feature of DrProject. They
allow hyperlinking between tickets, reports, changesets, wiki pages,
milestones, and source files anywhere WikiFormatting is used.

DrProjectLinks are generally of the form 'item:id' (where id
represents the number, [[name]] or path of the item) though some
frequently used kinds of items also have short-hand, alternative,
notations.

Some examples:

• Tickets: '!#1' or '!ticket:1'
• Reports: '!{1}' or '!report:1'
• Changesets: '![1]' or '!changeset:1'
• Wiki pages: '[[CamelCase]]' or '!wiki:CamelCase'
• Milestones: '!milestone:1.0'
• Files: '!source:trunk/COPYING'
• Mail messages: '!@1@'

Display:

• Tickets: #1 or ticket:1
• Reports: {1} or report:1
• Changesets: [1] or changeset:1
• Wiki pages: CamelCase or wiki:CamelCase
• Milestones: milestone:1.0
• Files: source:trunk/COPYING
• Mail messages: 1

Note: The CamelCase form is rarely used, but it can be convenient
to refer to pages whose [[name]]s do not follow WikiPageNames rules, i.e.,
single words, non-alphabetic characters, etc.

DrProject links using the full (non-shorthand) notation can also be
given a custom link title like this:

[ticket:1 This is a link to ticket number one].

which displays:

[ticket:1 This is a link to ticket number one].

It might seem simple, but it allows users to build complex webs of
information quickly and easily. The "link trail" extremely helpful to
better understand what's happening in a project or why a particular
change was made.

source: links¶

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.

Where to use DrProjectLinks¶

You can use DrProjectLinks in:

• Source code (Subversion) commit messages
• Wiki pages
• Full descriptions for tickets, reports and milestones

and any other text fields explicitly marked as supporting
WikiFormatting.

Escaping DrProjectLinks¶

To prevent parsing of DrProjectLinks, you can escape them by preceding
them with a '!' (exclamation mark).

 !NoLinkHere.
 ![42] is not a link either.

Display:
!NoLinkHere.
![42] is not a link either.

Inter-Project Linking¶

There is currently no shorthand for making wiki links between projects.
To do this, you must use the full URL as you would for any other web
site.

---

See also:

• WikiFormatting
• DrProjectWiki