Changes between Version 51 and Version 52 of WikiFormatting
- Timestamp:
- Oct 31, 2005, 1:23:57 PM (19 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
WikiFormatting
v51 v52 11 11 12 12 13 == Font styles ==13 == Font Styles == 14 14 15 15 The Trac wiki supports the following font styles: … … 22 22 * ~~strike-through~~ 23 23 * ^superscript^ 24 * ,,subscript,, .24 * ,,subscript,, 25 25 }}} 26 26 … … 33 33 * ~~strike-through~~ 34 34 * ^superscript^ 35 * ,,subscript,, .36 37 Strictly speaking, the `{{{...}}}` and {{{`...`}}} commands do not only select a monospace font, but additionally mark the surrounded text as preformatted. No further wiki processing is done on this text.38 39 == Heading ==40 41 You can create heading by starting a line with one up to five ''equal'' "=" characters35 * ,,subscript,, 36 37 Note that the `{{{...}}}` and {{{`...`}}} commands not only select a monospace font, but also treat their content as verbatim text, meaning that no further wiki processing is done on this text. 38 39 == Headings == 40 41 You can create heading by starting a line with one up to five ''equal'' characters ("=") 42 42 followed by a single space and the headline text. The line should end with a space 43 followed by the same number of '' equal'' characters.43 followed by the same number of ''='' characters. 44 44 45 45 Example: … … 58 58 == Paragraphs == 59 59 60 A new text paragraph is created whenever two blocks of text are separated 61 by one or more empty lines. 60 A new text paragraph is created whenever two blocks of text are separated by one or more empty lines. 62 61 63 62 A forced line break can also be inserted, using: … … 69 68 Line 1[[BR]]Line 2 70 69 71 Text paragraphs can be indented by starting the lines with two or more spaces.72 73 70 74 71 == Lists == 75 72 76 73 The wiki supports both ordered/numbered and unordered lists. 77 There must be a space preceding the star "*" or number "1.", or nothing will happen.78 74 79 75 Example: … … 97 93 1. Item 2 98 94 99 100 == Definition lists == 95 Note that there must be one or more spaces preceding the list item markers, otherwise the list will be treated as a normal paragraph. 96 97 98 == Definition Lists == 101 99 102 100 The wiki also supports definition lists. … … 121 119 122 120 123 == Preformatted text ==124 125 Block quotes, preformatted text, are suitable for source code snippets, notes and examples. Use three ''curly braces'' wrapped around the text to define a block quote.121 == Preformatted Text == 122 123 Block containing preformatted text are suitable for source code snippets, notes and examples. Use three ''curly braces'' wrapped around the text to define a block quote. The curly braces need to be on a separate line. 126 124 127 125 Example: … … 139 137 }}} 140 138 139 141 140 == Blockquotes == 142 141 … … 166 165 [wiki:WikiRestructuredText#BiggerReSTExample reStructuredText]. 167 166 167 168 168 == Links == 169 169 170 Hyperlinks are automatically created for WikiPageNames and urls. 171 !WikiPageLinks can be disabled by 172 prepending an exclamation mark "!" character, such as {{{!WikiPageLink}}}. 170 Hyperlinks are automatically created for WikiPageNames and URLs. !WikiPageLinks can be disabled by prepending an exclamation mark "!" character, such as {{{!WikiPageLink}}}. 173 171 174 172 Example: … … 180 178 TitleIndex, http://www.edgewall.com/, !NotAlink 181 179 182 Links can be given a more descriptive title by writing the link followed by 183 a space and a title and all this inside square brackets. 184 If the descriptive title is omitted, then the explicit prefix is disguarded, 185 unless the link is an external link. This can be useful for wiki pages 186 not adhering to the WikiPageNames convention. 187 188 Like this: 180 Links can be given a more descriptive title by writing the link followed by a space and a title and all this inside square brackets. If the descriptive title is omitted, then the explicit prefix is disguarded, unless the link is an external link. This can be useful for wiki pages not adhering to the WikiPageNames convention. 181 182 Example: 189 183 {{{ 190 184 * [http://www.edgewall.com/ Edgewall Software] … … 201 195 === Trac Links === 202 196 203 Wiki pages can link directly to other parts of the Trac system. 204 Pages can refer to tickets, reports, changesets, milestones, source files and 205 other Wiki pages using the following notation: 197 Wiki pages can link directly to other parts of the Trac system. Pages can refer to tickets, reports, changesets, milestones, source files and other Wiki pages using the following notations: 206 198 {{{ 207 199 * Tickets: #1 or ticket:1 208 200 * Reports: {1} or report:1 209 201 * Changesets: r1, [1] or changeset:1 210 * Revision Logs: r1:3, [1:3] or log:branches/0. 9-stable#1:3202 * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1:3 211 203 * Wiki pages: CamelCase or wiki:CamelCase 212 204 * Milestones: milestone:1.0 or milestone:"End-of-days Release" … … 221 213 * Reports: {1} or report:1 222 214 * Changesets: r1, [1] or changeset:1 223 * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1 000:2000215 * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1:3 224 216 * Wiki pages: CamelCase or wiki:CamelCase 225 217 * Milestones: milestone:1.0 or milestone:"End-of-days Release" … … 236 228 You may avoid making hyperlinks out of TracLinks by preceding an expression with a single "!" (exclamation mark). 237 229 230 Example: 238 231 {{{ 239 232 !NoHyperLink … … 259 252 http://www.edgewall.com/gfx/trac_example_image.png 260 253 261 However, this doesn't give much control over the display mode. 262 This way of inserting images is deprecated in favor of the more powerful `Image` macro 263 (see WikiMacros). 254 However, this doesn't give much control over the display mode. This way of inserting images is deprecated in favor of the more powerful `Image` macro (see WikiMacros). 264 255 265 256 266 257 == Macros == 267 258 268 Macros are ''custom functions'' to insert dynamic content in a page. 269 See WikiMacros for usage. 259 Macros are ''custom functions'' to insert dynamic content in a page. 270 260 271 261 Example: … … 277 267 [[Timestamp]] 278 268 269 See WikiMacros for more information, and a list of installed macros. 270 279 271 280 272 == Processors == 281 273 282 Trac supports alternative markup formats using WikiProcessors. 283 For example, processors are used to write pages in 274 Trac supports alternative markup formats using WikiProcessors. For example, processors are used to write pages in 284 275 [wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML]. 285 276 286 See WikiProcessors for more information. 287 288 '''Example 1:''' 277 Example 1: 289 278 {{{ 290 279 #!html … … 301 290 }}} 302 291 303 '''Example 2:''' 292 Example: 304 293 {{{ 305 294 #!html … … 333 322 }}} 334 323 324 See WikiProcessors for more information. 325 326 335 327 == Miscellaneous == 336 328 … … 347 339 348 340 ---- 349 350 341 See also: TracLinks, TracGuide, WikiHtml, WikiMacros, WikiProcessors, TracSyntaxColoring. 351 352 ----353