Difference between revisions of "Help:Markup"

ADVERTISEMENT
From Diablo Wiki
Jump to: navigation, search
(Section Headers)
m (=Aligning Cells)
 
(24 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
Wiki pages are designed to be easy to create and edit, and require a minimal amount of technical knowledge. If you can create a forum post, you can edit a wiki page. Read this page for some basic theory and common codes, and you'll be well on your way. Also keep in mind that you can always click the edit tab on an existing page to see how it was formatted.
 
Wiki pages are designed to be easy to create and edit, and require a minimal amount of technical knowledge. If you can create a forum post, you can edit a wiki page. Read this page for some basic theory and common codes, and you'll be well on your way. Also keep in mind that you can always click the edit tab on an existing page to see how it was formatted.
 +
 +
For information on how to create pages, read the [[Help:New article|New article]] help page.
  
  
 
==Wiki Code==
 
==Wiki Code==
Wikis use their own syntax (markup) for creating text formatting. Below is a list of common syntax you can use to format your pages. A more extensive guide to wiki editing can be found [http://meta.wikimedia.org/wiki/Help:Editing on Wikimedia's site].
+
Wikis use their own syntax (markup) for formatting text. Below is a list of common syntax you can use to format your pages. A more extensive guide to wiki editing can be found [http://meta.wikimedia.org/wiki/Help:Editing on Wikimedia's site].
  
  
 
===Text Formatting===
 
===Text Formatting===
Wiki pages should present information with words and occasional images, in a simple, low-tech format. Wiki pages are more analogous to forum posts or word documents than to modern webpages, and as such only a few commands are necessary. Some of the most useful are:
 
  
* ''Italic Text'' <nowiki>''Your Text''</nowiki> (2 apostrophes)<br>
+
{| width="70%"
* '''Bold Text''' <nowiki>'''Your Text'''</nowiki> (3 apostrophes)<br>
+
! What you see
* '''''Bold Italic Text''''' <nowiki>'''''Your Text'''''</nowiki> (5 apostrophes)<br>
+
! What you type
* <u>Underline</u> <nowiki><u>Your Text</u></nowiki>
+
|-
 +
| ''Italic Text''
 +
| <nowiki>''Your Text''</nowiki> (2 apostrophes)
 +
|-
 +
| '''Bold Text'''
 +
| <nowiki>'''Your Text'''</nowiki> (3 apostrophes)
 +
|-
 +
| '''''Bold Italic Text'''''
 +
| <nowiki>'''''Your Text'''''</nowiki> (5 apostrophes)
 +
|-
 +
<u>Underline</u>
 +
| <nowiki><u>Your Text</u></nowiki>
 +
|-
 +
| <strike>Strike out</strike>
 +
| <nowiki><strike>Strike out</strike></nowiki>
 +
|-
 +
| Superscripts and subscripts: X<sup>2</sup>, H<sub>2</sub>O
 +
| <nowiki>X<sup>2</sup>, H<sub>2</sub>O</nowiki>
 +
|}
  
  
===Section Headers===
+
===Text Layout===
To keep pages readable and organized, separate the text into sections. Section headers do this nicely, and are automatically added to the table of contents. Headers should be hierarchical and descending, as needed. There are several levels of headers, and the text so offset by equals signs will display in descending point size and font colour.
 
* Heading 1  <nowiki>==Your heading==</nowiki><br>
 
* Heading 2  <nowiki>===Your heading===</nowiki><br>
 
* Heading 3  <nowiki>====Your heading====</nowiki><br>
 
  
The single equal sign is ''not'' used in articles. It's used for the formatting for the title of pages. Use the double equal signs for the first heading and replace any heading hierarchies on article pages that might use the single one.
+
{| width="70%"
 +
! What you see
 +
! What you type
 +
|-
 +
| :Indented text
 +
| <nowiki>: Indented text.</nowiki>
 +
|-
 +
| <center>Centered text</center>
 +
| <nowiki><center>Centered text</center></nowiki>
 +
|-
 +
| <blockquote>The '''blockquote''' command produces block quotations, typically by surrounding them with whitespace.</blockquote>
 +
| <nowiki><blockquote>The '''blockquote''' command produces block quotations, typically by surrounding them with whitespace.</blockquote></nowiki>
 +
|}
  
  
====Lists====  
+
===Footers (Sources/Citations)===
Aside from links and tables, covered elsewhere on this page, the most common formatting tool is the list. There are two types: bulleted and numbered, and they are written in exactly the same manner. To create a bullet list, simply place asterisks (*) at the start of each line you want to bullet. If you want a numbered list, use the hash (#) sign. To add subheadings, simply use 2 or more such punctuation signs. The wiki script will automatically arrange them on the page.
 
  
<blockquote><pre>
+
{|
* Item One
+
! width="20%" | What you're doing
* Item Two
+
! width="30%" | What you see
** Item Two and a half
+
! width="50%" | What you type
*** Item two and three quarters
+
|-
* Item Three.
+
| Assigning reference number
</pre></blockquote>
+
| High proportion of women play with their romantic partner <ref>[http://news.bbc.co.uk/1/hi/technology/7796482.stm The virtual battle of the sexes] - BBC 23/12/08</ref>.
 +
| High proportion of women play with their romantic partner <nowiki><ref>[http://news.bbc.co.uk/1/hi/technology/7796482.stm The virtual battle of the sexes] - BBC 23/12/08</ref>.</nowiki>
 +
|-
 +
| Assigning reference id
 +
| Used to reference a single source multiple times in the same article <ref name=incgamers>[http://www.incgamers.com/Columns/59/2010-year-of-the-sandbox 2010: Year Of The Sandbox] - IncGamers 19/02/10</ref>.
 +
| Used to reference a single source multiple times in the same article <nowiki><ref name=incgamers>[http://www.incgamers.com/Columns/59/2010-year-of-the-sandbox 2010: Year Of The Sandbox] - IncGamers 19/02/10</ref></nowiki>.
 +
|-
 +
| Reference a reference id already created
 +
| 2010 promises to be very different from 2009. <ref name="incgamers"/>
 +
| 2010 promises to be very different from 2009. <nowiki><ref name="incgamers"/></nowiki>
 +
|}
  
Turns into:
 
----
 
* Item One
 
* Item Two
 
** Item Two and a half
 
*** Item two and three quarters
 
* Item Three.
 
----
 
  
Bullet points or numbered lists should be used to organize and format pages, and to present short facts in sequence.
+
Add <nowiki><references/></nowiki> where you want the list of citations to appear (usually at the foot of the page), and the list will appear thus:
  
 +
<references/>
  
====Soft Returns====
 
The wiki script ignores single returns. For instance, if you type something that looks like this in the edit box:
 
  
<blockquote><pre>
+
===Section Headers===
This<br>
+
To keep pages organized, separate the text into sections. Section headers do this nicely, and are automatically added to the table of contents. Headers should be hierarchical and descending, as needed. There are several levels of headers formed by equals signs that will display in descending point size and font colour.
line<br>
 
has<br>
 
a<br>
 
lot<br>
 
of<br>
 
returns.
 
</pre></blockquote>
 
  
It will show up on the page as a plain line of text, without any line breaks. You need to add a <nowiki><br></nowiki> tag to each line you want to format below the next. It's also possible to use pointed or numbered lists for breaks. Read above about lists.
+
{| width="70%"
 +
! What you see
 +
! What you type
 +
|-
 +
| <font style="font-size: 130%; color: #F9E3A0; font-weight: bold; border-bottom: 1px solid #4B100E;">Heading 1</font>
 +
| ==Heading 1==
 +
|-
 +
| <font style="color: #6D8552; border-bottom: none; font-weight: bold; font-size: 110%;">Heading 2</font>
 +
| ===Heading 2===
 +
|-
 +
| <font style="color: #91A07F; border-bottom: none; font-weight: bold; font-size: 100%;">Heading 2</font>
 +
| ===Heading 3===
 +
|}
  
  
====Quote Boxes====
+
The single equal sign is ''not'' used in articles. It's automatically used for formatting the title of pages. Use the double equal signs for the first heading.
To make a short quote stand out, simply add one space before it begins, and the wiki script will automatically place it in a red-tinted box with a special outline. For example:
 
  
Aren't I dramatic!
+
Do not put numbers at the beginning of headings as the wiki automatically inserts them in the Table of Contents box.
  
This should only be used for short notes, since items in this sort of box do not receive additional wiki formatting, and will stretch pages infinitely wide. Use the <nowiki><br></nowiki> command to keep such lines from running endlessly off to the right, if they are longer than a few words.
 
  
==Creating Links==
+
===The Table of Contents Box===
 +
Wiki format automatically creates ToC boxes like you see at the top of this page, after 4 headings have been created.  If you have only 3 headlines but need a ToC box then type <nowiki>__toc__</nowiki>.
  
Creating links is very simple and there are two methods to do so: an external site link for outside sources and an internal site link for content inside the DiabloWiki.
 
  
===Internal Links===
+
===Lists===  
Internal site link use two brackets <nowiki>[[ ]]</nowiki> on either side of the title, with an optional title (if specified, separate with a | character). <nowiki>[[Topic|Link Title]]</nowiki>
+
One of the most common formatting tool is the list used to present short facts in sequence.
  
  
====Linking to Categories====
+
{| width="70%"
Linking to [[Help:Category|categories]] can be helpful, since the search option will not generally display a category page even if that's the most useful page for their desired information. It's also helpful for newer wiki users who may not know to scroll to the bottom of a page to find the automated category links.
+
! What you see
 +
! What you type
 +
|-
 +
|
 +
* Item One
 +
* Item Two
 +
** Item Two and a half
 +
*** Item two and three quarters
 +
* Item Three
 +
| <nowiki>*</nowiki> Item One<br>
 +
<nowiki>*</nowiki> Item Two<br>
 +
<nowiki>**</nowiki> Item Two and a half<br>
 +
<nowiki>***</nowiki> Item two and three quarters<br>
 +
<nowiki>*</nowiki> Item Three
 +
|-
 +
|
 +
# Item One
 +
# Item Two
 +
## Sub item
 +
## Sub item
 +
## Sub item
 +
# Item Three
 +
# Item Four
 +
|
 +
<nowiki>#</nowiki> Item One<br>
 +
<nowiki>#</nowiki> Item Two<br>
 +
<nowiki>##</nowiki> Sub item<br>
 +
<nowiki>##</nowiki> Sub item<br>
 +
<nowiki>##</nowiki> Sub item<br>
 +
<nowiki>#</nowiki> Item Three<br>
 +
<nowiki>#</nowiki> Item Four
 +
|-
 +
|
 +
* Female Classes
 +
**Amazon<br>Assassin<br>Sorceress
 +
* Male Classes
 +
**Barbarian<br>Druid<br>Necromancer<br>Paladin
 +
|
 +
<nowiki>*</nowiki> Female Classes<br>
 +
<nowiki>**</nowiki>Amazon<nowiki><br></nowiki>Assassin<nowiki><br></nowiki>Sorceress<br>
 +
<nowiki>*</nowiki> Male Classes<br>
 +
<nowiki>**</nowiki>Barbarian<nowiki><br></nowiki>Druid<nowiki><br></nowiki>Necromancer<nowiki><br></nowiki>Paladin
 +
|-
 +
|
 +
; List Heading : with an automatic indent
 +
; Bolds it : then will
 +
: list
 +
: your
 +
: items
 +
: below
 +
|
 +
<nowiki>;</nowiki> List Heading<nowiki>:</nowiki> with an automatic indent<br>
 +
<nowiki>;</nowiki> And no bullets<nowiki>:</nowiki> then will<br>
 +
<nowiki>:</nowiki> list<br>
 +
<nowiki>:</nowiki> your<br>
 +
<nowiki>:</nowiki> items<br>
 +
<nowiki>:</nowiki> below<br>
 +
|}
  
The problem is of course that adding the "<nowiki>[[ ]]</nowiki>" around a category name will only add that page into the category, so to create a clickable link to a category and avoiding this, type: ''"<nowiki>[[:Category:xxxxx]]</nowiki>"'' where "xxxxx" is the name of the Category.
 
  
The only difference from actually adding the category is the ":" before the "Category". An optional title is often good to use here, so people don't get confused by the "strange" name. Remember If that page is meant to be in that category, add a tag for it at the end of the page as well.
+
===Soft Returns===
 +
The wiki script ignores single returns. If you wish to create a new paragraph you need to hit return twice to leave one blank line. If you want to list something directly underneather another line of text then you need to use <nowiki><br></nowiki>
  
===External Links===
 
  
External links are used like this: <nowiki>[http://yourlink.com Your Link Title]</nowiki>.
+
===Preformatted Boxes===
  
External links can be made with one bracket on either side of the link without space and a description, like <nowiki>[http://yourlink.com]</nowiki>, and will create a link in brackets, like this: [http://www.diabloii.net].
+
These boxes will go as wide as the text, so to control their width you will need to use <nowiki><br></nowiki>.
  
To add title text to your link, use a space between the URL and the text. For example, linking to the IncGamers Diablo2 website (http://www.diabloii.net) is done with <nowiki>[http://http://www.diabloii.net Diabloii.Net  website]</nowiki> which turns into [http://diabloii.net Diabloii.Net website]. When possible, provide text for the link, as not doing so produces the "[1]" style links which are better suited to citations.
+
Preformatted boxes are used for:
  
The link can also just be typed without using brackets at all for a "bare link", such as http://www.diabloii.net. This is acceptable for simple links (like short domains) that are easily recognizable.
+
* pasting preformatted text
 +
* algorithm descriptions
 +
* program source code
 +
* ASCII art
  
==Table of Contents Boxes==
+
You make one by simply adding a space before the beginning of a sentence.
  
Wiki format is pretty clever and can automatically create TOC boxes like you see at the top of the page. A content box is automatically created when you use 4 or more headlines, which are formatted as explained above. All headlines will show up in the TOC, which is very handy.
+
Aren't I dramatic!
  
Additional equals signs will create additional layers of headings. It's that simple!
+
==Creating Links==
 +
Creating links is very simple and there are two methods to do so: an external site link for outside sources and an internal site link for content inside the {{WikiTitle}}.
  
Try to avoid putting numbers into page headers, since numbers are automatically generated by the wiki table of contents, and will look redundant or even misleading.
+
{| width="100%"
 +
! colspan="3" |Internal Links
 +
|-
 +
! What you're Linking to
 +
! What you see
 +
! What you type
 +
|-
 +
| Article
 +
| [[Worldstone]]
 +
| <nowiki>[[Worldstone]]</nowiki>
 +
|-
 +
| Category
 +
| [[:Category:Monk]]
 +
| <nowiki>[[:Category:Monk]]</nowiki>
 +
|-
 +
| Category without the word 'category' displaying
 +
| [[:Category:Classes| Monk]]
 +
| <nowiki>[[:Category:Classes |Monk]]</nowiki>
 +
|-
 +
| Section within an article
 +
| [[Monk#Background| Monk Background]]
 +
| <nowiki>[[Monk#Background]]</nowiki>
 +
|-
 +
| Link to section with own text
 +
| He travelled from his [[The Borderlands|homeland]].
 +
| <nowiki>He travelled from his [[The Borderlands|homeland]]</nowiki>.
 +
|-
 +
| To merge link and text
 +
| She soon become proficient in [[enchant]]ing.
 +
| She soon become proficient in <nowiki>[[enchant]]ing</nowiki>.
 +
|-
 +
| Between the main DiabloWiki and Diablo 2 Wiki
 +
| {{iw|Horadric_Cube Horadric Cube}}
 +
| <nowiki>{{iw|Horadric_Cube Horadric Cube}}</nowiki>
 +
|-
 +
| Directly to an image (not embedded on page)
 +
| [[:Image:Jay_Wilson.jpg| here's Jay Wilson]]
 +
| <nowiki>[[:Image:Jay_Wilson.jpg| here's Jay Wilson]]</nowiki>
 +
|-
 +
| Link to an image
 +
| [[:File:Waypoints-act1.jpg|Waypoint map]]
 +
| <nowiki>[[:File:Waypoints-act1.jpg|Waypoint map]]</nowiki>
 +
|-
 +
! colspan="3" |External Links
 +
|-
 +
| External page as url
 +
| http://www.incgamers.com
 +
| <nowiki>http://www.incgamers.com</nowiki>
 +
|-
 +
| External page as a piece of text
 +
| News at [http://www.incgamers.com IncGamers].
 +
| News at <nowiki>[http://www.incgamers.com IncGamers]</nowiki>.
 +
|-
 +
| External page as a number
 +
| [http://www.incgamers.com]
 +
| <nowiki>[http://www.incgamers.com]</nowiki>
 +
|-
 +
| External page without blue icon
 +
| {{wl|[http://diablo.incgamers.com/ Diablo: IncGamers]}}
 +
| <nowiki>{{wl|[http://diablo.incgamers.com/ Diablo: IncGamers]}}</nowiki>
 +
|}
  
 +
==Images==
 +
To insert an image, just add the following code, <nowiki>[[File:filename.jpg]]</nowiki>. Make sure you have the correct file extension. The valid image files for {{WikiTitle}} are:
 +
* .gif
 +
* .jpg
 +
* .png
 +
Images are automatically justified to the left side on a page, but it's easy to change this with variables, to make boxes around images and to change their size.
  
 +
See more examples about placing images on the '''[[Help:Image|Image Help page]]'''.
  
==Creating Tables==
+
===Images as Links===
 +
An image can be used to link elsewhere than its own image page. To do this, simply add a variable to the image like this:
 +
<blockquote><pre>
 +
[[File:Diablo_III_Logo.jpg|link=http://www.diablowiki.net/]]
 +
</pre></blockquote>
 +
Will display like this: [[File:Diablo_III_Logo.jpg|100px|link=http://www.diablowiki.net/]]
  
If you are familiar with html then wiki syntax will seem logical; however, if you are not familiar with html it is still pretty simple to follow.
+
The size attribute is used here to avoid blowing the image up to a massive size. To learn more about how to use and format images, see the '''[[Help:Image|Image Help page]]'''.
  
Here's an example of one of the mediawiki table notations:
+
This works with both internal and external links.
  
  <nowiki>{|</nowiki>
+
==Categories==
  <nowiki>! 1</nowiki>
+
Every page should be slotted into at least one category, to enable others to find it easily. If you are making new articles, it's very important to make sure they are put in the correct category.
  <nowiki>! 2</nowiki>
+
* Read more about categories in the [[Help:Category|Category Help page]].
  <nowiki>! 3</nowiki>
 
  <nowiki>|-</nowiki>
 
  <nowiki>| 4</nowiki>
 
  <nowiki>| 5</nowiki>
 
  <nowiki>| 6</nowiki>
 
  <nowiki>|}</nowiki>
 
  
which should look like this:
 
  
 +
==Creating Tables==
 +
The syntax for creating table is fairly easy and very logical. Here's a basic example:
 +
----
 +
<nowiki>{|</nowiki><br>
 +
<nowiki>! 1</nowiki><br>
 +
<nowiki>! 2</nowiki><br>
 +
<nowiki>! 3</nowiki><br>
 +
<nowiki>|-</nowiki><br>
 +
<nowiki>| 4</nowiki><br>
 +
<nowiki>| 5</nowiki><br>
 +
<nowiki>| 6</nowiki><br>
 +
<nowiki>|}</nowiki>
 +
----
 +
That will look like this:
 
{|  
 
{|  
 
! 1
 
! 1
Line 133: Line 302:
 
|}
 
|}
  
The tables are automatically formatted with the site style so you '''aren't required to add any style elements''' to the tables. The only time you would really need to add an element to the table is if you specify a width.
+
The tables are automatically formatted with the site style so you '''aren't required to add any style elements'''. The only time you would need to add an element to the table is if you want to specify a width or want to make a table that is different than the standard {{WikiTitle}} style.
  
As you can see the wiki code 'looks' like a table and you can expand on this and format more complex tables. Just check some of the pages with tables around the site if you need to see how things work.
+
As you can see the wiki code 'looks' like a table and you can expand on this and format more complex tables. It's easy enough to look at other tables as well, to get inspiration if you want to do more advanced things with it.
  
==Categories==
 
  
Categories and subcategories are the backbone of a wiki's navigation. (Especially since the wiki search options aren't very intuitive.) Every page should be slotted into at least one category, to enable other users to find it easily.
+
===Aligning Cells===
* Every page automatically displays the categories it is slotted into at the bottom of the page.
 
* Category designations should be straight forward and self evident.
 
* Category pages are generated automatically by the wiki script, with all pages in that category shown in alphabetical order. See the [[:Category:Monsters|Monsters Category]] for one example.
 
* It's helpful to add some introductory text to a category page, but this text should be kept short and to the point.
 
** If a fuller explanation is required, create a separate page for that purpose. See the [[:Category:Amazon|Amazon Category]] within which you can find an [[Amazon]] page, for instance.
 
  
To add a page to a category, (and create the category itself, if it does not already exist), place the following tag somewhere on the page in question (for ease of editing, it's recommended that categories are added at the very bottom of a page):
+
Aligning a shorter cell to the top to even out a multi-columned list.
  
<pre>
+
{|
[[Category:xxxxx]]
+
|
</pre>
+
* Locate the [[Flooded Causeway]]
 
+
* Go down to the [[Ruined Cistern]]
Where xxxxx is the name of the Category.
+
* Locate the exit to the [[Path to the Oasis]]
 
+
* Locate the [[The Forgotten Ruins]]
===Subcategories===
+
| valign="top" |
 
+
* Find Kulle's head.
Subcategories are automatically created by the wiki script, just like categories. They are displayed on categories pages, and are used to organize individual pages into smaller, more focused groups. These can overlap or intertwine to some degree. For instance, the [[:Category:Monsters|Monsters Category]] has subcategories for [[:Category:Act Bosses|Act Bosses]] and [[:Category:Superuniques|SuperUniques]]. Furthermore, the five Act Boss pages are all found within the SuperUniques category. Moving up the hierarchical tree, the monsters category is found within the [[:Category:Basics]].
+
* Return Kulle's head to [[Adria]] at [[Hidden Camp]]
 
+
* Listen to Kulle rejoice at being alive again
 
+
|}
===Linking to Categories===
 
 
 
Linking to categories can be helpful, since the search option will not generally display a category page even if that's the most useful page for their desired information. It's also helpful for newer wiki users who may not know to scroll to the bottom of a page to find automatically-generated links to every category a page is slotted into.
 
 
 
To create a clickable link to a category (without adding the page to that category), type:
 
  
 +
The code reads
 
<pre>
 
<pre>
[[:Category:xxxxx]]
+
{|
 +
|
 +
* Locate the [[Flooded Causeway]
 +
* Go down to the [[Ruined Cistern]]
 +
* Locate the exit to the [[Path to the Oasis]]
 +
* Locate the [[The Forgotten Ruins]]
 +
| valign="top" |
 +
* Find Kulle's head.
 +
* Return Kulle's head to [[Adria]] at [[Hidden Camp]]
 +
* Listen to Kulle rejoice at being alive again
 +
|}
 
</pre>
 
</pre>
  
Where xxxxx is the name of the Category. Notice this differs from the previous code by a ":" before the "Category".  If that page is meant to be in that category, add a tag for it at the end of the page as well.
 
  
==Images==
 
  
To insert an image (which must have been [[Special:Upload|previously uploaded]] to the wiki):
 
  
<pre>
 
[[Image:filename.jpg|alternate text here]]
 
</pre>
 
  
The example above shows a jpg, but it may use any valid file extension. Images inserted this way will be placed with left justification, and text will wrap around them.
+
* Read more about tables in the [[Help:Table|Table Help page]].
  
To link to the GWO Wiki page for the image, type:
+
==Try it out!==
 +
There is a special [[{{WikiTitle}}:Sandbox|Wiki Sandbox]] that you can try out your editing skills in, without making unnecessary changes to existing articles.
  
<pre>
 
[[:Image:filename.jpg]]
 
</pre>
 
 
Images automatically link to the full page for that image, where the image is displayed full size, along with any caption and copyright info included for it. Images may be set to link directly to other pages, though this is non-standard wiki practice, and its recommended that such links are provided in the image's caption, or are placed directly on the full image page. To link from an image:
 
 
<pre>
 
{{clickpic|TARGET PAGE TITLE|FULL PATH OF IMAGE FILE}}
 
</pre>
 
Where "FULL PATH OF IMAGE FILE" is the full path, for example <nowiki> http://www.imaginarywiki.com/wiki/index/image.jpg </nowiki> - so this works better with external images, but may be used with images you have uploaded with you use their full path instead of the usual shortcut.
 
 
===Image Formatting===
 
 
Images may be presented in various ways by adding commands within the brackets, after the image, separated by "pipes." For example, the image below this paragraph has the following code:
 
 
[[Image:Mon-achmel1.jpg|center|thumb|125px|Words about the image.]]
 
 
  <nowiki>[[Image:Mon-achmel1.jpg|center|thumb|125px|Words about the image.]]</nowiki>
 
 
The most common image formatting command is "frame" which simply adds a border around an image and (by default) right justifies it. Various other image formatting commands (such as thumb, or inserting a caption) will create a frame automatically, as seen in the above example.
 
* '''Right/left/center''' are valid justifying commands.
 
* Thumb will thumbnail an image, and should be used when the full image is so large it will affect a page's formatting. Default is 200 pixels wide. If a different display width is desired, simply type it in, immediately after the thumb command, separated by a pipe.
 
* To caption an image, simply type whatever you wish the caption to be, after the other commands, immediately before the closing double brackets.  Wiki formatting is to keep captions as short and to the point as possible. Long captions will stretch the image frame beyond the image, and look ugly.
 
  
 
==Further Reading==
 
==Further Reading==
 
 
* [[Help:FAQ|Onsite Wiki FAQ]]
 
* [[Help:FAQ|Onsite Wiki FAQ]]
 
* Advanced image technique placement, making thumbnails, captions, etc can be found in Wikipedia's article on [http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax extended image syntax].
 
* Advanced image technique placement, making thumbnails, captions, etc can be found in Wikipedia's article on [http://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax extended image syntax].
  
===Try it out!===
 
There is a special [[{{WikiTitle}}:Sandbox|Wiki Sandbox]] that you can try out your editing skills in, without making unnecessary changes to existing articles.
 
  
  
 
{{Help_navbox}}
 
{{Help_navbox}}

Latest revision as of 02:03, 17 November 2013

Wiki pages are designed to be easy to create and edit, and require a minimal amount of technical knowledge. If you can create a forum post, you can edit a wiki page. Read this page for some basic theory and common codes, and you'll be well on your way. Also keep in mind that you can always click the edit tab on an existing page to see how it was formatted.

For information on how to create pages, read the New article help page.


Wiki Code[edit source]

Wikis use their own syntax (markup) for formatting text. Below is a list of common syntax you can use to format your pages. A more extensive guide to wiki editing can be found on Wikimedia's site.


Text Formatting[edit source]

What you see What you type
Italic Text ''Your Text'' (2 apostrophes)
Bold Text '''Your Text''' (3 apostrophes)
Bold Italic Text '''''Your Text''''' (5 apostrophes)
Underline <u>Your Text</u>
Strike out <strike>Strike out</strike>
Superscripts and subscripts: X2, H2O X<sup>2</sup>, H<sub>2</sub>O


Text Layout[edit source]

What you see What you type
 :Indented text : Indented text.
Centered text
<center>Centered text</center>
The blockquote command produces block quotations, typically by surrounding them with whitespace.
<blockquote>The '''blockquote''' command produces block quotations, typically by surrounding them with whitespace.</blockquote>


Footers (Sources/Citations)[edit source]

What you're doing What you see What you type
Assigning reference number High proportion of women play with their romantic partner [1]. High proportion of women play with their romantic partner <ref>[http://news.bbc.co.uk/1/hi/technology/7796482.stm The virtual battle of the sexes] - BBC 23/12/08</ref>.
Assigning reference id Used to reference a single source multiple times in the same article [2]. Used to reference a single source multiple times in the same article <ref name=incgamers>[http://www.incgamers.com/Columns/59/2010-year-of-the-sandbox 2010: Year Of The Sandbox] - IncGamers 19/02/10</ref>.
Reference a reference id already created 2010 promises to be very different from 2009. [2] 2010 promises to be very different from 2009. <ref name="incgamers"/>


Add <references/> where you want the list of citations to appear (usually at the foot of the page), and the list will appear thus:

  1. The virtual battle of the sexes - BBC 23/12/08
  2. 2.0 2.1 2010: Year Of The Sandbox - IncGamers 19/02/10


Section Headers[edit source]

To keep pages organized, separate the text into sections. Section headers do this nicely, and are automatically added to the table of contents. Headers should be hierarchical and descending, as needed. There are several levels of headers formed by equals signs that will display in descending point size and font colour.

What you see What you type
Heading 1 ==Heading 1==
Heading 2 ===Heading 2===
Heading 2 ===Heading 3===


The single equal sign is not used in articles. It's automatically used for formatting the title of pages. Use the double equal signs for the first heading.

Do not put numbers at the beginning of headings as the wiki automatically inserts them in the Table of Contents box.


The Table of Contents Box[edit source]

Wiki format automatically creates ToC boxes like you see at the top of this page, after 4 headings have been created. If you have only 3 headlines but need a ToC box then type __toc__.


Lists[edit source]

One of the most common formatting tool is the list used to present short facts in sequence.


What you see What you type
  • Item One
  • Item Two
    • Item Two and a half
      • Item two and three quarters
  • Item Three
* Item One

* Item Two
** Item Two and a half
*** Item two and three quarters
* Item Three

  1. Item One
  2. Item Two
    1. Sub item
    2. Sub item
    3. Sub item
  3. Item Three
  4. Item Four

# Item One
# Item Two
## Sub item
## Sub item
## Sub item
# Item Three
# Item Four

  • Female Classes
    • Amazon
      Assassin
      Sorceress
  • Male Classes
    • Barbarian
      Druid
      Necromancer
      Paladin

* Female Classes
**Amazon<br>Assassin<br>Sorceress
* Male Classes
**Barbarian<br>Druid<br>Necromancer<br>Paladin

List Heading 
with an automatic indent
Bolds it 
then will
list
your
items
below

; List Heading: with an automatic indent
; And no bullets: then will
: list
: your
: items
: below


Soft Returns[edit source]

The wiki script ignores single returns. If you wish to create a new paragraph you need to hit return twice to leave one blank line. If you want to list something directly underneather another line of text then you need to use <br>


Preformatted Boxes[edit source]

These boxes will go as wide as the text, so to control their width you will need to use <br>.

Preformatted boxes are used for:

  • pasting preformatted text
  • algorithm descriptions
  • program source code
  • ASCII art

You make one by simply adding a space before the beginning of a sentence.

Aren't I dramatic!

Creating Links[edit source]

Creating links is very simple and there are two methods to do so: an external site link for outside sources and an internal site link for content inside the DiabloWiki.

Internal Links
What you're Linking to What you see What you type
Article Worldstone [[Worldstone]]
Category Category:Monk [[:Category:Monk]]
Category without the word 'category' displaying Monk [[:Category:Classes |Monk]]
Section within an article Monk Background [[Monk#Background]]
Link to section with own text He travelled from his homeland. He travelled from his [[The Borderlands|homeland]].
To merge link and text She soon become proficient in enchanting. She soon become proficient in [[enchant]]ing.
Between the main DiabloWiki and Diablo 2 Wiki Horadric Cube {{iw|Horadric_Cube Horadric Cube}}
Directly to an image (not embedded on page) here's Jay Wilson [[:Image:Jay_Wilson.jpg| here's Jay Wilson]]
Link to an image Waypoint map [[:File:Waypoints-act1.jpg|Waypoint map]]
External Links
External page as url http://www.incgamers.com http://www.incgamers.com
External page as a piece of text News at IncGamers. News at [http://www.incgamers.com IncGamers].
External page as a number [1] [http://www.incgamers.com]
External page without blue icon Diablo: IncGamers {{wl|[http://diablo.incgamers.com/ Diablo: IncGamers]}}

Images[edit source]

To insert an image, just add the following code, [[File:filename.jpg]]. Make sure you have the correct file extension. The valid image files for DiabloWiki are:

  • .gif
  • .jpg
  • .png

Images are automatically justified to the left side on a page, but it's easy to change this with variables, to make boxes around images and to change their size.

See more examples about placing images on the Image Help page.

Images as Links[edit source]

An image can be used to link elsewhere than its own image page. To do this, simply add a variable to the image like this:

[[File:Diablo_III_Logo.jpg|link=http://www.diablowiki.net/]]

Will display like this: Diablo III Logo.jpg

The size attribute is used here to avoid blowing the image up to a massive size. To learn more about how to use and format images, see the Image Help page.

This works with both internal and external links.

Categories[edit source]

Every page should be slotted into at least one category, to enable others to find it easily. If you are making new articles, it's very important to make sure they are put in the correct category.


Creating Tables[edit source]

The syntax for creating table is fairly easy and very logical. Here's a basic example:


{|
! 1
! 2
! 3
|-
| 4
| 5
| 6
|}


That will look like this:

1 2 3
4 5 6

The tables are automatically formatted with the site style so you aren't required to add any style elements. The only time you would need to add an element to the table is if you want to specify a width or want to make a table that is different than the standard DiabloWiki style.

As you can see the wiki code 'looks' like a table and you can expand on this and format more complex tables. It's easy enough to look at other tables as well, to get inspiration if you want to do more advanced things with it.


Aligning Cells[edit source]

Aligning a shorter cell to the top to even out a multi-columned list.

  • Find Kulle's head.
  • Return Kulle's head to Adria at Hidden Camp
  • Listen to Kulle rejoice at being alive again

The code reads

{|
| 
* Locate the [[Flooded Causeway]
* Go down to the [[Ruined Cistern]]
* Locate the exit to the [[Path to the Oasis]]
* Locate the [[The Forgotten Ruins]]
| valign="top" |
* Find Kulle's head.
* Return Kulle's head to [[Adria]] at [[Hidden Camp]]
* Listen to Kulle rejoice at being alive again
|}



Try it out![edit source]

There is a special Wiki Sandbox that you can try out your editing skills in, without making unnecessary changes to existing articles.


Further Reading[edit source]


Wiki Help Index [e]
Help Contents

Community Portal
Markup - Create article - Sandbox
Help FAQ
Wiki Support
Category Structure
DiabloWiki Policies
Help Category
Link us

Wiki Tools

Article History
Boilerplates
Deleting pages
Disambiguations
Moving Articles
Redirects
Stubs
Templates

Glossary

Articles
Categories
Images
Linking
Tables
Talk Pages
Vandalism