Dragoon Trail Chapter of the Izaak Walton League of America, Ankeny IA
Tutorial
From AnkenyIkes.org
Contents |
My Test Header
- bullet 1
- subbullet
- numbered bullet
- 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
- sub sub bulleted lines start with three asterisks.
- sub bulleted lines start with two asterisks.
* bulleted lines start with an asterisk. ** sub bulleted lines start with two asterisks. *** sub sub bulleted lines start with three asterisks. **** etcetera
- numbered use pound signs (sometimes called a sharp sign)
- numbering will be handled automaitcally
- 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
- To make a link internal to your wiki, enclose the link in double square brackets
** 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.
- This script created 11-Jul-2009 by Troy Frericks
- --
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:
- Here's an attached PDF: Media:My-Attached-pdf.pdf (could be .doc, .xls, etc)
* 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
- Wiki Colors: https://qed.princeton.edu/main/MediaWiki:Color_Names
Keyworks
tutorial