TextFormattingRules

From S23Wiki
Jump to: navigation, search

This page is obsolete. Try Tutorial.

Background Info on this page:
In its 'hay day' its usage was mainly to learn the syntax for formating a wiki engine we don't use anymore (called Usemod). A main reason we changed wiki engines was because of the amount of spam accumulating was really frustrating. With our new wiki engine, Mediawiki, we have more precise ways of weeding out spam + an amazing amount of other features that we are still learning to incorporate.


Obsolete page begins below


(Information provided by usemod TextFormatingRules & The WikiMarkupStandard & hytext.com)


Table of Contents

General information | Monospace text | Insert Preformated text | How to make indentations |

Bulleted lists | Numbered lists | Definition lists |

Links | InterWiki links | Non-wiki links | Targeted or Anchor links |

Insert Images |

Make Headings | How to make tables | Built-in isbn funtion |

How to have multiple pages sharing 1 page (page redirect) |

todo | Play in the SandBox


[#general]

General information

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

  • When editing a page remember: the 'Preview' button is your friend.
  • You will find that Pressing the Enter key (a.k.a. Carriage returns) will not show up on a wiki page unless you start a new paragraph. (They are still significant to use when editing a page)
  • Multiple spaces and tabs are ignored
  • Use tags like <b></b>for bold and <i></i> for italics
  • typing: ---- (4 hyphens in a arow) makes a horizontal line
  • typing: <nowiki>will not format/compile any text between these tags</nowiki>
  • If you don't understand how something works..use the source (look how it's done through the edit page function)
  • 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). (see this sentence for  
example)
  • The first character entered on a line often controls the formatting of the text on that line (see below)

[#monospace]

Monospace

A single " " (or 1 white space) character at the beginning of a sentence causes text to appear in a monospaced font where spaces are significant

This is monospaced text

You can also use <tt></tt> tag for monospace text

This is also monospaced using the above tag

[#pre]

Preformatted Text

Individual lines can be displayed as preformatted (fixed-width or "typewriter"-font) text by placing one or more spaces at the start of the line. Other wiki formatting (like links) will be applied to this kind of preformatted text.

Alternatively, multi-line sections can be marked as pre-formatted text with all other formatting suppressed by surrounding the text section with 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 <pre> formatted 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, and '''this is not bold'''.

and:

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

[#indentation]

Indentation

A single ":" (colon) character at the beginning of a sentence - causes text to be indented. Simple indented text:

: Paragraph to be indented (quote-block)
:: Paragraph indented more
::: Paragraph indented to third level

...which looks like:

Paragraph to be indented (quote-block)
Paragraph indented more
Paragraph indented to third level

[#bulleted]

Bulleted lists

A single "*" (asterisk) character at the beginning of a sentence - creates a bulleted list.

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

...which looks like:

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

[#numbered]

Numbered lists

A single "#" (hash) character at the beginning of a sentence - creates a numbered list.

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

...which looks like:

  1. Text for a numbered list item.
  2. Text for another numbered list item.
  3. Text for a third numbered list item.
    1. Text for second-level list.
      1. Text for third level, etc.

[#definition]

Definition lists

A single ";" (semicolon) character at the beginning of a sentence - creates a definition list. A ":" colon is required subsequently on the same line. Terms with indented definitions: [without a blank line between term and definition]

;Term One:Definition for One (indented)
;Term Two:Definition for Two (indented)
;Term Three:Definition for Three (indented)
;;Term (indented):Definition (indented two levels)
;;;Term (indented twice):Definition (indented to third level)

...which looks like:

Term One
Definition for One (indented)
Term Two
Definition for Two (indented)
Term Three
Definition for Three (indented)
Term (indented)
Definition (indented two levels)
Term (indented twice)
Definition (indented to third level)

[#links]

Links

An Inline link is a page within the wiki you are using Several ways to Inline link shown here

3 quick ways:

[#interwiki]

InterWiki Links

Link to other wikis or services: Explanation of InterWiki links

[#nonwiki]

Non-Wiki Links

  • Type: [[http://slashdot.org/]] To make a Non Wiki link but a refference: [[1]]
  • Type: [http://slashdot.org/ Slashdot] To make Non Wiki links with a description Slashdot or /.

[#anchor]

Targeted Links

To place a link anchor in a page use [#anchor]"[#anchor]" (without the double quotes) which can be referred to with any of the linking methods:


[#images]

Images

http://seti23.org/image/23mid.gif

The above was produced by simply typing http://seti23.org/image/23mid.gif 
into the wiki. Just provide the URL, and the image will be inserted inline.  
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.) 

[#headings]

Headings

Start a sentence with:

"=" (equals) + a space + any word + an additional space + a trailing "="

Like the following examples:

= Heading One =

== Heading Two =

=== Heading Three =
 
==== Heading Four =

===== Heading Five =

====== Heading Six =

produces:

Heading One

Heading Two

Heading Three

Heading Four

Heading Five
Heading Six

[#table]

Tables

"|" 2 vertical bars create a table

Typing: ||This||is||in||a||Box||

Results:

||This||is||in||a||Box|| (Make sure you make the box on a seperate line for it to work)


[#isbn]

ISBN links

Just write the ISBN Number, like this: ISBN 0-471-25311-1

Result: ISBN 0-471-25311-1


[#redirect]

Page Redirect

This solution allows multiple names to share the same page. To use the PageRedirect command, simply type:

#REDIRECT NewPageName

...at the beginning of the page. (The command must start at the first character of the first line of the page. REDIRECT must be in FULL CAPS.)

When the page containing the command is viewed, the NewPageName will be viewed instead. Redirections are not recursive--only the first redirection will be used.

see UseMod:PageRedirect about editing a redirected page

example: Free Links & SoulSeek


[#todo] Todo:

fnord

UseMod:UseModWiki/Features & UseMod:PageDeletion