Changes between Version 2 and Version 3 of WikiFormatting


Ignore:
Timestamp:
11/18/04 18:03:00 (20 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiFormatting

    v2 v3  
    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, TracGuide, WikiMacros, WikiProcessors, TracSyntaxColoring.
     231See also: TracLinks, TracGuide, WikiHtml, WikiMacros, WikiProcessors, TracSyntaxColoring.
     232