Changes

ADVERTISEMENT
From Diablo Wiki
Jump to: navigation, search

Help:Markup

1,865 bytes removed, 12:51, 28 August 2008
no edit summary
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 hash (#) sign. To add subheadings, simply use 2 or more such punctuation signs. The wiki script will automatically arrange them on the page.
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.
===External Links===* [[Help:Category|Category help page]]
External links are used like this: <nowiki>[http://yourlink.com Your Link Title]</nowiki>.
===External Links===External links can be are made with one bracket on either side of the link without space and a description, like similarly to internal links. The difference is that it uses single brackets (<nowiki>[http://yourlink.com]</nowiki>) and naturally also must contain an external URL. Another difference between internal and external links is that instead of a pipe ("|") to separate the link source with an alternative title, and will create it uses a simple space. This naturally means that it isn't possible to link to pages that uses spaces in brackets, like this: the URL. It's easy to distinguish external links in the wiki by the "external link icon" that appears on those links ([http://www.diabloiidiii.net/ example]).
To add title text to your linkThere are three types of links that can be used; either a clickable URL, a clickable number in brackets, use or a space between the URL and the textclickable link title. For example, linking The last one work very similar 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]internal links. When Do note that it isn't possible, provide text for to add letters at the end of an external link, as not doing so produces to make it part of the "[1]" style links which are better suited link title. The entire link title needs to citationsbe within the brackets.
The link can also just be typed without using brackets at all for a "bare link", such as ====Regular URL Link====Writing the following:<blockquote><pre>http://www.diabloiidiii.net/</pre></blockquote>Will display like this:----http://www.diii. This is acceptable for simple links (like short domains) that are easily recognizablenet/<br>----In cases where it's needed to whow the whole url, just write it out in the document, and it will automatically be parsed.
==Table of Contents Boxes==Numbered Link====Writing the following:<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>[1]</nowiki>, and the third one is <nowiki>[3]</nowiki>.
Wiki format is pretty clever and can automatically create TOC boxes ====Link in Title====Writing the following:<blockquote><pre>[http://www.diii.net/ Diii.net with custom title]<br></pre></blockquote>Will display like you see at the top of the pagethis:----[http://www.diii.net/ Diii. A content box net with custom title]<br>----This is automatically created when you use 4 or more headlines, which are formatted as explained above. All headlines will show up in naturally the TOCmost commonly used link, which and is very handyused much like the internal links.
Additional equals signs will create additional layers of headings. ====External Links Without Icon====It's that simple!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>.
Try to avoid putting numbers into page headersFor simple links that does not contain any odd characters like "?", since numbers are automatically generated by the wiki table of contents"=", and will look redundant or even misleading"&", you can use the [[Template:wl|Wiki Link template]] like this:<blockquote><pre>{{wl|[http://www.diii.net/ Title]}}<br></pre></blockquote>Will display like this: {{wl|[http://www.diii.net/ Title]}}
For more complex URLs, full html formatting is required. Just add <nowiki>"<span class="plainlinks">"</nowiki> directly in front of your link, and <nowiki>"</span>"</nowiki> directly after for the same effect as above.
==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 pretty relatively simple to follow.
Here's an example of one of the mediawiki table notations:
<nowiki>{|</nowiki> <nowiki>! 1</nowiki> <nowiki>! 2</nowiki> <nowiki>! 3</nowiki> <nowiki>|-</nowiki> <nowiki>| 4</nowiki> <nowiki>| 5</nowiki> <nowiki>| 6</nowiki> <nowiki>|}</nowiki>
which should That will look like this:
{|
|}
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 want to specify a widthor 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. It's easy enough to look at other tables as well, to get inspiration if you want to do more advanced things with it.
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==
 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.* 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 editingare making new articles, it's recommended that categories very important to make sure they are added at put in the very bottom of a page): <pre>[[Category:xxxxx]]</pre> Where xxxxx is the name of the Categoryright category.  ===Subcategories=== Subcategories are automatically created by the wiki script, just like * Read more about 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, in the [[Help: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:BasicsHelp page]].
===Linking to Categories===
In order to link directly to a category, add a ":" in front of "Category", like this: [[:Category:Help]], to make it a link instead of adding the article to the category. Optional title is useful. Read more about this in the links section on this page.
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:
 
<pre>
[[:Category:xxxxx]]
</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, just add the following code, that you can see is very similar to other wiki links: <nowiki>[[Image:filename.jpg]]</nowiki>. Make sure you don't forget to write the file extension. The valid image files for {{WikiTitle}} are:
* .gif
* .jpg
* .png
Images will automatically be justificated 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. Read more about images on the [[Help:Image|Image Help page]].
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.
 
To link to the GWO Wiki page for the image, type:
 
<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==
12,486
edits