Help:Tutorial

From Ball State University Libraries Wiki
Jump to: navigation, search


This page serves as a basic introduction to navigation, editing, and other uses of this wiki.

Account Creation

To create a new account, visit the log-in page and follow the link there to create a new account. There are currently no restriction on who may create an account, but you are encouraged to use your Ball State username for you account on the wiki. Use whatever you like for your password, but please try to keep it secure.

Navigation

There are two main ways to navigate a wiki:

  1. Click on links
    • Most of the links you encounter will take you to other pages of this wiki. Simply click on them to go to that page.
  2. Type something in the search box
    • If you have an idea of what you are looking for, the search box on the left side of the screen can help you find it. After you type in your search terms, you can click "Go" to go to the page with that title, or "Search" to search for your terms in the body of pages. (If you click "Go" and there is no page by that title, then the "Search" results will be displayed for you.)

You can return to the Main Page by following the link at the top of the navigation menu to the left. You will find other useful links in the same area.

Editing

Each page of this wiki should have several tabs along the top. If you click the tab labeled "edit", you can edit the page you are viewing. A link will also appear at the top right of each section of a page. You can use this link if you only need to edit that section.

Clicking on one of these links takes you to the editing page for that article or section. There you will encounter a large text box where you create or edit the contents of the page. There are three buttons at the bottom of the page. The first, "Save Page", saves any changes you made and publishes them to the article. The second, "Show preview", shows you what the article will look like with your changes, but does not publish the changes until you click "Save page". The final button, "Show changes", will show you the differences between the contents of the currently published page and the contents of the page after your edits.

Note: If someone else saves changes to a page while you are editing it, you will not be able to save your changes, so remember to save frequently.

Formatting

This wiki uses a relatively simple markup language, commonly referred to as wikitext. This allows you to do basic formatting of the page without having to know HTML. There are two ways to put in the markup:

  1. Type it into the text box using the codes in the table below
  2. Select the text you want to format and select the appropriate icon from the tool bar above the text box
Description You type You get
Use these anywhere on the page
Italic text ''italic'' italic
Bold text '''bold''' bold
Bold and italic '''''bold & italic''''' bold & italic
Escape wiki markup <nowiki>no ''markup''</nowiki> no ''markup''
Use these only at the beginning of a line
Headings of

different sizes

==level 1==
===level 2===
====level 3====
=====level 4=====

Level 1

Level 2

Level 3

Level 4
Horizontal rule

----


Bullet list

* one
* two
* three
** three and one-third
** three and two-thirds

  • one
  • two
  • three
    • three and one-third
    • three and two-thirds
Numbered list

# one
# two
# three
## three point one
## three point two

  1. one
  2. two
  3. three
    1. three point one
    2. three point two
Mixture of bulleted
and numbered lists

# one
# two
#* two point one
#* two point two

  1. one
  2. two
    • two point one
    • two point two
Definition list

;Definition
:item 1
:item 2

Definition
item 1
item 2
Preformatted text

  preformatted text is done with
  a space at the
  beginning of the line

preformatted text is done with
a space at the 
beginning of the line

Paragraphs

Wikitext ignores normal line breaks. To start a new paragraph, leave an empty line. You can also start a newline with the HTML tag <br />.

HTML

Some HTML-Tags are allowed, for example <code>, <div>, <span> and <font>.

Links

There are three sorts of links in this wiki:

  1. internal links to other pages in the wiki
  2. external links to websites
  3. inter-wiki links (links to other wikis)

To add an internal link, enclose the name of the page you want to link to in double square brackets. When you save the page, you'll see the new link pointing to your page. If the page exists already, it is displayed in blue, empty pages are displayed in red.

The first letter of the target page is automatically capitalized and spaces are represented as underscores (typing an underscore in the link will have a similar affect as typing a space, but is not recommended, since the underscore will also be shown in the text).

Description You type You get
Internal link [[Main Page]] Main Page
Piped link [[Main Page|different text]] different text
Anchor link [[#Editing|Anchor link]] Anchor link
External link http://mediawiki.org http://mediawiki.org
External link,

different title

[http://mediawiki.org MediaWiki] MediaWiki
External link,

unnamed

[http://mediawiki.org] [1]
Interwiki link [[Wikipedia:Ball State University]] Wikipedia:Ball State University
mailto unnamed [mailto:info@example.org] [2]
mailto named [mailto:info@example.org info] info
Uploaded file link [[Media:BSUlogo.png]] Media:BSUlogo.png

Categories/Tagging

You can add categories/tags to pages to provide and additional method of navigation. At the end of the page, include the line

[[Category:Category Name]]

You can include as many of these lines as you like if the page belongs in multiple categories.

More advanced formatting

Beyond the basic text formatting markup shown above, there are some more advanced formatting tricks:

  • Images
    • Note: For technical reasons, image uploading is currently disabled.
  • Tables

Creating new pages

There are multiple ways to create a new page.

  1. Click on a link to a page that does not exist
  2. Type the name of the page you want to create in the search box and click "Go"
  3. Type the name of the page you want to create at the end of the URL in the address bar

Revision control

The wiki will retain all previous versions of every article. To view these, click on the "history" tab on that page. This gives you a list of the old versions of the page, with the option to compare two versions. From here, you can revert the page to one of the versions you are displaying. Clicking the "edit" link next to the name of that version opens up the editing screen with the contents of that version in the text box. Click "Save page" to overwrite the current version.

Your page

If you've logged in, you may notice your username in the upper right of each page (along with a few other links). Clicking on this will take you to your user page. You can edit this just like any other page, and it provides a place for you to put anything you like. You can write notes to yourself, keep to-do lists, collect links to useful pages in the wiki, or anything else you can think of.