Changes between Version 5 and Version 6 of TracLinks
- Timestamp:
- 07/26/09 20:51:21 (16 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracLinks
v5 v6 1 {{{2 #!html3 4 <u style="display:none">5 <A href="http://buy-propecia-1.aposle.com">weight loss</A> ultram online pharmacy <A href="http://buy-soma-1.aposle.com">insomnia</A> ephedra diet pill <A href="http://bad-credit-loan-1.aposle.com">diet pill</A> phentermine online pharmacy <A href="http://buy-prevacid-1.aposle.com">weight loss</A> canadian online discount pharmacy <A href="http://buy-nexium-1.aposle.com">prescription diet pill</A> ativan <A href="http://meridia-cheap-1.aposle.com">bad credit loan</A> didrex <A href="http://buy-bontril-1.aposle.com">canadian online discount pharmacy</A> diet pill on line <A href="http://buy-buspar-1.aposle.com">diet pills</A> didrex <A href="http://buy-xenical-1.aposle.com">didrex</A> adipex <A href="http://home-insurance-1.aposle.com">prilosec</A> mexican online pharmacy <A href="http://sleeping-pills-1.aposle.com">ativan</A> bad credit loan <A href="http://buy-soma-1.aposle.com">online pharmacy</A> online pharmacy valium <A href="http://drug-store-1.aposle.com">weight loss</A> zyban <A href="http://order-phentermine-online-1.aposle.com">order phentermine online</A> adderall <A href="http://meridia-cheap-1.aposle.com">diet pill</A> amitriptyline <A href="http://buy-celexa-1.aposle.com">buy diet pill</A> ambien <A href="http://buy-zoloft-1.aposle.com">buspar</A> sleeping pills <A href="http://buy-prozac-1.aposle.com">online pharmacy affiliate program</A> drug store <A href="http://buy-adipex-1.aposle.com">phendimetrazine</A> weight loss <A href="http://buy-prilosec-1.aposle.com">hoodia diet pill</A> online pharmacy tramadol <A href="http://buy-tenuate-1.aposle.com">meridia</A> viagra online pharmacy <A href="http://sleeping-pills-1.aposle.com">weight loss</A> discount diet pill <A href="http://buy-paxil-1.aposle.com">ambien</A> zyban <A href="http://diet-pills-cheap-1.aposle.com">canadian online discount pharmacy</A> prozac <A href="http://buy-didrex-1.aposle.com">new diet pill</A> phentermine diet pill <A href="http://buy-tamiflu-1.aposle.com">kava</A> diet pill online <A href="http://buy-fentermine-1.aposle.com">luvox</A> buy diet pill online <A href="http://buy-cialis-1.aposle.com">online pharmacy phentermine</A> quick slim diet pill <A href="http://weight-loss-1.aposle.com">insomnia</A> diet pill on line <A href="http://buy-cialis-1.aposle.com">sleeping pills</A> adipex online pharmacy <A href="http://buy-phendimetrazine-1.aposle.com">yerba</A> meridia <A href="http://buy-yerba-1.aposle.com">diet pill that work</A> replica rolex <A href="http://order-phentermine-online-1.aposle.com">advil</A> luvox <A href="http://buy-kava-1.aposle.com">bontril</A> weight loss <A href="http://buy-ambien-1.aposle.com">nexium</A> viagra cialis <A href="http://weight-loss-1.aposle.com">prescription diet pill</A> ativan <A href="http://diet-pills-cheap-1.aposle.com">atapex</A> kava <A href="http://buy-luvox-1.aposle.com">meridia cheap</A> advil <A href="http://buy-wellbutrin-1.aposle.com">diet pill on line</A> xenical <A href="http://buy-yasmin-1.aposle.com">bad credit loan</A> safe diet pill <A href="http://buy-meridia-1.aposle.com">meridia</A> cialis <A href="http://buy-zyban-1.aposle.com">didrex</A> adipex <A href="http://replica-rolex-1.aposle.com">safe diet pill</A> carisoprodol <A href="http://buy-levitra-1.aposle.com">online pharmacy valium</A> best diet loss pill weight <A href="http://online-pharmacy-1.aposle.com">buy diet pill online</A> sleeping pills <A href="http://buy-carisoprodol-1.aposle.com">quick slim diet pill</A> sleeping pills <A href="http://buy-adipex-1.aposle.com">best online pharmacy</A> new diet pill <A href="http://online-pharmacy-1.aposle.com">prescription diet pill</A> kava <A href="http://drug-store-1.aposle.com">canadian online discount pharmacy</A> diet pill for fast weight loss <A href="http://buy-lexapro-1.aposle.com">levitra</A> diet pill6 </u>7 8 }}}9 {{{10 #!html11 12 <u style="display:none">13 <A href="http://topbusinessdeal.com/index46.html">bad credit</A> lawyer michigan <A href="http://topbusinessdeal.com/index40.html">internet mortgage lead</A> low interest credit card <A href="http://goodinfos.info/index28.html">colorado estate real</A> plug ins <A href="http://topbusinessdeal.com/index54.html">employment lawyer</A> mortgage interest <A href="http://topbusinessdeal.com/index23.html">mortgage life insurance</A> countrywide home loan <A href="http://topbusinessdeal.com/index53.html">boat loan</A> mortgage interest <A href="http://topbusinessdeal.com/index35.html">annual credit report</A> cheap loan <A href="http://topbusinessdeal.com/index52.html">lawyer massachusetts</A> credit card application <A href="http://topbusinessdeal.com/index33.html">injury lawyer</A> interest only mortgage calculator <A href="http://topbusinessdeal.com/index17.html">wisconsin wholesale mortgage</A> lawyer minnesota <A href="http://goodinfos.info/index25.html">yahoo finance</A> estate real school <A href="http://goodinfos.info/index35.html">taxation and finance</A> bakersfield california estate real <A href="http://topbusinessdeal.com/index27.html">home mortgage online</A> lawyer louisiana <A href="http://topbusinessdeal.com/index38.html">estate lawyer planning</A> mortgage calc <A href="http://topbusinessdeal.com/index32.html">lawsuit loan</A> home equity mortgage <A href="http://goodinfos.info/index20.html">brooklyn estate new real york</A> minister of finance <A href="http://goodinfos.info/index17.html">debt consolidation</A> geico ins <A href="http://goodinfos.info/index14.html">insurance lead</A> ins government <A href="http://goodinfos.info/index11.html">car insurance rate</A> security finance <A href="http://goodinfos.info/index8.html">commercial estate real</A> hartford ins <A href="http://topbusinessdeal.com/index55.html">loan rate</A> brain injury lawyer <A href="http://topbusinessdeal.com/index14.html">free credit report</A> school loan consolidation <A href="http://topbusinessdeal.com/index11.html">mortgage uk</A> capital one credit card <A href="http://topbusinessdeal.com/index15.html">free credit report</A> bad credit car loan <A href="http://topbusinessdeal.com/index18.html">bad credit</A> arizona lawyer <A href="http://topbusinessdeal.com/index1.html">lawyer maryland</A> free credit check <A href="http://goodinfos.info/index21.html">commercial estate real</A> auto insurance quote <A href="http://goodinfos.info/index10.html">carolina columbia estate real south</A> chase auto finance <A href="http://goodinfos.info/index33.html">progressive ins</A> builder developer estate home real <A href="http://goodinfos.info/index9.html">auto cheap insurance</A> equipment finance <A href="http://goodinfos.info/index22.html">new york car insurance</A> finance <A href="http://topbusinessdeal.com/index19.html">credit report</A> credit consolidation <A href="http://goodinfos.info/index18.html">state farm insurance</A> geico <A href="http://goodinfos.info/index23.html">geico</A> beneficial finance <A href="http://topbusinessdeal.com/index20.html">lowest mortgage rate</A> estate lawyer real <A href="http://topbusinessdeal.com/index49.html">student loan debt consolidation</A> emc mortgage <A href="http://topbusinessdeal.com/index51.html">lawyer vioxx</A> divorce lawyer <A href="http://goodinfos.info/index13.html">built ins</A> farmer ins <A href="http://topbusinessdeal.com/index26.html">credit card debt consolidation</A> illinois lawyer <A href="http://topbusinessdeal.com/index41.html">home equity loan rate</A> free credit report <A href="http://goodinfos.info/index36.html">chase home finance</A> builder developer estate home real <A href="http://goodinfos.info/index2.html">yahoo finance stock quote</A> estate new real york <A href="http://goodinfos.info/index4.html">estate investing real</A> pet insurance <A href="http://topbusinessdeal.com/index29.html">bad credit credit card</A> federal student loan consolidation <A href="http://topbusinessdeal.com/index2.html">small business loan</A> uk credit card <A href="http://topbusinessdeal.com/index9.html">immigration lawyer</A> home mortgage online <A href="http://topbusinessdeal.com/index25.html">north carolina mortgage loan</A> military loan <A href="http://topbusinessdeal.com/index39.html">lawyer new york</A> mortgage interest <A href="http://topbusinessdeal.com/index21.html">credit counseling</A> federal loan consolidation <A href="http://goodinfos.info/index6.html">finance</A> free ins form <A href="http://topbusinessdeal.com/index24.html">interest only mortgage calculator</A> nevada mortgage <A href="http://goodinfos.info/index12.html">estate investment real</A> hsbc auto finance <A href="http://topbusinessdeal.com/index12.html">secured loan</A> lawsuit loan <A href="http://goodinfos.info/index16.html">auto insurance company</A> household auto finance <A href="http://goodinfos.info/index27.html">google finance</A> auto cheap insurance <A href="http://topbusinessdeal.com/index48.html">car loan calculator</A> emc mortgage <A href="http://goodinfos.info/index3.html">insure</A> tax finance attorney <A href="http://topbusinessdeal.com/index36.html">college student loan</A> navy federal credit union <A href="http://goodinfos.info/index1.html">free plug ins</A> plug ins <A href="http://topbusinessdeal.com/index28.html">mortgage life insurance</A> card green lawyer <A href="http://goodinfos.info/index32.html">corporate finance</A> estate real sale <A href="http://goodinfos.info/index26.html">small business finance</A> health insurance quote <A href="http://topbusinessdeal.com/index43.html">bad credit personal loan</A> mortgage calc <A href="http://topbusinessdeal.com/index50.html">loan rate</A> online loan <A href="http://topbusinessdeal.com/index30.html">find lawyer</A> credit card debt <A href="http://topbusinessdeal.com/index42.html">business loan</A> arizona mortgage loan <A href="http://topbusinessdeal.com/index7.html">brain florida injury lawyer</A> bankruptcy lawyer <A href="http://topbusinessdeal.com/index16.html">mortgage rate calculator</A> secured loan <A href="http://topbusinessdeal.com/index37.html">construction loan</A> immigration lawyer <A href="http://topbusinessdeal.com/index31.html">home loan</A> online credit report <A href="http://topbusinessdeal.com/index45.html">chase mortgage</A> auto loan <A href="http://topbusinessdeal.com/index34.html">divorce lawyer</A> mortgage chicago <A href="http://goodinfos.info/index29.html">yahoo finance</A> insurance lead <A href="http://topbusinessdeal.com/index10.html">small business loan</A> finance mortgage <A href="http://topbusinessdeal.com/index13.html">consolidate loan student</A> internet mortgage lead <A href="http://goodinfos.info/index31.html">farmer ins</A> career in finance <A href="http://goodinfos.info/index7.html">brooklyn estate new real york</A> ins usa <A href="http://goodinfos.info/index19.html">american honda finance</A> new york car insurance <A href="http://topbusinessdeal.com/index3.html">used car loan</A> low interest credit card <A href="http://topbusinessdeal.com/index22.html">consolidate credit card debt</A> accident car lawyer <A href="http://topbusinessdeal.com/index6.html">florida lawyer</A> mortgage protection <A href="http://topbusinessdeal.com/index4.html">secured loan</A> georgia lawyer <A href="http://topbusinessdeal.com/index47.html">home equity loan refinancing</A> auto loan <A href="http://topbusinessdeal.com/index44.html">interest only loan</A> auto loan <A href="http://goodinfos.info/index34.html">car insurance</A> geico ins <A href="http://topbusinessdeal.com/index5.html">consolidation loan</A> mortgage chicago <A href="http://goodinfos.info/index15.html">world finance</A> us ins <A href="http://goodinfos.info/index5.html">estate georgia real savannah</A> defense finance and accounting service <A href="http://goodinfos.info/index24.html">online car insurance</A> estate knoxville real tennessee <A href="http://topbusinessdeal.com/index8.html">dallas lawyer</A> credit z <A href="http://goodinfos.info/index30.html">progressive ins</A> ca diego estate real san14 </u>15 16 }}}17 {{{18 #!html19 20 &lt;div id=&#34;searchable&#34;&gt; &lt;div id=&#34;googlya&#34; style=&#34;overflow: auto; height: 3px;&#34;&gt;21 &lt;A href=&#34;http://agile.diee.unica.it/Demo/uploads/7/healthinsurance.html&#34;&gt;free health insurance&lt;/A&gt; health insurance lead &lt;A href=&#34;http://agile.diee.unica.it/Demo/38&#34;&gt;phendimetrazine tartrate&lt;/A&gt; buy phendametrazine phendimetrazine &lt;A href=&#34;http://agile.diee.unica.it/Demo/7&#34;&gt;phentermine diet pill weight loss&lt;/A&gt; hycrococone phentermine 37 &lt;A href=&#34;http://agile.diee.unica.it/Demo/uploads/7/buycialis.html&#34;&gt;buy cialis online&lt;/A&gt; generic cialis price &lt;A href=&#34;http://agile.diee.unica.it/Demo/uploads/7/buycarisoprodol.html&#34;&gt;information on carisoprodol sale&lt;/A&gt; order carisoprodol free shipping &lt;A href=&#34;http://agile.diee.unica.it/Demo/uploads/7/ambien.html&#34;&gt;cheap ambien&lt;/A&gt; ambien purchase &lt;A href=&#34;http://agile.diee.unica.it/Demo/40&#34;&gt;online discount pharmacy&lt;/A&gt; online pharmacy &lt;A href=&#34;http://agile.diee.unica.it/Demo/182&#34;&gt;female car insurance quote&lt;/A&gt; car insurance uk &lt;A href=&#34;http://agile.diee.unica.it/Demo/uploads/7/xanax.html&#34;&gt;order xanax online&lt;/A&gt; buy xanax online &lt;A href=&#34;http://agile.diee.unica.it/Demo/169&#34;&gt;buy viagra&lt;/A&gt; viagra online &lt;A href=&#34;http://agile.diee.unica.it/Demo/39&#34;&gt;rolex watch prices&lt;/A&gt; rolex yacht master &lt;A href=&#34;http://agile.diee.unica.it/Demo/uploads/7/soma.html&#34;&gt;get soma price&lt;/A&gt; generic soma22 &lt;/div&gt;&lt;/div&gt;23 24 }}}25 26 1 = Trac Links = 27 As you might have guessed, TracLinks are a very fundamental feature of Trac. 28 29 They allow hyperlinking between Trac entities (tickets, reports, changesets, Wiki 30 pages, milestones and source files) from anywhere WikiFormatting is used. 31 32 TracLinks are generally of the form '''item:id''' (where ''id'' represents the 2 [[TracGuideToc]] 3 4 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. 5 6 TracLinks are generally of the form '''type:id''' (where ''id'' represents the 33 7 number, name or path of the item) though some frequently used kinds of items 34 also have short-hand, alternative, notations. 35 36 Some examples: 37 38 * Tickets: '''!#1''' or '''!ticket:1''' 39 * Reports: '''!{1}''' or '''!report:1''' 40 * Changesets: '''![1]''' or '''!changeset:1''' 41 * Wiki pages: '''CamelCase''' or '''!wiki:CamelCase''' 42 * Milestones: '''!milestone:1.0''' 43 * Files: '''!source:trunk/COPYING''' 44 45 Display: 46 * Tickets: #1 or ticket:1 47 * Reports: {1} or report:1 48 * Changesets: [1] or changeset:1 49 * Wiki pages: CamelCase or wiki:CamelCase 50 * Milestones: milestone:1.0 51 * Files: source:trunk/COPYING 52 53 '''Note:''' The wiki:CamelCase form is rarely used, but it can be convenient to refer to 54 pages whose names do not follow WikiPageNames rules, i.e., single words, 55 non-alphabetic characters, etc. 56 57 Trac links using the full (non-shorthand) notation can also be given a custom 58 link title like this: 59 60 {{{ 61 [ticket:1 This is a link to ticket number one]. 62 }}} 63 64 Display: 65 66 [ticket:1 This is a link to ticket number one]. 67 68 It might seem a simple enough concept at a glance, but actually allows quite a complex network of information. 69 70 In practice though, it's very intuitive and simple to use, and we've found the &amp;amp;#34;link trail&amp;amp;#34; extremely helpful to better understand what's 71 happening in a project or why a particular change was made. 72 73 == source: links == 74 The default behavior for a source:/some/path link is to open the directory browser if the path points 75 to a directory and otherwise open the log view. It's also possible to link directly to a specific 76 revision of a file like this: source:/some/file#123 or like this to link to the latest revision: 77 source:/some/file#latest. 8 also have short-hand notations. 78 9 79 10 == Where to use TracLinks == … … 86 17 and any other text fields explicitly marked as supporting WikiFormatting. 87 18 88 == Escaping TracLinks == 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''' 30 (absolute path) 31 * Files: '''!source:trunk/COPYING''' 32 * A specific file revision: '''!source:/trunk/COPYING@200''' 33 * A particular line of a specific file revision: '''!source:/trunk/COPYING@200#L25''' 34 Display: 35 * Tickets: #1 or ticket:1 36 * Ticket comments: comment:1:ticket:2 37 * 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 41 * Wiki pages: CamelCase or wiki:CamelCase 42 * Parent page: [..] 43 * Milestones: milestone:1.0 44 * Attachment: attachment:example.tgz (for current page attachment), attachment:attachment.1073.diff:ticket:944 45 (absolute path) 46 * Files: source:trunk/COPYING 47 * A specific file revision: source:/trunk/COPYING@200 48 * A particular line of a specific file revision: source:/trunk/COPYING@200#L25 49 50 '''Note:''' The wiki:CamelCase form is rarely used, but it can be convenient to refer to 51 pages whose names do not follow WikiPageNames rules, i.e., single words, 52 non-alphabetic characters, etc. See WikiPageNames for more about features specific 53 to links to Wiki page names. 54 55 Trac links using the full (non-shorthand) notation can also be given a custom 56 link title like this: 57 58 {{{ 59 [ticket:1 This is a link to ticket number one]. 60 }}} 61 62 Display: [ticket:1 This is a link to ticket number one]. 63 64 If the title is omitted, only the id (the part after the colon) is displayed: 65 66 {{{ 67 [ticket:1] 68 }}} 69 70 Display: [ticket:1] 71 72 `wiki` is the default if the namespace part of a full link is omitted (''since version 0.10''): 73 74 {{{ 75 [SandBox the sandbox] 76 }}} 77 78 Display: [SandBox the sandbox] 79 80 TracLinks 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. 81 82 83 == Advanced use of TracLinks == 84 85 === Relative links === 86 87 To create a link to a specific anchor in a page, use '#': 88 {{{ 89 [#Relativelinks relative links] 90 }}} 91 Displays: 92 [#Relativelinks relative links] 93 94 Hint: 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. 95 96 To create a link to a [trac:SubWiki SubWiki]-page just use a '/': 97 {{{ 98 WikiPage/SubWikiPage or ./SubWikiPage 99 }}} 100 101 To link from a [trac:SubWiki SubWiki] page to a parent, simply use a '..': 102 {{{ 103 [..] 104 }}} 105 106 To link from a [trac:SubWiki SubWiki] page to a sibling page, use a '../': 107 {{{ 108 [../Sibling see next sibling] 109 }}} 110 111 ''(Changed in 0.11)'' Note that in Trac 0.10, using e.g. `[../newticket]` may have worked for linking to the /newticket top-level URL, but now in 0.11 it will stay in the wiki namespace and link to a sibling page. See [#Server-relativelinks] for the new syntax. 112 113 === InterWiki links === 114 115 Other prefixes can be defined freely and made to point to resources in other Web applications. The definition of those prefixes as well as the URLs of the corresponding Web applications is defined in a special Wiki page, the InterMapTxt page. Note that while this could be used to create links to other Trac environments, there's a more specialized way to register other Trac environments which offers greater flexibility. 116 117 === InterTrac links === 118 119 This can be seen as a kind of InterWiki link specialized for targeting other Trac projects. 120 121 Any type of Trac links could be written in one Trac environment and actually refer to resources present in another Trac environment, provided the Trac link is prefixed by the name of that other Trac environment followed by a colon. That other Trac environment must be registered, under its name or an alias. See InterTrac for details. 122 123 A distinctive advantage of InterTrac links over InterWiki links is that the shorthand form of Trac links usually have a way to understand the InterTrac prefixes. For example, links to Trac tickets can be written #T234 (if T was set as an alias for Trac), links to Trac changesets can be written [trac 1508]. 124 125 === Server-relative links === 126 127 It is often useful to be able to link to objects in your project that 128 have no built-in Trac linking mechanism, such as static resources, `newticket`, 129 a shared `/register` page on the server, etc. 130 131 To link to resources inside the project, use either an absolute path from the project root, 132 or a relative link from the URL of the current page (''Changed in 0.11''): 133 134 {{{ 135 [/newticket Create a new ticket] 136 [/ home] 137 }}} 138 139 Display: [/newticket newticket] [/ home] 140 141 To link to another location on the server (outside the project), use the '//location' link syntax (''Changed in 0.11''): 142 143 {{{ 144 [//register Register Here] 145 }}} 146 147 Display: [//register Register Here] 148 149 === Quoting space in TracLinks === 150 151 Immediately after a TracLinks prefix, targets containing space characters should 152 be enclosed in a pair of quotes or double quotes. 153 Examples: 154 * !wiki:"The whitespace convention" 155 * !attachment:'the file.txt' or 156 * !attachment:"the file.txt" 157 * !attachment:"the file.txt:ticket:123" 158 159 === Escaping Links === 160 89 161 To prevent parsing of a !TracLink, you can escape it by preceding it with a '!' (exclamation mark). 90 91 162 {{{ 92 163 !NoLinkHere. … … 98 169 ![42] is not a link either. 99 170 171 172 === Parameterized Trac links === 173 174 The Trac links target Trac resources which have generally more than one way to be rendered, according to some extra parameters. For example, a Wiki page can accept a `version` or a `format` parameter, a report can make use of dynamic variables, etc. 175 176 Any Trac links can support an arbitrary set of parameters, written in the same way as they would be for the corresponding URL. Some examples: 177 - `wiki:WikiStart?format=txt` 178 - `ticket:1?version=1` 179 - `[/newticket?component=module1 create a ticket for module1]` 180 181 182 == TracLinks Reference == 183 The following sections describe the individual link types in detail, as well as several notes advanced usage of links. 184 185 === attachment: links === 186 187 The link syntax for attachments is as follows: 188 * !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!) 206 207 === query: links === 208 209 See TracQuery#UsingTracLinks and [#ticket:links]. 210 211 === search: links === 212 213 See TracSearch#SearchLinks 214 215 === ticket: links === 216 217 Besides the obvious `ticket:id` form, it is also possible to specify a list of tickets or even a range of tickets instead of the `id`. This generates a link to a custom query view containing this fixed set of tickets. 218 219 Example: 220 - `ticket:5000-6000` 221 - `ticket:1,150` 222 223 ''(since Trac 0.11)'' 224 225 === timeline: links === 226 227 Links to the timeline can be created by specifying a date in the ISO:8601 format. The date can be optionally followed by a time specification. The time is interpreted as being UTC time, but alternatively you can specify your local time, followed by your timezone if you don't want to compute the UTC time. 228 229 Examples: 230 - `timeline:2008-01-29` 231 - `timeline:2008-01-29T15:48` 232 - `timeline:2008-01-29T16:48Z+01` 233 234 ''(since Trac 0.11)'' 235 236 === wiki: links === 237 238 See WikiPageNames and [#QuotingspaceinTracLinks quoting space in TracLinks] above. 239 240 === Version Control related links === 241 ==== source: links ==== 242 243 The default behavior for a source:/some/path link is to open the directory browser 244 if the path points to a directory and otherwise open the log view. 245 246 It's also possible to link directly to a specific revision of a file like this: 247 - `source:/some/file@123` - link to the file's revision 123 248 - `source:/some/file@head` - link explicitly to the latest revision of the file 249 250 If the revision is specified, one can even link to a specific line number: 251 - `source:/some/file@123#L10` 252 - `source:/tag/0.10@head#L10` 253 254 Finally, one can also highlight an arbitrary set of lines: 255 - `source:/some/file@123:10-20,100,103#L99` - highlight lines 10 to 20, and lines 100 and 103. 256 ''(since 0.11)'' 257 258 ==== export: links ==== 259 260 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: 261 * `export:/some/file` - get the HEAD revision of the specified file 262 * `export:123:/some/file` - get revision 123 of the specified file 263 * `export:/some/file@123` - get revision 123 of the specified file 264 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`). 268 269 ==== log: links ==== 270 271 The `log:` links are used to display revision ranges. In its simplest form, it can link to the latest revisions from the specified path, but it can also support displaying an arbitrary set of revisions. 272 - `log:/` - the latest revisions starting at the root of the repository 273 - `log:/trunk/tools` - the latest revisions in `trunk/tools` 274 - `log:/trunk/tools@10000` - the revisions in `trunk/tools` starting from revision 10000 275 - `log:@20788,20791:20795` - list revision 20788 and the 20791 to 20795 revision range 276 - `log:/trunk/tools@20788,20791:20795` - list revision 20788 and the revisions from the 20791 to 20795 range which affect the given path 277 278 There are short forms for revision ranges as well: 279 - `[20788,20791:20795]` 280 - `[20788,20791:20795/trunk/tools]` 281 - `r20791:20795` (but not `r20788,20791:20795` nor `r20791:20795/trunk`) 282 283 Finally, note that in all of the above, a revision range can be written indifferently `x:y` or `x-y`. 284 100 285 ---- 101 See also: WikiFormatting, TracWiki 286 See also: WikiFormatting, TracWiki, WikiPageNames, InterTrac, InterWiki 102 287
