Wiki Manual

From Earlham CS Department
Revision as of 12:55, 5 August 2021 by Craigje (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

What is a Wiki?

Answer: different things to different people. To some it is

  • online collaboration software. People from around the globe can edit pages that are instantly updated. Anyone can create, read, and modify resources (webpages) and every other interested party will immediately see the changes.
    • a collective editing of content. Wikipedia is now the canonical example.
    • a Content Management System (CMS) stemming from the previous point

Content:CS Wiki Setup

The wiki site (this site) runs off of Quark. It uses Mediawiki 1.3.7 (we might want to think about upgrading that).

The document root for the wiki is located at /clients/www/mediawiki

The Apache configuration for the mediawiki subdomain is located at /usr/local/etc/apache22/extra/httpd-ssl.conf


Wiki Syntax

Here's Wikipedia's page on how to use wiki syntax.
Here's Mediawiki's page on Wiki Formatting Help.

Headings

To create headings, put a the heading on a line by itself and use equals signs (=) around the text. Fewer equals signs means a bigger heading.

For instance, the following wiki code

= Heading One =
== Heading Two ==
=== Heading Three ===
==== Heading Four ====

would look like this:

Heading One

Heading Two

Heading Three

Heading Four

Linking to a Page

Linking to a page inside the wiki is easy: just type two square brackets, the name of the page, and then two square brackets. For instance, to link to a page called My Curriculum, type [[My Curriculum]].

To link to a page outside of the wiki, use one square brackets, the URL, the text you want displayed, and then the ending bracket. For instance, to link to Google, type [http://google.com Google is convenient]. This example would look like this: Google is convenient.

Creating a Page

To create a page, just create a link as above to a page that doesn't exist yet. The first time you click on the link, you'll be able to start creating contents.

Bold, Italics, and Bullets, Oh my!

To create something in bold, use three apostrophes, like '''this is bold.'''. The previous example would look like this: this is bold.

To create something in italics, use two apostrophes, like ''this is italic''. The previous example would look like this: this is italic.

To be both bold and italic, add the apostrophes together for a total of five apostrophes.

Bulleted lists can automatically be created by adding an asterisk (*) in front of the text. For instance, wiki code that looks like this:

* Cats are nice
* I also like dogs
** Poodles are my favorite
** I also like bichons
* Aquariums are fun but take work

is displayed like this:

  • Cats are nice
  • I also like dogs
    • Poodles are my favorite
    • I also like bichons
  • Aquariums are fun but take work

Numbered lists: use # instead of *

To insert a line break inside of a bulleted item or numbered item, use

<br />

Do NOT press Enter inside your code for a single bulleted item. For example,

*My dogs (each with babies):
*# Dachshund
*# Leonberger
*# Oh, here's my email address:<br /><br />retriever@newfoundland.edu<br /><br />Please feel free to copy it!
*# Right, I shouldn't forget my chao chao

is displayed as:

  • My dogs (each with babies):
    1. Dachshund
    2. Leonberger
    3. Oh, here's my email address:

      retriever@newfoundland.edu

      Please feel free to copy it!
    4. Right, I shouldn't forget my chao chao

More on bulleted lists and numbered lists.

When you start to edit this page, you will see the syntax I am using to create different effects. I'll try to add more later, but this should get us all started.

Quotes

Regular quotes can be typed as text. Block quotes work fine as preformatted text:

This is a fine block quote!

Lists

  • start each line with a star
    • more stars make deeper levels
      • you can experiment with this

A blank line will end the list

  1. Numbered lists
  2. Are also simple to figure out
  3. You can subdivide your list
    1. By adding
    2. more # symbols

A blank line will end it

Font effects

These are pretty easy to do

with the highlight buttons

'how'