Changes between Version 1 and Version 2 of WikiFormatting
- Timestamp:
- Jan 30, 2006, 11:09:16 PM (18 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
WikiFormatting
v1 v2 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 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: 128 126 {{{ 129 127 {{{ 130 def HelloWorld() 128 def HelloWorld(): 131 129 print "Hello World" 132 130 }}} … … 135 133 Display: 136 134 {{{ 137 def HelloWorld() 135 def HelloWorld(): 138 136 print "Hello World" 139 137 }}} 140 138 139 140 == Blockquotes == 141 142 In order to mark a paragraph as blockquote, indent that paragraph with two spaces. 143 144 Example: 145 {{{ 146 This text is a quote from someone else. 147 }}} 148 149 Display: 150 This text is a quote from someone else. 141 151 142 152 == Tables == … … 155 165 [wiki:WikiRestructuredText#BiggerReSTExample reStructuredText]. 156 166 167 157 168 == Links == 158 169 159 Hyperlinks are automatically created for WikiPageNames and urls. 160 !WikiPageLinks can be disabled by 161 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}}}. 162 171 163 172 Example: … … 169 178 TitleIndex, http://www.edgewall.com/, !NotAlink 170 179 171 Links can be given a more descriptive title by writing the link followed by 172 a space and a title and all this inside square brackets. 173 If the descriptive title is omitted, then the explicit prefix is disguarded, 174 unless the link is an external link. This can be useful for wiki pages 175 not adhering to the WikiPageNames convention. 176 177 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: 178 183 {{{ 179 184 * [http://www.edgewall.com/ Edgewall Software] … … 190 195 === Trac Links === 191 196 192 Wiki pages can link directly to other parts of the Trac system. 193 Pages can refer to tickets, reports, changesets, milestones, source files and 194 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: 195 198 {{{ 196 199 * Tickets: #1 or ticket:1 197 200 * Reports: {1} or report:1 198 201 * Changesets: r1, [1] or changeset:1 199 * 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 200 203 * Wiki pages: CamelCase or wiki:CamelCase 201 204 * Milestones: milestone:1.0 or milestone:"End-of-days Release" 202 205 * Files: source:trunk/COPYING 206 * Attachments: attachment:"file name.doc" 203 207 * A specific file revision: source:/trunk/COPYING#200 204 208 * A filename with embedded space: source:"/trunk/README FIRST" … … 209 213 * Reports: {1} or report:1 210 214 * Changesets: r1, [1] or changeset:1 211 * 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 212 216 * Wiki pages: CamelCase or wiki:CamelCase 213 217 * Milestones: milestone:1.0 or milestone:"End-of-days Release" 214 218 * Files: source:trunk/COPYING 219 * Attachments: attachment:"file name.doc" 215 220 * A specific file revision: source:/trunk/COPYING#200 216 221 * A filename with embedded space: source:"/trunk/README FIRST" … … 223 228 You may avoid making hyperlinks out of TracLinks by preceding an expression with a single "!" (exclamation mark). 224 229 230 Example: 225 231 {{{ 226 232 !NoHyperLink … … 246 252 http://www.edgewall.com/gfx/trac_example_image.png 247 253 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). 255 248 256 249 257 == Macros == 250 258 251 Macros are ''custom functions'' to insert dynamic content in a page. 252 See WikiMacros for usage. 259 Macros are ''custom functions'' to insert dynamic content in a page. 253 260 254 261 Example: … … 260 267 [[Timestamp]] 261 268 269 See WikiMacros for more information, and a list of installed macros. 270 262 271 263 272 == Processors == 264 273 265 Trac supports alternative markup formats using WikiProcessors. 266 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 267 275 [wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML]. 268 276 269 See WikiProcessors for more information. 270 271 '''Example 1:''' 277 Example 1: 272 278 {{{ 273 279 #!html … … 284 290 }}} 285 291 286 '''Example 2:''' 292 Example: 287 293 {{{ 288 294 #!html … … 307 313 }}} 308 314 315 Perl: 316 {{{ 317 #!perl 318 my ($test) = 0; 319 if ($test > 0) { 320 echo "hello"; 321 } 322 }}} 323 324 See WikiProcessors for more information. 325 309 326 310 327 == Miscellaneous == … … 322 339 323 340 ---- 324 325 341 See also: TracLinks, TracGuide, WikiHtml, WikiMacros, WikiProcessors, TracSyntaxColoring. 326 327 ----
