Table of Contents
- Why Wikis?
- Basic Formatting
- Linking
- Advanced Formatting
- HTML
Why Wikis?
Why? There are a number of reasons why. As some of you may or may not know already,
Portals V2 was originally intended to be a wiki-like structure. However, due to various design flaws and other issues, that never came to be. Redemption had made a good sized post
here that you'll want to read that explains the main reasoning in detail. For the sake of brevity, here are just a few things:
- Flawed design crippling much of what was envisioned for portals
- Too many content restrictions
- GameGrep serves news better than portals
Basic Formatting
Ah, yes. Formatting. This is something that is going to be vital for staff and admin alike as we all adapt and learn the wiki platform. This section will hopefully teach you the wiki way of some of the most basic formatting.
Bolding text
On Neoseeker, we use
[b][/b]. In HTML, we use <b
><
/b>. In wikis, we use... apostrophes! All it takes is three apostrophes on either side of the text you want bolded and it will be bold when you save your changes!
To bold text...
'''Hello World!'''
translates to
Hello World!
Italicizing text
More apostrophe goodness. However, this time you only use two apostrophes.
To italicize text...
''Hello World!''
translates to
[i]Hello World!
Bolding and italicizing text at the same time
Similar to how you combine bold and italic tags in nTags and HTML, you combine the bold and italic tags in wiki markup. This means you need five apostrophes on both sides of the text.
To bold and italicize text...
'''''Hello World!'''''
translates to
Hello World![i][/i]
- Important: Make sure you use five (5) apostrophes. Four apostrophes will result in bolded text with a set of apostrophes surrounding it.
Creating a new line
To create a new line, simply press the enter/return key and the text will start on a new line. Since the same result happens on Neoseeker, I won't bother giving you a demonstration
here.
...Okay, nevermind; I just did.
Creating a new paragraph
Just like with neoforums, just double space at the end of a paragraph (hit the enter/return keys twice) to create a new paragraph.
Just like this.
Linking
There are various ways to link within a wiki, but the toughest part is remembering which format to use at which time.
Linking to an outside site
You simply use [
http://www.url.com Name of Site] to link to an external site.
To link to an outside site...
[
http://www.neoseeker.com Neoseeker]
translates to
Neoseeker!!Linking within the wiki (interpage)
Linking to pages within a wiki couldn't be simpler. The best thing about this style of linking is that if the page name doesn't exist, clicking the link will take you to add a new page with that name! To do this, simply type [[page name]].
To link within a wiki...
[[Vice City]]
translates to
Vice City!!!Linking within the wiki (intrapage)
This is just as easy as the interpage links. To link to another section within a page, simply type
. Note that section headings and subheadings are
automatically anchors. You can set an anchor manually using HTML, which will be explained toward the end of this guide.
To link within the wiki page...
[[#Grand Theft Auto: Vice City Rendition]]
translates to
Grand Theft Auto: Vice City Rendition
E-mail addresses
This is relatively simple as well and is basically a combination of HTML and external wiki linking. To do this, simply type [mailto:
email@domain.com Address]. Should you type [mailto:
email@domain.com], the link will become numbered instead.
Advanced Formatting
What, you thought linking and bolding/italicizing text would get you off the hook with wikis? You're in for a rough ride then if that's all you think. There are more advanced concepts for you to learn now such as headings and subheadings.
Headings
Headings are just that, the beginning of a new section. To do this, put two equals signs around the text you want to become a header.
To create a heading...
==tekmosis rocks!==
translates to
tekmosis rocks!
Subsections
Similar to the !! in nTags, just add an extra equals sign on both sides of the text you want to make a subsection. In other words, for a subsection of a heading, it's three equals signs.
To create a subsection...
===Krunal is lame===
translates to
Krunal is lame
- Note: For additional subheadings, continue to add equals signs. However, do not skip from two to four. They must be in order!
Unordered lists
These are identical to the ones you make on Neo... somewhat. Initially, you just start out with a bullet point, a space, and then text (* example), but you can add additional bullet points as needed to indent a line in a list.
To create an unordered list...
| code |
* Wiki admins
** Avalith
** Krunal
* Wiki dev
** tekmosis
* Neo admin
** Redemption
|
translates to
- Wiki admins
- Wiki dev
- Neo admin
Numbered lists
Numbered lists are very similar to unordered lists. The only difference is you use the pound sign (#) instead of the asterisk (*).
To create a numbered list...
| code |
# Wiki admins
## Avalith
## Krunal
# Wiki dev
## tekmosis
# Neo admin
## Redemption
|
translates to
- Wiki admins
- Avalith
- Krunal
- Wiki dev
- tekmosis
- Neo admin
- Redemption
Images
Now wikis aren't ALL about text, you know. There's got to be some eye candy involved. Everybody loves pretty images!
To show an image...
[[Image:forumlogo.gif]]
translates to
- Note: You can also add a frame around an image if you wish. To do this, add |frame after the file extension.
Note: You may also add alt text that appears when your mouse hovers over the image. To do this, add |alt text after the file extension, or if used on an image with a frame, after |frame.
- Note: Please upload the image to the wiki first. ALL images that are used should be hosted on the wiki. This drastically cuts down on page loading times if a site like Imageshack or Photobucket goes down for maintenance and it also makes content easier to manage.
- Note: You can also turn this into a link with text by adding a colon (
between the opening brackets and Image (example: [[:Image;forumlogo.gif]]).
HTML
u n d e r
c o n s t r u c t i o n 
