Changes between Version 2 and Version 3 of WikiPageNames


Ignore:
Timestamp:
Jan 30, 2018 2:16:51 PM (7 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • WikiPageNames

    v2 v3  
    1 = Wiki Page Names = 
     1= Wiki Page Names 
    22[[TracGuideToc]] 
    33 
    44Wiki 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. 
    55 
    6 CamelCase page names must follow these rules: 
     6CamelCase page names follow these rules: 
    77 
    8  1. The name must consist of '''alphabetic characters only'''. No digits, spaces, punctuation, or underscores are allowed. 
    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). 
     8 1. The name must consist of '''alphabetic characters only'''; no digits, spaces, punctuation or underscores are allowed. 
     9 1. A name must have at least two capital letters. 
     10 1. The first character must be capitalized. 
     11 1. Every capital letter must be followed by one or more lower-case letters.  
     12 1. The use of slash ( / ) is permitted in page names, where it typically represents a hierarchy. 
    1313 
    14 If you want to create a wiki page that doesn't follow CamelCase rules you can use the following syntax: 
     14If you want to create a wiki page that does not follow CamelCase rules. you can use the following syntax: 
    1515{{{ 
    1616 * [wiki:Wiki_page], [wiki:ISO9000], 
    … …  
    1919   and with a label: [wiki:"Space Matters" all about white space] 
    2020 * or simply: ["WikiPageName"]s 
    21  * even better, the new [[WikiCreole link style]] 
     21 * even better, the [[WikiCreole link style]] 
    2222   and with a label: [[WikiCreole link style|WikiCreole style links]] 
    2323}}} 
    … …  
    2828 * [wiki:"Space Matters"] ''(that page name embeds space characters)'' 
    2929   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]] 
     30 * or simply: ["WikiPageName"]s 
     31 * even better, the [[WikiCreole link style]] 
    3232   and with a label: [[WikiCreole link style|WikiCreole style links]] 
    33    ''(since 0.12, also now adopted by !MoinMoin)'' 
    3433 
     34It 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. 
    3535 
    36 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. 
     36You can prevent a !CamelCase name from being interpreted as a [TracLinks link] by quoting it with an exclamation mark: `!CamelCase`. See TracLinks#EscapingLinks. 
    3737 
    38 You can also prevent a CamelCase name to be interpreted as a TracLinks, by quoting it. See TracLinks#EscapingLinks. 
     38As 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. 
    3939 
    40 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. 
     40There are a few options that govern the rendering of WikiPageNames: 
     41* 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. 
     42* 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]. 
     43 
    4144---- 
    4245See also: WikiNewPage, WikiFormatting, TracWiki, TracLinks