Changes between Initial Version and Version 1 of WikiFormatting

Timestamp:

Nov 30, 2005, 4:55:44 PM (20 years ago)

Author:

trac

Comment:

--

WikiFormatting

@@ +1 @@
+= WikiFormatting =
+
+Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into flexible and powerful whole.
+
+Trac 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]. 
+
+This page demonstrates the formatting syntax available anywhere WikiFormatting is allowed.
+
+== Font styles ==
+
+The Trac wiki support the following font styles: '''bold''', ''italic'',
+__underline__ and ~~strike-through~~.
+
+{{{
+The Trac wiki support the following font styles: '''bold''', ''italic'',
+__underline__ and ~~strike-through~~.
+}}}
+
+
+== Heading ==
+
+You can create heading by starting a line with one up to five ''equal\\ '=' characters
+followed by a single space and the headline text. The line should end with a space 
+followed by the same number of ''equal'' characters. 
+
+''Note: As of writing, headings cannot contain TracLinks.''
+
+=== Example: ===
+{{{
+= Heading =
+== Subheading ==
+}}}
+
+
+== Paragraphs ==
+
+A new text paragraph is created whenever two blocks of text are separated
+by one or more empty lines.
+
+A forced line break can also be inserted, using:
+{{{
+Line 1[[BR]]Line 2
+}}}
+Display:
+
+Line 1[[BR]]Line 2
+
+  Text paragraphs can be indented by starting the lines with two or more spaces.
+
+== Lists ==
+The wiki supports both ordered/numbered and unordered lists.
+
+Example:
+{{{
+ * Item 1
+   * Item 1.1
+ * Item 2
+
+ 1. Item 1
+   1. Item 1.1
+ 1. Item 2
+}}}
+Display:
+ * Item 1
+   * Item 1.1
+ * Item 2
+
+ 1. Item 1
+   1. Item 1.1
+ 1. Item 2
+
+== Preformatted text ==
+Block 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:
+  
+Example:
+{{{
+ {{{
+  def HelloWorld()
+      print "Hello World"
+ }}}
+}}}
+
+Display:
+{{{
+ def HelloWorld()
+     print "Hello World"
+}}}
+
+== Tables ==
+
+Simple tables can be created like this:
+{{{
+||Cell 1||Cell 2||Cell 3||
+||Cell 4||Cell 5||Cell 6||
+}}}
+Display:
+||Cell 1||Cell 2||Cell 3||
+||Cell 4||Cell 5||Cell 6||
+
+== Links ==
+
+!Hyperlinks are automatically created for WikiPageNames and urls. !WikiPageLinks can be disabled by
+prepending an exclamation mark (!) character, such as {{{!WikiPageLink}}}.
+
+Examples:
+
+ TitleIndex, http://www.edgewall.com/.
+
+Links can be given a more descriptive title by writing the link followed by
+a space and a title and all this inside two square brackets. Like this:
+{{{
+ * [http://www.edgewall.com/ Edgewall Software]
+ * [wiki:TitleIndex Title Index]
+}}}
+Display:
+
+ * [http://www.edgewall.com/ Edgewall Software]
+ * [wiki:TitleIndex Title Index]
+
+=== Trac Links ===
+
+Wiki pages can link directly to other parts of the Trac system.
+Pages can refer to tickets, reports, changesets, milestones, source files and
+other Wiki pages using the following notation:
+ * Tickets: '''!#1''' or '''!ticket:1'''
+ * Reports: '''!{1}''' or '''!report:1'''
+ * Changesets: '''![1]''' or '''!changeset:1'''
+ * Wiki pages: '''CamelCase''' or '''!wiki:CamelCase'''
+ * Milestones: '''!milestone:1.0'''
+ * Files: '''!source:trunk/COPYING'''
+ * A specific file revision: '''!source:/trunk/COPYING#200'''
+Display:
+ * Tickets: #1 or ticket:1
+ * Reports: {1} or report:1
+ * Changesets: [1] or changeset:1
+ * Wiki pages: CamelCase or wiki:CamelCase
+ * Milestones: milestone:1.0
+ * Files: source:trunk/COPYING
+ * A specific file revision: source:/trunk/COPYING#200
+
+See TracLinks for more in-depth information.
+
+== Escaping Links and WikiNames ==
+You may avoid making hyperlinks out of TracLinks by preceding an expression with a single '!' (exclamation mark).
+
+{{{
+ !NoHyperLink
+ !#42 is not a link
+}}}
+
+Display:
+ !NoHyperLink
+ !#42 is not a link
+
+== Images ==
+
+Urls ending with .png, .gif or .jpg are automatically interpreted as image links, and converted to IMG tags.
+
+Example:
+{{{
+http://www.edgewall.com/gfx/trac_example_image.png
+}}}
+Display:
+
+http://www.edgewall.com/gfx/trac_example_image.png
+
+== Macros ==
+Macros are ''custom functions'' to insert dynamic content in a page. See WikiMacros for usage.
+
+Example:
+{{{
+ [[Timestamp]]
+}}}
+Display:
+ [[Timestamp]]
+
+== Processors ==
+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 more information.
+
+'''Example 1:'''
+{{{
+#!html
+<pre class="wiki">{{{
+#!html
+&lt;h1 style="text-align: right; color: blue"&gt;HTML Test&lt;/h1&gt;
+}}}</pre>
+}}}
+Display:
+{{{
+#!html
+<h1 style="text-align: right; color: blue">HTML Test</h1>
+}}}
+
+'''Example 2:'''
+{{{
+#!html
+<pre class="wiki">{{{
+#!python
+class Test:
+    def __init__(self):
+        print "Hello World"
+if __name__ == '__main__':
+   Test()
+}}}</pre>
+}}}
+Display:
+{{{
+#!python
+class Test:
+    def __init__(self):
+        print "Hello World"
+if __name__ == '__main__':
+   Test()
+}}}
+
+== Miscellaneous ==
+
+Four or more dashes will be replaced by a horizontal line (<HR>)
+
+{{{
+ ----
+}}}
+
+Display:
+----
+
+
+----
+See also: TracLinks, TracGuide, WikiHtml, WikiMacros, WikiProcessors, TracSyntaxColoring.
+