Help:Basics

From Starsider Wiki

Jump to: navigation, search

This guide is intended to help first-time users unfamiliar with the workings of a Wiki to find their feet as a contributor. You may find more detailed information on the full range of options and abilities available to users at Wikimedia's Basics page, which is part of the User's Guide.

Before being able to contribute to Starsider Wiki, you must first follow the instructions on Getting Started.

Contents

Contributing to Articles

Editing an Existing Article

To make any changes to any article on Starsider Wiki - be it additions, revisions, minor alterations, corrections, or deletions - simply click on the "Edit" button from the options displayed at the top of a page. This will present you with the raw article in a Wikicode editor.

Wikicode is relatively simple, and only necessary for formatting functions - paragraphs and line breaks will be generated automatically. Some basic Wikicode can be created for you by options on the editing page, such as Bold text, Italicisation, and so on. By playing around with these buttons, you can quickly get a grasp of some of the most common and important pieces of Wikicode.

Some information about more advanced use of these functions is included below, but it is worth mentioning here the vital importance of the Internal Link tags. These are links to other articles on the Wiki, and are generated thus:

John wanted to mention [[Mike]] in his article with a link.

This would render the word "Mike" as a link to an article on Starsider Wiki called "Mike". By simply placing the double brackets around a word, the Wiki will automatically generate a link to an article with exactly the same title as the word(s) - even if one does not currently exist (in which case, users following the link will be asked if they wish to create the article). If the title of Mike's article page is actually, in full, "Michael", but we wish for the link to it to still read as just "Mike", the following alteration is necessary:

John wanted to mention [[Michael|Mike]] in his article with a link.

Words which you wish to form External Links to pages on other web sites must be placed within only single, rather than double, brackets, and should also use the separating line between the actual link and the word. For instance:

John wanted to mention [http://www.michael.com Mike] in his article with a link.

Creating a New Article

The easiest way to add a new article to the Wiki is by doing a Search using the exact title of the page you wish to create. In the Search Results you will be informed that there is no page with this title, and given the option to create it. Click on the "create this page" link to get started.

Before you are done in the Wikicode editor and save your changes, thus putting the article in place on the Wiki, please be sure to properly Categorise it. Doing this is easy, and uses the Internal Link code given above, but in the following format (placed as the very last line of the article):

[[Category:Name]]

"Name" should be replaced with the proper title of the Category you feel that your article belongs in. This should be chosen from the list of available Starsider Wiki Categories listed under the "Knowledge" sidebar panel to the right. Categorising articles is very important, allowing for information on the Wiki to be much better organised, and for people to more easily find your article by virtue of it being listed on the relevant Category page. Categories should be a means to collect together nominal and canonical elements, not destinguish specific creations - if you have a designation that is unique to RP, it's highly recommended that you consider creating an article to detail it's constituent elements instead of a category.

Making Changes - Preview, Major, and Minor Edits

In making any alterations to an article, please use the "Show preview" button on the Editor before hitting "Save page", to ensure your changes appear correctly.

The main reason for this is that the Recent Changes page is used to keep track of all alterations to all articles on the Wiki. Using "Save page" a lot will fill up this page with spam which makes it hard to filter out meaningful changes from unimportant ones. So use "Show preview" religiously if you just want to check that your Wikicode is correct and shows up properly, before you "Save". Also make any alterations you want to an article in one session, rather than saving after every tiny change that pops into your head.

Another important and useful tool for this purpose is the "Summary" bar at the bottom of the Editor. All contributors are highly encouraged to fill this out to make a brief report on the nature of the changes they have made to an article (even just a single sentence), before hitting "Save page".

You may, however, choose to instead check the "This is a minor edit" box. The general rule of thumb is that an edit of a page that consists of spelling corrections, formatting, and minor rearranging of text should be flagged as a "minor edit". A major edit is basically something that makes the entry worth revisiting for somebody who wants to watch the article rather closely. So any "real" change, even if it is a single word, should be flagged as a "major edit" and explained in the Summary.

A Note on Infobox Templates

Templates are segments of Wiki markup that are meant to be automatically ("transcluded") into a page. You add them by putting the template's name in {{double braces}}. The main use of Templates on the Starsider Wiki is to create "Infoboxes" in an article which give a summary of important information about characters, guilds, ships, planets, and so on. Please see the list of Infobox templates for what is available, and follow the specific instructions given under each template for how to apply it properly to an article.

Discussing Articles

Because a Wiki is organic in nature, with articles constantly changing and being updated, and never truly "finished", communication between contributors to an article is encouraged. For this purpose every page has a "Discussion" tab alongside "Edit" on the top. The Discussion is a separate page attached to each article, and the full range of normal Wikicode may be used within it. These are also referred to as "Talk pages".

Starting and Using a Discussion

Until it is used for the first time, each article's Discussion page will remain "uncreated". Simply click on the red "Discussion" tab and add a comment, then save, to get the page started.

Any subsequent comments may be added to the Talk page by simply clicking the "+" button which will appear after choosing to view the page. This allows you to start a new section without needing to edit the whole page. The section header becomes the edit summary when you save the page, so it only needs to be typed once.

Whenever you make a comment/contribution to a Talk page, you should always sign it by typing either three or four tildes at the end: ~~~ will generate your username after saving, while ~~~~ will generate your username and a date/timestamp.

Formatting

Because the Wiki provides for a wide range of formatting styles, proper or at least consistent formatting is essential to maintaining readable talk pages.

The reference of a comment is determined by the number of colons (':') in front of it. If a reply is made to a statement, one adds a colon to the number of colons used in the statement being replied to. This style of conversation is easy to read.

For example:

How's the soup? --[[Bob]]
:It's great!! --[[Lisa]]
::Not too bad.. --[[George]]
:::I made it myself! --[[Bob]]
I think the soup-discussion should be moved to [[Talk:Soup]].. --[[Lisa]]
:I tend to disagree. --[[George]]

Wikicode markup

In the left column of the table below, you can find a series of Wiki markup examples. In the right column, you can see the resulting output. In other words, to make text look like it looks in the right column, type it in the format you see in the left column. You may want to keep this page open in a separate browser window for reference.

Basic formatting

Wiki markup Output
You can ''italicize text'' by putting 2 
apostrophes on each side. 

3 apostrophes will bold '''the text'''.

5 apostrophes will bold and italicize 
'''''the text'''''.

You can italicize text by putting 2 apostrophes on each side.

3 apostrophes will bold the text.

5 apostrophes will bold and italicize the text.

A single
newline
has no
effect on the
layout.

But an empty line
starts a new paragraph.

A single newline has no effect on the layout.

But an empty line starts a new paragraph.

You can break lines<br />
without starting a new paragraph.

You can break lines
without starting a new paragraph.

When adding a comment to a Talk page,
you should sign it. You can do this by
adding three tildes for your user name:<br />
~~~

Four for user name plus date/time:<br />
~~~~

Five for date/time:<br />
~~~~~

When adding a comment to a Talk page, you should sign it. You can do this by adding three tildes for your user name:
User

Four for user name plus date/time:
User 19:44, October 20, 2017 (UTC)

Five for date/time:
19:44, October 20, 2017 (UTC)

Sections, lists, lines, and footnotes

Wiki markup Output
==New section==

===Subsection===

====Sub-subsection====

New section

Subsection

Sub-subsection

* ''Unordered lists'' are easy to do:
** Start every line with a star.
*** More stars indicate a deeper level.
*: Previous item continues.
** A newline
* in a list  
marks the end of the list.
* Of course you can start again.
  • Unordered lists are easy to do:
    • Start every line with a star.
      • More stars indicate a deeper level.
    Previous item continues.
    • A newline
  • in a list

marks the end of the list.

  • Of course you can start again.
# ''Numbered lists'' are:
## Very organized
## Easy to follow
A newline marks the end of the list.
# New numbering starts with 1.
  1. Numbered lists are:
    1. Very organized
    2. Easy to follow

A newline marks the end of the list.

  1. New numbering starts with 1.
*You can even do mixed lists
*#and nest them
*#*like this<br />or include newlines
  • You can even do mixed lists
    1. and nest them
      • like this
        or include newlines
Here's a definition list:
; Word : Definition of the word
; A longer phrase needing definition
: Phrase defined
; A word : Which has a definition
: Also a second one
: And even a third

Begin with a semicolon. One item per line; 
a newline can appear before the colon, but 
using a space before the colon improves 
parsing.

Here's a definition list:

Word 
Definition of the word
A longer phrase needing definition
Phrase defined
A word 
Which has a definition
Also a second one
And even a third

Begin with a semicolon. One item per line; a newline can appear before the colon, but using a space before the colon improves parsing.

: A colon (:) indents a line or paragraph.
A newline starts a new paragraph. <br>
Often used for discussion on talk pages.
: We use 1 colon to indent once.
:: We use 2 colons to indent twice.
::: 3 colons to indent 3 times, and so on.
A manual newline starts a new paragraph.
A colon (:) indents a line or paragraph.

A newline starts a new paragraph.
Often used for discussion on talk pages.

We use 1 colon to indent once.
We use 2 colons to indent twice.
3 colons to indent 3 times, and so on.

A manual newline starts a new paragraph.

A horizontal dividing line: above
----
and below.

A horizontal dividing line: above


and below.

You can add footnotes to sentences using
the ''ref'' tag -- this is especially good
for citing a source.

:There are over six billion people in the
world.<ref>CIA World Factbook, 2006.</ref>

References: <references/>

You can add footnotes to sentences using the ref tag -- this is especially good for citing a source.

There are over six billion people in the

world.<ref>CIA World Factbook, 2006.</ref>

References: <references/>

Links and URLs

Wiki markup Output
[[Jedi]] is an "internal link".

Jedi is an "internal link".

Endings are blended into the link:
[[Jedi Knight]]s, [[cloak]]ing device.

Endings are blended into the link: Jedi Knights, cloaking device.

You can put formatting around a link.
Example: ''[[Starsider]]''.

You can put formatting around a link. Example: Starsider.

The ''first letter'' of an article is automatically
capitalized, so [[starsider]] goes to the same place
as [[Starsider]]. Capitalization matters after the
first letter.

The first letter of an articles is automatically capitalized, so starsider goes to the same place as Starsider. Capitalization matters after the first letter.

[[Jedi#Training]] is a link to the
"Training" section of the "Jedi" article.

Jedi#Training is a link to the "Training" section of the "Jedi" article.

[[Jedi#Training|Jedi]] is a "piped link".
It allows you to change the name of a
link with out changing its target.

Jedi is a "piped link". It allows you to change the name of a link with out changing its target.

Automatically hide stuff in parentheses: 
[[Sith Empire (Jedi Civil War)|]].

Automatically hide namespaces: 
[[Starsider:FAQ|]]

Automatically hide stuff in parentheses: Sith Empire.

Automatically hide namespaces: FAQ

[[Bob]] is a page that doesn't exist yet.

Bob is a page that doesn't exist yet.

You can make an external link just by typing a URL:
http://www.starwars.com/databank/

You can give it a title:
[http://www.starwars.com/databank/ DB]

Or leave the title blank:
[http://www.starwars.com/databank/]

You can make an external link just by typing a URL: http://www.starwars.com/databank/

You can give it a title: DB

Or leave the title blank: [1]

Linking to an e-mail address works the same way:
mailto:someone@domain.com or 
[mailto:someone@domain.com someone]

Linking to an e-mail address works the same way: mailto:someone@domain.com or someone

Category links do not show up in line
but instead at page bottom ''and cause the page to be
listed in the category.''
[[Category:Help pages]]

Add an extra colon to ''link'' to a category in line
without causing the page to be listed in the category:
[[:Category:Help pages]]

Category links do not show up in line but instead at page bottom and cause the page to be listed in the category.

Add an extra colon to link to a category in line without causing the page to be listed in the category: Category:Help pages

The Wiki reformats linked dates to match the reader's
date preferences. These three dates will show up the
same if you choose a format in your
[[Special:Preferences|]]:
* [[July 20]], [[1969]]
* [[20 July]] [[1969]]
* [[1969]]-[[07-20]]

The Wiki reformats linked dates to match the reader's date preferences. These three dates will show up the same if you choose a format in your Preferences:

To link to books, use 
[[Wikipedia:ISBN|ISBN]] links:<br />
ISBN 0123456789X

To link to books, use ISBN links:
ISBN 0123456789X

Images, media, and tables

Wiki markup Output
Display an image:<br />
[[Image:Sswiki.png]]

Display an image:
Image:Sswiki.png

Resize an image:<br />
[[Image:Sswiki.png|50px]]

Resize an image:

Align an image:<br />
[[Image:Sswiki.png|50px|right]]

Align an image:

A framed image:<br />
[[Image:Sswiki.png|frame]]

A framed image:

Add an image caption:<br />
[[Image:Sswiki.png|frame|This is an image.]]

Add an image caption:

This is an image.
This is an image.
A thumbnail image:<br />
[[Image:Sswiki.png|thumb|100px|Logo.]]

A thumbnail image:

Logo.
Enlarge
Logo.
An image gallery:<br />
<gallery>
Image:Sswiki.png|Logos.
</gallery>

An image gallery:

Link to an image description page:<br /> 
[[:Image:Sswiki.png]]

Link to an image description page:
Image:Sswiki.png

Link directly to an image:<br />
[[media:Sswiki.png]]

Link directly to an image:
media:Sswiki.png

{| border="1" cellspacing="0" 
cellpadding="5" align="center"
! This
! is
|- 
| a
| table
|}
This is
a table
Personal tools