close
Warning:
Can't synchronize with repository "(default)" (The repository directory has changed, you should resynchronize the repository with: trac-admin $ENV repository resync '(default)'). Look in the Trac log for more information.
- Timestamp:
-
2018-05-12T08:27:23-07:00 (7 years ago)
- Author:
-
trac
- Comment:
-
--
Legend:
- Unmodified
- Added
- Removed
- Modified
-
v3
|
v4
|
|
1 | | = !CamelCase = |
2 | | New words created by smashing together capitalized words. |
| 1 | = !CamelCase |
3 | 2 | |
4 | | CamelCase is the original wiki convention for creating hyperlinks, with the additional requirement that the capitals are followed by a lower-case letter; hence “AlabamA” and “ABc” will not be links. |
| 3 | New wiki links are automatically created when concatenating capitalized words, such that for example the words 'Camel' and 'Case' concatenated form a link to this CamelCase page. |
5 | 4 | |
6 | | == Customizing the Wiki behavior == |
| 5 | !CamelCase is the original wiki convention for creating hyperlinks, with the additional requirement that the capital letters are followed by a lower-case letter; hence "AlabamA" and "ABc" will not be links. |
7 | 6 | |
8 | | Some people dislike linking by CamelCase. While Trac remains faithful to the original Wiki style, it provides a number of ways to accomodate users with different preferences: |
9 | | * There's an option (`ignore_missing_pages` in the [wiki:TracIni#wiki-section "[wiki]"] section of TracIni) to simply ignore links to missing pages when the link is written using the CamelCase style, instead of that word being replaced by a gray link followed by a question mark.[[BR]] |
10 | | That can be useful when CamelCase style is used to name code artifacts like class names and there's no corresponding page for them. |
11 | | * There's an option (`split_page_names` in the [wiki:TracIni#wiki-section "[wiki]"] section of TracIni) to automatically insert space characters between the words of a CamelCase link when rendering the link. |
| 7 | == Customizing the Wiki behavior |
| 8 | |
| 9 | While Trac remains faithful to the original Wiki style, it also provides a number of ways to accommodate users with different preferences: |
| 10 | * To prevent the creation of a link for the CamelCase word, prefix the word with an exclamation mark (`!`): `!CamelCase`. |
| 11 | * By default a CamelCase word with no corresponding Wiki page will be rendered as a gray link followed by a question mark. This is useful for example when the CamelCase style is used to name code artefacts like class names, and a Wiki page is expected to exist to document each class. The behavior can be configured through the [TracIni#wiki-ignore_missing_pages-option "[wiki] ignore_missing_pages"] option in TracIni. |
| 12 | * To automatically insert space characters between the words of a CamelCase link when rendering the link, enable [TracIni#wiki-split_page_names-option "[wiki] split_page_names"] of TracIni. |
12 | 13 | * Creation of explicit Wiki links is also easy, see WikiPageNames for details. |
13 | | * In addition, Wiki formatting can be disabled completely in some places (e.g. when rendering commit log messages). See `wiki_format_messages` in the [wiki:TracIni#changeset-section "[changeset]"] section of TracIni. |
| 14 | * Wiki formatting can be disabled completely in some places, for example when rendering commit log messages. See the [TracIni#changeset-wiki_format_messages-option "[wiki] wiki_format_messages"] option in TracIni. |
14 | 15 | |
15 | 16 | See TracIni for more information on the available options. |
16 | 17 | |
17 | | == More information on !CamelCase == |
| 18 | == More information on !CamelCase |
18 | 19 | |
19 | 20 | * http://c2.com/cgi/wiki?WikiCase |