Difference between revisions of "Help:Editing"
| Line 53: | Line 53: | ||
== MediaWiki Formatting == | == MediaWiki Formatting == | ||
| − | The following is a table listing some of the most common formatting syntax used on this wiki | + | The following is a table listing some of the most common formatting syntax used on this wiki: |
{| border="1" class="article-table" | {| border="1" class="article-table" | ||
|- | |- | ||
| Line 74: | Line 74: | ||
|<nowiki>No wiki ''markup''</nowiki> this way (the syntax shown here will not format the text). | |<nowiki>No wiki ''markup''</nowiki> this way (the syntax shown here will not format the text). | ||
|} | |} | ||
| + | |||
| + | For more on formatting, please see [http://www.mediawiki.org/wiki/Help:Formatting#Text_formatting_markup Help:Formatting - Text formatting markup]. | ||
== HTML Tags == | == HTML Tags == | ||
| − | HTML stands for [http://en.wikipedia.org/wiki/HTML Hypertext Markup Language] and is used in the creation of webpages. HMTL is supported by MediaWiki, which allows for special tag functions within articles. The following is a table listing some of the most common HTML tags which are used in wiki articles | + | HTML stands for [http://en.wikipedia.org/wiki/HTML Hypertext Markup Language] and is used in the creation of webpages. HMTL is supported by MediaWiki, which allows for special tag functions within articles. The following is a table listing some of the most common HTML tags which are used in wiki articles: |
{| border="1" class="article-table" | {| border="1" class="article-table" | ||
|- | |- | ||
| Line 101: | Line 103: | ||
also ceases wiki syntax, like <nowiki> does.</pre> | also ceases wiki syntax, like <nowiki> does.</pre> | ||
|} | |} | ||
| − | If you want to learn more about | + | |
| + | For more on HTML tags in MediaWiki formatting, please see [http://www.mediawiki.org/wiki/Help:Formatting#HTML_tags Help:Formatting - HTML tags]. If you want to learn more about HTML, I suggest reading through [http://www.w3schools.com/html/default.asp w3School's HTML Tutorial]. | ||
=== About CSS === | === About CSS === | ||
| Line 112: | Line 115: | ||
===MediaWiki Table Steps=== | ===MediaWiki Table Steps=== | ||
| − | The following MediaWiki syntax is used to create tables | + | The following MediaWiki syntax is used to create tables: |
{| border="1" class="article-table" style="width: 1000px; height: 500px;"</pre> | {| border="1" class="article-table" style="width: 1000px; height: 500px;"</pre> | ||
|- | |- | ||
| Line 139: | Line 142: | ||
|Ends the table. | |Ends the table. | ||
|} | |} | ||
| + | |||
| + | Please see [http://www.w3schools.com/html/html_tables.asp HTML Tables] for more details. | ||
===MediaWiki Table Example=== | ===MediaWiki Table Example=== | ||
| Line 159: | Line 164: | ||
| row 2, data 2 | | row 2, data 2 | ||
|} | |} | ||
| + | |||
===HTML Table Steps=== | ===HTML Table Steps=== | ||
| − | The following tags are used to create tables. | + | The following tags are used to create tables. |
{| border="1" class="article-table" | {| border="1" class="article-table" | ||
|- | |- | ||
| Line 184: | Line 190: | ||
|This is put at the end of a table. | |This is put at the end of a table. | ||
|} | |} | ||
| + | |||
| + | Please see [http://www.mediawiki.org/wiki/Help:Tables Help:Tables] for more details. | ||
===HTML Table Example=== | ===HTML Table Example=== | ||
| Line 197: | Line 205: | ||
</table></pre> | </table></pre> | ||
<table border="1"><tr><td>row 1, cell 1</td><td>row 1, cell 2</td></tr><tr><td>row 2, cell 1</td><td>row 2, cell 2</td></tr></table> | <table border="1"><tr><td>row 1, cell 1</td><td>row 1, cell 2</td></tr><tr><td>row 2, cell 1</td><td>row 2, cell 2</td></tr></table> | ||
| + | |||
===Note on tables=== | ===Note on tables=== | ||
Revision as of 07:59, 2 January 2014
Please read the AlthasWiki FAQ before reading further.
This page should cover all the basic information that an AlthasWiki article editor should need to know. It is strongly recommended that you read this guide, even if you have previous MediaWiki experience.
Contents
MediaWiki Basics
Creating a Wiki Article
Before you can create (or edit) articles on this wiki, you will need to be a part of the AlthasDev group. If you are not already, please ask on the User_talk:Admin page.
Now, before you create an article, make sure that it isn't already created:
- Go to the Search box (currently on the left of the page) and search for the article you want to create.
- If one exists, don't create a new one!
- If you have information that would benefit an already-created article, then Edit the article.
If you can't find an article on the subject, but do see it referenced in one or more articles, then you should probably create a new article for the subject. I say "probably" because not all subjects necessarily need new articles. Some may be irrelevant to the AlthasWiki (creating a general "world" page to explain what the word is) or could simply be added as a part of another page (in which case, please go to Edit).
If you truly feel this subject needs a new article (use your best judgement here), then read on to linking to a new AlthasWiki article. There is another method for creating an article without the need of a link, but it is not advised (and won't be covered in this guide).
Linking to a (New) Wiki Article
- Add double brackets around the word that you'd like to create an article for (this will create a link to a new article, unless it already exists in the wiki).
[[article]]
2. Figure out a name for the article. As is mentioned in the FAQ, you should add "Lore:" or "SO:" as a prefix to your article name.
If an article is related to the history, geography, etc of Althas, then it needs a "Lore:" prefix. If an article is related to the Lays of Althas: Sundered Order game, then it need an "SO:" prefix. If neither of the above, then do not include a prefix (this should be quite rare).
[[Lore:ArticleName]]
If an article is dealing with the Lays of Althas: Sundered Order game itself (be it gameplay, quest, etc), then it needs an "SO:" prefix.
[[SO:ArticleName]]
3. With links, you need to have the name of the article first, then the word that will show up in the article (containing the link).
[[Lore:ArticleName|word]]
Please see Help:Links - MediaWiki Linking for more details.
Discussion
To discuss about an article, go to the top of an article and click the "discussion" link. The main intention of an article's discussion page is to talk about the article in question.
Edit
To edit an article, go to the top of an article and click the "edit" link.
History
To see a history of past edits, click the "history" link. The following explains what you are seeing in an article's history page (from left to right).
- (curr | prev): "Current" and "Previous" show the differences between two edits. The two radio buttons you select (just to the right of these two links) will be the two edits that are compared.
- Time and date: The time and date of past edits to an article. You can click them to see what the article once looked like at that time.
- Username: The user responsible for the edit at the time and date in question.
- talk: The user's Talk page.
- undo: Undo the changes in that specific edit. Not generally recommended.
Delete
To delete an article, go to the top of an article and click the "delete" link. An article can not be recovered after deletion, use discretion!
Move
To move an article, go to the top of an article and click the "move" link. Moving an article will rename the article and move all of its history to the new name.
Protect
To protect an article, go to the top of an article and click the "protect" link. This page will allow the user to effect the rights of who can/cannot edit and move the article.
Watch
To watch/unwatch an article, go to the top of an article and click the "watch" or "unwatch" link. By clicking this link, your account will be notified of edits to the selected article.
MediaWiki Formatting
The following is a table listing some of the most common formatting syntax used on this wiki:
| Syntax | Example |
|---|---|
''Italic'' |
Italicize a word, phrase, sentence, etc. |
'''Bold''' |
Bold a word, phrase, sentence, etc. |
'''''Bold & Italic''''' |
Bold & italicize a word, phrase, sentence, etc. |
<strike>strike text</strike> |
|
no ''markup'' |
No wiki ''markup'' this way (the syntax shown here will not format the text). |
For more on formatting, please see Help:Formatting - Text formatting markup.
HTML Tags
HTML stands for Hypertext Markup Language and is used in the creation of webpages. HMTL is supported by MediaWiki, which allows for special tag functions within articles. The following is a table listing some of the most common HTML tags which are used in wiki articles:
| Syntax | Example |
|---|---|
| Underline | Underline a word, phrase, sentence, etc. |
<br /> |
MediaWiki ignores single line breaks (Enter key). You can break to a new paragraph by leaving an empty line (two Enters), or Begin a new line within a paragraph with this HTML tag. |
<blockquote>Blockquote</blockquote> |
Will tab the text inside the
and leave spaces above and below. |
<!-- Comment --> |
Comments are visible only inside edit mode. These will generally be left as notes for wiki editors. |
<pre>preformatted text</pr e> (without the extra space between "pr" and "e") |
Text in a pre element is displayed in a fixed-width font; it preserves both spaces and line breaks. It also ceases wiki syntax, like <nowiki> does. |
For more on HTML tags in MediaWiki formatting, please see Help:Formatting - HTML tags. If you want to learn more about HTML, I suggest reading through w3School's HTML Tutorial.
About CSS
CSS (Cascading Style Sheets) is a style sheet language used for formatting purposes (alongside HTML) in web design. CSS is supported by MediaWiki article pages. If you want to learn about this style sheet language, I suggest reading through w3School's CSS Tutorial.
Currently, AlthasWiki is using CSS Message Boxes for special message boxes here on the wiki. Until proper MediaWiki Message Boxes are created for AlthasWiki (like mbox), CSS message boxes will be used as placeholders. The CSS code for these message boxes can be found under MediaWiki:Common.css.
Tables in MediaWiki
Tables are used fairly often on the AlthasWiki. There are two ways to create tables in MediaWiki:
MediaWiki Table Steps
The following MediaWiki syntax is used to create tables:
| Step 1: | {| class="article-table" border="1" cellpadding="1" cellspacing="1" style="width: 750px; height: 400px;"
|
Create a new table. All variables except for class="article-table"are optional (defaulting, usually, to 1).
|
| Step 2: | |- |
Start a new Table Row. |
| Step 3, Optional: | ! scope="col"|Table Header |
! scope="col"|adds a new Table Header cell (column) to the table (optional). Repeat Step 3 as many times as you'd like until you have the number of header cells you want to use in your table (then preceed back to Step 2, but you cannot do Step 3 again). Please be sure that all proceeding table datas (as explained in Step 4) match the number of table headers. |
| Step 4, Optional: | |Table Data |
Adds a new Table Data cell (column) to the table (optional). Repeat Step 4 as many times as you'd like until you have the number of header cells you want to use in your table (unless you performed Step 3, in which case the number of table datas must match the number of table headers). Go back to Step 2 if you'd like more table rows (but skip Step 3 all times forward now). If you wish to end the table, go to Step 5. |
| Step 5: | |} |
Ends the table. |
Please see HTML Tables for more details.
MediaWiki Table Example
{| class="article-table" border="1"
|-
| row 1, data 1
| row 1, data 2
|-
| row 2, data 1
| row 2, data 2
|}
| row 1, data 1 | row 1, data 2 |
| row 2, data 1 | row 2, data 2 |
HTML Table Steps
The following tags are used to create tables.
| Step 1: | <table border="1"> |
This begins a new table. The bordervariable is the width that the table will take: set as 0 for an invisible border. |
| Step 2: | <tr> |
This starts off a new row for the table. |
| Step 3: | <td>cell</td> |
This starts off a new cell in the row you just created (begin with <td> and end with </td>. You can repeat Step 3 as many times as you like to create new cells (creating a new column every time). |
| Step 4: | </tr> |
This ends off a row. You can then go back to Step 2 if you'd like to create another row. |
| Step 5: | </table> |
This is put at the end of a table. |
Please see Help:Tables for more details.
HTML Table Example
<table border="1"> <tr> <td>row 1, cell 1</td> <td>row 1, cell 2</td> </tr> <tr> <td>row 2, cell 1</td> <td>row 2, cell 2</td> </tr> </table>
| row 1, cell 1 | row 1, cell 2 |
| row 2, cell 1 | row 2, cell 2 |
Note on tables
On the AlthasWiki, I personally prefer using MediaWiki syntax for tables over HTML Tables (the former is much easier to read; the latter will add space preceding the table if any are included, which usually means you'll have to include no spaces in the HTML tags).
Extensions
These are the extensions used on the Wiki:
- AudioPlayer2: Allows the embeding of MP3 audio files via WordPress Audio Player Standalone.
- ConfirmEdit: To help fight against bot registration.
- QuestyCaptcha: Plugin for the ConfirmEdit extension. Adds a question and answer captcha during user registration.
- CSS MenuSidebar: Allows additional sidebar elements as menus with "dropdown" items.
- Modified MediaWiki:Common.css to allow dropdown menu items.
- Modified MediaWiki:Monobook.css skin as dropdown menu items were cut off on body of wiki.
- Access via MediaWiki:MenuSidebar
- Replace Text: Provides a special page to allow administrators to do a global string find-and-replace on both the text and titles of the wiki's content pages. (If you would like access to this extension, please contact Admin).
- Access via Special:ReplaceText
- Talkright: The editing of talk pages is now a distinct action from the editing of articles.
- UserMerge: Allows wiki users with the usermerge permission (Bureaucrat in this case) to merge one Wiki user's account with another Wiki user's account.
- Access via Special:UserMerge
See Special:Version for further details.
Skins
These are skins that are being looked into as options for the Wiki (aside from the MediaWiki default ones):
