SixthWorld:Tutorial

From Sixth World Wiki

Jump to: navigation, search

Welcome to the SixthWorld Wiki! The SixthWorld Wiki is a collaborativly edited encylopedia for Shadowrun. This tutorial aims to introduce the basics of how to edit a wiki page so that you can become a contributing member to the SixthWorld Wiki community.

Please remember that this is a basic tutorial and is in no way exhaustive. However, there should be enough information here to get you going.

Good luck!

This tutorial has taken shape based off of the one available at Wikipedia. Some text has been taken directly from the Wikipedia tutorial.

Contents

[edit] Editing

An overview of Editing Pages, Show Preview, Minor Edits, and Edit Summary. These are the basic functions when working with the wiki and after reading through this section you can jump in and start contributing.

[edit] Editing pages

This is the most basic wiki function. Every page that is editable has a link, Edit this page, at the top. This allows the wiki community to add, change, modify, create, and remove content. This link takes

Let's test it out! In a new window open this page's sandbox.

[edit] Show Preview

It is important to use the Show Preview function often. This lets you see what your edits are going to look like on the final page. Using this function from the edit page will undoubtedly save you time if you make a habit of checking your work before saving.

[edit] Minor Edits

If you are logged in as a registered user you can mark an edit as Minor. The most common use of this feature is when you edit a page for spelling mistakes, adding links, or other mintor presentation issues and not changes to the content.

[edit] Edit Summary

It is considered good practice to enter a short summary of the changes you've made to a page in the Summary box prior to hitting Save. This allows people to easily see what edits you've made. It can be as simple as saying "typo" for fixing a spelling mistake or other typo to something more detailed for less minor edits.


[edit] Formatting

Wiki can accept some html tags, but most of the time using the built-in wiki mark-up language is the best option. Here we'll take a quick look at some of those wiki mark-up options.

[edit] The Edit Page Buttons

On the edit page there is a row of formatting buttons above the edit window. You can click on these to do things such as insert Bold, italics, links to other SithWorldWiki pages, external links, and other things. There are of course more formatting functions than those on the short bar above the edit window and we'll take a quick look at some of them that are and aren't there in the rest of this section.

[edit] Bold and italics

The most commonly used tags are probably bold and italics. Bolding and italiziing are done by surrounding the text with multiple apostrophes.

  • ''italics'' is rendered italics. (2 apostrophes)
  • '''bold''' is rendered bold. (3 apostrophes)
  • '''''bolded italics''''' is rendered bolded italics. (2 + 3 = 5 apostrophes)


[edit] Headings and subheadings

The next most common wiki mark-up is used to organize text on the page. Headings and subheadings are being used on this page to break up the sections. At the top of the page you will see a Table of Contents box. This box is auto-generated by the wiki when a page has three or more headings.

  • ==Top level heading== (2 equals signs)
  • ===Subheading=== (3 equals signs)
  • ====Another level down==== (4 equals signs)

[edit] Links

Here we will discuss how to add and use links on the page you are creating or editing.

[edit] Internal Links

One of the most useful features is extensive crosslisting by internal links. These easily created links allow users to access information related to the article they are currently reading.

[edit] When to link

At this early stage in the creation of the SixthWorld Wiki it is hard to know when to create and internal link and when not to. When in doubt, even if there is no page to link to currently, if you think something should be expanded on in another article make a link. Hopefully you can come back later and fill in the new page or someone else will take it upon themselves to do so.

By using internal links this way we can expand the content of the wiki and make it easier to use.

[edit] How to link

When you want to make a link to another SixthWorld Wiki page (called a wiki link) you have to put it in double square brackets, like this:

[[Article X]]

For example, if you want to make a link to the Ares Macrotechnology page, it would be:

[[Ares Macrotechnology]]

If you want the link to the article to show text other than the article title, you can add an alternative name by adding after the pipe "|" divider (SHIFT + BACKSLASH on most keyboards).

For example, if you wanted to make a link to the above example, but wanted it to say "my text" you would write it as such:

To view the article, [[Article X|my text]]...

It would appear as:

To view the article, my text...

but would link to "Article X".


[edit] Alternate endings

When you want to use the plural of an article title (or add any other suffix) for your link, you can add the extra letters directly outside the double square brackets.

For example, you would write:

Awakened creatures such as [[Western Dragon]]s....

It would appear as:

Awakened creatures such as Western Dragons....

[edit] Linking dates

Linking dates may not seem useful; however, please do link dates since it enables the use of a user preference in how dates are displayed. An unlinked date, like July 13, 2064, will always be displayed in that manner. If you link the date:

[[July 13]], [[2064]]

Wikipedia will display it in one of the following ways:

July 13, 2064
13 July 2064
2064 July 13
2064-07-13

according to the preference set by the individual user. (This feature is only available to logged in users. It only works if the date is linked.)

[edit] External links

External links should be provided for material that is referenced from other websites that for copyright or other reasons cannot or should not be included with the main text of the article. Making an external link where the URL is all the text needed is as simple as writing the URL, http://www.dumpshock.com.

To make an external link with text other than the URL you would write:

[http://www.dumpshock.com Click here to visit Dumpshock.com]

It would appear as:

Click here to visit Dumpshock.com

External links that are used as references should be placed at the end of the article and listed as follows under a heading using a bulleted list:

==External links==
*[http://www.dumpshock.com Dumpshock.com]


[edit] Talk Pages

A key feature of wikis is the ability to discuss a page and its content. This is accomplished by editing and adding to the Talk Page. You can access an articles Talk Page by clicking on the Discuss this page link at the bottom of the article. If the talk page doesn't exist feel free to be the first to add to the discussion.

The talk page is used if you have any questions or concerns about an article, but feel it would be best to discuss the content before making any changes to the article directly. If you are contemplating major changes to an article that someone else is working on it may be best to raise your concerns on the talk page before proceeding.

When you add to a talk page please remember to sign your comment with the signature tag --~~~~. This tag can also be accessed from the formatting options above the edit window, it is the next to last option. This will leave your username and a timestamp next to your comments so that other users can follow the discussion more easily.

[edit] Indenting

Indenting can help the layout of a discussion very much, making it much easier to read. A standard practice is to indent your reply one more level than the person you are replying to.

There are several ways of indenting discussed below.

[edit] Plain Indentations

The simplest way of indenting is to place a colon (:) in front of your paragraph. The more you place in front of the paragraph, the further indented it will be. for example:

   This is aligned all the way to the left
   :This is indented slightly
   ::This is indented more

Is shown as:

This is aligned all the way to the left

This is indented slightly
This is indented more

[edit] Bullet Points

You can also indent using bullets, usually used for lists. To insert a bullet, use an asterisk (*). Similar to indentation, more asterisks in front of a paragraph changes the indentation. A brief example:

   *First List Item
   *Second List Item
   **Sub-Second List Item
   *Isn't this fun!

Which is shown as:

  • First List Item
  • Second List Item
    • Sub-Second List Item
  • Isn't this fun!

[edit] Numbered Items

You can also create numbered lists. for this, use the number sign or hash symbol (#). This is usually used for polls and voting. Again, you can affect the indent of the number by the number of #'s you put before your line.

   #First Item
   #Second Item
   ##Second Sub?
   #Third Item

Is shown as:

  1. First Item
  2. Second Item
    1. Second Sub?
  3. Third Item

[edit] Example

Here is an example of a well formatted discussion:

Hi. I have a question about this article. I'm pretty sure purple elephants only live in New York!

Well, last time I was in New York, the elephants I saw were green.
I think you should find a source for your claims.
Okay - these elephant journals agree with me:
  • Elephants Monthly
  • Elephants World
I live in Australia, where the elephants look like kangaroos! These people agree with my statement:
  1. Mr. X
  2. Ms. Y
  3. Mr. Z

Here is an example signature:

--68.0.124.50 20:04, 11 Sep 2004 (Eastern Daylight Time)

[edit] Experiment

Instead of editing the sandbox to experiment click on Discuss this page at the bottom of the page and strike up a conversation!


[edit] Keep in mind

A few things to keep in mind when editing a page.

[edit] Conduct

To be expanded upon when the community figures out a code of conduct. However, please keep in mind that we are all here to share our ideas with the community. Please treat everyone with respect and try to behave in a generally civil manner towards each other.

[edit] Editorial policies

To be expaned upon later. Generally this board will have the feel and tone as that of Shadowland. However, some guidelines will exist to give the site a uniform look and feel.

[edit] Copyrights

Do not submit copyrighted material without permission.

Please note that all contributions to SixthWorld WIki are considered to be released under the GNU Free Documentation License (see SixthWorld:Copyrights for details). If you don't want your writing to be edited mercilessly and redistributed at will, then don't submit it here. You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. DO NOT SUBMIT COPYRIGHTED WORK WITHOUT PERMISSION!


[edit] Registration

Everyone is welcome to contribute to SithWorld Wiki whether or not they are registered. There are some benefits to registering, including more options and preferences as well as a defined precence in the community.

If you haven't created an account yet click on the Log in link at the top of the page and then click on the Create an Account button to register with SixthWorld Wiki and become a registered member of the community


[edit] Wrap up

Now you know the basics for working with the wiki! Any comments or feedback on this tutorial? Feel like something wasn't explained well enough, or want to know about something that isn't here? Let us know by dropping a comment on this page's talk page. You can also introduce yourself at SixthWorld:New user log.


[edit] External Links

Personal tools