HomePage | RecentChanges | Preferences | Create User ID | Existing User Login | Page Index | WhatIsAWiki?

Basic Wiki Editing Rules

The basic editing rules are simple. (you don't even need to know HTML, and you certainly don't need to memorize all of these to get started! :-) Learn a few, go play, and come back when you're ready for more tricks. This list is growing longer over time.)

(Click the "Edit text of this page" link near the bottom to see how this page looks before your browser formats it for viewing. Opening that "Edit text of this page" link in a separate browser window will let you compare the raw wiki text and the formatted-for-your-browser result side by side.)

Separate paragraphs with a single blank line. (If you don't, Wiki will format all the lines as one big paragraph.)

If you decide you want to quit without saving your edits, just hit tbe "Back" button on your browser. As long as you don't hit the "Save" button, it won't update the website.

Use four "-" (dash) characters to create a horizontal line.
(This section pulled almost verbatim from UseMod:TextFormattingRules)

Basic Text Formatting:

Entering text on a wiki can be done simply. Follow these guidelines:

Repetition of the first character on the line generally increases the indentation or emphasis

Good Habits

ALWAYS CLICK THE "PREVIEW" BUTTON BEFORE SAVING. That will let you see how your edits look before saving the page, and help you to catch any typos or things that didn't work out the way you expected. That way, you won't have to re-edit the page 2-3 times trying to get a link to look just right... (This is a very good habit to get into.) You can hit "Preview" as many times as you want to see how things will look before you actually save the page. No one else will see your work until you hit "Save", so you needn't worry about someone seeing a half-edited page. (Do remember to save when you're done!)

Type a short description of what your edit was about in the "Summary" box before hitting "Save". This description will show up in the RecentChanges page and let others get an idea of what you were working on.If you know what you're going to do, you can type the Summary in at the start of your editing session. (I do this near the start of an edit so I don't forget it at the end.)

It's OK (and recommended) to hit "Preview" as many times as you like while editing, to see how your edits look. Changes don't show up until you actually hit "Save", so feel free to preview early and often.

Do not indent paragraphs.

     (Indenting may cause your text to appear in a monospaced font, like this, which probably isn't what you want.)

Bullet Items and Lists

  1. Use a single "#" (pound or number sign) at the beginning of a line to make a numbered bullet item
  2. The next "#" line increases the number. (You can insert a new "#" line in between already-existing lines, and it will automagically renumber everything for you.)
    1. Use "##" to make a second-level numbered bullet.
      1. Third-level numbered bullet, etc.


Use "= " (equal-sign & a space) and " =" (a space & equal sign) to surround a header. The number of "=" you use corresponds to the "<H#>" (header) tag in HTML. One ("=") is largest, and Six ("======") is the smallest header, like so:

Header 1

Header 2

Header 3

Header 4

Header 5
Header 6

Note that you need to put that space between the "=" and your header.

=This is incorrect. It Has no spaces to separate from the equal-signs, so it doesn't become a header.=

Creating New Pages

You can easily create new page links by joining two capitalized words, such as SamplePage, or a word with multiple capitals separated by at least one lowercase letter, such as ExamplE?. (THese dON't woRK, THOUgh, siNCE THE CAPital leTTers ARen't SEPARATED.) This type of word is often called either a [WikiName] or a [WikiWord], but there are also other names used on [other wikis].

When the Wiki software sees a Wiki:WikiName like that, it automatically creates a link to that page...even if the page doesn't yet exist! In fact, if the page you're linking to doesn't yet exist, instead of being a fully-underlined link-word, it will only have a blue "?" (question-mark) link after it. When you (or someone else) first clicks on that "link-to-an-as-yet-unknown-page", the new page is instantly created and you can start editing it.

If you want to see what this is like, find a "?" link on a page somewhere... (Possibly here, or WholeFuture/Table Of Contents has a bunch of them...) Click on that "?" link and it will create the page for you. If you don't really want to edit the page right then, just hit tbe "Back" button on your browser (i.e. - don't click "Save"), and it won't actually save the newly-created page. That link will still have a "?" and it will wait for some other person to click and create it. This is handy if you want to leave forward-pointing links to pages that you think will be needed in the future, but haven't got the time to create right now. Wiki won't treat them as "broken" links, but as "future" links.

Cool Wiki Thing: You can even have multiple pages with these "future" links pointing to a page that doesn't yet exist. Say you had six different pages that all had a forward-pointing "future" link to a page that didn't exist. As soon as someone, anyone, clicked on one of those "?" forward-links, Wiki would create the page and let them edit. As soon as they clicked "Save" (after Previewing, of course!) Wiki would save the new page, and then automatically update all six of those "future" links on the other pages to make them into fully working links! This makes it very easy to leave the equivalent of little digital "breadcrumbs" as a path for future wiki-workers to to build from, or for you to come back to in the future.

You could also create a wiki link by putting double square brackets around a single word that doesn't have two capital letters, such as Users.

You can create a /SubPage by putting a "/" in front of the page name. Those sub pages will appear grouped under whichever page you're on, such as WikiEditingRules/SubPage (sub page of this page) or WholeFuture/Table Of Contents (sub page of the WholeFuture page.) This is a great way of keeping related pages together and organized.

Links and Images

Regular URLs such as http://reality.sculptors.com/ don't need any special formatting. They create links automatically.

You can add images simply by putting the URL to the image in the text. So, a link to a picture somplace, like http://reality.sculptors.com/Gifs/house-feathered-2.png pulls in the image and puts it right on the page, like this:

The image link doesn't need any special tags, and can even be on another website somewhere across the Internet!. Your browser goes off and fetches it automatically.

You can easily link to pages on other Wikis (elsewhere across the Net) by using a shortcut nickname from the InterMap file, These follow the format of Nickname:PageName, such as Wiki:WhyWikiWorks or WikiPedia:Main_Page

You can name a link (Offsite URL or other Wiki site) rather than just using the URL by using the format [URL Link name of one or more words] The first space after the URL is where the new link name begins. Spaces in a link name are OK, as_are_underscore_separators. Examples would be [Reality Sculptors] or [UseMod's WhatIsaWiki Page]

Summary of Quick Linking Tips


Do not indent paragraphs.

     (Indenting may cause your text to appear in a monospaced font, like this, which probably isn't what you want.)

You can put "nowiki"..."/nowiki" HTML-tags around an area that you don't want to have wiki work its magic on. For example, a MultiCapitalizedWord that you don't want to become a link to a wiki page. (Edit this page to see real examples of this.)

If you want to learn more advanced text editing rules, check out UseMod:TextFormattingRules, or our local DocPage?.

You can practice in our local SandBox, or on the [WikiWikiSandbox] on a different Wiki site. Another good thing to check out is the Wiki:TipsForBeginners page.

(PS - Did you remember to "Preview" and then click "Save" when you're all done? :-) )

HomePage | RecentChanges | Preferences | Create User ID | Existing User Login | Page Index | WhatIsAWiki?
This page is read-only | View other revisions
Last edited November 2, 2004 9:41 pm (diff)
Reality Sculptors Homepage