Difference between revisions of "Manual:Guidelines"
Line 120: | Line 120: | ||
# bullet 1 | # bullet 1 | ||
# bullet 2 | # bullet 2 | ||
− | |||
− | |||
== Tables == | == Tables == | ||
Line 143: | Line 141: | ||
|}</nowiki> | |}</nowiki> | ||
− | This is | + | This is the output for the above table: |
{| class="wikitable" | {| class="wikitable" | ||
Line 162: | Line 160: | ||
== Links to MediaWiki help topics == | == Links to MediaWiki help topics == | ||
− | |||
* [http://www.mediawiki.org/wiki/Manual:Interface/Sidebar Customizing the sidebar] | * [http://www.mediawiki.org/wiki/Manual:Interface/Sidebar Customizing the sidebar] | ||
+ | |||
* [http://www.mediawiki.org/w/index.php?title=Help:Formatting Formatting] | * [http://www.mediawiki.org/w/index.php?title=Help:Formatting Formatting] | ||
+ | |||
+ | * [http://www.mediawiki.org/wiki/Help:Tables#Wiki_table_markup_summary Table Markup] |
Revision as of 19:02, 10 May 2015
These are the guidelines for content. If you want to test out formatting then use the Manual:TestPage.
The wiki is very tolerant of extra spaces and lines in most cases. You should understand that the wiki is focused on content and easy formatting.
Contents
Spacing
Extra spaces are generally ignored
a b c
displays as
a b c
however, there is one special case. If you start a line with a space then the text is shown literally such as:
This line starts with a space and then I put lots of spaces between this word and this word
The space tells the wiki to ignore formatting and enclose the box in a table. You can also use the nowiki tag which ignores more formatting. View this in Edit to see the use of nowiki.
This is not using the nowiki tag
This is using the '''nowiki''' tag
Note that the first example using a space did not ignore the bold formatting.
Line Breaks
A single line break creates a space. For example, the following
A B C
displays as
A B C
If you want a line break between paragraphs then you see 2 line breaks. For example,
Line 1 Line 2
displays as
Line 1
Line 2
If you want double spacing then...
...you need to have three line breaks
Text Formatting
'''Bold'''
displays as Bold
''Italic''
displays as Italic
There is no underlining formatting.
Headers
Page Names
Page names handle spaces without any problems so you would name a page Employee Time Cards and not EmployeeTimeCards. All examples are working with a made up feature in the software called Widgets. This also demonstrates issues with words that have singular and pluralization forms, e.g. Budget, Budgets, Time Card, Time Cards.
The configuration page would be named Widget Configuration.
The employee page would be named Employee Widgets, because to access the Widget information you go to the employee and then to the Widgets tab.
A summary page of the reports that are available from the Report tab, Widget drop down, would be named the WidgetReports page.
Images
Use PNG images. Images are named in a similar scheme to the page that they appear on. For example, the that appears of the select tab on the Employee Main page is EmployeeMainTab.png. The picture of what appears in the tab is EmployeeMainTabPage.png.
Smaller images can appear inline by using
File:EmployeeMainTab.png"
Lists
Use * at the beginning of a line for a bulleted list, and # for a numbered list. Use
* bullet A * bullet B
displays as
- bullet A
- bullet B
# bullet 1 # bullet 2
displays as
- bullet 1
- bullet 2
Tables
Use The wikitable style table. Use line breaks to distinguish between rows.
{| class="wikitable" |- ! Header A ! Header B |- | Row A1 | Row B1 |- | Row A2 | Row B2 |}
This is the output for the above table:
Header A | Header B |
---|---|
Row A1 | Row B1 |
Row A2 | Row B2 |