Difference between revisions of "Help:MediaWiki basics/Beginner training"

From LIMSWiki
Jump to navigationJump to search
(Added more content.)
Line 157: Line 157:


Several other relevant text organization techniques exist, but we'll get to them in the [[Help:MediaWiki basics/Intermediate training|intermediate training guide]].
Several other relevant text organization techniques exist, but we'll get to them in the [[Help:MediaWiki basics/Intermediate training|intermediate training guide]].
===User pages and functions===
====User profile====
Assuming you have an account here and are logged in, you should notice a few pieces of extra navigation in the top-right: [[File:Vector user links.png]]
Note, your version may have the word "my" in front of each word, but overall it should look like that. Notice in this example the username and talk links are red. (A red link in the wiki indicates the titled page hasn't been created yet.) This typically happens for new users who haven't set up their user profile and talk pages. Remember what we talked about in the beginning concerning [[Help:MediaWiki basics/Beginner training#Creating a page|creating a page]]? Well, that's exactly what should be done with these two pages. By selecting your username, you'll be invited to create and edit your user page in the User: namespace. Likewise, your talk page — another namespace called User talk: (or Help talk:, LIMSWiki talk:, or just Talk: depending on the namespace) where users can discuss problems, suggest changes, or give praise for an associated page — can be created so others can leave comments.
* Here's a user page: [[User:Shawndouglas]]
* Here's a user talk page: [[User talk:Shawndouglas]]
====Preferences====
You can set numerous preferences for your account. Those preferences take effect when you are logged in. Feel free to change what you wish, but here are a few suggestions:
* Under the "User profile" tab ensure at a minimum "E-mail me when my user talk page is changed" is checked.
* Under the "Appearance" tab, "Advanced options" section ensure "Show table of contents (for pages with more than 3 headings)" is checked.
* Under the "Editing" tab increase the size of your editing window to at least 60 columns and 40 rows, or for wide screens 80 columns and 40 or 50 rows. A bigger editing window is always handy.
* Also under the "Editing" tab, consider putting a check next to: Show preview before edit box; Show preview on first edit; Enable section editing via <nowiki>[edit]</nowiki> links; Show edit toolbar
====Watch a page====
You can "watch" pages in MediaWiki. Pages you have a vested interest in and need to monitor can be watched. When changes are made to those pages, you'll be notified so you can review the changes as needed. To watch a page, simply select the "watch" link from the available tabs at the top-left. For example, you could watch your user page and talk page so you are notified of changes to them.
'''Note''': Be sure to go to your preferences, and on the first tab "User profile" be sure to select towards the bottom "E-mail me when a page on my watchlist is changed." Save your changes.

Revision as of 14:21, 21 October 2013

Getting started with MediaWiki

Note: When opening links from wiki pages, right-click a link and choose to open it in a new tab. This should make navigating your way through the wiki less complex.

You'll notice a box with text and a big blue "i" in it above. We'll get to that in a bit. But first let's talk about...

Creating a page

A wiki is made up of parent pages and subpages, and each page has a unique title. When choosing a title for a page on LIMSwiki, the editor must be aware of the naming conventions for article titles. That previous blue link takes you to a page explaining those rules, including using lower case, using singular nouns, and avoiding abbreviations among others. Right-click that link, open it in a new tab, and read more about these naming conventions.

Done? The next thing we need to know about titles and page creation is that choosing a correct namespace is vital. Namespaces are a mechanism for grouping/separating wiki pages, differentiating between the purpose of the pages at a high level. Pages in certain namespaces can have special properties or behave differently when they interact with other pages. Namespaces are indicated in page titles by prefixing the page name with "namespace:", so the prefix "Help:" in this page's title ("Help:MediaWiki basics/Beginner training") indicates that this page is in the Help namespace. A page whose name is not prefixed by a namespace lies in the mainspace.

If you're not sure what space your page belongs in, you might want to check out Help:Namespaces.

How to create a page

The easiest way to create a new page on this site is to use this wiki's "create a new page" tool. Following the previously mentioned naming conventions, choose the correct namespace and simply enter the title of the parent page. For non-mainspace pages, be sure to add the title after the namespace prefix.

Otherwise, simply type the full title of the page you wish to create into the search box on any page and select "Go". If the page does not already exist, you'll be asked if you want to create it. For example, if you wish to create a page titled "Nuclear reactor", type it into the search box, select "Go", and you'll see "Create the page 'Nuclear reactor" on this wiki!"

Finally, to create a subpage, simply add a / and the subtitle, following the usual naming conventions. This page you are on ("Help:MediaWiki basics/Beginner training") is an example of a subpage of Help:MediaWiki basics. Subpages should be created sparingly if at all.

Examples of page titles:

An example of a wiki entry using formatting for bold and italic text, internal links, external links, and a header

Links

Links provide embedded navigation to other content within the wiki or to content outside the wiki. They are an important part of wiki editing and provide convenient avenues for further user research.

Here are four of the most common link formation methods in MediaWiki:

  1. This is an internal link to the "Laboratory" page (on this wiki): Laboratory
  2. This is an internal link to the "Laboratory" page, but this time making different text appear for the link: I'm such a rebel
  3. This is an external link to the same page located on Wikipedia: [1]
  4. This is an external link to the same page located on Wikipedia, using different link text: Wikipedia's page on the laboratory

You should notice the differences between internal and external links and how to format them:

  • You can make an internal link by using a set of double square brackets. The title can be left as the default: [[Laboratory informatics]] yields... Laboratory informatics
  • Or you can give it a new title by adding a pipe (|) and then typing the text you want to appear in place of the original: [[Laboratory informatics|cool laboratory stuff]] yields... cool laboratory stuff
  • You can make an external link by using a set of single square brackets. The title can be left blank: [http://clinfowiki.org] yields... [2]
  • However, it's better you give it a title by adding one space and typing the text you want to appear in place of the URL: [http://clinfowiki.org ClinfoWiki.org] yields... ClinfoWiki.org

Consult the relevant Help:Contents section for more information.

Text formatting

Bold text

Here I bold this text for effect: Do you think it looks ok?

I can even make a link appear in bold like this: LIMS vendor

How did I do that? I simply added three apostrophes to each side like so: '''Here I bold this text for effect''' yields... Here I bold this text for effect and '''[[LIMS vendor]]''' yields... LIMS vendor

Italic text

Here's italic text for you: What do you think?

Like bold text, I can italicize a link like this: LIMS vendor

How did I do that? I simply added two apostrophes to each side like so: ''Here's italic text for you'' yields... Here's italic text for you and ''[[LIMS vendor]]'' yields...LIMS vendor

Spacing

This is my first line of text. This is my second line of text.

Here's what I entered into the edit box to get the above to appear:

This is my first line of text.
This is my second line of text.

Notice what happens if I don't put a space between the lines of text in the edit screen? The lines run together. You'd think putting a line of text under another with a hard return would be enough, but it's not. You must add an additional hard return, creating a space between the lines in the edit box. I actually want it to look like this:

This is my first line of text.

This is my second line of text.

So I have to edit it like this in the code:

This is my first line of text.

This is my second line of text.

Several other relevant text formatting techniques exist, but we'll get to them in the intermediate training guide.

Organizing text

Headings and subheadings

If you are viewing the code to this page (again, you do that by clicking the "edit" link at top), you'll notice there are several bits of code with numerous "=" signs. These are responsible for creating headings and subheadings.

You'll notice the first example:

==Getting started with MediaWiki==

This is the first level of headings, the section heading. You do this by placing two "=" in front and behind some text.

NOTE: Know we have a rule here, just as in Wikipedia; with the exception of proper nouns, only the first word of the heading or subheading is capitalized! In this case, it's "Getting started with MediaWiki", not "Getting Started With MediaWiki".

If you look under the heading "Getting started with MediaWiki", you'll notice numerous subheadings. And in the subsection "Text formatting" there is yet another subheading below that:

===Text formatting===

====Bold text====

Simply add another "=" to the front and back to create an additional subheading.

Bulleted and numbered lists

In several subsections of this page, you should have noticed two types of lists: bulleted and numbered lists. Both are simple to use and effective for organizing information in a wiki entry.

First let's look at the code for the first couple of bulleted items in the the Creating a page section:

* [[User:Shawndouglas]] (in the "User" namespace)
* [[Help:MediaWiki basics]] (in the "Help" namespace; note the lowercase "basics")

Adding an asterisk (*) in front of the lines of text produced a bulleted list. Feel free to place the bulleted items as shown above or add a hard return between each item (exhibited in the Links section of this page) to space out your bulleted items.

Now let's look at the code for the first couple of numbered items in the the Links section:

# This is an internal link to the "Laboratory" page (on this wiki): [[Laboratory]]
# This is an internal link to the "Laboratory" page, but this time making different text appear for the link: [[Laboratory|I'm such a rebel]]

Adding the pound sign (#) in front of the lines of text produced an ordered numerical list. Notice no extra hard return was placed between the two items. This is an important distinction: look what happens if we separate the two lines with a hard return:

  1. This is an internal link to the "Laboratory" page (on this wiki): Laboratory
  1. This is an internal link to the "Laboratory" page, but this time making different text appear for the link: I'm such a rebel

Lesson: If you want your numerical list to remain intact, don't add that extra hard return.

Several other relevant text organization techniques exist, but we'll get to them in the intermediate training guide.

User pages and functions

User profile

Assuming you have an account here and are logged in, you should notice a few pieces of extra navigation in the top-right: Vector user links.png

Note, your version may have the word "my" in front of each word, but overall it should look like that. Notice in this example the username and talk links are red. (A red link in the wiki indicates the titled page hasn't been created yet.) This typically happens for new users who haven't set up their user profile and talk pages. Remember what we talked about in the beginning concerning creating a page? Well, that's exactly what should be done with these two pages. By selecting your username, you'll be invited to create and edit your user page in the User: namespace. Likewise, your talk page — another namespace called User talk: (or Help talk:, LIMSWiki talk:, or just Talk: depending on the namespace) where users can discuss problems, suggest changes, or give praise for an associated page — can be created so others can leave comments.

Preferences

You can set numerous preferences for your account. Those preferences take effect when you are logged in. Feel free to change what you wish, but here are a few suggestions:

  • Under the "User profile" tab ensure at a minimum "E-mail me when my user talk page is changed" is checked.
  • Under the "Appearance" tab, "Advanced options" section ensure "Show table of contents (for pages with more than 3 headings)" is checked.
  • Under the "Editing" tab increase the size of your editing window to at least 60 columns and 40 rows, or for wide screens 80 columns and 40 or 50 rows. A bigger editing window is always handy.
  • Also under the "Editing" tab, consider putting a check next to: Show preview before edit box; Show preview on first edit; Enable section editing via [edit] links; Show edit toolbar

Watch a page

You can "watch" pages in MediaWiki. Pages you have a vested interest in and need to monitor can be watched. When changes are made to those pages, you'll be notified so you can review the changes as needed. To watch a page, simply select the "watch" link from the available tabs at the top-left. For example, you could watch your user page and talk page so you are notified of changes to them.

Note: Be sure to go to your preferences, and on the first tab "User profile" be sure to select towards the bottom "E-mail me when a page on my watchlist is changed." Save your changes.