Changes between Version 2 and Version 3 of WikiFormatting


Ignore:
Timestamp:
Dec 14, 2006, 8:47:14 PM (17 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • WikiFormatting

    v2 v3  
    1515The Trac wiki supports the following font styles:
    1616{{{
    17  * '''bold'''
     17 * '''bold''', '''!''' can be bold too''', and '''! '''
    1818 * ''italic''
    1919 * '''''bold italic'''''
    … …  
    2626
    2727Display:
    28  * '''bold'''
     28 * '''bold''', '''!''' can be bold too''', and '''! '''
    2929 * ''italic''
    3030 * '''''bold italic'''''
    … …  
    3535 * ,,subscript,,
    3636
    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.
     37Notes:
     38 * `{{{...}}}` 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.
     39 * {{{ ! }}} 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.
    3840
    3941== Headings ==
    … …  
    4244followed by a single space and the headline text. The line should end with a space
    4345followed by the same number of ''='' characters.
     46The heading might optionally be followed by an explicit id. If not, an implicit but nevertheless readable id will be generated.
    4447
    4548Example:
    … …  
    4851== Subheading ==
    4952=== About ''this'' ===
     53=== Explicit id === #using-explicit-id-in-heading
    5054}}}
    5155
    … …  
    5458== Subheading ==
    5559=== About ''this'' ===
    56 
     60=== Explicit id === #using-explicit-id-in-heading
    5761
    5862== Paragraphs ==
    … …  
    8084
    8185 1. Item 1
    82    1. Item 1.1
     86   a. Item 1.a
     87   a. Item 1.b
     88      i. Item 1.b.i
     89      i. Item 1.b.ii
    8390 1. Item 2
     91And numbered lists can also be given an explicit number:
     92 3. Item 3
    8493}}}
    8594
    … …  
    9099
    91100 1. Item 1
    92    1. Item 1.1
     101   a. Item 1.a
     102   a. Item 1.b
     103      i. Item 1.b.i
     104      i. Item 1.b.ii
    93105 1. Item 2
     106And numbered lists can also be given an explicit number:
     107 3. Item 3
    94108
    95109Note that there must be one or more spaces preceding the list item markers, otherwise the list will be treated as a normal paragraph.
    … …  
    97111
    98112== Definition Lists ==
     113
    99114
    100115The wiki also supports definition lists.
    … …  
    144159Example:
    145160{{{
    146 This text is not a quote from someone else.
    147 
    148161  This text is a quote from someone else.
    149 
    150 This text comes after a quote from someone else.
    151 }}}
    152 
    153 Display:
    154 
    155 This text is not a quote from someone else.
    156 
     162}}}
     163
     164Display:
    157165  This text is a quote from someone else.
    158166
    159 This text comes after a quote from someone else.
     167== Discussion Citations ==
     168
     169To delineate a citation in an ongoing discussion thread, such as the ticket comment area, e-mail-like citation marks (">", ">>", etc.) may be used. 
     170
     171Example:
     172{{{
     173>> Someone's original text
     174> Someone else's reply text
     175My reply text
     176}}}
     177
     178Display:
     179>> Someone's original text
     180> Someone else's reply text
     181My reply text
     182
     183''Note: Some WikiFormatting elements, such as lists and preformatted text, are  lost in the citation area.  Some reformatting may be necessary to create a clear citation.''
    160184
    161185== Tables ==
    … …  
    187211 TitleIndex, http://www.edgewall.com/, !NotAlink
    188212
    189 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.
     213Links 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 discarded, unless the link is an external link. This can be useful for wiki pages not adhering to the WikiPageNames convention.
    190214
    191215Example:
    … …  
    209233 * Reports: {1} or report:1
    210234 * Changesets: r1, [1] or changeset:1
    211  * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1:3
    212  * Wiki pages: CamelCase or wiki:CamelCase
    213  * Milestones: milestone:1.0 or milestone:"End-of-days Release"
    214  * Files: source:trunk/COPYING
    215  * Attachments: attachment:"file name.doc"
    216  * A specific file revision: source:/trunk/COPYING#200
    217  * A filename with embedded space: source:"/trunk/README FIRST"
     235 * ...
    218236}}}
    219237
    … …  
    222240 * Reports: {1} or report:1
    223241 * Changesets: r1, [1] or changeset:1
    224  * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1:3
    225  * Wiki pages: CamelCase or wiki:CamelCase
    226  * Milestones: milestone:1.0 or milestone:"End-of-days Release"
    227  * Files: source:trunk/COPYING
    228  * Attachments: attachment:"file name.doc"
    229  * A specific file revision: source:/trunk/COPYING#200
    230  * A filename with embedded space: source:"/trunk/README FIRST"
     242 * ...
    231243
    232244See TracLinks for more in-depth information.
    … …  
    250262== Images ==
    251263
    252 Urls ending with `.png`, `.gif` or `.jpg` are automatically interpreted as image links, and converted to `<img>` tags.
    253 
    254 Example:
    255 {{{
    256 http://www.edgewall.com/gfx/trac_example_image.png
    257 }}}
    258 
    259 Display:
    260 
    261 http://www.edgewall.com/gfx/trac_example_image.png
    262 
    263 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).
     264Urls ending with `.png`, `.gif` or `.jpg` are no longer automatically interpreted as image links, and converted to `<img>` tags.
     265
     266You now have to use the ![[Image]] macro (see below).
    264267
    265268
    … …  
    303306#!html
    304307<pre class="wiki">{{{
     308#!python
     309class Test:
     310
     311    def __init__(self):
     312        print "Hello World"
     313if __name__ == '__main__':
     314   Test()
     315}}}</pre>
     316}}}
     317
     318Display:
     319{{{
    305320#!python
    306321class Test:
    … …  
    309324if __name__ == '__main__':
    310325   Test()
    311 }}}</pre>
    312 }}}
    313 
    314 Display:
    315 {{{
    316 #!python
    317 class Test:
    318     def __init__(self):
    319         print "Hello World"
    320 if __name__ == '__main__':
    321    Test()
    322326}}}
    323327
    … …  
    327331my ($test) = 0;
    328332if ($test > 0) {
    329 echo "hello";
     333    print "hello";
    330334}
    331335}}}