View source for Wiki 101

{{TOCright}}

{{WikiversityActivities}}

==Learning and thinking==

Wikiversity seeks to engage participants in explorations of those topics that they are most interested in. Wikiversity seeks to collect and organize information and make it accessible to learners, but Wikiversity is not just concerned with a collection of facts. Each domain of human knowledge and each collection of facts can be explored by making use of various organizational strategies and patterns of thinking. Wikiversity seeks to make explicit and learnable the patterns of thought that that experts find useful in the study of different subjects. Wikiversity is not about tests and grades. So how is anyone to judge if learning is taking place, if learners are thinking at Wikiversity?

==Wiki 101==

Wikiversity is devoted to the idea that Wikiversity participants should be active learners. In a wiki, a major activity is editing wiki pages. The wiki editing interface can be a source of confusion for new users. "Wiki 101" is a Wikiversity project devoted to the task of providing new Wikiversity editors with everything they need to start editing Wikiversity pages.

It is through the editing of wiki pages that we can, as a learning community, judge if learning is taking place within Wikiversity. Did something you saw at Wikiversity make you think? If so, share your thoughts and experiences by being a wiki editor.

===Prerequisites===

*[[Introduction to Wiki]] - this project aims to function as a service project for the Wikiversity community and provide learning resources that will aid new Wikiversity editors.
*[[Wikiversity:Guided tour]] - Take this tour to get an overview of how Wikiversity works.

===MediaWiki Handbook===

The definitive guide to editing pages at Wikiversity or any of the [[Wikiversity:Service community|Wikimedia projects]] is the [[m:MediaWiki|MediaWiki Handbook]]. MediaWiki is the [[w:software|software]] that runs Wikiversity servers. You can open the handbook in a separate browser window or tab keeping it handy while editing away at Wikiversity.

===Namespaces===

[[m:Help:Namespace|Namespaces]] are ways to keep large sections of content organized. The following are some that Wikiversity editors should become familiar with:

#[[Wikiversity:Main Page|Main Namespace]] - This is where lessons and shared learning materials reside. These are the only content titles without prefixes.
#[[Help:Contents|Help Namespace]] - Prefixed with '''<kbd>Help:</kbd>''', this namespace has a top-level table of contents at [[Help:Contents]] which links to other help pages. The '''Help''' link appears in the left navigation panel on every Wikiversity page.
#[[Special:Listusers|User Namespace]] - Prefixed with '''<kbd>User:</kbd>''', this namespace is where your userpage resides if you have [[Special:Userlogin|created an account and logged in]]. Creating an account gives MediaWiki a way to provide you with a Watchlist, keep track of your contributions and many other features.
#[[Special:Specialpages|Special Namespace]] - Prefixed with '''<kbd>Special:</kbd>''', this namespace contains many types of pages like [[Special:Recentchanges]], [[Special:Allpages]] and many others. Just click on [[Special:Specialpages]] to see.
#[[Special:Categories|Category Namespace]] - Prefixed with '''<kbd>Category:</kbd>''', This is how things are classified and organized at Wikiversity.
#[[m:Help:Template|Template Namespace]] - Prefixed with '''<kbd>Template:</kbd>''', this namespace allows pieces of content to be used on several pages for messages, navigation  aids, or other reusable information. A template is "called" by placing a tag like <nowiki>{{SomeTemplate}}</nowiki> in the page you are editing. 
#[[m:Help:Image|Image Namespace]] - Prefixed with '''<kbd>Image:</kbd>''', this namespace holds pictures and image files that anyone can [[Special:Upload|Upload]] to Wikiversity. See [[Special:Newimages]] for examples.
#[[Talk:Wiki 101|Talk namespaces]] - Prefixed with '''<kbd>Talk:</kbd>''', this namespace is for the discussion area that goes with each article in the main namespace. For prefixed pages, the prefix is appended with '''<kbd>_talk</kbd>''' to link to its discussion page. Examples: [[User talk:CQ]] (my user talk page), [[Template talk:Translators]], [[Image talk:Wiki.png]], ...
#[[Wikiversity|Wikiversity namespace]] - Prefixed with '''<kbd>Wikiversity:</kbd>''', this namespace is for pages that are ''about'' Wikiversity and its administration. It is known also as the project namespace. Examples: [[Wikiversity:About]], [[Wikiversity:Welcome, newcomers]], [[Wikiversity:Introduction]], ...
#[[Portal:Portals|Portal namespace]] - Prefixed with '''<kbd>Portal:</kbd>''', this namespace is for navigating general areas of interest through what we call portals. Examples: [[Portal:Education]], [[Portal:Practical Arts and Sciences]], ...
#[[Wikiversity:Schools|School namespace]] - Prefixed with '''<kbd>School:</kbd>''', This namespace is for major areas of interest and general study organized in a more traditional form. Examples: [[School:Medicine]], [[School:Computer Science]], etc.
#[[Topic:Topics|Topic namespace]] - Prefixed with '''<kbd>Topic:</kbd>''', This namespace is for Department, Divisions or specialized areas of interest or study. They are usually linked to Schools and/or Portals. Examples: [[Web design|Topic:Web Design]], [[Portal:Translation|Topic:Translation]], [[Public international law|Topic:Public International Law]], etc.

Learning to work within and among namespaces is essential to understanding how Wikiversity is built, organized and maintained.

===Text formatting===

Text formatting is easy with MediaWiki:

 <nowiki>'''Bold'''</nowiki> renders '''Bold'''
 <nowiki>''Italic''</nowiki> renders ''Italic''
 
 <nowiki>'''''Bold Italic'''''</nowiki> renders '''''Bold Italic'''''

Adding a space before some text renders:

 A space before some text renders the text
 in a gray box like this one

See the [[m:Help:Editor|MediaWiki Handbook]] for much more information about starting new pages, text formating, creating sections and subsections, and all sorts of tips and tricks.

===Linking pages===

Linking pages is usually as simple as surrounding a word with square brackets: <nowiki>[[Some word or phrase]]</nowiki>. If you link to a page that does not exist, you produce a [[red link]]. Clicking on a red link automatically opens the editor at that page. If the page exists, you will see a [[blue link]]. 

Make sure you are linking to the correct page. For example,
 <nowiki>[[Public International Law]]</nowiki>
produces a red link because the actual article is at [[Public international law|Topic:Public International Law]]. You can hide the fact that it is in the Topic namespace by adding a pipe (|) at the end like this:
 <nowiki>[[Public international law|]]</nowiki>
causing it to appear like this:
 [[Public international law|Public International Law]]. 

Sometimes it is necessary to create a ''redirect'' from one page to another. For example, <nowiki>[[Wikiversity]]</nowiki> links to [[Wikiversity]] which is a REDIRECT to [[Wikiversity:About]]. Notice that when you get to '''Wikiversity:About''' you see '''"Redirected from [[Wikiversity]]"''' which is the <kbd>#REDIRECT</kbd> page.

You can link to articles outside of Wikiversity.
 [[w:Main Page|Wikipedia]] - <nowiki>[[w:Some Wikipedia article]]</nowiki>
 [[m:Main Page|Meta-Wikimedia]] - <nowiki>[[m:An article at Meta]]</nowiki>
 [[b:Main Page|Wikibooks]] - <nowiki>[[b:A title at Wikibooks]]</nowiki>
This is called '''[[m:Help:Interwiki linking|Interwiki linking]]''' is an easy way to link to existing articles at Wikiversity [[Wikiversity:Service community|sister projects]].

Finally, you can link to external resources like this:
 <nowiki>[http://www.google.com Google]</nowiki>
Which renders:
 [http://www.google.com Google]
Notice that we use one square bracket instead of two and that the url can contain no spaces. The first space encountered acts to separate the ''url'' from the ''face'' that we want to appear. Always use courtesy and common sense when linking to outside sites. ''See [[Wikiversity:External links|external link]] for more info''

===Lists and listings===

You can add a bullet to an item by simply adding an asterisk (*) to a new line:
*Bulleted Item

You can create a bulleted list like this:
 *Item
 *Another item
 *Yet another item
Renders:
*Item
*Another item
*Yet another item

A numbered list is created using:
 #Item
 #Another item
 #Yet another item
Which renders:
#Item
#Another item
#Yet another item

It is customary to make lists with descriptions:
#Item - Description of item
#Another item - More detailed description of a numbered item that may use more than one line.
#Yet another item - Very terse and lengthy description of yet another item that may include a number of sentances. You may not add a line break or paragraph break and expect your numbering to be continued. It will start over.
#Still yet another item - Not starting a new paragraph or break allows this numbered listing to continue.

#Item - A paragraph break restarted the numbering
##Nested item 1 - nested item using ##
##Nested item 2 - another nested item using ##
#Another Item - counter returns to higher level with #
## Start a set of nested bulleted items using ##
##* nested bulleted item using ##*
##* nested bulleted item using ##*
## Start another set of nested bulleted items using ##
##* nested bulleted item using ##*
##* nested bulleted item using ##*
#Yet another Item - Counter keeps its place in a mixed hierarchy of items

These are some commonly used listing basics. See the [[m:Help:List|MediaWiki Handbook]] for much more about lists and listings .

===Table basics===

[[m:Help:Table|Tables]] are frames that can be easily created using wiki syntax to make sets of data more logical and aesthetically pleasing. The basic syntax is:
<pre>
{|
|+ Simple Table
!heading 1 !! heading 2 !! heading 3
|-
|data A1 || data A2 || data A3
|-
|data B1 || data B2 || data B3
|}
</pre>
Which renders:
{|
|+ Simple Table
!heading 1 !! heading 2 !! heading 3
|-
|data A1 || data A2 || data A3
|-
|data B1 || data B2 || data B3
|}

Not too pretty yet. MediaWiki includes some '''table attributes''' using a predefined '''classes''', such as <kbd>class="wikitable"</kbd> that we add to the table's opening tag:
<pre>{| class="wikitable"</pre>
By simply adding the wikitable class, the same code gives us:

{| class="wikitable"
|+ Simple Table
!heading 1 !! heading 2 !! heading 3
|-
|data A1 || data A2 || data A3
|-
|data B1 || data B2 || data B3
|}

A bit nicer, eh? If we really want to get fancy, we can customize with more table and '''style''' attributes:
<pre>
{| cellpadding="4" cellspacing="1" style="text-align:center; font-weight:bold; font-size:120%"
|+ Not-so-simple Table
|-style="background:Black; color:White"
!heading 1 !! heading 2 !! heading 3
|- style="background:FireBrick" 
|style="color:LightYellow"|data A1
|style="color:AliceBlue"|data A2
|style="color:MistyRose"|data A3
|-
|- style="background:MidnightBlue" 
|style="color:LightYellow"|data B1
|style="color:AliceBlue"|data B2
|style="color:MistyRose"|data B3
|}
</pre>
Which renders:
{| cellpadding="4" cellspacing="1" style="text-align:center; font-weight:bold; font-size:120%"
|+ Not-so-simple Table
|-style="background:Black; color:White"
!heading 1 !! heading 2 !! heading 3
|- style="background:FireBrick" 
|style="color:LightYellow"|data A1
|style="color:AliceBlue"|data A2
|style="color:MistyRose"|data A3
|-
|- style="background:MidnightBlue" 
|style="color:LightYellow"|data B1
|style="color:AliceBlue"|data B2
|style="color:MistyRose"|data B3
|}

These color atrributes were made with [[Named colors|Named Colors]], but other [[w:web colors|web colors]] and methods can be used. A host of other [[w:Attribute (computing)|attributes]] can be used to alter the look and feel of a table. There are as many ways to make tables as there are Wiki editors! See the [[m:Help:Table|MediaWiki Handbook]] for more.

====Explore====

Take a look at the code used on the [[Wikiversity:Main Page]] and its subpages:
#[[Wikiversity:Main Page/Welcome]]
#[[Wikiversity:Main Page/Communications and community]]
#[[Wikiversity:Main Page/Related links]]

Use the '''edit''' tab, but please don't change these without clearance. Look for table elements and how they work together to form the [[Wikiversity:Main Page|Main Page]] at [[Wikiversity]].

Don't be shy about ''studying'' the code that drives Wikiversity, just hit '''cancel''' when you are done. It's best not to edit high-traffic pages but if you do accidently "mess up" a page, notify one of the [[Wikiversity:Custodians]]. (...and be more careful next time).

===Templates===

Sometimes it is desirable to create templates that can be reused on many pages. These are created in the [[m:Help:Template|Template namespace]] and can be quite complex for even experienced editors.

One of the simpler types is a reusable list. [[Template:Wikiversitysister-list]] is an example of a handy way to show all of Wikiversity's sisterprojects. Simply add the code <nowiki>{{Wikiversitysister-list}}</nowiki> to a page. It renders:

{{Wikiversitysister-list}}

====Referring to a template====

A way to ''refer'' to a template and the tag that calls it without [[w:transclusion|transcluding]] it is like this:
 <nowiki>{{tl|Wikiversitysister-list}}</nowiki>
which renders:
 {{tl|Wikiversitysister-list}}
Notice that the text inside the curly brackets links to [[Template:Wikiversitysister-list]].

====Page templates====

Sometimes it is handy to create whole pages from templates called "boilerplates". These are usually used for [[Wikiversity:Schools|Schools]], [[Wikiversity:Naming conventions|divisions and departments]]. See [[:Category:Page creation templates]] for ideas on how to create whole pages from templates. 

====Explore====

Go to [[Template:Wikiversitysister-list]] and click '''edit'''. Notice the combined use of table attributes, interwiki links, embedded HTML tags and other tricks to get the list to render the way its author intended. Please do not make any changes to this template. Hit '''cancel''' after youve had a long look. 

If you want, you can copy and paste the code into the [[Wikiversity:Sandbox]] or a [[Wikiversity:subpages|subpage]] of your user page. (See [[m:Sub pages]] and [[Wikiversity:Userboxes]] for more about subpages and userboxes.

====Template documentation====

Instructions on how and where to ''use'' a template should appear on its associated '''<kbd>Template talk:</kbd>''' page. Example: [[Template talk:Wikiversitysister-list]]. Unfortunately, many Wikiversity templates remain undocumented.

====Userboxes====

[[Wikiversity:Userboxes|Userboxes]] are a popular tradition around Wiki sites. They are often artistic, witty and complex to create. {{tl|User oops}} is a cute one:  
{{User oops}}<br style="clear: both;">

Explore that one. Notice the extensive use of [[m:Help:Variable|MediaWiki variables]] such as <nowiki>{{TALKSPACE}} and {{{1|{{PAGENAME}}}}}</nowiki>.

====Template Taskforce====

If you wish to learn more about creating and using templates, consider joining the Wikiversity [[Wikiversity:Templates|Template Taskforce]].

===Advanced editing===

This lesson touched on some basic editing principles. When you want to go further, See (and help to develop) more [[Wiki]] and [[MediaWiki/Introduction|MediaWiki]] lessons.

==See also==

*[[Wiki]] - a project devoted to learning how to use wiki technology to facilitate online learning.
*[[MediaWiki/Introduction|Topic:MediaWiki]] - an advanced exploration of the [[m:MediaWiki|MediaWiki]] software suite. ([[Wiki 101]] is a recommended prerequisite)
*[[w:Help:Contents/Editing Wikipedia|Wikipedia guides to editing]]


{{WikiversityUsers}}

[[Category:Wiki]]
[[Category:Pages moved from Meta]]
[[Category:Introductions]]