TextFormattingRules

Featured: Featured Stories | Picture Gallery

Linda Darnell | Canadians Discover That Carrying Twins, Triplets Or Quadruplets Poses A Health Risk

Chat11.com Web Bible11.com MyBibleCenter.com

The Wiki Way More About This Book

Wiki Text Formatting Rules

Simple editing is one of the major benefits of using a wiki. Users can edit pages without knowing HTML, and still use many formatting features of HTML. Most wikis define a set of formatting rules to convert plain text into HTML. Some wikis (like this one) also allow some HTML "tags", like <b>, <i>, and <pre> within a page. (Some wikis use raw HTML instead of special formatting rules.)

Tips | Hints

Basic Text Formatting:

• Carriage returns (ie pressing the Enter key) are significant in formatting a wiki page
• Multiple spaces and tabs are ignored
• Use tags <b>bold</b> and <i>italic</i>
• Use tag <tt>for monospace text</tt>
• The first character entered on a line often controls the formatting of the text on that line (shades of Fortran), in brief (see below and sub pages for details):
  • " " space causes text to appear in a monospaced font where spaces are significant
  • ":" colon causes text to be indented
  • "=" equals - followed by a space - creates a heading, a trailing "=" - preceeded by a space - is required
  • "*" asterisk creates a bulleted list
  • "#" hash creates a numbered list
  • ";" semicolon creates a definition list, a ":" colon is required subsequently on the same line
  • "----" four hyphens creates a horizontal line
  • "||" vertical bar creates a table (requires a table patch, eg WikiPatches/TableSyntaxCommonMarkup?Create) Seems to be included in the latest release, at least || works, and the patch doesn't apply.

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

• Leave a single blank line between paragraphs.
• Suppress wiki formatting and linking through escaped WikiWiki text -- <nowiki>WikiWiki</nowiki>
• Insert an image using a full URL, eg http://usemod.com/wiki.gif

Additional Text Formatting Rules:

/WikiTextFormatting?Create

/WikiLists?Create

/WikiHeadings?Create

/WikiImages?Create

/WikiLines?Create

Page, URL, and InterWiki?Create Links:

Nonexistent pages, like SampleUndefinedPage?Create, will be displayed with a question mark link. The question mark link indicates the page doesn't exist yet--follow the link to create and edit the page. [The sample page used here is a special example page--you can't define it.]

URLs

Plain URL link: http://www.usemod.com/cgi-bin/mb.pl?SandBox -- http://www.usemod.com/cgi-bin/mb.pl?SandBox

Named URL link: http://www.usemod.com/cgi-bin/mb.pl?SandBox -- http://www.usemod.com/cgi-bin/mb.pl?SandBox

= URLS Using Anchors?

 [Buried Treasure]  -- [http://www.usemod.com/cgi-bin/mb.pl?SandBox#anchor Buried Treasure]

How does one set an anchor? AnswerMe?Create

InterWiki?Create

InterWiki?Create link: UseMod?Create:InterWiki?Create -- UseMod:InterWiki

You can separate links from adjacent text with spaces or the special "" (two double-quotes) delimiter. The "" delimiter is not displayed--it is useful for cases like plural forms of page links (such as UseModWiki s). In nearly all cases trailing punctuation is ignored, so you can safely make links like http://www.usemod.com/, without the trailing comma being part of the link. You can also use FreeLinks?Create.

Lists:

* Text for a bulleted list item.
** Text for second-level list.
*** Text for third level, etc.

...which looks like:

• Text for a bulleted list item.
  • Text for second-level list.
    • Text for third level, etc.

Numbered lists:

# Text for a numbered list item.
## Text for second-level list.
### Text for third level, etc.
## Another Text for the second level.

...which looks like:

1. Text for a numbered list item.
   1. Text for second-level list.
      1. Text for third level, etc.
   2. Another Text for the second level.

Definition Text:

;Term:Definition (indented)
;;Term (indented):Definition (indented two levels)
;;;Term (indented twice):Definition (indented to third level)

...which looks like:

Term

Definition (indented)

Term (indented)

Definition (indented two levels)

Term (indented twice)

Definition (indented to third level)

Images

Just provide the URL, and the image will be inserted inline.

http://blackice.whitetrash.cx/images/blackice.png

These extensions are recognized: gif, jpg, png, bmp, jpeg

If you have a choice, results are usually best with png for computer generated images, and JPEG for photographic images.

Preformatted Text

Additionally, multi-line sections can be marked as pre-formatted text using lines starting with <pre> (to start pre-formatted text), and </pre> (to end preformatted text). The <pre> and </pre> tags are not displayed. Wiki links and other formatting is not done within a preformatted section. (If you want wiki formatting, use spaces at the start of the line instead of the <pre> and </pre> tags.)

For instance:

Pre-formatted section here.  No other link
  or format processing

is done on pre-formatted sections.
For instance, UseModWiki is not a link here.

   This is the starting-spaces version of
   preformatted text.  Note that links like
   UseModWiki  still work.

Miscellaneous rules:

• To quote text without applying the wiki formatting rules, enclose it within a <nowiki> ... </nowiki> section. Within a nowiki section, only HTML-quoting of special characters (<>&) will occur--no other formatting rules will be applied.
• A line which ends in a backslash character (\) will be joined with the next line before most formatting rules are applied. This can be useful for breaking up long sections of text in line-sensitive sections (like lists or indented text).
• If raw-HTML sections are enabled (they are disabled by default), you can enter raw HTML code within a ... section. Note that no quoting is done, so you will need to use sequences like &lt; if you want to display a < character.
• Most of the formatting rules are order-independent. On rare occasions the order of processing may be important. The rules are processed in the following order: raw HTML sections, HTML quoting, nowiki tags, backslash line joining, preformatted sections, paragraphs, lists and indented text, horizontal lines, italic/bold text, URLs, and finally ordinary WikiName?Create links. [No longer fully accurate for 0.88, needs updating.]

HTML

• Encoding the "<" less than, ">" greater than, and "&" ampersand characters is optional.
• Characters such as <, © and ∞ may be encoded on pages as: "&lt;", "&copy;" and "&infin;" respectively. See http://www.w3.org/TR/html4/sgml/entities.html. [UseMod?Create:DougConley?Create dcon]

See also

WikiBugs/TextFormatting?Create

MeatBall?Create:TextFormattingRules

WikiMarkupLanguage

This page written by Garnet

Search for books about:

Bobsgear - Get A Free Enterrpise Wiki Space!
Review: The Bobsgear Project was started to develop a variety of Confluence plugins. This installation of the Confluence Enterprise wiki includes flexible attachments, many Confluence plugins, personal blogs, interesting articles, and more. Bobsgear already has spaces related to politics, art and photography wiki, technical issues wiki, ediscovery wiki, health, Christian theology and Sabbath School wiki, the bible, book reviews, and quotations. Bobsgear allows free signup, and invites anyone to create a free hosted Confluence wiki space.

NEW USERS CLICK HERE! for a quick introduction to Wiki.

Elapsed:1