Difference between revisions of "Help:Markup"

ADVERTISEMENT
From Diablo Wiki
Jump to: navigation, search
m (Creating Links)
Line 191: Line 191:
 
==Creating Links==
 
==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}}.
 
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}}.
 
  
 
{| width="100%"
 
{| width="100%"
Line 201: Line 200:
 
|-
 
|-
 
| Article
 
| Article
| [[Monk]]
+
| [[Worldstone]]
| <nowiki>[[Monk]]</nowiki>
+
| <nowiki>[[Worldstone]]</nowiki>
 
|-
 
|-
 
| Category
 
| Category
| [[:Category:Classes]]
+
| [[:Category:Monk]]
| <nowiki>[[:Category:Classes]]</nowiki>
+
| <nowiki>[[:Category:Monk]]</nowiki>
 
|-
 
|-
 
| Category without the word 'category' displaying
 
| Category without the word 'category' displaying
| [[:Category:Classes| Classes]]
+
| [[:Category:Classes| Monk]]
| <nowiki>[[:Category:Classes |Classes]]</nowiki>
+
| <nowiki>[[:Category:Classes |Monk]]</nowiki>
 
|-
 
|-
 
| Section within an article
 
| Section within an article
Line 217: Line 216:
 
|-
 
|-
 
| Link to section with own text
 
| Link to section with own text
| Her stats can be [[Monk| seen here]].
+
| He travelled from his [[The Borderlands|homeland]].
| Her stats can be <nowiki>[[Monk| seen here]]</nowiki>
+
| <nowiki>He travelled from his [[The Borderlands|homeland]]</nowiki>.
 
|-
 
|-
 
| To merge link and text
 
| To merge link and text
| Fighting against [[Monk]]s
+
| She soon become proficient in [[enchant]]ing.
| Fighting against <nowiki>[[Monk]]s</nowiki>
+
| She soon become proficient in <nowiki>[[enchant]]ing</nowiki>.
 
|-
 
|-
 
| Between the main DiabloWiki and Diablo 2 Wiki
 
| Between the main DiabloWiki and Diablo 2 Wiki
| {{iw|Amazon Amazon}}
+
| {{iw|Horadric_Cube Horadric Cube}}
| <nowiki>{{iw|Amazon Amazon}}</nowiki>
+
| <nowiki>{{iw|Horadric_Cube Horadric Cube}}</nowiki>
 
|-
 
|-
| Directly to an image (not embeded on page)
+
| Directly to an image (not embedded on page)
 
| [[:Image:Jay_Wilson.jpg| here's Jay Wilson]]
 
| [[:Image:Jay_Wilson.jpg| here's Jay Wilson]]
 
| <nowiki>[[:Image:Jay_Wilson.jpg| here's Jay Wilson]]</nowiki>
 
| <nowiki>[[:Image:Jay_Wilson.jpg| here's Jay Wilson]]</nowiki>
Line 236: Line 235:
 
| Unknown
 
| Unknown
 
|-
 
|-
 +
! colspan="3" |External Links
 
|-
 
|-
 
| External page as url
 
| External page as url
 
| http://www.incgamers.com
 
| http://www.incgamers.com
 
| <nowiki>http://www.incgamers.com</nowiki>
 
| <nowiki>http://www.incgamers.com</nowiki>
|-
 
! colspan="3" |External Links
 
 
|-
 
|-
 
| External page as a piece of text
 
| External page as a piece of text
Line 254: Line 252:
 
| {{wl|[http://diablo.incgamers.com/ Diablo: IncGamers]}}
 
| {{wl|[http://diablo.incgamers.com/ Diablo: IncGamers]}}
 
| <nowiki>{{wl|[http://diablo.incgamers.com/ Diablo: IncGamers]}}</nowiki>
 
| <nowiki>{{wl|[http://diablo.incgamers.com/ Diablo: IncGamers]}}</nowiki>
|}  
+
|}
 
 
  
 
==Images==
 
==Images==

Revision as of 01:21, 19 November 2010

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

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

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

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)

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

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

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

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

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

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

Are you 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

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 a DiabloWiki template Unknown Unknown
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

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. Read more about images on the Image Help page.


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:

[[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

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

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.


Try it out!

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


Further Reading


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