Changes between Version 21 and Version 22 of 0.12/WikiFormatting

Timestamp:

Jul 16, 2012, 9:16:12 PM (12 years ago)

Author:

trac

Comment:

—

0.12/WikiFormatting

@@ -1 @@
-** Note: this page was used to prepare the 0.12 version of wiki:/WikiFormatting, see now directly that toplevel page **
+** Note: this page documents the 0.12 version of Trac, see [[0.11/WikiFormatting]] if you need the previous version **
+
 = WikiFormatting =
 [[TracGuideToc]]
+[[TranslatedPages]]
 
 Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into a flexible and powerful whole.
@@ -20 +22 @@
 
 
-== Cheatsheet ==
+== Cheat sheet ==
 
 ||= '''Category''' =||= '''Wiki Markup''' =||= '''Display''' =||
@@ -29 +31 @@
 || `'''bold'''`, `''italic''`, `'''''Wikipedia style'''''` || \
 || '''bold''', ''italic'', '''''Wikipedia style''''' ||
-|| {{{`monospaced and ''nowiki''`}}} || \
-|| `monospaced and nowiki` ||
+|| {{{`monospaced (''other markup ignored'')`}}} || \
+|| `monospaced (''other markup ignored'')` ||
 || `**bold**`, `//italic//`, `**//!WikiCreole style//**` || \
 || **bold**, //italic//, **//!WikiCreole style//** ||
@@ -42 +44 @@
 }}}
 {{{#!td style="padding-left: 2em"
-== Level 2
+== Level 2 ==
 === Level 3 ^([#hn note])^
 }}}
@@ -66 +68 @@
  {{{
  * bullets list
-   on multiple paragraphs
+   on multiple lines
    1. nested list
      a. different numbering 
@@ -74 +76 @@
 {{{#!td
 * bullets list
-  on multiple paragraphs
+  on multiple lines
   1. nested list
     a. different numbering
@@ -86 +88 @@
  {{{
   term:: definition on
-         multiple paragraphs
+         multiple lines
  }}}
 }}}
 {{{#!td
  term:: definition on
-        multiple paragraphs
+        multiple lines
 }}}
 |-----------------------------------------------------------
@@ -168 +170 @@
 || Ticket [[ticket:1]], [[ticket:1|ticket one]] ||
 |-----------------------------------------------------------
-{{{#!th rowspan=2
-[#EscapingLinksandWikiPageNames Escaping Markup]
+{{{#!th rowspan=2 
+[#SettingAnchors Setting Anchors]
+}}}
+|| `[=#point1 (1)] First...` ||\
+|| [=#point1 (1)] First... ||
+|| `see [#point1 (1)]` ||\
+|| see [#point1 (1)] ||
+|-----------------------------------------------------------
+{{{#!th rowspan=3
+[#Escaping Escaping Markup]
 }}}
 || `!'' doubled quotes` ||\
@@ -175 +185 @@
 || `!wiki:WikiFormatting`, `!WikiFormatting` ||\
 || !wiki:WikiFormatting, !WikiFormatting ||
+|| {{{`}}}`{{{-}}}`{{{`}}}` triple curly brackets` ||\
+|| `{{{-}}}` triple curly brackets ||
 |-----------------------------------------------------------
 ||= [#Images Images] =|| `[[Image(`''link''`)]]` || [[Image(htdocs:../common/trac_logo_mini.png)]] ||
@@ -287 +299 @@
 followed by a single space and the headline text. 
 
-[=#hn] The headline text can be followed by the same number of "=" characters, but this is no longer mandatory.
+[=#hn]
+The headline text can be followed by the same number of "=" characters, but this is no longer mandatory.
 
 Finally, the heading might optionally be followed by an explicit id. If not, an implicit but nevertheless readable id will be generated.
@@ -304 +317 @@
   {{{
   #!div
+  = Heading =
   == Subheading
   === About ''this'' ===
@@ -669 +683 @@
 
 
-== Escaping Links and WikiPageNames ==
+== Setting Anchors ==
+
+An anchor, or more correctly speaking, an [http://www.w3.org/TR/REC-html40/struct/links.html#h-12.2.1 anchor name] can be added explicitly at any place in the Wiki page, in order to uniquely identify a position in the document:
+
+{{{
+[=#point1]
+}}}
+
+This syntax was chosen to match the format for explicitly naming the header id [#Headings documented above]. For example:
+{{{
+== Long title == #title
+}}}
+
+It's also very close to the syntax for the corresponding link to that anchor:
+{{{
+[#point1]
+}}}
+
+Optionally, a label can be given to the anchor:
+{{{
+[[=#point1 '''Point 1''']]
+}}}
+
+||= Wiki Markup =||= Display =||
+|----------------------------------
+{{{#!td
+  {{{
+  [#point2 jump to the second point]
+
+  ...
+
+  Point2:  [=#point2] Jump here
+  }}}
+}}}
+{{{#!td
+  [#point2 jump to the second point]
+
+  ...
+
+  Point2:  [=#point2] Jump here
+}}}
+
+For more complex anchors (e.g. when a custom title is wanted), one can use the Span macro, e.g. `[[span(id=point2, class=wikianchor, title=Point 2, ^(2)^)]]`.
+
+
+== Escaping Links, WikiPageNames and other Markup == #Escaping
 
 You may avoid making hyperlinks out of TracLinks by preceding an expression with a single "!" (exclamation mark).
@@ -679 +738 @@
    !#42 is not a link
   }}}
+  {{{
+Various forms of escaping for list markup:
+ `-` escaped minus sign \\
+ ``1. escaped number  \\
+ {{{*}}} escaped asterisk sign
+  }}}
 }}}
 {{{#!td
  !NoHyperLink
  !#42 is not a link
+
+Various forms of escaping for list markup:
+ `-` escaped minus sign \\
+ ``1. escaped number  \\
+ {{{*}}} escaped asterisk sign
 }}}
 
@@ -694 +764 @@
  * `[[Image(wiki:WikiFormatting:picture.gif)]]` (referring to attachment on another page)
  * `[[Image(ticket:1:picture.gif)]]` (file attached to a ticket)
- * `[[Image(htdocs:picture.gif)]]` (referring to a file inside project htdocs)
+ * `[[Image(htdocs:picture.gif)]]` (referring to a file inside the [TracEnvironment environment] `htdocs` directory)
  * `[[Image(source:/trunk/trac/htdocs/trac_logo_mini.png)]]` (a file in repository)
 
@@ -707 +777 @@
 }}}
 
-See WikiMacros for further documentation on the `[[Image()]]` macro.
+See WikiMacros for further documentation on the `[[Image()]]` macro, which has several useful options (`title=`, `link=`, etc.)
 
 
@@ -938 +1008 @@
 !WikiCreole style \\ line\\break
 }}}
+