Advanced Editing & Editing Guide

Contents

[edit] Images

This part of the help page will tell you about the Syntax on adding images to the wiki and how to do it. This will be more in depth and ore advanced that what the basic wiki coding will tell you, so you really need the basic knowledge first before attempting this and any of the other coding in the Editing Guide Help Page.

[edit] Syntax

Input the following syntax to add an image to the page.

[[Image:{file_name}|{option}]]

The option can be zero or more of the options below;

  • border, frame, thumb, or frameless: These control how you format the image and to how to portray it.
  • left, right, center, none: These control the alignment of the image.
  • {width}px: Controls and alters the width of the image.
  • {height}px: Controls and alters the height of the image.
  • {x}px: Controls and alters the overal size of the image. e.g. 250px
    • Note that quality may be lost during resizing of the images and if an image it set above it's actual size, it will blur.
  • link={destination}: Will link an image using the arbituary title or the URL.
    • link=: Will display an image without a link. e.g. [[Image:The Waters Of Mars.jpg|20px|link=Main_Page]]The Waters Of Mars.jpg
    • Note that link= cannot be used in conjunction with the thumb syntax. As thumb is meant to link to a larger version of the image.
  • alt={alternative text}: Changed the alternative text of an image (alt="")

All of these options do not have to be arranged in any specific order, the only exception of the format options, which should be prioritised in a frame, 'thumb and frameless and/or border order. If the option giving does not match any of these, it will be considered a caption text. Caption text can obtain wiki linking and other various coding the wiki allows.

[edit] Categories

Categories are a way of grouping together pages that are similar to one another, much the Category:Creatures and Category:Template. Adding a Category to a page will resut in a bar at the bottom of a page with a link to all other pages in the specified category. Much like this;

Category:Template

To add a Category to the page, input the following syntax anywhere inside the edit box;

[[Category:{name}]]

Where {name} is in the syntax you input the name of the group into which you want the page to be grouped with. There is no specific limit to the amount of Category tags tat can be added to any given page.

Much like pages, Images can also be categorised by adding the Category syntax into their description. Also by adding Categories into Categories it then Categorises them into sub-categories, it is advised to keep a degree or order with your categories and obtain a certain hierarchy with them.

[edit] Sort Key

You can use a Sort Key to determine where a category will appear within a category, you can achieve this by using the following code;

[[Category:{name}|{SORT}]]

For example, if you wanted to add this page to the Coding Category under 'C' then you would input a syntax like this;

[[Category:Coding|Coding]]

Note: That Sort Key's are case sensitive, even the use of a space is considered a case. The order of each Category follows the order of Unicode.

The Sort key will not tamper with the Category name, the above example will still turn out as "Category:Coding".

Tip: Wikicode, by default, makes pages not in the "Main" name spaces have the same letter in that starting space. (eg. 'C' in Category Namespace) which makes this whole process and sorting efficient and redundant. A trick to avoid is is to use the 'Special' Sort Key below;

[[Category:{name}|{{PAGENAME}}]]

{{PAGENAME}} is an actual default code in wikicoding, it will create the name of the said page without having to write it down. This code is most useful when writing templates. (eg: Editing Guide) Note that certain preferences in the page name such as Template:, Help: and Category: will not appear when using {{PAGENAME}}, But will appear using {{FULLPAGENAME}}.

[edit] Creating Categories

Creating categories is just as easy as creating a new page (See: Help:The Basics), the only thing you really have to remember is to add Category: before the what you want to name the category.

Infact the wiki automatically creates a name of all the pages without having to create a category, but these categories are far more vague and really on group them together in a way that's also very general and won't help (or very little) when organising your pages.

Renaming (or moving) a category can not be done like normal pages, if the name needed to be changed, change the name of the category and te page will automatically be re-categorised into the new category, but it erases the page history which is ill-advised with wikis.

[edit] Linking to Categories

To link to a certain category you input a colon (:) before the category;

[[:Category:{name}]]

For examplte, if I used [[:Category:Template]] it will result in; Category:Template.

If you want to link to a category but give it a different name, you following the same protocol as changing the name of a link (See Help:The Basics for details on that).

[[:Category:{name}|{text}]]

And example of this is if I were to input [[:Category:Template|Link]] it will result in; Link. Redirects to a category will also need a colon.

[edit] Tables

Tables one of the best ways to organise alot of information and lay it out an an organised yet presentable way. You can create templated on the wikis by either XHTML or wikicode, but with XTML you have to directly use the elements needed but the benefit of using wikicode is that the tables are construsted using certain character symbols that, when editing, make it both visually appealling and easier to read the structure in the article.

Generally, it's best to avoid using tables unless they are absolutly needed as making tales often comlicattes the editing process.

[edit] Table Mark-up basics

{|
Table Start
|+
Table caption, optional, Placing; between Table Start and first Table Row
|-
Table Row; Optional (only optional on first row) -- Wikiengines assume the first row.
!
Table Header;optional Consecutive table header cells may be added on same line separated by double marks (!!) or start on new lines, each with its own single mark (!).
|
Table Data; Needed
|}
Table end
  • All the above coding needs to be started in a seperate line, except the double || and !!. Blank spaces at the beginning of the sentance are ignored.
  • XHTML Code. Each attribute, except Table End, optionally require one or more XHTML attribute. 'Attributes' often require all being on the same line. You can seperate atttributes with the use of a space.
    • Cells and captions (ie. | or ||, ! or !! and |+) all hold content. So to seperate any attribute from another you use the Pip (|) symbol. the content in a cell can be on the same line of a seperate one.
    • Table and Row marks (ie {| and |-) Do not directly hold any content and therefore the pipe attribute is not needed. If you add a pipe attribute then the parsar may be deleted or ot work correctly.
  • Content may (a) follow its cell mark on the same line after any optional XHTML attributes or (b) on lines below the cell mark. Content that uses wiki markup that itself needs to start on a new line, such as lists, headings, or nested tables, must be on its own new line.
  • Escaping to insert a pipe (|) character into a table use the <nowiki> markup.

[edit] The Basics

This example does not have any borders and will act as the foundation to create other tables;

Code Outcome
{|
|Item 1
|Item 2
|-
|Item 3
|Item 4
|-
|Item 5
|Item 6
|}
Item 1 Item 2
Item 3 Item 4
Item 5 Item 6

You can use the same code all on one line using the double pipe attribute rather than the single one. (||)

Adding a large number of spaces can be added to the code without it effecting the outcome;

Code Outcome
{|
|  Item1  ||  Item2  || Item3
|-
|  Item4  ||  Item5  || Item6
|-
|  Item7  ||  Item8  || Item9
|}
Item1 Item2 Item3
Item4 Item5 Item6
Item7 Item8 Item9

[edit] Table Headers

To create table headers you need to use the ! syntax.

Code Outcome
{|
! Header1
! Header2
|-
|Label1
|Label1.1
|Label1.2
|-
|Label2
|Label2.1
|Label2.2
|-
|Label3
|Label3.1
|Label3.2
|}
Header1 Header2
Label1 Label1.1 Label1.2
Label2 Label2.1 Label2.2
Label3 Label3.1 Label3.2

[edit] Captions

Captions appear in tables (usually above, unless specified otherwise) using the |+ attribute.

Code Outcome
{|
|+This is a Caption
|-
|Label1
|Label2
|-
|Label3
|Label4
|-
|Label5
|Label6
|}
This is a Caption
Label1 Label2
Label3 Label4
Label5 Label6