Editing AsylumProjects:Tutorial

{{Shortcut|AP:TUTOR|AP:T}}


Asylum Projects is a collaborative wiki database that you can help edit and contribute to.  This tutorial will help you become a contributor to Asylum Projects.

The following article will give you guidance about the style and content of Asylum Projects articles, and tell you about the Asylum Projects community and important Asylum Projects policies and conventions.

There are links to "sandbox" pages where you can practice what you're learning. Try things out and play around! Nobody will mind if you mess up and experiment in these practice areas.

<P Style="font-size:85%">''Note: The tutorial assumes you are using the default page layout. If you're logged in and have changed your preferences, the location of links may differ.''</p>

== Editing ==
[[Image:Tut1.png|right|Click "edit" to change an article]]
With the exception of a few protected pages, every page has a link that says "'''''edit'''''", which lets you edit the page you are looking at. It is Asylum Projects's most basic feature, and allows you to make corrections and add facts to articles.  If you add information to a page, please try to provide references so others can see where you found the information.  (The same as providing sources for a research paper/book.).

Go to the [[/sandbox|sandbox]] and click the "''edit''" link. This will open an editing window containing the text for that page. Add something fun and interesting or "Hello world!", then click '''Save page''' and see what you have done! Be careful to make sure that you are editing the sandbox page, and not the text of this tutorial.

===Show preview===    
One important feature to start using now is the '''Show preview''' button. Try making an edit in the [[/sandbox|sandbox]], then clicking the '''{{Mediawiki:Showpreview}}''' button instead of '''Save Page'''. This allows you to see what the page will look like after your edit, ''before'' you actually save. We all make mistakes; this feature lets you catch them. Using Show Preview before saving also lets you try format changes and other edits without cluttering up the page history. Do not forget to save your edits after previewing, though!

===Edit summary===
[[File:800px-Mediawiki-button-preview.png|thumb|right|650px|The "[[Wikipedia:Show preview|Show preview]]" button is right next to the "save page" button and below the [[Help:Edit summary|edit summary]] field.]]
Before you hit '''Save page''', it is considered good etiquette (or "Wikiquette") to enter a polite explanation of your changes in the '''[[Wikipedia:Edit summary|Edit summary]]''' box between the edit window and the '''Save page''' and '''Show preview''' buttons. It can be quite short; for example if you just enter "typo", people will know you made a spelling correction.  Also, if the change you have made to the page is minor, such as correcting a spelling or grammar error, be sure to check the box "This is a minor edit" (this is only available if you have logged in).


==Formatting==

'''Formatting Asylum Projects articles''' is a bit different from writing on a standard word processor. Instead of a strict WYSIWYG approach ("What You See Is What You Get"), Asylum Projects uses text codes to create particular elements of the page (e.g. headings). This "language" is known as '''Wikitext''' (or '''Wiki-markup''') and is designed for ease of editing.

=== Bold and italics ===
The most commonly used wiki tags are '''bold''' and ''italics''. '''Bolding''' and ''italicizing'' are done by surrounding a word or phrase with multiple apostrophes (<tt>'</tt>):

{| style="border:none; text-align:left;"
|-<!--COLUMN HEADINGS-->
| style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You type'''	
| style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You get'''
|-<!--1ST ROW-->
|<tt><nowiki>''italic''</nowiki></tt>
|''italic''
|-<!--2ND ROW-->
|
<tt><nowiki>'''bold'''</nowiki></tt>
|
'''bold'''
|-<!--3RD ROW-->
|
<tt><nowiki>'''''bold italic'''''</nowiki></tt>
|
'''''bold italic'''''
|}

On Asylum Projects, the names of an article's subject are written in '''bold''' when they are first mentioned in the article. For example, the article [[Elizabeth II of the United Kingdom]] begins:

:'''Elizabeth II''' (Elizabeth Alexandra Mary Windsor; born 21 April 1926) is Queen of sixteen sovereign states, holding each crown and title equally.

''Italics'' may be used for the names of books, movies, albums, and computer/video game titles. If the first mention of the subject of an article is also a book or movie title then '''''bold italics''''' is used. 

For more information about when to use bold and italics, see [[AsylumProjects:Manual of style]].

===Headings and subheadings===
Headings and subheadings are an easy way to improve the organization of an article. If you can see two or more distinct topics being discussed, you can break up the article by inserting a heading for each '''[[Wikipedia:Section|section]]'''.

Headings can be created like this:

{| width=100% style="border:none; text-align:left;"
|-<!--COLUMN HEADINGS-->
| style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You type'''	
| width="80%" style="background:#E6F2FF; padding:0.3em; text-align:center;"|'''You get'''
|-
|
<tt><nowiki>== Heading ==</nowiki></tt>
| 
== Heading ==
|-
|
<tt><nowiki>=== Subheading ===</nowiki></tt><br />
|
=== Subheading ===
|}

If an article has at least four headings, a table of contents will automatically be generated. Try creating a heading in this page's [[/sandbox/]]. It will be added automatically to the table of contents for the page, assuming three others already exist. 

=== HTML ===
Wikitext contains all the features required to follow Asylum Projects formatting conventions and knowledge of [[HTML]] code is not necessary, although it is often used for more specific formatting such as using colors, text and paragraph styles, and page layout.

<div style="float:right; background-color:#f5faff; padding: .2em .6em; margin-bottom:10px; border: 1px solid #cee0f2;">'''See [[Wikipedia:How to edit a page|How to edit a page]] or the [[Wikipedia:Cheatsheet|Cheatsheet]] for more on editing a page.'''<br />
'''You can also check out an [[Wikipedia:Annotated article|annotated example page]].'''</div>
<div style="float:left; background-color: #f5faff; color: #000; padding: .2em .6em; font-size: 130%; border: 1px solid #cedff2;">'''Test what you have learned in the [[/sandbox]]'''</div><br/>
<br/>
==Linking==

'''Linking''' Asylum Projects articles together is very important. These easily created links allow users to access information related to the article they are reading and greatly add to Asylum Projects utility.

===How to link===
To make a link to another Asylum Projects page (called a <em>wiki link</em>), put it in double square brackets, like this:
:<tt><nowiki>[[Sandbox]]</nowiki></tt> = [[Sandbox]]

If you want to link to an article, but display some other text for the link, you can do so by adding the [[Help:Piped link|pipe]] "|" divider (SHIFT + BACKSLASH on English-layout and other keyboards) followed by the alternative name. For example:
:<tt><nowiki>[[Target page|display text]]</nowiki></tt> = [[Target page|display text]]

You can make a link to a specific section of a page like so:
:<tt><nowiki>[[Target page#Target section|display text]]</nowiki></tt> = [[Target page#Target section|display text]]

If you want the display text of the link to appear in italics or bold, nest the double square brackets for the link within the multiple apostrophes that delimit the italicized or bold text, like this:
:<tt><nowiki>''[[War and Peace]]''</nowiki></tt> = ''[[War and Peace]]''

Please check your links to ensure they point to the correct article. For example, [[Apple]] points to  the article about the fruit, while [[Apple, Inc.]] is the title of the article about the computer manufacturer. There are also [[Wikipedia:Disambiguation|"disambiguation" pages]] -- these are not articles, but pages which contain links to articles with similar titles. Some, such as [[Apple (disambiguation)]] are obvious, while others such as [[Georgia]] use generic titles. These differing titles make piped links especially useful, as a link to [[Georgia (country)]] is far less readable than a piped link called [[Georgia (country)|Georgia]].

===When  to link===
Adding links to an article makes it more useful, but too many links can be distracting. This is why you should only link the first occurrence of a word.  Lead sections can have more links.

Looking at other Asylum Projects articles can also help you learn when to add links. 

===Categories===
You can also put the article in a category with others in a related topic. Just type <nowiki>[[Category:]]</nowiki>, and put the name of the category between the colon and the brackets.

'''It is very important to put in the correct categories so that other people can easily find your work.''' The best way to find which categories to put in is to look at pages on similar subjects, and check which categories they use. For example if you write an article about a type of tree, you may look at an article on another type of tree to see which categories could be appropriate.

<div style="float: right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:3px;">'''For more information refer to the [[Wikipedia:Categories|Categories]] page.'''</div>

<div style="float: left; background-color: #f5faff; color: #000; padding: .2em .6em; font-size: 130%; border: 1px solid #cedff2;">'''Test what you have learned in the [[/sandbox/]]'''</div><br>
<br/>
==Referencing==

While a lot of the information within this database comes from personal research and also from other sources, if possible it is recommended to cite where you got the information.  This database wiki uses an inline citing system to make it easier to refrence where the bit of information came from.

=== Footnotes ===
The easiest way to create an inline citation is using [[Wikipedia:Footnotes|footnotes]]. You can create footnotes with '''Wiki markup''' (under the edit box on your Wiki GUI) by adding
* <nowiki><ref>YOUR SOURCE</ref></nowiki> '''ref tags''' around your source, and if not there already,
* <nowiki>{{Reflist}}</nowiki> or <nowiki><references/></nowiki> under the heading '''<nowiki>==References==</nowiki>''' near the bottom of the page.


'''If your source is a website''', you should create an '''external link''' to the website address. Do not use other Asylum Projects articles as sources. 

To create an external link to your source, put the website address ([[URL]]) in square brackets after the text you add, such as 
* <nowiki><ref>[http://www.google.com Google search engine]</ref></nowiki>
It is a good idea, though not required, to provide a short description just after the external site address. This description will be displayed in the reference list as the title of the external site, rather than the actual URL of the site. 

To cite a webpage without giving a description, you can just give the URL and enclose it in ref tags, for example
* <nowiki><ref>http://www.google.com</ref></nowiki>

There are templates allowing to format references, such as links to news articles, see [[Wikipedia:Citation templates]].

=== The external links section ===
Many Asylum Projects articles have a separate section labelled '''External links'''. This section is for linking to websites with significant and reliable additional information on an article's topic.  Not all external links are appropriate for use in a Asylum Projects article, see [[Wikipedia:External links]] for a guideline. Before adding a website to an '''External links''' section, it is advised that you suggest it on the article's '''Discussion''' (talk) page.

If you simply type in the full URL for the page to which you wish to link:
:<tt>http://www.google.com</tt>
The wiki will automatically treat this text as a link (as has been done with the URL above) and will display the raw web address, including the "<nowiki>http://</nowiki>" part. It is recommended that you do not use this format much, as raw URLs are ugly and often give no clue to what the site actually ''is''.

By including a space after a URL and inside a single set of brackets you can decide what text will be visible, for example:
:<tt><nowiki>[http://www.google.com Google search engine]</nowiki></tt>
will make only the text following the space visible, yet will still keep the link seen here:
:<tt>[http://www.google.com Google search engine]</tt>

<div style="float: left; background-color: #f5faff; color: #000; padding: .2em .6em; font-size: 130%; border: 1px solid #cedff2;">'''Test what you have learned in the [[/sandbox/]]'''</div><br/>
<br/>
==Talk Pages==
'''Talk pages''' are a key feature of Asylum Projects, offering the ability to discuss articles and other issues with other editors. They are not to be used as a chat room, soapbox, battleground or for general discussion of the article topic.

If you have a question, concern or comment related to improving the article put a note in the article's '''[[Wikipedia:Talk page|talk page]]''' and not in the article itself. You do that by clicking the "discussion" tab at the top of the page. Do not worry if the link shows up in red; it is all right to create the talk page if it does not already exist.

When you post a new comment, put it at the bottom of the talk page. The exception is, if you are responding to someone else's remarks, put your comment below theirs. You can indent your comment by typing a colon (<tt>:</tt>) at the beginning of a line.

You should sign your comments by typing <tt><nowiki>~~~</nowiki></tt> for just your username, or <tt><nowiki>~~~~</nowiki></tt> for your username and a time signature (see the example discussion below). This way, when  you save the page, your signature will be inserted automatically. Otherwise your comments, etc., will still appear but without your name.  Most of us use time signatures because it makes following discussions much easier. For your convenience, there is a button at the top of the edit box with a signature icon inserts <nowiki>"--~~~~"</nowiki> when pressed.

You can get a username by [[Special:Userlogin|creating an account]] (it is 100% free). 

=== User talk pages ===
Every contributor has a user talk page on which other contributors can leave messages. This includes contributors who have not created an account. If someone has left you a message, you will see a note saying "You have new messages", with a link to '''[[Special:Mytalk|your user talk page]]'''.

You can reply in either of two ways. One is to put a message on the user talk page of the person you are replying to. The other is to put your reply on your own talk page beneath the original message.  Both are common on Asylum Projects;  however, be aware that replying on your own talk page runs the risk that your reply won't be seen, if the user does not look at your talk page again. If you choose this approach, it is a good idea to post a notice at the top of your talk page so people know they have to keep an eye on it.

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

There are several ways of indenting in Asylum Projects:

==== Plain indentations ====
The simplest way of indenting is to place a colon (<tt>:</tt>) at the beginning of a line. The more colons you put, the further indented the text will be. A newline (pressing '''Enter''' or '''Return''') marks the end of the indented paragraph.

For example:
: <tt>This is aligned all the way to the left.</tt>
: <tt><nowiki>: </nowiki>This is indented slightly.</tt>
: <tt><nowiki>:: </nowiki>This is indented more.</tt>
is shown as:
: This is aligned all the way to the left.
:: This is indented slightly.
::: This is indented more.

====Bullet points====
You can also indent using ''bullets'', usually used for lists. To insert a bullet, use an asterisk (<tt>*</tt>). Similar to indentation, more asterisks in front of a paragraph means more indentation.

A brief example:
: <tt><nowiki>* </nowiki>First list item</tt>
: <tt><nowiki>* </nowiki>Second list item</tt>
: <tt><nowiki>** </nowiki>Sub-list item under second</tt>
: <tt><nowiki>* </nowiki>Third list item</tt>

Which is shown as:
:* First list item
:* Second list item
:** Sub-list item under second
:* Third list item

==== Numbered items ====
You can also create numbered lists. For this, use the number sign or octothorpe (<tt>#</tt>). This is usually used for polls and voting. Again, you can affect the indent of the number by the number of <tt>#</tt>s you use.

Example:
: <tt><nowiki># </nowiki>First item</tt>
: <tt><nowiki># </nowiki>Second item</tt>
: <tt><nowiki>## </nowiki>Sub-item under second item</tt>
: <tt><nowiki># </nowiki>Third item</tt>

Shows up as:
:# First item
:# Second item
:## Sub-item under second item
:# Third item

=== Example discussion ===
''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! [[Wikipedia:User page|JayRandumWikiUser]] 02:49, 10 Dec 2003 (UTC)
: Well, last time I was in New York, the elephants I saw were green. &mdash; [[Wikipedia:User page|try2BEEhelpful]] 17:28, 11 Dec 2003 (UTC)
:: I think you should find a source for your claims. [[Wikipedia:User page|Living&nbsp;&times;&nbsp;Skepticism]] 20:53, 11 Dec 2003 (UTC)
::: Okay, these elephant journals agree with me:
:::* ''Elephants Monthly''
:::* ''Elephants World''
::: &mdash; [[Wikipedia:User page|try2BEEhelpful]] 19:09, 12 Dec 2003 (UTC)
: I live in Australia, where the elephants look like kangaroos! The people below agree with my statement: [[Wikipedia:User page|-DontGdayMateMe]] 17:28, 14 Dec 2003 (UTC)
:# [[Wikipedia:User page|ElefantLuvr]] 01:22, 15 Dec 2003 (UTC)
:# [[Wikipedia:User page|AisleVoteOnAnything]] 05:41, 15 Dec 2003 (UTC)
:# [[Wikipedia:User page|alittlebehindthetimes]] 18:39, 27 Jan 2004 (UTC)

Note that if you want to include a list in your comments, add colons before each item, for example:

: <tt><nowiki>::: Okay, these elephant journals agree with me:</nowiki><br/></tt>
: <tt><nowiki>::: * ''Elephants Monthly''</nowiki><br/></tt>
: <tt><nowiki>::: * ''Elephants World''</nowiki><br/></tt>
: <tt><nowiki>::: ~~~~</nowiki></tt>

Also, signing your message off is done by:
* Writing <nowiki>~~~</nowiki> for the name ([[Wikipedia:User page|try2BEEhelpful]]), or 
* Writing <nowiki>~~~~</nowiki> for the name and date ([[Wikipedia:User page|try2BEEhelpful]] 19:09, 12 Dec 2003 (UTC)), or
* Writing <nowiki>~~~~~</nowiki> for the date only (19:09, 12 Dec 2003 (UTC)).

You should usually sign with both name and date, but votes are often signed with names only.

=== Experiment ===
Experiment!  This time, instead of editing a sandbox, leave a message on the talk page by clicking "Discuss this page" or "Discussion".  Remember to sign your user name.  You might want to try responding to someone else's post.  Remember, you should use "Show preview" to see if your formatting works before you save.

<div style="float: right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:3px;">'''Try a sample discussion at this page's [[Wikipedia talk:Tutorial (Talk pages)|Discussion Page]]'''</div>

=== Other project pages ===
In addition to Talk pages, there are some other categories of behind-the-scenes pages that help editors communicate with each other, and serve a variety of other roles in building Asylum Projects. These different areas are often referred to as '''namespaces''' &mdash; as in, "the '''Talk''' namespace".

Pages in the '''Asylum Projects''' namespace (also known as the "[[Wikipedia:Project namespace|Project namespace]]") provide information about Asylum Projects and how to use it.

Content written in a '''Template''' page will be displayed in articles that contain the corresponding template reference. For example, the content written in [[Template:Protected]] will appear in any article that contains the <nowiki>{{protected}}</nowiki> tag. Take a look at [[Wikipedia:Template messages]] to see what templates have already been created. You can use the corresponding tags in articles. You can also create new templates.

All these project pages also have Talk pages of their own.

<div style="float:right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:10px;">'''For more information on namespaces, see [[Wikipedia:Namespace]]'''</div>
@@ Line 11: / Line 11: @@
 == Editing ==
-{{Help Page|[[Help:Editing pages]]}}
 [[Image:Tut1.png|right|Click "edit" to change an article]]
 With the exception of a few protected pages, every page has a link that says "'''''edit'''''", which lets you edit the page you are looking at. It is Asylum Projects's most basic feature, and allows you to make corrections and add facts to articles.  If you add information to a page, please try to provide references so others can see where you found the information.  (The same as providing sources for a research paper/book.).
@@ Line 23: / Line 22: @@
 [[File:800px-Mediawiki-button-preview.png|thumb|right|650px|The "[[Wikipedia:Show preview|Show preview]]" button is right next to the "save page" button and below the [[Help:Edit summary|edit summary]] field.]]
 Before you hit '''Save page''', it is considered good etiquette (or "Wikiquette") to enter a polite explanation of your changes in the '''[[Wikipedia:Edit summary|Edit summary]]''' box between the edit window and the '''Save page''' and '''Show preview''' buttons. It can be quite short; for example if you just enter "typo", people will know you made a spelling correction.  Also, if the change you have made to the page is minor, such as correcting a spelling or grammar error, be sure to check the box "This is a minor edit" (this is only available if you have logged in).
 ==Formatting==
-{{Help Page|[[Help:Formatting]]}}
 '''Formatting Asylum Projects articles''' is a bit different from writing on a standard word processor. Instead of a strict WYSIWYG approach ("What You See Is What You Get"), Asylum Projects uses text codes to create particular elements of the page (e.g. headings). This "language" is known as '''Wikitext''' (or '''Wiki-markup''') and is designed for ease of editing.
@@ Line 70: / Line 70: @@
 |
 <tt><nowiki>== Heading ==</nowiki></tt>
 |
 == Heading ==
 |-
@@ Line 90: / Line 89: @@
 <br/>
 ==Linking==
-{{Help Page|[[Help:Links]]}}
 '''Linking''' Asylum Projects articles together is very important. These easily created links allow users to access information related to the article they are reading and greatly add to Asylum Projects utility.
@@ Line 122: / Line 121: @@
 <div style="float: left; background-color: #f5faff; color: #000; padding: .2em .6em; font-size: 130%; border: 1px solid #cedff2;">'''Test what you have learned in the [[/sandbox/]]'''</div><br>
 <br/>
 ==Referencing==
@@ Line 159: / Line 157: @@
 <br/>
 ==Talk Pages==
-{{Help Page|[[Help:Namespaces]]}}
-{{Help Page|[[Help:Talk pages]]}}
 '''Talk pages''' are a key feature of Asylum Projects, offering the ability to discuss articles and other issues with other editors. They are not to be used as a chat room, soapbox, battleground or for general discussion of the article topic.
@@ Line 267: / Line 263: @@
 <div style="float:right; background-color:#f5faff; color: #000; padding: .2em .6em; font-size: 100%; border: 1px solid #cedff2; margin-bottom:10px;">'''For more information on namespaces, see [[Wikipedia:Namespace]]'''</div>
-==See Also:==
-*[[Help:Images]]
-*[[Help:Editing]]
-*[[Help:User page]]
-*[[Help:Watchlist]]
-[[Category:Help]]