Synopsis
- To create a page, first create a link in another page, then click on that link.
- Choose a page name that both is concise (short) and appropriate (not more general than the page content).
- Good page names are About or WikiAdministration.
- Enclose page names in square brackets to create a link: [About], [WikiAdministration].
- You can write page names consisting of several words with blanks, hyphens, or lowercase with blanks. For example all of [Wiki Administration], [wiki administration], and [wiki-administration] refer to the same page, [WikiAdministration]. However, [wikiadministration] would be a different page.
Details
The following may be of interest if you have some experience with the Wiki and encounter specific problems.
- Only letters (A-z, diacritical letters), digits (0-9), the underscore, and period ("_", ".") are allowed in Wiki page names.
- The name can not be all-digits; numeric names are reserved for footnotes.
- It is recommended that names start with a letter; although most of the Wiki software will function if a name starts with a digit, some specific functions may have problems with this.
- CamelCase: Wiki page names are traditionally written using "CamelCase" (also known as "InterCapping"), i. e., with at least another uppercase letter in the wiki link word). This makes the creation of internal hyperlinks really easy. However, in this Wiki the links are written by enclosing them in square brackets, using the [link] notation. This is similar to the use in Wikipedia
(which uses double opening and double closing brackets).
- Crusher: When enclosed in [], names may contain blanks or punctuation and be written lower case. All of [WikiAdministration], [wiki administration], [wiki-administration], [(wiki) administration] refer to the same page.
- However, [wikiadministration] would refer to a different page [Wikiadministration].
- As of JSPWiki 2.2, a bug occurs when using double quotes inside a link. ["wiki"-administration] erroneously refers to a page "quotwikiquotAdministration".
- The automatic capitalization prevents you from using technical terms starting with lowercase (tRNA, cDNA, etc.) as page names.
- Occasionally the punctuation stemmer causes erroneous spelling, e. g., [John's page] becomes [JohnsPage].
- Wiki formatting rules are not supported inside a link. You can not write [Wiki __Administration__]. Unfortunately, you can not work around this by separating display-text and link-text.as in Wiki ~__Administration~__. This still results in: Wiki __Administration__ being displayed (but linked correctly to |WikiAdministration]).
- The only current work-around is to write: [Wiki|WikiAdministration] __[Administration|WikiAdministration]__. The problem is probably irrelevant in many disciplines, but unfortunate in biology because parts of a link relating to taxon names often have to be italicized.
- Plural stemmer: Simple English plural forms (trailing "s") are automatically recognized. [MyPage] and [MyPages] will refer to the same page (whichever has been created first).
- However, as of JSPWiki 2.2 the plural stemmer is ignorant of the regular plural form ending on "-y", all irregular English plural forms, as well as of plurals in other languages. For example, [Category]/[Categories], [Index]/[Indices]/[Indexes], [Analysis]/[Analyses], [Leaf]/[Leaves], [Man]/[Men], [Echo]/[Echoes], [Larva]/[Larvae], [Taxon]/[Taxa], [Datum]/[Data], [Schema]/[Schemata] are all not recognized as plural forms and treat as separat names.
- The work-around is either to create extra pages which contain a forward link to the corresponding other form, or to write the link like [Category|Categories], where "Category" is displayed, but links to the "Categories" page.
- It is also possible to use the SET Alias='ForwardPageName' mechanism. However, as of JSPWiki 2.2, editing (e. g., removing or changing the alias) is difficult (with Wiki methods you always end up editing the forward destination; the solution is to type an edit url in the browser by hand).
Copyrighted material retrieved from http://www.DiversityWorkbench.net/Portal//WikiPageNameHelp