==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].
==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:
* <u>Underline</u> <nowiki><u>Your Text</u></nowiki>
==Section Headers==
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 hierarchial and descending, as needed. There are three levels of headers, and the text so offset by equals signs will display in descending point size and font color.
===Section Headers===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>Subheading * Heading 2 <nowiki>===Your heading===</nowiki><br>Subheading * 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. Avoid putting numbers into page headers, since numbers are automatically generated by the wiki table of contents, and will look redundant or even misleading. ====The Table of Contents Box====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. The level structure of the TOC works just as explained above with headlines. It's that simple!
===Lists===
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 pound 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 Two and a half
*** Item two and three quarters
* Item Three.
</pre></blockquote>
Turns into:
<blockquote># * Item One# * Item Two## ** Item Two and a half### *** Item two and three quarters# * Item Three.</blockquote>
Bullet points or numbered lists should be used to organize and format pages, and to present short facts in sequence.
===Soft Returns===
====Soft Returns====The wiki script ignores single returns. For instance, if you type something that looks like this in th the edit box:
This<br>
returns.
It will 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.
Lists, generated by the * or # codes, are an exception, as shown in the above example.
===Quote =Preformatted Boxes====To make a preformatted box, for showing text with fixed width, especially when showing different types of code, 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:
To make a short quote stand out, simply add two spaces 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!
ArenUse this tool primarily to show code in explanatory pages, but it't I dramatic!s also possible to use it for short notes, since items in this sort of box do not receive additional wiki formatting, and will stretch pages infinitely wide. Use a soft break to keep such lines from running endlessly off to the right, if they are longer than a few words.
This should only be used ==Creating Links==Creating links is very simple and there are two methods to do so: an external site link for short notes, since items in this sort of box do not receive additional wiki formatting, outside sources and will stretch pages infinitely wide. Use an internal site link for content inside the <nowiki><br></nowiki> command to keep such lines from running endlessly off to the right, if they are longer than a few words{{WikiTitle}}.
=Creating Links=
Creating links is very simple and there are ===Internal Links===An internal site link use two methods brackets <nowiki>[[ ]]</nowiki> on either side of the title, with an optional title (if specified, separate with a | character). <nowiki>[[Topic|Link Title]]</nowiki>. If you add link brackets to the same article currently shown, the link will turn '''bold''' instead of into a link. It's also possible to do so: an external site modify the link for outside sources and an internal site title without changing the link for content inside by adding characters after the DiabloWikiright side brackets (<nowiki>]]</nowiki>) like this: <nowiki>[[Topic|Link Title]]ing</nowiki>.
==Internal Links==The following code:<blockquote><pre>[[Help:Contents]]<br>[[Help:Contents|Help]]<br>[[Help:Contents|Help]]ing<br>[[Help:Contents|Help]]ers<br></pre></blockquote>Will look like this:----[[Help:Contents]]<br>[[Help:Contents|Help]]<br>[[Help:Contents|Help]]ing<br>[[Help:Contents|Help]]ers<br>----
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>
==External Links==Linking to Categories====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.
External links are used like 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>[http[:Category://yourlink.com Your Link Titlexxxxx]]</nowiki>"'' where "xxxxx" is the name of the Category.
External links can be made with one bracket on either side of The only difference from actually adding the category is the link without space and a description, like <nowiki>[http"://yourlink" before the "Category".com]</nowiki>An optional title is often good to use here, and will create a link so people don't get confused by the "strange" name. Remember If that page is meant to be in bracketsthat category, like this: [http://www.diabloii.net]add a tag for it at the end of the page as well.
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 [httpHelp://diabloii.net Diabloii.Net websiteCategory|Category help page]. When possible, provide text for the link, as not doing so produces the "[1]" style links which are better suited to citations.
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.
=Table ===Linking to Images====Sometimes you might want to link directly to an image instead of Contents Boxes=embedding it on the page. If so there are two ways to do this:* Use a direct, external, link to the image url: [http://www.diablowiki.net/images/2/24/Jay_Wilson.jpg Image]* Use an internal wiki link to the image page: [[:Image:Jay_Wilson.jpg| Image]]The former way works exactly like any external link (read more about that later), for the link title, URL or a little bracketed link. The latter works just like Category Links, with a ":" in front, and with the possibility to change title with a pipe ("|").
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.
Additional equals signs will create additional layers ===External Links===External links are made similarly to internal links. The difference is that it uses single brackets (<nowiki>[ ]</nowiki>) and naturally also must contain an external URL. Another difference between internal and external links is that instead of headingsa pipe ("|") to separate the link source with an alternative title, it uses a simple space. This naturally means that it isn't possible to link to pages that uses spaces in the URL. It's easy to distinguish external links in the wiki by the "external link icon" that simple!appears on those links ([http://www.diii.net/ example]).
Try to avoid putting numbers into page headers, since numbers There are automatically generated by the wiki table three types of contentslinks that can be used; either a clickable URL, a clickable number in brackets, and will look redundant or even misleadinga clickable link title. The last one work very similar to internal links. Do note that it isn't possible to add letters at the end of an external link to make it part of the link title. The entire link title needs to be within the brackets.
====Regular URL Link====
Writing the following:
<blockquote><pre>
http://www.diii.net/
</pre></blockquote>
Will display like this: http://www.diii.net/
=Creating Tables=In cases where it's needed to show the whole URL, just write it out in the document, and it will automatically be parsed.
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.
Here's an example of one of ====Numbered Link====Writing the mediawiki table notationsfollowing:<blockquote><pre>[http://www.diii.net/]</pre></blockquote>Will display like this: [http://www.diii.net/]
This is a numbered link that is excellent to use when sourcing other pages. It will be numbered from how many similar links are on a document, so the first such link is <nowiki>{|</nowiki> <nowiki>! [1]</nowiki> , and the third one is <nowiki>! 2</nowiki> <nowiki>! [3]</nowiki> <nowiki>|-</nowiki> <nowiki>| 4</nowiki> <nowiki>| 5</nowiki> <nowiki>| 6</nowiki> <nowiki>|}</nowiki>.
which should look like this:
{| ====Link in Title====! 1Writing the following:! 2<blockquote><pre>! 3[http://www.diii.net/ Diii.net with custom title]<br>|- </pre></blockquote>| 4| 5| 6 |}Will display like this: [http://www.diii.net/ Diii.net with custom title]
The tables are automatically formatted with This is naturally 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 most commonly used link, and is used much like the table is if you specify a widthinternal links.
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.
=Categories===External Links Without Icon====It's possible to remove the little external link icon from links, and this is mostly used when linking within the Diablo community, such as links to the other Diablo wiki, or to <span class="plainlinks"> [http://www.diii.net/ Diii.net]</span>.
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 categoryFor simple links that does not contain any odd characters like "?", "=", to enable other users to find it easily.* 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 scriptor "&", with all pages in that category shown in alphabetical order. See you can use the [[Template:Category:Monsterswl|Monsters CategoryWiki Link template]] for one example.like this:* It's helpful to add some introductory text to a category page, but this text should be kept short and to the point.<blockquote><pre>** If a fuller explanation is required, create a separate page for that purpose. See the [{{wl|[http:Category//www.diii.net/ Title]}}<br></pre></blockquote>Will display like this:Amazon{{wl|Amazon Category]] within which you can find an [[Amazon]http://www.diii.net/ Title] page, for instance.}}
To For more complex URLs, full html formatting is required. Just add a page to a category<nowiki>"<span class="plainlinks">"</nowiki> directly in front of your link, (and create the category itself, if it does not already exist), place the following tag somewhere on the page in question (<nowiki>"</span>"</nowiki> directly after for ease of editing, it's recommended that categories are added at the very bottom of a page):same effect as above.
<pre>
[[Category:xxxxx]]
</pre>
Where xxxxx is ===General Linking Guidelines===When you know how to make a link in the code, it's also imperative that you know how to use this knowledge in the wiki. It's quite simple on the whole:* Link any word that has an article with the same name in the wiki.* Only link words that would make the article you are reading more clear in context for the link. Sometimes it might have an opposite effect if linking the word "stash" when it's not used to describe the ingame [[stash]], but perhaps a general description of a cache of some sort used in a novel. Know when NOT to link.* Only link the first of the Categorysame word mentioned in an article.** If an article is long, or has several sections, you should link it so that it's easy to get to the link, wherever you are. One link per section is a good guideline.
==Subcategories==
Subcategories are automatically created by the wiki script==Images==To insert an image, just like categories. They are displayed on categories pagesadd the following code, and are used to organize individual pages into smaller, more focused groups. These that you can overlap or intertwine see is very similar to some degree. For instance, the [[:Categoryother wiki links:Monsters|Monsters Category]] has subcategories for <nowiki>[[Image:Category:Act Bosses|Act Bosses]] and [[:Category:Superuniques|SuperUniquesfilename.jpg]]</nowiki>. Furthermore, Make sure you don't forget to write the five Act Boss pages file extension. The valid image files for {{WikiTitle}} are all found within the SuperUniques category:* .gif* .jpg* . Moving up pngImages will automatically be justificated to the hierarchical treeleft side on a page, but it's easy to change this with variables, the monsters category is found within to make boxes around images and to change their size. Read more about images on the [[Help:Category:BasicsImage|Image Help page]].
==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. If you are making new articles, it's very important to make sure they are put in the right category.* Read more about categories in the [[Help:Category|Category Help page]].Please also note that you need special formatting to [[Help:Markup#Linking to Categories==|link 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 ==Creating Tables==If you are familiar with html then wiki table syntax will seem logical; however, if you are not familiar with html it is still relatively simple to a category (without adding the page to that category), type:follow.
Here's an example of one of the mediawiki table notations:----<nowiki>{|</nowiki><br><nowiki>! 1</nowiki><br><nowiki>! 2</nowiki><br><nowiki>! 3</nowiki><br><prenowiki>|-</nowiki><br>[[:Category:xxxxx]]<nowiki>| 4</nowiki><br><nowiki>| 5</nowiki><br><nowiki>| 6</nowiki><br><nowiki>|}</prenowiki>----That will look like this:{| ! 1! 2! 3|- | 4| 5| 6 |}
Where xxxxx is The tables are automatically formatted with the name of site style so you '''aren't required to add any style elements''' to the Categorytables. Notice this differs from The only time you would really need to add an element to the previous code by table is if you want to specify a width or want to make a ":" before the "Category". If table that page is meant to be in that category, add a tag for it at the end of different than the page as wellstandard {{WikiTitle}} style.
=Images=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.* Read more about tables in the [[Help:Table|Table Help page]].
To insert an image (which must have been [[Special:Upload|previously uploaded]] to the wiki):
<pre>==Try it out!==There is a special [[Image{{WikiTitle}}:filename.jpgSandbox|alternate text hereWiki Sandbox]]</pre>that you can try out your editing skills in, without making unnecessary changes to existing articles.
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.
To link to the GWO Wiki page for the image, type: <pre>==Further Reading==* [[Help:Image:filename.jpgFAQ|Onsite Wiki FAQ]]</pre> Images automatically link to the full page for that * Advanced imagetechnique placement, making thumbnails, where the image is displayed full sizecaptions, along with any caption and copyright info included for it. Images may etc can be set to link directly to other pages, though this is non-standard wiki practice, and its recommended that such links are provided found in the imageWikipedia's caption, or are placed directly article 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://wwwen.imaginarywikiwikipedia.comorg/wiki/index/Wikipedia:Extended_image_syntax extended imagesyntax].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=
* [[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]. ==Try it out!==There is a special [[{{WikiTitleHelp_navbox}}:Sandbox|Wiki Sandbox]] that you can try out your editing skills in, without making unnecessary changes to existing articles.