Changes between Version 2 and Version 3 of WikiFormatting


Ignore:
Timestamp:
09/26/06 13:01:38 (18 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. 
     
    150165  This text is a quote from someone else. 
    151166 
     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.'' 
     184 
    152185== Tables == 
    153186 
     
    178211 TitleIndex, http://www.edgewall.com/, !NotAlink 
    179212 
    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. 
     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. 
    181214 
    182215Example: 
     
    200233 * Reports: {1} or report:1 
    201234 * Changesets: r1, [1] or changeset:1 
    202  * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1:3 
    203  * Wiki pages: CamelCase or wiki:CamelCase 
    204  * Milestones: milestone:1.0 or milestone:"End-of-days Release" 
    205  * Files: source:trunk/COPYING 
    206  * Attachments: attachment:"file name.doc" 
    207  * A specific file revision: source:/trunk/COPYING#200 
    208  * A filename with embedded space: source:"/trunk/README FIRST" 
     235 * ... 
    209236}}} 
    210237 
     
    213240 * Reports: {1} or report:1 
    214241 * Changesets: r1, [1] or changeset:1 
    215  * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1:3 
    216  * Wiki pages: CamelCase or wiki:CamelCase 
    217  * Milestones: milestone:1.0 or milestone:"End-of-days Release" 
    218  * Files: source:trunk/COPYING 
    219  * Attachments: attachment:"file name.doc" 
    220  * A specific file revision: source:/trunk/COPYING#200 
    221  * A filename with embedded space: source:"/trunk/README FIRST" 
     242 * ...  
    222243 
    223244See TracLinks for more in-depth information. 
     
    241262== Images == 
    242263 
    243 Urls ending with `.png`, `.gif` or `.jpg` are automatically interpreted as image links, and converted to `<img>` tags. 
    244  
    245 Example: 
    246 {{{ 
    247 http://www.edgewall.com/gfx/trac_example_image.png 
    248 }}} 
    249  
    250 Display: 
    251  
    252 http://www.edgewall.com/gfx/trac_example_image.png 
    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). 
     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). 
    255267 
    256268 
     
    294306#!html 
    295307<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{{{ 
    296320#!python 
    297321class Test: 
     
    300324if __name__ == '__main__': 
    301325   Test() 
    302 }}}</pre> 
    303 }}} 
    304  
    305 Display: 
    306 {{{ 
    307 #!python 
    308 class Test: 
    309     def __init__(self): 
    310         print "Hello World" 
    311 if __name__ == '__main__': 
    312    Test() 
    313326}}} 
    314327 
     
    318331my ($test) = 0; 
    319332if ($test > 0) { 
    320 echo "hello"; 
     333    print "hello"; 
    321334} 
    322335}}}