Edgewall Software

Changes between Version 41 and Version 42 of WikiFormatting


Ignore:
Timestamp:
Sep 12, 2005, 11:35:57 AM (17 years ago)
Author:
Christian Boos
Comment:

Be more consistent in the way each syntax feature is presented, plus a few updates for 0.9 along the way

Legend:

Unmodified
Added
Removed
Modified
  • WikiFormatting

    v41 v42  
    88This page demonstrates the formatting syntax available anywhere WikiFormatting is allowed.
    99
     10
    1011== Font styles ==
    1112
    1213The Trac wiki supports the following font styles:
     14{{{
    1315 * '''bold'''
    1416 * ''italic''
     
    1921 * ^superscript^
    2022 * ,,subscript,,.
    21 
    22 {{{
    23 The Trac wiki supports the following font styles:
     23}}}
     24
     25Display:
    2426 * '''bold'''
    2527 * ''italic''
     
    3032 * ^superscript^
    3133 * ,,subscript,,.
    32 }}}
    3334
    3435
     
    3940followed by the same number of ''equal'' characters.
    4041
    41 ''Note: As of writing, headings cannot contain TracLinks.''
    42 
    43 === Example: ===
     42Example:
    4443{{{
    4544= Heading =
    4645== Subheading ==
    47 }}}
     46== About ''this'' ==
     47}}}
     48
     49Display:
     50= Heading =
     51== Subheading ==
     52== About ''this'' ==
    4853
    4954
     
    6368  Text paragraphs can be indented by starting the lines with two or more spaces.
    6469
     70
    6571== Lists ==
     72
    6673The wiki supports both ordered/numbered and unordered lists.
    6774(Note: there must be a space preceding the star (*) or number (1.), or nothing will happen.)
     
    8794 1. Item 2
    8895
     96
    8997== Preformatted text ==
     98
    9099Block 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:
    91100 
     
    104113}}}
    105114
     115
    106116== Tables ==
    107117
     
    111121||Cell 4||Cell 5||Cell 6||
    112122}}}
     123
    113124Display:
    114125||Cell 1||Cell 2||Cell 3||
    115126||Cell 4||Cell 5||Cell 6||
    116127
     128
    117129== Links ==
    118130
    119 !Hyperlinks are automatically created for WikiPageNames and urls. !WikiPageLinks can be disabled by
     131Hyperlinks are automatically created for WikiPageNames and urls.
     132!WikiPageLinks can be disabled by
    120133prepending an exclamation mark (!) character, such as {{{!WikiPageLink}}}.
    121134
    122 Examples:
    123 
    124  TitleIndex, http://www.edgewall.com/.
     135Example:
     136{{{
     137 TitleIndex, http://www.edgewall.com/, !NotAlink
     138}}}
     139
     140Display:
     141 TitleIndex, http://www.edgewall.com/, !NotAlink
    125142
    126143Links can be given a more descriptive title by writing the link followed by
    127 a space and a title and all this inside square brackets. Like this:
     144a space and a title and all this inside square brackets.
     145If the descriptive title is omitted, then the explicit prefix is disguarded,
     146unless the link is an external link. This can be useful for wiki pages
     147not adhering to the WikiPageNames convention.
     148
     149Like this:
    128150{{{
    129151 * [http://www.edgewall.com/ Edgewall Software]
    130152 * [wiki:TitleIndex Title Index]
    131 }}}
    132 Display:
    133 
     153 * [wiki:ISO9000]
     154}}}
     155
     156Display:
    134157 * [http://www.edgewall.com/ Edgewall Software]
    135158 * [wiki:TitleIndex Title Index]
     159 * [wiki:ISO9000]
     160
    136161
    137162=== Trac Links ===
     
    140165Pages can refer to tickets, reports, changesets, milestones, source files and
    141166other Wiki pages using the following notation:
    142  * Tickets: '''!#1''' or '''!ticket:1'''
    143  * Reports: '''!{1}''' or '''!report:1'''
    144  * Changesets: '''!r1''', '''![1]''' or '''!changeset:1'''
    145  * Revision log: '''!r1:3''', '''![1:3]''' or '''!log:#1:3'''
    146  * Wiki pages: '''CamelCase''' or '''!wiki:CamelCase'''
    147  * Milestones: '''!milestone:1.0'''
    148  * Files: '''!source:trunk/COPYING'''
    149  * A specific file revision: '''!source:/trunk/COPYING#200'''
    150 Display:
     167{{{
    151168 * Tickets: #1 or ticket:1
    152169 * Reports: {1} or report:1
    153170 * Changesets: r1, [1] or changeset:1
    154  * Differences: r1:3, [1:3] or log:#1:3
     171 * Revision Logs: r1:3, [1:3] or log:branches/0.9-stable#1:3
    155172 * Wiki pages: CamelCase or wiki:CamelCase
    156  * Milestones: milestone:1.0
     173 * Milestones: milestone:1.0 or milestone:"End-of-days Release"
    157174 * Files: source:trunk/COPYING
    158175 * A specific file revision: source:/trunk/COPYING#200
     176 * A filename with embedded space:"/trunk/README FIRST"
     177}}}
     178
     179Display:
     180 * Tickets: #1 or ticket:1
     181 * Reports: {1} or report:1
     182 * Changesets: r1, [1] or changeset:1
     183 * Revision Logs: r1:3, [1:3] or log:branches/0.8-stable#1000:2000
     184 * Wiki pages: CamelCase or wiki:CamelCase
     185 * Milestones: milestone:1.0 or milestone:"End-of-days Release"
     186 * Files: source:trunk/COPYING
     187 * A specific file revision: source:/trunk/COPYING#200
     188 * A filename with embedded space:"/trunk/README FIRST"
    159189
    160190See TracLinks for more in-depth information.
    161191
     192
    162193== Escaping Links and WikiNames ==
     194
    163195You may avoid making hyperlinks out of TracLinks by preceding an expression with a single '!' (exclamation mark).
    164196
     
    172204 !#42 is not a link
    173205
     206
    174207== Images ==
    175208
    176 Urls ending with .png, .gif or .jpg are automatically interpreted as image links, and converted to IMG tags.
     209Urls ending with `.png`, `.gif` or `.jpg` are automatically interpreted as image links, and converted to IMG tags.
    177210
    178211Example:
     
    184217http://www.edgewall.com/gfx/trac_example_image.png
    185218
     219
    186220== Macros ==
    187 Macros are ''custom functions'' to insert dynamic content in a page. See WikiMacros for usage.
     221
     222Macros are ''custom functions'' to insert dynamic content in a page.
     223See WikiMacros for usage.
    188224
    189225Example:
     
    191227 [[Timestamp]]
    192228}}}
     229
    193230Display:
    194231 [[Timestamp]]
    195232
     233
    196234== Processors ==
    197 Trac supports alternative markup formats using WikiProcessors. For example, processors are used to write pages in [wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML].
     235
     236Trac supports alternative markup formats using WikiProcessors.
     237For example, processors are used to write pages in
     238[wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML].
    198239
    199240See WikiProcessors for more information.
     
    207248}}}</pre>
    208249}}}
     250
    209251Display:
    210252{{{
     
    225267}}}</pre>
    226268}}}
     269
    227270Display:
    228271{{{
     
    235278}}}
    236279
     280
    237281== Miscellaneous ==
    238282
    239283Four or more dashes will be replaced by a horizontal line (<HR>)
    240284
     285Example:
    241286{{{
    242287 ----
     
    246291----
    247292
    248 ---
     293
    249294----
    250 -
     295
    251296See also: TracLinks, TracGuide, WikiHtml, WikiMacros, WikiProcessors, TracSyntaxColoring.
    252297