Changes between Version 91 and Version 129 of WikiFormatting
- Timestamp:
- (multiple changes)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
WikiFormatting
v91 v129 1 ** Note: this page documents the 0.12 version of Trac, see [[0.11/WikiFormatting]] if you need the previous version ** 2 = WikiFormatting = 1 = WikiFormatting 2 3 3 [[TracGuideToc]] 4 5 Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into a flexible and powerful whole. 6 7 Trac has a built in small and powerful wiki rendering engine. This wiki engine implements an ever growing subset of the commands from other popular Wikis, 8 especially [http://moinmo.in/ MoinMoin] and [trac:WikiCreole]. 9 10 11 This page will give you an in-depth explanation of the wiki markup available anywhere WikiFormatting is allowed. 12 13 The ''Cheat sheet'' below gives you a quick overview for the most common syntax, each link in the ''Category'' column will lead you to the more detailed explanation later in this page. 14 15 A few other wiki pages present the advanced features of the Trac wiki markup in more depth: 16 - TracLinks covers all the possible ways to refer precisely to any Trac resource or parts thereof, 17 - WikiPageNames talks about the various names a wiki page can take, CamelCase or not 18 - WikiMacros lists the macros available for generating dynamic content, 19 - WikiProcessors and WikiHtml details how parts of the wiki text can be processed in special ways 20 21 22 == Cheatsheet == 4 [[TranslatedPages]] 5 6 Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into a flexible and unified whole. 7 8 Trac has a powerful wiki rendering engine that implements a subset of the commands from other popular Wikis, such as [https://moinmo.in/ MoinMoin] and [trac:WikiCreole]. 9 10 The sections below provide an overview for the most common syntax, each link in the ''Category'' column leads you to the more detailed explanation later in this page. 11 12 The following wiki pages present the advanced features of the Trac wiki markup in more depth: 13 - TracLinks covers all the possible ways to refer to any Trac resource or parts thereof. 14 - WikiPageNames covers the various names a wiki page can take, whether in CamelCase or not. 15 - WikiMacros lists the macros available for generating dynamic content. 16 - WikiProcessors and WikiHtml details how parts of the wiki text can be processed in special ways. 17 - [trac:wiki:TracDev/Proposals/AdvancedWikiOperations AdvancedWikiOperations] provides some operations in uncommon or administrative scenarios. 18 19 == Common wiki markup 23 20 24 21 ||= '''Category''' =||= '''Wiki Markup''' =||= '''Display''' =|| … … 29 26 || `'''bold'''`, `''italic''`, `'''''Wikipedia style'''''` || \ 30 27 || '''bold''', ''italic'', '''''Wikipedia style''''' || 31 || {{{`monospaced and ''nowiki''`}}} || \32 || `monospaced and nowiki` ||33 28 || `**bold**`, `//italic//`, `**//!WikiCreole style//**` || \ 34 29 || **bold**, //italic//, **//!WikiCreole style//** || 30 || {{{`monospaced (''other markup ignored'')`}}} || \ 31 || `monospaced (''other markup ignored'')` || 35 32 |----------------------------------------------------------- 36 33 ||= [#Headings Headings] =||\ 37 {{{#!td 38 {{{ 39 == Level 2 ==34 {{{#!td 35 {{{ 36 == Level 2 40 37 === Level 3 ^([#hn note])^ 41 38 }}} … … 65 62 {{{#!td 66 63 {{{ 67 * bullet slist68 on multiple paragraphs64 * bullet list 65 on multiple lines 69 66 1. nested list 70 a. different numbering 67 a. different numbering 71 68 styles 72 69 }}} 73 70 }}} 74 71 {{{#!td 75 * bullet slist76 on multiple paragraphs72 * bullet list 73 on multiple lines 77 74 1. nested list 78 75 a. different numbering … … 86 83 {{{ 87 84 term:: definition on 88 multiple paragraphs85 multiple lines 89 86 }}} 90 87 }}} 91 88 {{{#!td 92 89 term:: definition on 93 multiple paragraphs90 multiple lines 94 91 }}} 95 92 |----------------------------------------------------------- … … 98 95 {{{ 99 96 {{{ 100 multiple lines, ''no wiki'' 97 multiple lines, ''no wiki'', 101 98 white space respected 102 99 }}} … … 105 102 {{{#!td 106 103 {{{ 107 multiple lines, ''no wiki'' 104 multiple lines, ''no wiki'', 108 105 white space respected 109 106 }}} … … 149 146 [#Links Links] 150 147 }}} 151 || `http ://trac.edgewall.org` ||\152 || http ://trac.edgewall.org ||148 || `https://trac.edgewall.org` ||\ 149 || https://trac.edgewall.org || 153 150 || `WikiFormatting (CamelCase)` ||\ 154 151 || WikiFormatting (CamelCase) || … … 161 158 || `#1 (ticket)`, `[1] (changeset)`, `{1} (report)` ||\ 162 159 || #1 (ticket), [1] (changeset), {1} (report) || 163 || `ticket:1, ticket:1#comment:1 ` ||\164 || ticket:1, ticket:1#comment:1 ||160 || `ticket:1, ticket:1#comment:1, comment:1:ticket:1` ||\ 161 || ticket:1, ticket:1#comment:1, comment:1:ticket:1 || 165 162 || `Ticket [ticket:1]`, `[ticket:1 ticket one]` ||\ 166 163 || Ticket [ticket:1], [ticket:1 ticket one] || … … 169 166 |----------------------------------------------------------- 170 167 {{{#!th rowspan=2 171 [#EscapingLinksandWikiPageNames Escaping Markup] 168 [#SettingAnchors Setting Anchors] 169 }}} 170 || `[=#point1 (1)] First...` ||\ 171 || [=#point1 (1)] First... || 172 || `see [#point1 (1)]` ||\ 173 || see [#point1 (1)] || 174 |----------------------------------------------------------- 175 {{{#!th rowspan=3 176 [#Escaping Escaping Markup] 172 177 }}} 173 178 || `!'' doubled quotes` ||\ … … 175 180 || `!wiki:WikiFormatting`, `!WikiFormatting` ||\ 176 181 || !wiki:WikiFormatting, !WikiFormatting || 182 || [[html(<code>`{{{-}}}` triple curly brackets</code>)]] ||\ 183 || `{{{-}}}` triple curly brackets || 177 184 |----------------------------------------------------------- 178 185 ||= [#Images Images] =|| `[[Image(`''link''`)]]` || [[Image(htdocs:../common/trac_logo_mini.png)]] || … … 187 194 {{{#!td 188 195 {{{ 189 {{{ 190 #!div style="font-size: 80%" 196 {{{#!div style="font-size: 80%" 191 197 Code highlighting: 192 198 {{{#!python … … 197 203 }}} 198 204 {{{#!td style="padding-left: 2em" 199 {{{ 200 #!div style="font-size: 80%" 205 {{{#!div style="font-size: 80%" 201 206 Code highlighting: 202 {{{#!python 207 {{{#!python 203 208 hello = lambda: "world" 204 209 }}} … … 214 219 }}} 215 220 }}} 216 {{{#!td style="padding-left: 2em" 217 {{{#!comment 218 Note to Editors: ... 219 }}} 220 }}} 221 || ''(comment is shown in edit mode only)'' || 221 222 |----------------------------------------------------------- 222 223 ||= [#Miscellaneous Miscellaneous] =||\ 223 224 {{{#!td 224 225 {{{ 225 Line [[br]] break 226 Line [[br]] break 226 227 Line \\ break 227 228 ---- … … 234 235 }}} 235 236 236 237 == Font Styles == 237 == Font Styles 238 238 239 239 The Trac wiki supports the following font styles: … … 241 241 {{{#!td 242 242 {{{ 243 * '''bold''', 244 ''' triple quotes !''' 245 can be bold too if prefixed by ! ''', 243 * '''bold''', 244 ''' triple quotes !''' 245 can be bold too if prefixed by ! ''', 246 246 * ''italic'' 247 247 * '''''bold italic''''' or ''italic and … … 251 251 (hence `{{{` or {{{`}}} quoting) 252 252 * ~~strike-through~~ 253 * ^superscript^ 253 * ^superscript^ 254 254 * ,,subscript,, 255 * **also bold**, //italic as well//, 255 * **also bold**, //italic as well//, 256 256 and **'' bold italic **'' //(since 0.12)// 257 }}} 258 }}} 259 {{{#!td 260 * '''bold''', 261 ''' triple quotes !''' 262 can be bold too if prefixed by ! ''', 257 * [[span(style=color: #FF0000, a red text )]] 258 }}} 259 }}} 260 {{{#!td 261 * '''bold''', 262 ''' triple quotes !''' 263 can be bold too if prefixed by ! ''', 263 264 * ''italic'' 264 265 * '''''bold italic''''' or ''italic and … … 268 269 (hence `{{{` or {{{`}}} quoting) 269 270 * ~~strike-through~~ 270 * ^superscript^ 271 * ^superscript^ 271 272 * ,,subscript,, 272 * **also bold**, //italic as well//, 273 * **also bold**, //italic as well//, 273 274 and **'' bold italic **'' //(since 0.12)// 275 * [[span(style=color: #FF0000, a red text )]] 274 276 }}} 275 277 276 278 Notes: 277 279 * `{{{...}}}` 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. 278 * {{{ ! }}} tells wiki parser to not take the following characters as wiki format, so pay attention to put a space after !, e.g. when ending bold. 279 * all the font styles marks have to be used in opening/closing pairs, 280 and they must nest properly (in particular, an `''` italic can't be paired 281 with a `//` one, and `'''` can't be paired with `**`) 282 283 284 == Headings == 285 286 You can create heading by starting a line with one up to six ''equal'' characters ("=") 287 followed by a single space and the headline text. 288 289 [=#hn] The headline text can be followed by the same number of "=" characters, but this is no longer mandatory. 280 * {{{ ! }}} tells wiki parser to not take the following characters as wiki format, so pay attention to put a space after `!`, e.g. when ending bold. 281 * all the font styles marks have to be used in opening/closing pairs, 282 and they must nest properly; in particular, an `''` italic can't be paired 283 with a `//` one, and `'''` can't be paired with `**`. 284 285 == Headings 286 287 You can create a heading by starting a line with one up to six ''equal'' characters (`=`) followed by a single space and the headline text. 288 289 [=#hn] 290 The headline text can be followed by the same number of `=` characters, but this is not mandatory. That is, `=== Section3 ===` is identical to `=== Section3`. 290 291 291 292 Finally, the heading might optionally be followed by an explicit id. If not, an implicit but nevertheless readable id will be generated. … … 304 305 {{{ 305 306 #!div 307 = Heading = 306 308 == Subheading 307 309 === About ''this'' === … … 311 313 }}} 312 314 313 == Paragraphs ==315 == Paragraphs 314 316 315 317 A new text paragraph is created whenever two blocks of text are separated by one or more empty lines. … … 325 327 one 326 328 327 Paragraph 329 Paragraph 328 330 two 329 331 }}} … … 332 334 Line 1[[BR]]Line 2 333 335 334 Paragraph 336 Paragraph 335 337 one 336 338 337 Paragraph 339 Paragraph 338 340 two 339 341 }}} 340 342 341 == Lists ==343 == Lists 342 344 343 345 The wiki supports both ordered/numbered and unordered lists. 344 346 345 Example:346 347 ||= Wiki Markup =||= Display =|| 347 348 {{{#!td … … 349 350 * Item 1 350 351 * Item 1.1 351 * Item 1.1.1 352 * Item 1.1.1 352 353 * Item 1.1.2 353 354 * Item 1.1.3 … … 356 357 - items can start at the beginning of a line 357 358 and they can span multiple lines 358 - be careful though to continue the line 359 - be careful though to continue the line 359 360 with the appropriate indentation, otherwise 360 361 that will start a new paragraph... 361 362 362 363 1. Item 1 363 364 a. Item 1.a … … 374 375 * Item 1 375 376 * Item 1.1 376 * Item 1.1.1 377 * Item 1.1.1 377 378 * Item 1.1.2 378 379 * Item 1.1.3 … … 381 382 - items can start at the beginning of a line 382 383 and they can span multiple lines 383 - be careful though to continue the line 384 - be careful though to continue the line 384 385 with the appropriate indentation, otherwise 385 386 that will start a new paragraph... … … 395 396 }}} 396 397 397 398 == Definition Lists == 398 == Definition Lists 399 399 400 400 The wiki also supports definition lists. … … 420 420 Note that you need a space in front of the defined term. 421 421 422 423 == Preformatted Text == 422 == Preformatted Text 424 423 425 424 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. 426 425 427 426 ||= Wiki Markup =||= Display =|| 428 427 {{{#!td … … 443 442 Note that this kind of block is also used for selecting lines that should be processed through WikiProcessors. 444 443 445 == Blockquotes ==444 == Blockquotes 446 445 447 446 In order to mark a paragraph as blockquote, indent that paragraph with two spaces. … … 459 458 }}} 460 459 461 == Discussion Citations ==462 463 To delineate a citation in an ongoing discussion thread, such as the ticket comment area, e -mail-like citation marks (">", ">>", etc.) may be used.460 == Discussion Citations 461 462 To delineate a citation in an ongoing discussion thread, such as the ticket comment area, email-like citation marks (`>`, `>>`, etc.) may be used. 464 463 465 464 ||= Wiki Markup =||= Display =|| … … 479 478 }}} 480 479 481 482 == Tables ==483 === Simple Tables === 484 Simple tables can be created like this:480 == Tables 481 === Simple Tables 482 483 Simple tables can be created: 485 484 ||= Wiki Markup =||= Display =|| 486 485 {{{#!td … … 495 494 }}} 496 495 497 Cell headings can be specified by wrapping the content in a pair of '='characters.498 Note that the '=' characters have to stick to the cell separators, like this:496 Cell headings can be specified by wrapping the content in a pair of `=` characters. 497 Note that the `=` characters have to stick to the cell separators: 499 498 ||= Wiki Markup =||= Display =|| 500 499 {{{#!td … … 511 510 }}} 512 511 513 Finally, specifying an empty cell means that the next non empty cell will span the empty cells . For example:512 Finally, specifying an empty cell means that the next non empty cell will span the empty cells: 514 513 ||= Wiki Markup =||= Display =|| 515 514 {{{#!td … … 528 527 }}} 529 528 530 Note that if the content of a cell "sticks" to one side of the cell and only one, then the text will be aligned on that side. Example:529 Note that if the content of a cell sticks to one side of the cell and only one, then the text will be aligned on that side: 531 530 ||= Wiki Markup =||= Display =|| 532 531 {{{#!td … … 553 552 }}} 554 553 555 If contrary to the example above, the cells in your table contain more text, it might be convenient to spread a table row over multiple lines of markup. The `\` character placed at the end of a line after a cell separator tells Trac to not start a new row for the cells on the next line .554 If contrary to the example above, the cells in your table contain more text, it might be convenient to spread a table row over multiple lines of markup. The `\` character placed at the end of a line after a cell separator tells Trac to not start a new row for the cells on the next line: 556 555 557 556 ||= Wiki Markup =|| 558 557 {{{#!td 559 558 {{{ 560 || this is column 1 [http ://trac.edgewall.org/newticket new ticket] || \561 || this is column 2 [http ://trac.edgewall.org/roadmap the road ahead] || \559 || this is column 1 [https://trac.edgewall.org/newticket new ticket] || \ 560 || this is column 2 [https://trac.edgewall.org/roadmap the road ahead] || \ 562 561 || that's column 3 and last one || 563 562 }}} … … 566 565 ||= Display =|| 567 566 {{{#!td style="padding: 2em;" 568 || this is column 1 [http ://trac.edgewall.org/newticket new ticket] || \569 || this is column 2 [http ://trac.edgewall.org/roadmap the road ahead] || \567 || this is column 1 [https://trac.edgewall.org/newticket new ticket] || \ 568 || this is column 2 [https://trac.edgewall.org/roadmap the road ahead] || \ 570 569 || that's column 3 and last one || 571 570 }}} 572 571 573 === Complex Tables === 574 575 If the possibilities offered by the simple "pipe"-based markup for tables described above are not enough for your needs, you can create more elaborated tables by using [#Processors-example-tables WikiProcessor based tables]. 576 577 578 == Links == 579 580 Hyperlinks are automatically created for WikiPageNames and URLs. !WikiPageLinks can be disabled by prepending an exclamation mark "!" character, such as {{{!WikiPageLink}}}. 581 582 ||= Wiki Markup =||= Display =|| 583 {{{#!td 584 {{{ 585 TitleIndex, http://www.edgewall.com/, !NotAlink 586 }}} 587 }}} 588 {{{#!td 589 TitleIndex, http://www.edgewall.com/, !NotAlink 590 }}} 591 592 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. 572 === Complex Tables 573 574 If the possibilities offered by the simple pipe-based markup (`||`) for tables described above are not enough for your needs, you can create more elaborate tables by using [#Processors-example-tables WikiProcessor based tables]. 575 576 == Links 577 578 Hyperlinks are automatically created for WikiPageNames and URLs. !WikiPageLinks can be disabled by prepending an exclamation mark (`!`), such as `!WikiPageLink`. 579 580 ||= Wiki Markup =||= Display =|| 581 {{{#!td 582 {{{ 583 TitleIndex, https://www.edgewall.com/, !NotAlink 584 }}} 585 }}} 586 {{{#!td 587 TitleIndex, https://www.edgewall.com/, !NotAlink 588 }}} 589 590 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. 593 591 If the descriptive title is omitted, then the explicit prefix is discarded, unless the link is an external link. This can be useful for wiki pages not adhering to the WikiPageNames convention. 594 592 … … 596 594 {{{#!td 597 595 {{{ 598 * [http ://www.edgewall.com Edgewall Software]599 * [wiki:TitleIndex Title Index] 600 * [wiki:TitleIndex] 596 * [https://www.edgewall.com Edgewall Software] 597 * [wiki:TitleIndex Title Index] 598 * [wiki:TitleIndex] 601 599 * [wiki:ISO9000] 602 600 }}} 603 601 }}} 604 602 {{{#!td 605 * [http ://www.edgewall.com Edgewall Software]606 * [wiki:TitleIndex Title Index] 607 * [wiki:TitleIndex] 603 * [https://www.edgewall.com Edgewall Software] 604 * [wiki:TitleIndex Title Index] 605 * [wiki:TitleIndex] 608 606 * [wiki:ISO9000] 609 607 }}} 610 608 611 Following the [trac:WikiCreole] trend, the descriptive title can also be specified by writing the link followed by a pipe ( '|') and a title and all this inside //double// square brackets.612 613 {{{#!td 614 {{{ 615 * [[http ://www.edgewall.com|Edgewall Software]]609 Following the [trac:WikiCreole] trend, the descriptive title can also be specified by writing the link followed by a pipe (`|`) and a title and all this inside //double// square brackets. 610 611 {{{#!td 612 {{{ 613 * [[https://www.edgewall.com|Edgewall Software]] 616 614 * [[wiki:TitleIndex|Title Index]] 617 615 or even [[TitleIndex|Title Index]] … … 622 620 }}} 623 621 {{{#!td 624 * [[http ://www.edgewall.com|Edgewall Software]]622 * [[https://www.edgewall.com|Edgewall Software]] 625 623 * [[wiki:TitleIndex|Title Index]] 626 624 or even [[TitleIndex|Title Index]] … … 630 628 }}} 631 629 632 '''Note''': the [trac:WikiCreole] style for links is quick to type and 633 certainly looks familiar as it's the one used on Wikipedia and in many 634 other wikis. Unfortunately it conflicts with the syntax for [#Macros macros]. 635 So in the rare case when you need to refer to a page which is named after 636 a macro (typical examples being TitleIndex, InterTrac and InterWiki), 637 by writing `[[TitleIndex]]` you will actually call the macro instead of linking 638 to the page. 639 640 == Trac Links == 630 '''Note''': the [trac:WikiCreole] style for links is quick to type and certainly looks familiar as it is the one used on Wikipedia and in many other wikis. Unfortunately it conflicts with the syntax for [#Macros macros]. 631 So in the rare case when you need to refer to a page which is named after a macro (typical examples being TitleIndex, InterTrac and InterWiki), by writing `[[TitleIndex]]` you will actually call the macro instead of linking to the page. 632 633 == Trac Links 641 634 642 635 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: … … 649 642 * Changesets: r1, [1] or changeset:1 650 643 * ... 651 * targeting other Trac instances, 644 * targeting other Trac instances, 652 645 so called InterTrac links: 653 646 - Tickets: #Trac1 or Trac:ticket:1 … … 659 652 * Reports: {1} or report:1 660 653 * Changesets: r1, [1] or changeset:1 661 * ... 662 * targeting other Trac instances, 654 * ... 655 * targeting other Trac instances, 663 656 so called InterTrac links: 664 657 - Tickets: #Trac1 or Trac:ticket:1 … … 668 661 There are many more flavors of Trac links, see TracLinks for more in-depth information and a reference for all the default link resolvers. 669 662 670 671 == Escaping Links and WikiPageNames == 672 673 You may avoid making hyperlinks out of TracLinks by preceding an expression with a single "!" (exclamation mark). 663 == Setting Anchors 664 665 An anchor, or more correctly speaking, an [https://www.w3.org/TR/REC-html40/struct/links.html#h-12.2.1 anchor name] can be added explicitly at any place in the Wiki page, to uniquely identify a position in the document: 666 667 {{{ 668 [=#point1] 669 }}} 670 671 This syntax was chosen to match the format for explicitly naming the header id [#Headings documented above]: 672 {{{ 673 == Long title == #title 674 }}} 675 676 It is also very close to the syntax for the corresponding link to that anchor: 677 {{{ 678 [#point1] 679 }}} 680 681 Optionally, a label can be given to the anchor: 682 {{{ 683 [=#point1 '''Point 1'''] 684 }}} 685 686 ||= Wiki Markup =||= Display =|| 687 |---------------------------------- 688 {{{#!td 689 {{{ 690 [#point2 jump to the second point] 691 692 ... 693 694 Point2: [=#point2] Jump here 695 }}} 696 }}} 697 {{{#!td 698 [#point2 jump to the second point] 699 700 ... 701 702 Point2: [=#point2] Jump here 703 }}} 704 705 For more complex anchors (eg when a custom title is wanted), you can use the Span macro: `[[span(id=point2, class=wikianchor, title=Point 2, ^(2)^)]]`. 706 707 == Escaping Links, WikiPageNames and other Markup == #Escaping 708 709 You may avoid making hyperlinks out of TracLinks by preceding an expression with a single exclamation mark (`!`). 674 710 675 711 ||= Wiki Markup =||= Display =|| … … 679 715 !#42 is not a link 680 716 }}} 717 {{{ 718 Various forms of escaping for list markup: 719 ^^- escaped minus sign \\ 720 ^^1. escaped number \\ 721 ^^* escaped asterisk sign 722 }}} 681 723 }}} 682 724 {{{#!td 683 725 !NoHyperLink 684 726 !#42 is not a link 685 }}} 686 687 == Images == 727 728 Various forms of escaping for list markup: 729 ^^- escaped minus sign \\ 730 ^^1. escaped number \\ 731 ^^* escaped asterisk sign 732 }}} 733 734 == Images 688 735 689 736 Urls ending with `.png`, `.gif` or `.jpg` are no longer automatically interpreted as image links, and converted to `<img>` tags. … … 694 741 * `[[Image(wiki:WikiFormatting:picture.gif)]]` (referring to attachment on another page) 695 742 * `[[Image(ticket:1:picture.gif)]]` (file attached to a ticket) 696 * `[[Image(htdocs:picture.gif)]]` (referring to a file inside project htdocs)743 * `[[Image(htdocs:picture.gif)]]` (referring to a file inside the [TracEnvironment environment] `htdocs` directory) 697 744 * `[[Image(source:/trunk/trac/htdocs/trac_logo_mini.png)]]` (a file in repository) 698 745 … … 707 754 }}} 708 755 709 See WikiMacros for further documentation on the `[[Image()]]` macro. 710 711 712 == Macros == 713 714 Macros are ''custom functions'' to insert dynamic content in a page. 756 See WikiMacros for further documentation on the `[[Image()]]` macro, which has several useful options (`title=`, `link=`, etc.) 757 758 == Macros 759 760 Macros are ''custom functions'' that insert dynamic content in a page. 715 761 716 762 ||= Wiki Markup =||= Display =|| … … 726 772 See WikiMacros for more information, and a list of installed macros. 727 773 728 The detailed help for a specific macro can also be obtained more directly by appending a "?"to the macro name.774 The detailed help for a specific macro can also be obtained more directly by appending a `?` to the macro name. 729 775 730 776 ||= Wiki Markup =||= Display =|| … … 738 784 }}} 739 785 740 741 == Processors == 742 743 Trac supports alternative markup formats using WikiProcessors. For example, processors are used to write pages in 744 [wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML]. 786 == Processors 787 788 Trac supports alternative markup formats using WikiProcessors. For example, processors are used to write pages in 789 [wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML]. 745 790 746 791 ||= Wiki Markup =||= Display =|| … … 754 799 {{{#!td style="border: 0px" 755 800 {{{ 756 {{{ 757 #!html 801 {{{#!html 758 802 <h1 style="text-align: right; color: blue"> 759 803 HTML Test … … 764 808 {{{#!td valign="top" style="border: 0px" 765 809 766 {{{ 767 #!html 810 {{{#!html 768 811 <h1 style="text-align: right; color: blue">HTML Test</h1> 769 812 }}} … … 779 822 {{{#!td style="border: 0px" 780 823 {{{ 781 {{{ 782 #!python 824 {{{#!python 783 825 class Test: 784 826 785 827 def __init__(self): 786 828 print "Hello World" … … 790 832 }}} 791 833 }}} 792 {{{ 793 #!td valign="top" style="border: 0px" 794 795 {{{ 796 #!python 834 {{{#!td valign="top" style="border: 0px" 835 836 {{{#!python 797 837 class Test: 798 838 def __init__(self): … … 824 864 |---------------- 825 865 {{{#!td 826 As processors can be easily nested, 866 As processors can be easily nested, 827 867 so can be tables: 828 868 {{{#!th … … 841 881 }}} 842 882 }}} 843 {{{ 844 #!td valign="top" style="border: 0px" 883 {{{#!td valign="top" style="border: 0px" 845 884 846 885 {{{#!th rowspan=4 align=justify … … 856 895 |---------------- 857 896 {{{#!td 858 As processors can be easily nested, 897 As processors can be easily nested, 859 898 so can be tables: 860 899 {{{#!th … … 876 915 See WikiProcessors for more information. 877 916 878 879 == Comments == 917 == Comments 880 918 881 919 Comments can be added to the plain text. These will not be rendered and will not display in any other format than plain text. … … 885 923 {{{ 886 924 Nothing to 887 {{{ 888 #!comment 925 {{{#!comment 889 926 Your comment for editors here 890 927 }}} 891 see ;-)928 see. 892 929 }}} 893 930 }}} 894 931 {{{#!td 895 932 Nothing to 896 {{{ 897 #!comment 933 {{{#!comment 898 934 Your comment for editors here 899 935 }}} 900 see ;-) 901 }}} 902 903 == Miscellaneous == 904 905 An horizontal line can be used to separated different parts of your page: 906 907 ||= Wiki Markup =||= Display =|| 908 {{{#!td 909 {{{ 910 Four or more dashes will be replaced 911 by an horizontal line (<HR>) 936 see. 937 }}} 938 939 == Miscellaneous 940 941 ||= Wiki Markup =||= Display =|| 942 {{{#!td 943 Horizontal line: 944 {{{ 945 Four or more dashes will be replaced 946 by a horizontal line (<HR>) 912 947 ---- 913 948 See? … … 916 951 {{{#!td 917 952 Four or more dashes will be replaced 918 by a nhorizontal line (<HR>)953 by a horizontal line (<HR>) 919 954 ---- 920 955 See? … … 922 957 |---------------------------------- 923 958 {{{#!td 924 {{{ 925 "macro" style [[br]] line break 926 }}} 927 }}} 928 {{{#!td 929 "macro" style [[br]] line break 959 Two examples of line breaks: 960 {{{ 961 "macro" style [[BR]] line break 962 }}} 963 or: 964 {{{ 965 !WikiCreole style \\ line\\break 966 }}} 967 }}} 968 {{{#!td 969 "macro" style [[BR]] line break 970 971 !WikiCreole style \\ line\\break 930 972 }}} 931 973 |---------------------------------- 932 {{{#!td933 {{{934 !WikiCreole style \\ line\\break935 }}}936 }}}937 {{{#!td938 !WikiCreole style \\ line\\break939 }}}