Difference between revisions of "Wiki Manual"
m |
|||
(18 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
− | = | + | ==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 [[Servers:Quark | Quark]]. It uses Mediawiki 1.3.7 (we might want to think about upgrading that). | ||
+ | |||
+ | The document root for the wiki is located at <code>/clients/www/mediawiki</code> | ||
+ | |||
+ | The Apache configuration for the mediawiki subdomain is located at <code>/usr/local/etc/apache22/extra/httpd-ssl.conf</code> | ||
+ | |||
+ | |||
+ | ==Wiki Syntax== | ||
+ | |||
+ | __NOTOC__ | ||
+ | Here's Wikipedia's page on [http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet how to use wiki syntax].<br /> | ||
+ | Here's Mediawiki's page on [http://www.mediawiki.org/wiki/Help:Formatting 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 | ||
+ | |||
+ | <pre> | ||
+ | = Heading One = | ||
+ | == Heading Two == | ||
+ | === Heading Three === | ||
+ | ==== Heading Four ==== | ||
+ | </pre> | ||
+ | |||
+ | 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 '''<nowiki>[[My Curriculum]]</nowiki>'''. | ||
+ | |||
+ | 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 '''<nowiki>[http://google.com Google is convenient]</nowiki>'''. This example would look like this: [http://google.com 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 <nowiki>'''this is bold.'''</nowiki>. The previous example would look like this: '''this is bold.''' | ||
+ | |||
+ | To create something in italics, use two apostrophes, like <nowiki>''this is italic''</nowiki>. 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: | ||
+ | |||
+ | <pre> | ||
+ | * Cats are nice | ||
+ | * I also like dogs | ||
+ | ** Poodles are my favorite | ||
+ | ** I also like bichons | ||
+ | * Aquariums are fun but take work | ||
+ | </pre> | ||
+ | |||
+ | 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 <pre><br /></pre> | ||
+ | Do NOT press Enter inside your code for a single bulleted item. For example, | ||
+ | |||
+ | <pre> | ||
+ | *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 | ||
+ | </pre> | ||
+ | |||
+ | is displayed as: | ||
+ | |||
+ | *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 | ||
+ | |||
+ | [https://en.wikipedia.org/wiki/Help:List 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: | ||
+ | <pre> | ||
+ | This is a fine block quote! | ||
+ | </pre> | ||
+ | |||
+ | ===Lists=== | ||
+ | *start each line with a star | ||
+ | **more stars make deeper levels | ||
+ | ***you can experiment with this | ||
+ | |||
+ | A blank line will end the list | ||
+ | |||
+ | #Numbered lists | ||
+ | #Are also simple to figure out | ||
+ | #You can subdivide your list | ||
+ | ##By adding | ||
+ | ##more # symbols | ||
+ | |||
+ | A blank line will end it | ||
+ | |||
+ | ===Font effects=== | ||
+ | '''These are pretty easy to do''' | ||
+ | ''with the highlight buttons'' | ||
+ | |||
+ | 'how' |
Latest revision as of 11:55, 5 August 2021
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):
- Dachshund
- Leonberger
- Oh, here's my email address:
retriever@newfoundland.edu
Please feel free to copy it! - 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
- more stars make deeper levels
A blank line will end the list
- Numbered lists
- Are also simple to figure out
- You can subdivide your list
- By adding
- more # symbols
A blank line will end it
Font effects
These are pretty easy to do
with the highlight buttons
'how'