Changes between Version 125 and Version 126 of WikiFormatting
- Timestamp:
- Jul 23, 2018, 12:00:19 AM (6 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
WikiFormatting
v125 v126 6 6 Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into a flexible and unified whole. 7 7 8 Trac has a built-inpowerful wiki rendering engine that implements a subset of the commands from other popular Wikis, such as [http://moinmo.in/ MoinMoin] and [trac:WikiCreole].8 Trac has a powerful wiki rendering engine that implements a subset of the commands from other popular Wikis, such as [http://moinmo.in/ MoinMoin] and [trac:WikiCreole]. 9 9 10 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 11 12 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 preciselyto any Trac resource or parts thereof.13 - TracLinks covers all the possible ways to refer to any Trac resource or parts thereof. 14 14 - WikiPageNames covers the various names a wiki page can take, whether in CamelCase or not. 15 15 - WikiMacros lists the macros available for generating dynamic content. … … 95 95 {{{ 96 96 {{{ 97 multiple lines, ''no wiki'' 97 multiple lines, ''no wiki'', 98 98 white space respected 99 99 }}} … … 102 102 {{{#!td 103 103 {{{ 104 multiple lines, ''no wiki'' 104 multiple lines, ''no wiki'', 105 105 white space respected 106 106 }}} … … 194 194 {{{#!td 195 195 {{{ 196 {{{ 197 #!div style="font-size: 80%" 196 {{{#!div style="font-size: 80%" 198 197 Code highlighting: 199 198 {{{#!python … … 204 203 }}} 205 204 {{{#!td style="padding-left: 2em" 206 {{{ 207 #!div style="font-size: 80%" 205 {{{#!div style="font-size: 80%" 208 206 Code highlighting: 209 207 {{{#!python … … 280 278 Notes: 281 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. 282 * {{{ ! }}} 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.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. 283 281 * all the font styles marks have to be used in opening/closing pairs, 284 282 and they must nest properly; in particular, an `''` italic can't be paired … … 287 285 == Headings 288 286 289 You can create heading by starting a line with one up to six ''equal'' characters ("=") followed by a single space and the headline text.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. 290 288 291 289 [=#hn] 292 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 The headline text can be followed by the same number of `=` characters, but this is not mandatory. That is, `=== Section3 ===` is identical to `=== Section3`. 293 291 294 292 Finally, the heading might optionally be followed by an explicit id. If not, an implicit but nevertheless readable id will be generated. … … 462 460 == Discussion Citations 463 461 464 To delineate a citation in an ongoing discussion thread, such as the ticket comment area, email-like citation marks ( ">", ">>", etc.) may be used.462 To delineate a citation in an ongoing discussion thread, such as the ticket comment area, email-like citation marks (`>`, `>>`, etc.) may be used. 465 463 466 464 ||= Wiki Markup =||= Display =|| … … 483 481 === Simple Tables 484 482 485 Simple tables can be created like this:483 Simple tables can be created: 486 484 ||= Wiki Markup =||= Display =|| 487 485 {{{#!td … … 496 494 }}} 497 495 498 Cell headings can be specified by wrapping the content in a pair of '='characters.499 Note that the '='characters have to stick to the cell separators: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: 500 498 ||= Wiki Markup =||= Display =|| 501 499 {{{#!td … … 578 576 == Links 579 577 580 Hyperlinks are automatically created for WikiPageNames and URLs. !WikiPageLinks can be disabled by prepending an exclamation mark ( '!'), such as {{{!WikiPageLink}}}.578 Hyperlinks are automatically created for WikiPageNames and URLs. !WikiPageLinks can be disabled by prepending an exclamation mark (`!`), such as `!WikiPageLink`. 581 579 582 580 ||= Wiki Markup =||= Display =|| … … 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.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. 612 610 613 611 {{{#!td … … 709 707 == Escaping Links, WikiPageNames and other Markup == #Escaping 710 708 711 You may avoid making hyperlinks out of TracLinks by preceding an expression with a single exclamation mark ( '!').709 You may avoid making hyperlinks out of TracLinks by preceding an expression with a single exclamation mark (`!`). 712 710 713 711 ||= Wiki Markup =||= Display =|| … … 760 758 == Macros 761 759 762 Macros are ''custom functions'' t oinsert dynamic content in a page.760 Macros are ''custom functions'' that insert dynamic content in a page. 763 761 764 762 ||= Wiki Markup =||= Display =|| … … 774 772 See WikiMacros for more information, and a list of installed macros. 775 773 776 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. 777 775 778 776 ||= Wiki Markup =||= Display =|| … … 801 799 {{{#!td style="border: 0px" 802 800 {{{ 803 {{{ 804 #!html 801 {{{#!html 805 802 <h1 style="text-align: right; color: blue"> 806 803 HTML Test … … 811 808 {{{#!td valign="top" style="border: 0px" 812 809 813 {{{ 814 #!html 810 {{{#!html 815 811 <h1 style="text-align: right; color: blue">HTML Test</h1> 816 812 }}} … … 826 822 {{{#!td style="border: 0px" 827 823 {{{ 828 {{{ 829 #!python 824 {{{#!python 830 825 class Test: 831 826 … … 837 832 }}} 838 833 }}} 839 {{{ 840 #!td valign="top" style="border: 0px" 841 842 {{{ 843 #!python 834 {{{#!td valign="top" style="border: 0px" 835 836 {{{#!python 844 837 class Test: 845 838 def __init__(self): … … 888 881 }}} 889 882 }}} 890 {{{ 891 #!td valign="top" style="border: 0px" 883 {{{#!td valign="top" style="border: 0px" 892 884 893 885 {{{#!th rowspan=4 align=justify … … 931 923 {{{ 932 924 Nothing to 933 {{{ 934 #!comment 925 {{{#!comment 935 926 Your comment for editors here 936 927 }}} … … 940 931 {{{#!td 941 932 Nothing to 942 {{{ 943 #!comment 933 {{{#!comment 944 934 Your comment for editors here 945 935 }}}