Changes between Version 1 and Version 2 of WikiPageNames


Ignore:
Timestamp:
Apr 13, 2011, 9:06:07 PM (14 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • WikiPageNames

    v1 v2  
    11= Wiki Page Names =
     2[[TracGuideToc]]
    23
    3 Wiki page names are written using CamelCase. Within a wiki text, any word in CamelCase automatically becomes a hyperlink to the wiki page with that same name.
     4Wiki 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.
    45
    5 Page names must follow these rules:
     6CamelCase page names must follow these rules:
    67
    78 1. The name must consist of '''alphabetic characters only'''. No digits, spaces, punctuation, or underscores are allowed.
    8  1. A name must have at least two capital letters.
    9  1. The first character must be capitalized.
    10  1. Every capital letter must be followed by one or more lower-case letters.
    11  1. The use of slash ( / ) is permitted to create a hierarchy inside the wiki.  (See !SubWiki and !ParentWiki macros in the [http://projects.edgewall.com/trac/wiki/MacroBazaar MacroBazaar] which provide a way to list all sub-entries and a link up the hierarchy respectively.)
     9 2. A name must have at least two capital letters.
     10 3. The first character must be capitalized.
     11 4. Every capital letter must be followed by one or more lower-case letters.
     12 5. The use of slash ( / ) is permitted in page names (possibly representing a hierarchy).
    1213
    13 If you want to create a wiki page that doesn't follow CamelCase rules you could use the following syntax:
     14If you want to create a wiki page that doesn't follow CamelCase rules you can use the following syntax:
    1415{{{
    15 [wiki:Wiki_page]
     16 * [wiki:Wiki_page], [wiki:ISO9000],
     17   and with a label: [wiki:ISO9000 ISO 9000 standard]
     18 * [wiki:"Space Matters"]
     19   and with a label: [wiki:"Space Matters" all about white space]
     20 * or simply: ["WikiPageName"]s
     21 * even better, the new [[WikiCreole link style]]
     22   and with a label: [[WikiCreole link style|WikiCreole style links]]
    1623}}}
    1724
    1825This will be rendered as:
    19  [wiki:Wiki_page]
     26 * [wiki:Wiki_page], [wiki:ISO9000],
     27   and with a label: [wiki:ISO9000 ISO 9000 standard]
     28 * [wiki:"Space Matters"] ''(that page name embeds space characters)''
     29   and with a label: [wiki:"Space Matters" all about white space]
     30 * or simply: ["WikiPageName"]s ''(old !MoinMoin's internal free links style)''
     31 * even better, the new [[WikiCreole link style]]
     32   and with a label: [[WikiCreole link style|WikiCreole style links]]
     33   ''(since 0.12, also now adopted by !MoinMoin)''
    2034
     35
     36Starting 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.
     37
     38You can also prevent a CamelCase name to be interpreted as a TracLinks, by quoting it. See TracLinks#EscapingLinks.
     39
     40As 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.
    2141----
    22 See also: WikiNewPage, WikiFormatting, TracWiki
     42See also: WikiNewPage, WikiFormatting, TracWiki, TracLinks