Changes

ADVERTISEMENT
From Diablo Wiki
Jump to: navigation, search

Help:Markup

3,755 bytes removed, 04:06, 21 February 2010
no edit summary
==Wiki Code==
Wikis use their own syntax (markup) for creating formatting 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===
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:
* {| width="70%"! What you see! What you type|-| ''Italic Text'' | <nowiki>''Your Text''</nowiki> (2 apostrophes)<br>* |-| '''Bold Text''' | <nowiki>'''Your Text'''</nowiki> (3 apostrophes)<br>* |-| '''''Bold Italic Text''''' | <nowiki>'''''Your Text'''''</nowiki> (5 apostrophes)<br>* |-| <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 HeadersText 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>
{| 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 single equal sign is ''not'blockquote' used in articles'' command produces block quotations, typically by surrounding them with whitespace. It</blockquote>| <nowiki><blockquote>The '''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 oneblockquote''' command produces block quotations, typically by surrounding them with whitespace.</blockquote></nowiki>|}
Avoid putting numbers into page headers, since numbers are automatically generated by the wiki table of contents, and will look redundant or even misleading.
===Footers (Sources/Citations)===
{| ! width="20%" | What you're doing! width="30%" | What you see! width=="50%" | What you type|-| Assigning reference number| 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 Table virtual battle of Contents Box===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>.Wiki format is pretty clever and can automatically create TOC boxes like you see at | Used to reference a single source multiple times in the top same article <nowiki><ref name=incgamers>[http://www.incgamers.com/Columns/59/2010-year-of -the page-sandbox 2010: Year Of The Sandbox] - IncGamers 19/02/10</ref></nowiki>. A content box is automatically |-| Reference a reference id already created when you use 4 or more headlines, which are formatted as explained above| 2010 promises to be very different from 2009. All headlines will show up in the TOC, which is <ref name="incgamers"/>| 2010 promises to be very handydifferent from 2009.<nowiki><ref name="incgamers"/></nowiki>|}
The level structure of the TOC works just as explained above with headlines. It's that simple!
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:
===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.<references/>
<blockquote><pre>
* Item One
* Item Two
** Item Two and a half
*** Item two and three quarters
* Item Three
</pre></blockquote>
Turns ===Section Headers===To keep pages organized, separate the text into:<blockquote>* Item One* Item Two** Item Two sections. Section headers do this nicely, and are automatically added to the table of contents. Headers should be hierarchical and a half*** Item two descending, as needed. There are several levels of headers formed by equals signs that will display in descending point size and three quarters* Item Three</blockquote>font colour.
Bullet points or numbered lists should be used to organize and format pages, and to present short facts in sequence.{| 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===|}
====Soft Returns====The wiki script ignores single returnsequal sign is ''not'' used in articles. It's automatically used for formatting the title of pages. For instance, if you type something that looks like this in Use the double equal signs for the edit box:first heading.
This<br>line<br>has<br>a<br>lot<br>Do not put numbers at the beginning of<br>returnsheadings as the wiki automatically inserts them in the Table of Contents box.
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.
===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>.
====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:
Aren't I dramatic!===Lists=== One of the most common formatting tool is the list used to present short facts in sequence.
Use this tool primarily to show code in explanatory pages, but it'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.
{| width==Creating Links=="70%"! 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>Creating links is very simple <nowiki>**</nowiki> Item Two and there are a half<br><nowiki>***</nowiki> Item two methods to do soand 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 external site link for outside sources and automatic indent; Bolds it : then will: list: your: items: below|<nowiki>;</nowiki> List Heading<nowiki>:</nowiki> with an internal site link for content inside the {{WikiTitle}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>|}.
===Internal LinksSoft Returns===An internal site link use two brackets <nowiki>[[ ]]</nowiki> on either side of the title, with an optional title (if specified, separate with The wiki script ignores single returns. If you wish to create a | character). <nowiki>[[Topic|Link Title]]</nowiki>new paragraph you need to hit return twice to leave one blank line. If you add link brackets want to the same article currently shown, the link will turn '''bold''' instead list something directly underneather another line of into a link. It's also possible text then you need to modify the link title without changing the link by adding characters after the right side brackets (<nowiki>]]use </nowiki>) like this: <nowikibr>[[Topic|Link Title]]ing</nowiki>.
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>
----
===Preformatted Boxes===
====Linking to Categories and Templates====Linking to [[Help:Category|categories]] can be helpful, since the search option These boxes will not generally display a category page even if that's go as wide as the most useful page for text so to control their desired information. It's also helpful for newer wiki users who may not know width you will need to scroll to the bottom of a page to find the automated category linksuse <nowiki><br></nowiki>.
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, typeAre you used for: ''"<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.* pasting preformatted text* algorithm descriptions* program source code* ASCII art
* [[Help:Category|Category help page]]You make one by simply adding a space before the beginning of a sentence.
Aren't I dramatic!
====InterWiki Creating Links====Links between the main {{wl|[http://www.diablowiki.net/ Diablo Wiki]}} and other DiabloWikis like {{wl|[http://diablo2.diablowiki.net/ Diablo 2 Wiki]}} can use a shortcut called "[[Template:Iw|InterWiki]]". It's a [[Help:Template|template]] that makes it quick Creating links is very simple and easy to make a link across wikis. You can use it like this:<blockquote><pre>{{iw|Article_Name Article Name]}}</pre></blockquote> Will display like this: {{iw|Article_Name Article Name}} (mind you, this article does not exist). The first time the article name is written, underscores '''MUST''' be used. The second time does not need to be the exact article name as you can write it in plural or singular, or perhaps a completely different word.  ====Linking to Images====Sometimes you might want to link directly to an image instead of embedding it on the page. If so there are two ways methods to do this:* Use a direct, external, link to the image urlso: [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 site 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, outside sources and with the possibility to change title with a pipe ("|"). All about [[Help:Image| uploading, adding and organising]] images in the wiki.   ===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 a pipe ("|") to separate the site 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 for content inside the URL. It's easy to distinguish external links in the wiki by the "external link icon" that appears on those links ([http://www.diii.net/ example]). There are three types of links that can be used; either a clickable URL, a clickable number in brackets, or a 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/ In cases where it's needed to show the whole URL, just write it out in the document, and it will automatically be parsed.  ====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{{WikiTitle}}. 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>.  ====Link in Title====Writing the following:<blockquote><pre>[http://www.diii.net/ Diii.net with custom title]</pre></blockquote>Will display like this: [http://www.diii.net/ Diii.net with custom title] This is naturally the most commonly used link, and is used much like the internal links. 
====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>. This works similar to the "InterWiki" link explained above, but will work with '''ANY''' web link.
It only works for simple links that does not contain any odd characters like {| width="?", 100%"! colspan=", or 3"&", |Internal Links|-! What you're Linking to! What you see! What you can use the type|-| Article| [[Template:wl|Wiki Link templateMonk]] like this:| <blockquotenowiki>[[Monk]]<pre/nowiki>{{wl|-| Category|[http[:Category://www.diii.net/ TitleClasses]]}}| </prenowiki>[[:Category:Classes]]</blockquotenowiki>Will display like this|-| Category without the word 'category' displaying| [[:Category: {{wlClasses| Classes]]|<nowiki>[[http:Category:Classes |Classes]]</nowiki>|-| Section within an article| [[Monk#Background| Monk Background]]| <nowiki>[[Monk#Background]]</www.diii.net/ Title]}}nowiki>|-| Link to section with own textFor more complex URLs, full html formatting is required| Her stats can be [[Monk| seen here]]. Just add | Her stats can be <nowiki>"<span class="plainlinks">"[[Monk| seen here]]</nowiki> directly in front of your |-| To merge link, and text| Fighting against [[Monk]]s| Fighting against <nowiki>"[[Monk]]s</spannowiki>"|-| Between the main DiabloWiki and Diablo 2 Wiki| {{iw|Amazon Amazon}}| <nowiki>{{iw|Amazon Amazon}}</nowiki> directly after for the same effect as above.|-| Directly to an image (not embeded on page)===General Linking Guidelines===When you know how to make a link in the code, it| [[:Image:Jay_Wilson.jpg| here's also imperative that you know how to use this knowledge in the wikiJay Wilson]]| <nowiki>[[:Image:Jay_Wilson. Itjpg| here's quite simple on the whole:Jay Wilson]]</nowiki>|-* | Link any word that has an article with the same name in the wikito a DiabloWiki template| Unknown| Unknown|-|-| External page as url| http://www.incgamers.com* Only link words that would make the article you are reading more clear in context for the link| <nowiki>http://www.incgamers. Sometimes it might have an opposite effect if linking the word com</nowiki>|-! colspan="stash3" when it's not used to describe the ingame |External Links|-| External page as a piece of text| News at [http://www.incgamers.com IncGamers].| News at <nowiki>[stashhttp://www.incgamers.com IncGamers]</nowiki>.|-| External page as a number| [http://www.incgamers.com], but perhaps a general description of a cache of some sort used in a novel| <nowiki>[http://www. Know when NOT to linkincgamers.com]</nowiki>|-| External page without blue icon* Only link the first of the same word mentioned in an article| {{wl|[http://diablo.incgamers.com/ Diablo: IncGamers]}}** 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| <nowiki>{{wl|[http://diablo. One link per section is a good guidelineincgamers.com/ Diablo: IncGamers]}}</nowiki>|}
==Images==
To insert an image, just add the following code, that you can see is very similar to other wiki links: <nowiki>[[File:filename.jpg]]</nowiki>. Make sure you don't forget to write have the correct file extension. The valid image files for {{WikiTitle}} are:
* .gif
* .jpg
* .png
Images will are automatically be justificated 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. Read more about images on the '''[[Help:Image|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 others to find it easily. If you are making new articles, it's very important to make sure they are put in the right correct 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]].
==Creating Tables==
If you are familiar with html then wiki The syntax for creating table syntax will seem is fairly easy and very logical; however, if you are not familiar with html it is still relatively simple to follow. Here's an a basic example of one of the mediawiki table notations:
----
<nowiki>{|</nowiki><br>
|}
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 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. It's easy enough to look at other tables as well, to get inspiration if you want to do more advanced things with it.
* [[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].
 
 
{{Help_navbox}}