| 1 | = Wiki Page Names |
| 2 | [[TracGuideToc]] |
| 3 | [[TranslatedPages]] |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | CamelCase page names follow these rules: |
| 8 | |
| 9 | 1. The name must consist of '''alphabetic characters only'''; no digits, spaces, punctuation or underscores are allowed. |
| 10 | 1. A name must have at least two capital letters. |
| 11 | 1. The first character must be capitalized. |
| 12 | 1. Every capital letter must be followed by one or more lower-case letters. |
| 13 | 1. The use of slash ( / ) is permitted in page names, where it typically represents a hierarchy. |
| 14 | |
| 15 | If you want to create a wiki page that does not follow CamelCase rules. you can use the following syntax: |
| 16 | {{{ |
| 17 | * [wiki:Wiki_page], [wiki:ISO9000], |
| 18 | and with a label: [wiki:ISO9000 ISO 9000 standard] |
| 19 | * [wiki:"Space Matters"] |
| 20 | and with a label: [wiki:"Space Matters" all about white space] |
| 21 | * or simply: ["WikiPageName"]s |
| 22 | * even better, the [[WikiCreole link style]] |
| 23 | and with a label: [[WikiCreole link style|WikiCreole style links]] |
| 24 | }}} |
| 25 | |
| 26 | This will be rendered as: |
| 27 | * [wiki:Wiki_page], [wiki:ISO9000], |
| 28 | and with a label: [wiki:ISO9000 ISO 9000 standard] |
| 29 | * [wiki:"Space Matters"] ''(that page name embeds space characters)'' |
| 30 | and with a label: [wiki:"Space Matters" all about white space] |
| 31 | * or simply: ["WikiPageName"]s |
| 32 | * even better, the [[WikiCreole link style]] |
| 33 | and with a label: [[WikiCreole link style|WikiCreole style links]] |
| 34 | |
| 35 | 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. |
| 36 | |
| 37 | You can prevent a !CamelCase name from being interpreted as a [TracLinks link] by quoting it with an exclamation mark: `!CamelCase`. See TracLinks#EscapingLinks. |
| 38 | |
| 39 | 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. |
| 40 | |
| 41 | There are a few options that govern the rendering of WikiPageNames: |
| 42 | * 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. |
| 43 | * 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]. |
| 44 | |
| 45 | ---- |
| 46 | See also: WikiNewPage, WikiFormatting, TracWiki, TracLinks |