| 143 | |
| 144 | === Link anchors === |
| 145 | |
| 146 | To create a link to a specific anchor in a page, use '#': |
| 147 | {{{ |
| 148 | [#Linkanchors Link anchors] or [[#Linkanchors|Link anchors]] |
| 149 | }}} |
| 150 | [#Linkanchors Link anchors] or [[#Linkanchors|Link anchors]] |
| 151 | |
| 152 | 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. |
| 153 | |
| 154 | To create a link to the first or last occurrence of a term on a page, use a ''pseudo anchor'' starting with '#/' or '#?': |
| 155 | {{{ |
| 156 | [#/Milestone first occurrence of Milestone] or |
| 157 | [#?Milestone last occurrence of Milestone] |
| 158 | }}} |
| 159 | [#/Milestone first occurrence of Milestone] or |
| 160 | [#?Milestone last occurrence of Milestone] |
| 161 | This will also highlight all other matches on the linked page. By default only case sensitive matches are considered. To include case insensitive matches append '/i': |
| 162 | {{{ |
| 163 | [#/Milestone/i first occurrence of Milestone or milestone] or |
| 164 | [#?Milestone/i last occurrence of Milestone or milestone] |
| 165 | }}} |
| 166 | [#/Milestone/i first occurrence of Milestone or milestone] or |
| 167 | [#?Milestone/i last occurrence of Milestone or milestone] |
| 168 | |
| 169 | ''(since Trac 1.0)'' |
| 170 | |
| 171 | Such anchors can be very useful for linking to specific lines in a file in the source browser: |
| 172 | {{{ |
| 173 | [trac:source:tags/trac-0.12/trac/wiki/api.py#L127 Line 127] or |
| 174 | [trac:source:tags/trac-0.12/trac/ticket/roadmap.py#L47 Line 47] |
| 175 | }}} |
| 176 | [trac:source:tags/trac-0.12/trac/wiki/api.py#L127 Line 127] or |
| 177 | [trac:source:tags/trac-0.12/trac/ticket/roadmap.py#L47 Line 47] |
| 178 | (Hint: The line numbers displayed in the source browser are links to anchors on the respective lines.) |
| 179 | |
| 180 | Since such links become outdated when the file changes, it can be useful to link using a '#/' pseudo anchor instead: |
| 181 | {{{ |
| 182 | [trac:source:trunk/trac/wiki/api.py#/IWikiSyntaxProvider IWikiSyntaxProvider] or |
| 183 | [trac:source:trunk/trac/env.py#/ISystemInfoProvider ISystemInfoProvider] |
| 184 | }}} |
| 185 | [trac:source:trunk/trac/wiki/api.py#/IWikiSyntaxProvider IWikiSyntaxProvider] or |
| 186 | [trac:source:trunk/trac/env.py#/ISystemInfoProvider ISystemInfoProvider] |