summaryrefslogtreecommitdiff
path: root/TWiki/WikiWord.mdwn
blob: 4457a568600fdd914cf0e201af2a160e291c6e80 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
A WikiWord consists of two or more words with initial capitals, run together.

When you type a WikiWord, you establish a hyperlink. It's as easy as that.

WikiWords are styled like this because:

* It makes Wiki hyperlinks instantly recognizable
* It leads to interesting Wiki topics
* It avoids the need to fiddle with HTML tags
* It avoids over-general topics, because at least two words are required

**Syntax of a WikiWord**

* Uppercase letter(s)
* Lowercase letter(s)
* Uppercase letter(s)
* Optional lowercase or uppercase letter(s) or number(s)

**Good examples for WikiWords:**

* [[WikiWord]]
* [[GoodStyle]]
* [[AVeryLongWikiTopicNameIsAlsoPossible]]
* [[ProblemY2K]]

**Bad examples for WikiWords:**

* Web: Name with no uppercase letter in between
* T5Wiki: Name with number before the first lowercase letter
* Know-How: Name with dashes in between

**Hints**

* Insert WikiWords wherever you can. Rich linking helps to make a Wiki successful.
* To stop a WikiWord from being turned into a hyperlink, insert the text `<nop>` immediately before the WikiWord.
* A topic is usually presented in the singular. Plural WikiWords are automatically linked to the singular topic, i.e. the link [[WikiWords]] links to the topic [[WikiWord]].
* Sometimes you have to be creative to find a good WikiName. For example, if you want to create a topic about the year 2000 problem, you could go for [[FixY2K]] or [[YearTwoK]] or [[YearTwoThousand]], but not Year2K or Y2K or Y2000.
* Turn acronyms into WikiWords, i.e. take [[FaqIndex]] for a "FAQ index" topic.