Changes between Version 2 and Version 3 of WikiPageNames

Timestamp:

12/12/21 16:56:51 (3 years ago)

Author:

trac

Comment:

--

WikiPageNames

@@ -1 @@
-= Wiki Page Names =
+= Wiki Page Names
 [[TracGuideToc]]
 
 Wiki page names commonly use the CamelCase convention. Within wiki text, any word in CamelCase automatically becomes a hyperlink to the wiki page with that name.
 
-CamelCase page names must follow these rules:
+CamelCase page names follow these rules:
 
- 1. The name must consist of '''alphabetic characters only'''. No digits, spaces, punctuation, or underscores are allowed.
- 2. A name must have at least two capital letters.
- 3. The first character must be capitalized.
- 4. Every capital letter must be followed by one or more lower-case letters. 
- 5. The use of slash ( / ) is permitted in page names (possibly representing a hierarchy).
+ 1. The name must consist of '''alphabetic characters only'''; no digits, spaces, punctuation or underscores are allowed.
+ 1. A name must have at least two capital letters.
+ 1. The first character must be capitalized.
+ 1. Every capital letter must be followed by one or more lower-case letters.
+ 1. The use of slash ( / ) is permitted in page names, where it typically represents a hierarchy.
 
-If you want to create a wiki page that doesn't follow CamelCase rules you can use the following syntax:
+If you want to create a wiki page that does not follow CamelCase rules. you can use the following syntax:
 {{{
  * [wiki:Wiki_page], [wiki:ISO9000],
@@ -19 +19 @@
    and with a label: [wiki:"Space Matters" all about white space]
  * or simply: ["WikiPageName"]s
- * even better, the new [[WikiCreole link style]]
+ * even better, the [[WikiCreole link style]]
    and with a label: [[WikiCreole link style|WikiCreole style links]]
 }}}
@@ -28 +28 @@
  * [wiki:"Space Matters"] ''(that page name embeds space characters)''
    and with a label: [wiki:"Space Matters" all about white space]
- * or simply: ["WikiPageName"]s ''(old !MoinMoin's internal free links style)''
- * even better, the new [[WikiCreole link style]]
+ * or simply: ["WikiPageName"]s
+ * even better, the [[WikiCreole link style]]
    and with a label: [[WikiCreole link style|WikiCreole style links]]
-   ''(since 0.12, also now adopted by !MoinMoin)''
 
+It is possible to link to a specific ''version'' of a Wiki page as you would do for a specific version of a file, for example: WikiStart@1.
 
-Starting with Trac 0.11, it's also possible to link to a specific ''version'' of a Wiki page, as you would do for a specific version of a file, for example: WikiStart@1.
+You can prevent a !CamelCase name from being interpreted as a [TracLinks link] by quoting it with an exclamation mark: `!CamelCase`. See TracLinks#EscapingLinks.
 
-You can also prevent a CamelCase name to be interpreted as a TracLinks, by quoting it. See TracLinks#EscapingLinks.
+As in the example above, you can append an anchor to a Wiki page name to link to a specific section within that page. The anchor can be seen by hovering the mouse over a section heading, then clicking on the [[html(¶)]] sign that appears at its end. The anchor is usually generated automatically, but it is also possible to specify it explicitly: see WikiFormatting#using-explicit-id-in-heading.
 
-As visible in the example above, one can also append an anchor to a Wiki page name, in order to link to a specific section within that page. The anchor can easily be seen by hovering the mouse over a section heading, then clicking on the [[html(¶)]] sign that appears at its end. The anchor is usually generated automatically, but it's also possible to specify it explicitly: see WikiFormatting#using-explicit-id-in-heading.
+There are a few options that govern the rendering of WikiPageNames:
+* CamelCase linking to missing pages can be disabled with the `ignore_missing_pages` [https://trac.edgewall.org/wiki/TracIni#wiki-section option]. Linking to missing pages is enabled by default.
+* The `split_page_names` option, when enabled, will split CamelCase words when rendering a link. For example, WikiStart will be rendered as [WikiStart Wiki Start].
+
 ----
 See also: WikiNewPage, WikiFormatting, TracWiki, TracLinks