Editing the wiki - Formatting guide
From GrassrootsPedia
(via the Wikipedia formatting guide.)
Formatting Wiki articles works differently than writing on a standard word processor. Instead of a strict "what you see is what you get" approach, the NOI wiki uses text codes to create particular elements of the page (e.g. headings). This "language" is known as Wikitext (or Wiki-markup) and is designed for ease of editing.
Contents |
Bold and italics
The most commonly used wiki tags are bold and italics. Bolding and italicizing are done by surrounding a word or phrase with multiple apostrophes ('):
| You type | You get |
| ''italic'' | italic |
|
'''bold''' |
bold |
|
'''''bold italic''''' |
bold italic |
Headings and subheadings
Headings and subheadings are an easy way to improve the organization of an article. If you can see two or more distinct topics being discussed, you can break up the article by inserting a heading for each section.
Headings can be created like this:
| You type | You get |
|
== Heading == |
Heading |
|
=== Subheading === |
Subheading |
Headings will be added automatically to the table of contents for the page, assuming it already exists.
Linking
Linking NOI Wiki articles together is very important. These easily-created links allow users to access information related to the article they're reading and greatly add to the NOI Wiki's utility.
When to link
The easiest way to learn when to link is to look at NOI Wiki articles for examples. If you're trying to decide whether to make a link or not, ask yourself "If I were reading this article, would the link be useful to me?" Usually link the first, and only the first, occurrence of a word/term in the article, that does not have an implicitly understood definition.
How to link
When you want to make a link to another NOI Wiki page (called a wiki link) you have to put it in double square brackets, like this:
- [[Sandbox]] = Sandbox
If you want the display text of the link to have a different title, you can do so by adding the pipe "|" divider (SHIFT + BACKSLASH on English-layout and other keyboards) followed by the alternative name. For example:
- [[Target page|display text]] = display text
You can make a link to a specific section of a page like so:
- [[Target page#Target section|display text]] = display text
