Dragoon Trail Chapter of the Izaak Walton League of America, Ankeny IA

Tutorial

From AnkenyIkes.org

Jump to: navigation, search

Contents

My Test Header

  • bullet 1
    • subbullet
  1. numbered bullet
  2. numbered bullet

Test Link Internal to My Wiki .description here

How To Edit A Wiki

This document is meant to be read from top to bottom, not as a reference to specific tasks. It is a general overview with little detail. Please allocate 15 minutes and proceed.

With the widespread use of wiki's for knowledge base & sharing of information at BTS, I see the need for a very simple, 15 minute introduction. Wiki's can handle text (95% of what I see is text information), images, word documents, etc.

The main objective is to all the user to EASILY enter data that can then be searched & displayed in a reasonable format. EASILY is the operative word. If entering data is not easy to do, nobody would be doing it. I'm constantly updating the DBA knowledge base (this wiki) between tasks. That way, I (or a fellow DBA) can gain from that information at a later date. And we have. In fact, it is really indispensable.

This very quick overview is based on the specific type of wiki called 'MediaWiki'. If you google 'mediawiki AND editing' you will have all the information you could possibly want regarding how to edit a wiki. Most of that information is transferable to any wiki that exists. This is intended as a very quick introduction.

Loggin In, Do You Have Access

Are You Logged In

  • Look at the top of the screen. You will either...
    • your username to the left
    • "log out" to the right
  • OR
    • "Log in / create account" in the upper right corner of the screen

If you are not logged in, you will need to be for the rest of this guide. Click the "Log in / create account" link. Enter your user & password, then click OK. You should then see (at the top of the screen) your username to the left an "log out" to the right.

If you do not, stop at this point and get help from your wiki administrator.

Do You Have Access To Edit The Wiki

This is simple. At the top of what ever page you are on, there are a set of tabs. Usually, "page", "discussion", "edit", "history", "delete", "move", "protect", "watch". I've only used "page", "edit", and "history".

  • "page" shows the page content. That is what the viewers of your data will see.
  • "history" keeps revisions of each page, so you can go back in needed, or view what was changed when.
  • "edit", if it is there, will allow you to edit the page. If that tab is there, you may proceed to the rest of this document. If it is not, you need to stop and get help from your wiki administrator.

Once you have found the "edit" tab, you may proceed :)

Editing, Canceling Previewing, And Saving A Wiki Page

To edit the current page, click the "edit" tab at the top of the page. You'll see an edit box open. Click just inside the upper left corner of the box and type "TEST123" followed by five returns. Click the SAVE PAGE button at the bottom of the box. See the results? You've just edited your first wiki page.

Click "edit" again, delete the "TEST123" and the blank lines. Click SHOW PREVIEW to see the page as it will appear when saved, and notice you could continue editing if you wished. Notice the "Cancel" link just to the right of SHOW PREWVIEW? If you find that you don't want to make any changes, click it. Click SAVE PAGE to save the page.

Headers

To create major headers, use two equal signs. For example, the header above was created with this...

== Headers ==

Minor Headers

To create minor headers, use three equal signs. Again, for example, the header above was created with this...

=== Minor Headers ===

As an exercise, edit the current wiki page and add the header "My Test Header" to the top of the page, followed by five blank lines and save it. See previous section for how to edit and save.

Bullets & Numbered Lines

  • bulleted lines start with an asterisk.
    • sub bulleted lines start with two asterisks.
      • sub sub bulleted lines start with three asterisks.
        • etcetera
* bulleted lines start with an asterisk.
** sub bulleted lines start with two asterisks.
*** sub sub bulleted lines start with three asterisks.
**** etcetera


  1. numbered use pound signs (sometimes called a sharp sign)
  2. numbering will be handled automaitcally
  3. etcetera
# numbered use pound signs (sometimes called a sharp sign)
# numbering will be handled automaitcally
# etcetera


Edit your wiki page and just under the header, add 2 bulleted lines, and 2 numbered lines. Save the page.

Internal Links

** Sample Test Link Internal To My Wiki

The new link will appear Red when empty, blue when contains data, but unvisited, and purple when contains data and unvisited (your colors may vary).

Create a wiki link in your wiki, save, click the link to add data. Save. Take a second to review your new page. Press your browsers BACK button TWICE to come back to the original page. Click your browser's REFRESH button to see the new color for the link.

Text

If you do not want your text formatted by the wiki, place a space in column 1. For example, suppose I wanted this to be just as I typed it.

  1. This script created 11-Jul-2009 by Troy Frericks
  2. --

ls -l > out.dat

I would need to add a space in column 1. Since you can't see a space, I have used a dot (period) here for the example.

.# This script created 11-Jul-2009 by Troy Frericks
.#
.ls -l > out.dat

External References

To reference external links, surround the link by square brackets, ie [1]

To reference external links, surround the link by square brackets, ie [2]

If you would like a description on the link, inside the brackets, after the link, type a space followed by the description... ie, Click me to go to google

If you would like a description on the link, inside the brackets, after the link, type a space followed 
by the description... ie, Click me to go to google


Add an external link to your wiki.

Images And Attachments

* Here's an image: [ [Image:My-Test-Image.jpg] ]
* Here's an attached PDF: [ [Media:My-Attached-pdf.pdf] ] (could be .doc, .xls, etc)


When you first click on newly created link, it will ask you to indicate where the file is on your PC. From then forward, the image or attachment will be in the wiki. If the engine knows how to display it, it will. If not, it will wait for the readers to click. If they do, it will ask what application (ie, Adobe Reader).

Add an image & a pdf to you wiki page to see how they are displayed.

Other

Take minute to edit your wiki and remove the lines you added at the beginning.

Fifteen minutes was just a guess. If it took you longer than fifteen minutes, please email me with the actual time. This page was created on 11-Jun-2009, and to date, I have not received any actuals. Does that mean that my estimate is spot on? My email address is 'troyf' and the domain name of the email address is 'to.net'

Embedded CSS

To embed CSS in a page: CSS <- The word CSS surrounded by tags to make it red.

To embed CSS in a page: < span style="color:red">CSS< /span> <- The word CSS surrounded by tags to make it red.

Further Reference

Keyworks

tutorial

Personal tools