Help:Contents
From ILabWiki
| Table of contents |
Welcome to the iLab Wiki
For general help in editing the wiki you can check out MediaWiki's help page (http://www.mediawiki.org/wiki/Help:Contents)
Quick Help
1. Much html code will work on the wiki. However, some things are different.
- <p> and </p> tend not work and will show up on the page
- You can use ' character for italics and bold
- You can add numbers and bullets using # and *
- Literals can be placed using <nowiki>
- a href is replaced with square brackets as such
[http://www.linkto.com/myfile.html]
2. When you add 4 or more headlines, the wiki will generate a table of contents
3. To create a new page type in your web address bar
http://ilab.usc.edu/wiki/index.php/MyNewPage
4. When linking to a document on the wiki be sure to use an internal link such as
[[NewMachine | This is a page for new machines]]
Which looks like: This is a page for new machines
Do not link to an internal document using a standard html link such as
[http://ilab.usc.edu/wiki/index.php/NewMachine This is a page for new machines]
Which looks like: This is a page for new machines (http://ilab.usc.edu/wiki/index.php/NewMachine)
The reason for this is that the wiki will keep track of internally linked pages which prevents broken links. If you use an external link, the wiki will not know to check it if the link changes.
General Policies
Conformance
The wiki is here so that we can all share our knowledge. However, try to conform to good standards when adding and editing content. Try and maintain the format and index structure as well as style of the wiki as it currently is.
Material Placement
When you post a new page you will need to link it back to one of the main index pages. Try to choose the topic which seems most appropriate. If it seems that your new article logically could fit into two categories, place it in both indexes. This will make your page easier to find. However, only do this if it seems that your page truly could belong in both categories. Don't do this too often if you can avoid it.
Linking Like Crazy
Please create as many links as you can within the page you are creating. This is one of the neat things about the internet and the wiki. By creating lots of links, you make it easy for readers to understand you and you make it easier for them to quickly access more material on other topics of interest.
Migrating Material to the Wiki
Ideally, if you have material you want the lab to have access to, you should migrate it to the wiki rather than keep it in a separate server. The primary reason for migration is that the document becomes shared and can be edited by other users. However, if no one should ever need to edit your document or if you need to keep it separate so it can be public, it is perfectly reasonable to not migrate your document but instead create an html link to it.
Signing Your Work
If you want to be responsible person for a document, be sure to sign the document at the bottom. This can be given as:
---- ~~~~
Which will yield a signature like:
Nathan 15:11, 2 Feb 2007 (PST)
You don't need to sign every document, but it helps others to know who to talk to about certain content etc.
Adding/Editing a Navigation Bar
At the top of each document should be a navigation bar point to the topic it is in. To place a Navigation Bar, get the name from one of the other documents also in that topic and insert it in the same way. It should look like:
{{Navbar_Sys_Admin}}
Where you should replace "Sys_Admin" with your current topic.
Navigation Bars are stored as a template. You can edit it in the same way you would any wiki page, but to get to it, you need to prefix it with
Template:
So to edit the Navbar_Sys_Admin try
http://ilab.usc.edu/wiki/index.php/Template:Navbar_Sys_Admin
New templates can also be created in this way, just as with pages.
Using Templates
The wiki has several predefined templates which you can use to format your documents.
Navigation Bars
Most documents should include a navigation bar at the top. These include currently:
- Template:Navbar_Code
- Template:Navbar_Hardware
- Template:Navbar_Sys_Admin
- Template:Navbar_Tech_Report
- Template:Navbar_User_Help
Styles
Many of the iLab styles have been ported into the wiki. You can use these quickly and easily.
Basic Styles
Custom iLab Colors
| This Color |
| This Color |
| This Color |
| This Color |
| This Color |
| This Color |
| This Color |
| This Color |
| This Color |
Creating a Pimpin' Sig
For user in discussion groups and other casual pages you can use templates to create a cool signature. You can do this by creating a signature file.
- Create a template
http://ilab.usc.edu/wiki/index.php/Template:Sig_Myname
- Go to it and them edit it. Something like
{|
| T. Nathan Mundhenk <br> [mailto:nathan@mundhenk.com nathan@mundhenk.com] <br>
Thanks for checking out {{PAGENAMEE}}
----
[[User:Nathan| My Wiki User Page]]
|[[Image:T-Nathan-Mundhenk-Photo.jpg|center|thumb|100px| Ad nauseum ]]
|}
Then whenever you need to sign a personal page you can just type
{{Sig_Myname}}
The end product might look something like:
| T. Nathan Mundhenk nathan@mundhenk.com (mailto:nathan@mundhenk.com) Thanks for checking out Contents |  |
