source: wiki/pages/WikiPageNames @ 43921

Last change on this file since 43921 was 43921, checked in by aafsvn, 3 years ago

[titan] autoupdate wiki files

File size: 2.6 KB
RevLine 
[40558]1= Wiki Page Names
2[[TracGuideToc]]
3
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.
5
6CamelCase page names follow these rules:
7
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.
13
14If you want to create a wiki page that does not follow CamelCase rules. you can use the following syntax:
15{{{
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
[43921]21 * even better, the [[WikiCreole link style]]
[40558]22   and with a label: [[WikiCreole link style|WikiCreole style links]]
23}}}
24
25This will be rendered as:
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
[43921]31 * even better, the [[WikiCreole link style]]
[40558]32   and with a label: [[WikiCreole link style|WikiCreole style links]]
33
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.
35
[43921]36You can prevent a !CamelCase name from being interpreted as a [TracLinks link] by quoting it with an exclamation mark: `!CamelCase`. See TracLinks#EscapingLinks.
[40558]37
[43921]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.
[40558]39
[43921]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
[40558]44----
45See also: WikiNewPage, WikiFormatting, TracWiki, TracLinks
Note: See TracBrowser for help on using the repository browser.