No edit summary |
(that's automatic) |
||
Line 114: | Line 114: | ||
== Structure of a Wiki Page == | == Structure of a Wiki Page == | ||
This section describes the common structure of a wiki page. Follow these guidelines for every wiki page. There are additional rules used for formal Fedora documentation, covered in [[DocsProject/WritingUsingTheWiki]] ; those rules are only required for content written to follow the procedures of the [[DocsProject| Fedora Documentation Project]]. Pages that are templates of standard content that are drawn into other pages may have a different structure. | This section describes the common structure of a wiki page. Follow these guidelines for every wiki page. There are additional rules used for formal Fedora documentation, covered in [[DocsProject/WritingUsingTheWiki]] ; those rules are only required for content written to follow the procedures of the [[DocsProject| Fedora Documentation Project]]. Pages that are templates of standard content that are drawn into other pages may have a different structure. |
Revision as of 19:30, 18 March 2010
Basic Syntax
What you type | What it looks like |
---|---|
'''bold text''' |
bold text |
''italics'' |
italics |
'''''bold italics''''' |
bold italics |
<code>Monospace text</code> |
Monospace text
|
Lists
What you type | What it looks like |
---|---|
* A list item * Another list item ** Oh joy, more list items! |
|
# A numbered item # Another numbered item ## Sub items ## More sub items # Third numbered item |
|
* An unordered item... *# With a sub-list that is ordered *# More steps * Back to the first list *# Another ordered list *#* With its own sub point |
|
Links
What you type | What it looks like |
---|---|
Visit [[DocsProject]] to learn more about Fedora's documentation. |
Visit DocsProject to learn more about Fedora's documentation. |
Our [[Websites|websites team]] offers many individuals who can help Fedora. |
Our websites team offers many individuals who can help Fedora. |
See [[Artwork#Join]] on how to join the Art Team. |
See Artwork#Join on how to join the Art Team. |
[[The weather in London]] is a page that doesn't exist yet. |
The weather in London is a page that doesn't exist yet. |
http://fedoraproject.org/ |
http://fedoraproject.org/ |
Here are some sites: [http://www.deviantart.com] [http://www.flickr.com] |
Here are some sites: [1] [2] |
[http://fedoraproject.org Our home page] is full of interesting information. |
Our home page is full of interesting information. |
Use a ':' in the link to link to an [[:Image:Growth_wide.jpg|image]]. |
Use a ':' in the link to link to an image. |
The [[:Category:Documentation]] lists all end-user documentation. |
The Category:Documentation lists all end-user documentation. |
The [[Category:Documentation]] link puts this page in the listed category; the link appears automatically on the bottom of the page and not inline. |
The [[Category:Documentation]] link puts this page in the listed category; the link appears automatically on the bottom of the page and not inline. |
Tables
Tables should be used sparingly and only when necessary.
For more advanced table usage, read up on Mediawiki.org's page on tables.
What you want | How to get it |
---|---|
Start a table | {| |
Table header | ! Column 1 !! Column 2 !! Column 3 |
Table row | |- |
Table data | | Cell 1 || Cell 2 || Cell 3 |
End a table | |} |
IRC Logs
IRC logs can either be surrounded in <pre>
tags, or converted into MediaWiki pipe-tables with irclog2html and Ian's MediaWiki patch for irclog2html.
Structure of a Wiki Page
This section describes the common structure of a wiki page. Follow these guidelines for every wiki page. There are additional rules used for formal Fedora documentation, covered in DocsProject/WritingUsingTheWiki ; those rules are only required for content written to follow the procedures of the Fedora Documentation Project. Pages that are templates of standard content that are drawn into other pages may have a different structure.
- The title of the page is a first-level header. It is created automatically from the page title.
- Sections are created using the equals symbols in pairs:
== Header 2 == === Header 3 === ==== Header 4 ==== ===== Don't do this, 5 levels of nesting means you need a new page or three =====
- The table of contents is automatically created and populated when the page grows big enough.
- Anchors to sections are automatically created, with specific symbols used in place of punctuation and spaces:
This page ==> This_page This, that, and the other page ==> This%2C_that%2C_and_the_other_page