Help:Editing
From LevelTenWiki
This article is to help contributors format clear and consistent articles for easy comprehension. For help on naming pages or hiding articles please see Help:Moving Pages
A more complete reference for editing can be found on the mediawiki site: http://meta.wikimedia.org/wiki/Help:Editing
Contents |
Table of Contents
The Wiki will automatically create a table of contents for people browsing the page using the headings you provide in the article. Think of the equal signs as the <h2> through <h4> as used on a typical LevelTen website. If the Table of contents looks wrong, consider revising the hierarchy of the headings you chose.
Section Headers
Put equal signs around major topic headings
Minor Topic Heading
Double equal signs around text make it a minor topic heading
Sub Heading
Triple Equal signs make it a sub heading
Sub Sub Heading
I can't imagine you'd need to get this detailed too often, but when you do, you can put four equals signs around text. The change is barely noticeable from three equals signs, but the main benefit is that it shows up in the table of contents.
Writing Content
Treat the first paragraph of the article as a general introduction. Do not provide a Heading, because the Article Name should suffice. The table of contents will be automatically generated right before the first heading you use if the content of the article is long enough to potentially cause scrolling.
- Write your thoughts in simple declarative sentences, without words indicating speakers such as I, we, you ,me, or us.
- Try to find reputable references and link or cite the source.
- If you do find sources, include them in a section at the bottom of your article called 'External Links' (with single equal signs around it)
- When writing about how our business incorporates the topic's information, put it in a section title 'Our Practices' (single equals) right before 'External Links'
Formatting Content
This section deals with formatting and emphasizing text, as well as appropriately listing items and linking to other pages, internal and external
Basic formatting
Normal text can be typed out. Some HTML is allowed, such as the span with CSS applied that makes this green box appear.
Line breaks aren't necessary, just separate your paragraphs by a line to make a new paragraph. Leading and kerning cannot be changed via wiki syntax, as the look and feel of the content should remain consistent for readability's sake. If you must change this, use the CSS properties letter-spacing and line-height.
Put two apostrophes around text to make it italic
Put three apostrophes around text to make it bold
If you'd like to make a list:
- Put an asterisk in front of the line of text
- To make a sub-list, just put two asterisks
- It's quite simple
- You can take it even further
- The list bullets and indents are rendered automatically
Ordered lists are easy as well
- First Item
- Second Item
- First Sub-item
- second sub-item
- Third Item
- Unordered subitems
- lists can be mixed in any way
- First sub-sub-item
- Second sub-sub-item
Tables
A table has weird syntax. Just check to see how this one was made to do one.
| Exclamation marks go before table headers (<th> in html). The stylesheet we have will automatically bold and center cells you declare as headings | a pipe | goes before a normal cell |
|---|---|
| a pipe-dash |- starts a new row. | you do not have to close any of these elements |
Code Snippets
To write a piece of code, indent each line with two spaces
$myVar = someFunction($foo,$bar); $myVar++;
Linking
To make a WikiLink, add two brackets around the text. The logo references this aspect of the Wiki software. When you switch back to View Mode the link will be either red or blue. Blue means that the term you are linking to exists. A red link means no page has been created for that term. There are ways of setting up terms to be an alias of another term, such as SEO redirecting to search engine optimization, so you can avoid duplicating content within the system. See Help:Moving Pages
External URLs are automatically hyperlinked...
- http://www.leveltendesign.com <- Plain URL
- LevelTen Website <- Titled HyperLink
