User:Shawndouglas/Training

From LIMSWiki
Jump to: navigation, search

Beginner wiki training

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

Links

This is me making an internal link to the template "ombox," which is used on this page: Template:Ombox

This is me making an internal link to the template "ombox," but this time making different text appear for the link: I'm such a rebel

This is me making an external link to the same template located on Wikipedia: [1]

This is me making an external link to the same template located on Wikipedia, using different link text: Why is there no pipe in this type of link?

You should notice the difference between these two types of 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://www.nupedia.com] 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://www.nupedia.com Nupedia] yields...

Nupedia

Consult the relevant Help:Contents section for more information.

Templates

Let's get back to that box with text and a big blue "i" at the top. We call that an "infobox." That's created using the template "ombox," referenced above in the first set of example links. Open one of those links in a new tab or window to learn more about this template.

Templates are distinct because they contain two braces in front (like this: {{ ) and two in the back (like this: }} ).

Here are some internal links to pages on this wiki that utilize a variety of different templates. Let's look at each page (open in a new tab or window) and choose the "edit" option to see the code:

Consult the relevant Help:Contents section for more information.

Formatting text

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'''

'''[[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''

''[[LIMS vendor]]''

Preformatted text

You'll notice so far I've used several instances of gray boxes with wiki code in them on this page. How do you display that wiki code like that without the browser running it? You do it by using the preformatted text tag:

<pre>This is preformatted text. Here is the ombox code used on this page:

{{ombox
| type      = notice
| style     = width: 960px;
| text      = This is my sandbox, where I play with features and test MediaWiki code. If you wish to leave a comment for me, please see [[User_talk:Shawndouglas|my discussion page]] instead.<p></p>
}}
</pre>

So you essentially use the <pre> tag to display the code without rendering it.

But wait a minute. How did I just get the <pre> tag to show on the page without the browser running it? In this sentence and the one previous to this, I used a different technique to display the tag:

<nowiki><pre></nowiki>

I used the <nowiki> tag to display what would otherwise be rendered as code. Note that with both tags, I had to "close" their use with a corresponding duplicate but with the "/" character in front of the word.

This may seem a bit confusing at first, but don't worry. You'll get the hang of this type of formatting. I wanted to introduce it for the next topic: spacing.

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 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.

There are several relevant Help:Contents sections with more information about text formatting.

Organizing text

If you are viewing the code to this page, 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:

==Sandbox begins below==

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 "Organizing text," not "Organizing Text."

If you look under the heading "Sandbox begins below," you'll notice numerous subheadings. And in the subsection "Formatting text" there is yet another subheading below that:

===Formatting text===

====Bold text====

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

You can also create ordered and unordered lists, add definition lists, add extra spacing in the front of text (useful for commenting on talk pages), and how to sign your comments (also very important). Learn about these items and more in the relevant Help:Contents section.

Citation

To begin using citations, it's easy to start with a copy/paste of existing citation code. Inline citations are added directly after a piece of information or quote in a body of wiki text.

You'll want to use this page as your initial guide: LIMSWiki:Citation guidelines

It details the citation code you'll use on probably 95 percent of the references you make: Cite web, Cite book, and Cite journal

You can copy code from there, paste it into your edit, and then edit the values of the fields. That page also has links to the original templates in case you need additional attributes not listed in the examples.

Also, it's imperative to include a references section on any page that includes inline citations. Otherwise, pages won't show up properly. You do that by placing the following code:

==References==
<references />

Images

Wiki puzzleThis is me playing with linking to images on Wikimedia Commons. We'll get into image uploading and linking a little later.