Changes between Version 19 and Version 20 of 0.12/WikiFormatting

Timestamp:

Apr 10, 2010, 3:12:22 PM (14 years ago)

Author:

Christian Boos

Comment:

add examples of WikiCreole #Links and warn about possible ambiguity with #Macros

0.12/WikiFormatting

@@ -153 +153 @@
 || WikiFormatting (CamelCase) ||
 |-----------------------------------------------------------
-{{{#!th rowspan=3
+{{{#!th rowspan=5
 [#TracLinks TracLinks]
 }}}
@@ -162 +162 @@
 || `ticket:1, ticket:1#comment:1` ||\
 || ticket:1, ticket:1#comment:1 ||
+|| `Ticket [ticket:1]`, `[ticket:1 ticket one]` ||\
+|| Ticket [ticket:1], [ticket:1 ticket one] ||
+|| `Ticket [[ticket:1]]`, `[[ticket:1|ticket one]]` ||\
+|| Ticket [[ticket:1]], [[ticket:1|ticket one]] ||
 |-----------------------------------------------------------
 {{{#!th rowspan=2
@@ -585 +589 @@
 }}}
 
-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 discarded, unless the link is an external link. This can be useful for wiki pages not adhering to the WikiPageNames convention.
-
-||= Wiki Markup =||= Display =||
-{{{#!td
-  {{{
-   * [http://www.edgewall.com/ Edgewall Software]
-   * [wiki:TitleIndex Title Index]
+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 discarded, unless the link is an external link. This can be useful for wiki pages not adhering to the WikiPageNames convention.
+
+||= Wiki Markup =||= Display =||
+{{{#!td
+  {{{
+   * [http://www.edgewall.com Edgewall Software]
+   * [wiki:TitleIndex Title Index] 
+   * [wiki:TitleIndex] 
    * [wiki:ISO9000]
   }}}
 }}}
 {{{#!td
- * [http://www.edgewall.com/ Edgewall Software]
- * [wiki:TitleIndex Title Index]
- * [wiki:ISO9000]
-}}}
+   * [http://www.edgewall.com Edgewall Software]
+   * [wiki:TitleIndex Title Index] 
+   * [wiki:TitleIndex] 
+   * [wiki:ISO9000]
+}}}
+
+Following the [trac:WikiCreole] trend, the descriptive title can also be specified by writing the link followed by a pipe ('|') and a title and all this inside //double// square brackets. 
+
+{{{#!td
+  {{{
+   * [[http://www.edgewall.com|Edgewall Software]]
+   * [[wiki:TitleIndex|Title Index]]
+     or even [[TitleIndex|Title Index]]
+   * [[wiki:TitleIndex]]
+     ''' but not ![[TitleIndex]]! '''
+   * [[ISO9000]]
+  }}}
+}}}
+{{{#!td
+   * [[http://www.edgewall.com|Edgewall Software]]
+   * [[wiki:TitleIndex|Title Index]]
+     or even [[TitleIndex|Title Index]]
+   * [[wiki:TitleIndex]]
+     ''' but not ![[TitleIndex]]! '''
+   * [[ISO9000]]
+}}}
+
+'''Note''': the [trac:WikiCreole] style for links is quick to type and
+certainly looks familiar as it's the one used on Wikipedia and in many
+other wikis. Unfortunately it conflicts with the syntax for [#Macros macros].
+So in the rare case when you need to refer to a page which is named after
+a macro (typical examples being TitleIndex, InterTrac and InterWiki), 
+by writing `[[TitleIndex]]` you will actually call the macro instead of linking
+to the page.
 
 == Trac Links ==
@@ -612 +648 @@
    * Changesets: r1, [1] or changeset:1
    * ...
+   * targeting other Trac instances, 
+     so called InterTrac links:
+     - Tickets: #Trac1 or Trac:ticket:1
+     - Changesets: [Trac1] or Trac:changeset:1
   }}}
 }}}
@@ -619 +659 @@
  * Changesets: r1, [1] or changeset:1
  * ... 
-}}}
-
-There are many more flavors of Trac links, see TracLinks for more in-depth information.
+ * targeting other Trac instances, 
+   so called InterTrac links:
+   - Tickets: #Trac1 or Trac:ticket:1
+   - Changesets: [Trac1] or Trac:changeset:1
+}}}
+
+There are many more flavors of Trac links, see TracLinks for more in-depth information and a reference for all the default link resolvers.