Wiki markup
From SAGESWiki
Wiki markup is the syntax for writing and editing pages on the SAGES wiki. Here is a quick reference sheet (sure to grow) for a few of the most common things you might want to know how to do. For the full list of things you can do in MediaWiki markup, refer to the MediaWiki help page on the subject, or the slightly more user-friendly version at Wikipedia. You might find it useful to keep this page open in a separate window while you work. Remember that you can always use the sandbox as a place to experiment.
Contents |
Formatting
To put text in italics, use two apostrophes on either side of the text (two single quotes, not the double quote):
- ''italics''
To make text bold, use three apostrophes.
- ''bold'''
To make text italic and bold, use five apostrophes.
- '''''italic and bold'''''
Lists and Indenting
Indenting
A colon at the beginning of a line will indent the entire paragraph that follows (not just the first line of that paragraph). Multiple colons will move the left margin further in.
Bulleted Lists
- For bulleted lists
- Start every line with a star.
- More stars push a line
- Futher into the hierarchy;
- Which is to say, further to the right.
- A line break within in a list
- More stars push a line
- Start every line with a star.
- will end a list item.
- * For bulleted lists
- ** Start every line with a star.
- *** More stars push a line
- **** Futher into the hierarchy;
- **** Which is to say, further to the right.
- *** A line break within in a list
- will end a list item.
Numbered Lists
- For numbered lists
- Start every line with a pound sign.
- More pound signs
- Will indent and start a new list
- Beginning again with 1.
- Numbered lists work in every other way
- In every other way
- Just like
- Bulleted lists.
- # For numbered lists
- # Start every line with a pound sign.
- ## More pound signs
- ## Will indent and start a new list
- ## Beginning again with 1.
- # Numbered lists work
- ## In every other way
- ## Just like
- # Bulleted lists.
Links
There are a few different ways to mark up hypertext links, depending on whether you are linking to a page inside our wiki or somewhere else on the Internet.
Linking to Pages on the SAGES Wiki
When the Page Name is the Same as the Linked Text
In the simplest case, the linked text will be the same as the name of the page you're linking to, like this:
- Go to the [[test page]]
will show up as:
- Go to the test page
Internally, the wiki software does a few things to the URL generated here. The first letter of the target page will be capitalized automatically and spaces are turned into underscores. (You can type an underscore in the link, instead, for the same effect, but it doesn't look very nice on the page.) So the URL in the link above is [1], which is a SAGES Wiki page with the title “Test page”.
Warning! In links of this type with more than one word, capital letters in later words will be carried through to the generated URL. That means that while Go to the test page and Go to the Test page both point to the same page, Go to the Test Page points somewhere else! ([2]). (You can set up a redirect for URLs that should all point to the same content. The syntax is #REDIRECT test page.) Best practice is to use all lowercase for your link.
If you link to a page that doesn't exist yet, the software is clever enough to recognize that state of affairs, and makes the link send people directly to an "Edit this Page" for that page. Don't be afraid to make links to new pages or to put content in an empty page; that's part of how wikis grow.
When the Page Name is Different From the Linked Text
But what if you want to link to a page within the wiki, but to have the linked text say something else, like this?
- Those wombats are always messing around with my articles!
Then you use what is called a “pipe link”. It looks like this:
- Those wombats are always [[test page|messing around with my articles]]!
What you put to the left of the pipe character is what the software uses to generate the link, just like in the example above. The text to the right of the pipe character appears directly on the page as a hypertext link.
Linking to Pages outside the SAGES Wiki
These links work sort of like the previous example, except that you don't want the wiki software to generate a SAGESwiki URL from anything within the brackets.
- External links use single brackets.
- External links don't use a pipe. Instead, use a space to separate the URL from the link text.
Say you want to link to Google, at http://www.google.com. (Notice that the software automatically turns that text into a link to Google, too!) You create a sentence like this:
- Try searching at Google.
by typing this:
- Try searching at [http://www.google.com Google].
Images
Currently the SAGES wiki does not permit file uploading. This means that we cannot host image files directly on the wiki. If you want to display an image on a page in the wiki, first you must make sure that it is hosted elsewhere on the Internet. If there is an Internet-accessible address for the image (that is, one beginning with http://), simply enter that URL on its own line, and it will display as an image. So:
- http://stuttercut.org/dishrack.jpg
will display as
Important Note: When you link to an image on the wiki that is hosted elsewhere, the host will be responsible for the bandwith charges associated with the wiki users' viewing of that image. When people do this without permission from the host, it is often referred to as "bandwidth theft". (The picture above is from Vera Tobin's personal website, so she could link to it freely as she saw fit.) Generally speaking, the amount of bandwidth used by linking to an image on a low-traffic site is not burdensome. However, because many links to the same image, or even one link on a high-traffic site can indeed become very burdensome, bandwidth theft of any sort tends to be looked upon as impolite. Avoid it.
Any image you want to use here can be hosted in the ordinary SAGES webspace; if you don't have access to that space, contact the wiki administrators at sageswiki@case.edu, and we'll upload it for you.
Section Headings and the Table of Contents
The software automatically generates a table of contents (like the one you see on this page) for any page with four or more headers. It puts the TOC right before the first header.
Top-level section headers look like the "Section Headings and the Table of Contents" text right above this. To create them in Wiki markup, use two equal signs on either side of the text in question, like this:
- ==Top-Level Section==
For subsections, use three equal signs; for sub-subsections, use four.
- ===Subsection===
- ====Sub-Subsection===
Signing Contributions
If you're adding material to a page where a dialogue is in progress or you'd like one to be, we suggest that you sign your contributions, so it's easier to follow the back-and-forth of conversation. Please always sign your contributions to the discussion pages. There is a shortcut button that lets you insert a signature and timestamp, or use the following markup:
- --~~~~
will show up as this (if you're me!):
- --Vera Tobin 17:20, 20 Apr 2005 (EDT)
Four tildes will include the date stamp; three tildes will give just a signature. Note that you have to be logged in for this to work. One other thing: the default setting when you first sign up for your account is for signatures like this to append your username rather than what you have entered as your "Real name". To change this, click on "Preferences" and fill in the field for "Nickname".

