Difference between revisions of "GBAtemp Wiki Tutorial"

Latest revision as of 16:08, 27 April 2010

This tutorial aims to teach you how to use this Wiki, how to create pages, headings, and much much more! It will teach you by providing examples on the most common wiki functions.

Overview

The text, images, and layout you see is created by using a special wiki markup language. Once you know the basic tags and code it is extremely easy to add things to the Wiki and edit pages! Wiki markup is a lot simpler than other markup languages such as HTML. This tutorial will teach you the basics. In addition to this tutorial one of the best ways to learn Wiki markup is to visit a page that has something you want to know how to do on it and click the "edit" tab to see how the page was made. Remember learn from examples!

If there is anything not covered here that you wish to learn about, refer to the help contents.

Creating Pages

There is no button to create a new page. Pages can generally only be created in two ways.

• Linking to a new page
• Adding the new page to your browser address

Linking to a new page

Lets say from this page I wanted to create a link to a new page called "Tutorial 1 2 3" and in the process create that page. I would use the following code:

[[Tutorial 1 2 3]]

The [[...]] tags signify a link within the wiki.

Lets create the page now:

Tutorial 1 2 3

If there is nothing on the page the link will show up in red and the page will simply show an edit box, nothing else. Use the edit box to create the page using Wiki markup. Once the page has something on it the link to it will turn blue.

Adding the new page through your browser address

The main page of the wiki as it shows up in your browser is http://wiki.gbatemp.net/wiki/Main_Page

Try changing the last part that says "Main_Page" to anything you want eg: http://wiki.gbatemp.net/wiki/Tutorials_are_fun

Going to the link will bring you to the non-existant page where you have the ability to click the edit tab and begin creating the page.

As a general rule using the internal wiki link tags [[...]] is the best way to create a page as it ensures that people will be able to find the page as there is a link to it somewhere.

Organising Headings

The content box you see at the top of this page is created automatically when you have enough headings. To create a heading use the tag:

== Title Here ==

Simple as that. The two equals signs either side of text will create the heading. But what if you want to create a sub-heading? Simple:

=== Sub-Title Here ===

Using three equals signs will create a sub-heading within the original heading. If you want another heading like it again use three equals signs again, or if you want a further sub-sub-heading use four equals signs. To create another normal heading just use two equals signs. The content box at the top of the page will automatically update to show your headings.

Please do not use level 1 headers ( = Title = )

Table Of Contents

The Table Of Contents (TOC) will automatically be placed on a page when there are enough headers present. If you do not want the TOC to appear, use:

__NOTOC__

If you wish to add a TOC to a page where there is none, use:

__FORCETOC__

Note that there are 2 underscores on both sides!

Text

Just like on the invision forums GBAtemp uses, there are tags to make your text bold or italic, create links, embed pictures etc. The tags are different to on the forums, but easy to remember.

Bolding is done by adding three ' either side of a word, like this:

'''Text you want bold here'''

Italics are done by adding two ' either side of a word, like this:

''Text you want in italics here''

Bold Italics are done by adding five ' either side of a word (2 for italics 3 for bold), like this:

'''''Text you want bold and italic here'''''

If you want to indent a new paragraph start the line with the : symbol. For example

:Indented Paragraph

Links

Internal links within the wiki (sometimes called interwiki links) are done with the follow tag:

[[Page name here]]

For example Main Page

To alter the name that is shown into the actual page, add the new title behind a "|", like this:

[[Main Page|something like this]]

Which results in something like this.

As said in the Creating Pages section you can also link to a page that has not yet been created to create it.

(Hint: Click the 'View Source' tab at the top of this page to see the code I'm using if you are unsure of anything)

External links can be added without any tag:

http://www.websiteaddress.com

If you want to name your external link, you have to use this:

[http://www.websiteaddress.com Website Name]

Note the Single [ ] (unlike the double ones for internal links) and that no "|" is used between the link and the name.

That code when used would look like this: Website Name

Images

To upload an image or file to the wiki simply click to the 'Upload file' link in the toolbox on the left hand side of the wiki. Or click the following link: Special:Upload

Images uploaded to the wiki can be posted with the following code:

[[Image:name.jpg]]

Where name.jpg is replace it with filename for the image you uploaded. As a general guideline stick with .jpg images as not all image types are supported by the uploader. Abuse of the uploader will result in an ip ban from the wiki and forums. That means no illegal or pornographic content.

To make a thumbnail image appear in the top right hand corner of a page as seen on this page, use this code:

[[Image:imagename.jpg|thumb|Description to appear below the image]]

Place this code at the very top of a page, before any headings etc.

Categories

For an example of what adding a categories tag does scroll to the very bottom of the AceKard page. It will show a small box with 'Category: NDS Slot-1 Carts'. Click it!

This will take you to a page that shows all other pages in the same category (they all have the same category code at the bottom of their pages). This is very useful for organising pages and I highly suggest you put a categories tag at the bottom of pages you create. Make sure to keep them uniform as all objects that belong together should have the same category name.

To add a category box place this code at the bottom of a page:

[[Category:Category name here]]

Create a sensible and systematic category name so that the wiki is organised neatly. For the Category link to turn blue you need at least two pages in the same category and some additional text on the page. For example I'm going to create the 'Tutorials' category by placing it at the bottom of this page. Check it out!

If you'd like to link to a category without adding it to the page, simply add another ":" before the word category:

[[:Category:Category name here]]

Deletion

If you created a page accidentally, moved a page, or if a page is no longer required, you can request for it to be deleted. Once a page has been marked with a deletion request, a staff member will take a look at it and decide whether deletion of the page is warranted or not, and will proceed to take the appropriate action.

Put the following at the top of the page you would like to make a deletion request for, and save the page:

{{Delete}}

You can also enter a reason if needed:

{{Delete|Reason}}