Code

Changes between Version 4 and Version 5 of WikiFormatting


Ignore:
Timestamp:
08/02/05 10:07:43 (9 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiFormatting

    v4 v5  
    11= WikiFormatting = 
    22 
    3 Wiki serves as the core component of Trac, which tightly integrates all the other parts of Trac into flexible and powerful system. 
     3Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into flexible and powerful whole. 
     4 
    45Trac 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 especially [http://moin.sf.net/ MoinWiki].  
    56 
    6 This page demonstrates some of the formatting commands available in the Trac Wiki. 
     7This page demonstrates the formatting syntax available anywhere WikiFormatting is allowed. 
    78 
    89== Font styles == 
    910 
    10 The Trac wiki support the following font styles: '''bold''', ''italic'' 
    11 and __underline__. 
    12  
    13 {{{ 
    14 The Trac wiki support the following font styles: '''bold''', ''italic'' 
    15 and __underline__. 
    16 }}} 
     11The Trac wiki support the following font styles: '''bold''', ''italic'', 
     12__underline__ and ~~strike-through~~. 
     13 
     14{{{ 
     15The Trac wiki support the following font styles: '''bold''', ''italic'', 
     16__underline__ and ~~strike-through~~. 
     17}}} 
     18 
    1719 
    1820== Heading == 
    1921 
    20 You can create heading by starting a line with one up to five equal signs 
    21 followed by a space and the headline text. The line should end with a space  
    22 followed by the same number of equal signs.  
     22You can create heading by starting a line with one up to five ''equal\\ '=' characters 
     23followed by a single space and the headline text. The line should end with a space  
     24followed by the same number of ''equal'' characters.  
     25 
     26''Note: As of writing, headings cannot contain TracLinks.'' 
    2327 
    2428=== Example: === 
     
    3236 
    3337A new text paragraph is created whenever two blocks of text are separated 
    34 by an empty line. A newline can also be inserted like this: 
     38by one or more empty lines. 
     39 
     40A forced line break can also be inserted, using: 
    3541{{{ 
    3642Line 1[[BR]]Line 2 
     
    4046Line 1[[BR]]Line 2 
    4147 
    42  Text paragraphs can also be indented by starting the lines with a few spaces. 
     48  Text paragraphs can be indented by starting the lines with two or more spaces. 
     49 
    4350== Lists == 
     51The wiki supports both ordered/numbered and unordered lists. 
     52 
    4453Example: 
    4554{{{ 
     
    6271 
    6372== Preformatted text == 
    64 Block quotes, also know as preformatted text, is suitable for source code snippets, notes and examples. Use three ''curly braces'' wrapped around the text: 
     73Block 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: 
    6574   
     75Example: 
    6676{{{ 
    6777 {{{ 
     
    90100== Links == 
    91101 
    92 Hyperlinks are automatically created for WikiPageNames and urls. !WikiPageLinks can be disabled by 
    93 prepending a bang (!) character like this {{{!WikiPageLink}}}. 
    94  
    95 For example: 
     102!Hyperlinks are automatically created for WikiPageNames and urls. !WikiPageLinks can be disabled by 
     103prepending an exclamation mark (!) character, such as {{{!WikiPageLink}}}. 
     104 
     105Examples: 
    96106 
    97107 TitleIndex, http://www.edgewall.com/. 
     
    108118 * [wiki:TitleIndex Title Index] 
    109119 
    110 === Intra Trac Links === 
    111  
    112 Trac allows wiki pages to link directly to other parts of the Trac system. 
    113 Pages can refer to tickets, reports and changesets by simply writing the 
    114 ticket, report and changeset numbers in the following notation: 
    115 {{{ 
    116  * Ticket #1  
    117  * Report {1} 
    118  * Changeset [1] 
    119  * File source:trunk/COPYING. 
     120=== Trac Links === 
     121 
     122Wiki pages can link directly to other parts of the Trac system. 
     123Pages can refer to tickets, reports, changesets, milestones, source files and 
     124other Wiki pages using the following notation: 
     125 * Tickets: '''!#1''' or '''!ticket:1''' 
     126 * Reports: '''!{1}''' or '''!report:1''' 
     127 * Changesets: '''![1]''' or '''!changeset:1''' 
     128 * Wiki pages: '''CamelCase''' or '''!wiki:CamelCase''' 
     129 * Milestones: '''!milestone:1.0''' 
     130 * Files: '''!source:trunk/COPYING''' 
     131 * A specific file revision: '''!source:/trunk/COPYING#200''' 
     132Display: 
     133 * Tickets: #1 or ticket:1 
     134 * Reports: {1} or report:1 
     135 * Changesets: [1] or changeset:1 
     136 * Wiki pages: CamelCase or wiki:CamelCase 
     137 * Milestones: milestone:1.0 
     138 * Files: source:trunk/COPYING 
    120139 * A specific file revision: source:/trunk/COPYING#200 
    121 }}} 
    122 Display: 
    123  * Ticket #1  
    124  * Report {1} 
    125  * Changeset [1] 
    126  * File source:trunk/COPYING. 
    127  * A specific file revision: source:/trunk/COPYING#200 
    128  
    129 See TracLinks for more information about intra-trac linking. 
     140 
     141See TracLinks for more in-depth information. 
     142 
     143== Escaping Links and WikiNames == 
     144You may avoid making hyperlinks out of TracLinks by preceding an expression with a single '!' (exclamation mark). 
     145 
     146{{{ 
     147 !NoHyperLink 
     148 !#42 is not a link 
     149}}} 
     150 
     151Display: 
     152 !NoHyperLink 
     153 !#42 is not a link 
    130154 
    131155== Images == 
    132156 
    133 Urls ending with .png, .gif or .jpg will be converted to an IMG-tag. 
     157Urls ending with .png, .gif or .jpg are automatically interpreted as image links, and converted to IMG tags. 
    134158 
    135159Example: 
     
    152176 
    153177== Processors == 
    154 Trac supports alternative markup formats using WikiProcessors. For example, processors are used to write pages in [wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML]. See WikiProcessors for documentation. 
     178Trac supports alternative markup formats using WikiProcessors. For example, processors are used to write pages in [wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML].  
     179 
     180See WikiProcessors for more information. 
    155181 
    156182'''Example 1:''' 
     
    189215   Test() 
    190216}}} 
     217 
    191218== Miscellaneous == 
    192219 
     
    202229 
    203230---- 
    204 See also: TracLinks, WikiMacros, WikiProcessors, TracSyntaxColoring. 
     231See also: TracLinks, TracGuide, WikiHtml, WikiMacros, WikiProcessors, TracSyntaxColoring. 
     232