Help:Basic Formatting

From WikiCNS
Revision as of 12:22, 12 June 2007 by Dberg (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

This page is for assisting in basic formatting of text on wiki pages.


Note, the CNS Wiki has a WYSIWYG editor available to each registered user. You can format your text within this editor without using Wikitext. Links, however, are formed via Wikitext. We recommend trying the wikitext. In order to edit wiki, click on your preferences and navigate to the edit tab. Turn off WYSIWYG editing.


Contents

Boldness and Italics

Boldness can be performed simply by using three apostrophes on each side of the text you wish to boldify. For example,

<nowiki>This is bold text</nowiki>

becomes This is bold text


Italics can be perfomed by using two apostrophes on either side of the text you wish to italicise. For example,

<nowiki>This is italicised text</nowiki>

becomes This is italicised text.


Naturally, these two can be combined:

<nowiki>This is bold and italicised</nowiki>

becomes This is bold and italicised.


In order to print something like multiple apostrophes or tildes (without wiki interpreting), use the nowiki tag: <nowiki><nowiki> Here are five apostrophes in a row without bold italics. </nowiki></nowiki>

Signatures

Users can leave timestamped signatures to identify themselves. Three tildes (<code><nowiki>Dberg</nowiki></code>) inserts the user's name, four tildes (<code><nowiki>Dberg 14:16, 7 June 2007 (EDT)</nowiki></code>) inserts the user's name with a timestamp, and five tildes (<code><nowiki>14:16, 7 June 2007 (EDT)</nowiki></code>) gives just a timestamp with no name. You can also insert your signature with timestamp from edit screen toolbar (second button from the right).

Signatures should be used on all talk pages. In addition, at least Suggestions, Mobile Phone Mast and Revive Point pages require their use. On other pages signatures should not be used.

Headings and Subheadings

Put a heading on a separate row with an equals signs on each side:

=Major Section Title=

in order to create a section heading. Use additional equals signs to create smaller and smaller subheadings.

For example,

====This is just a minor subheading.====

creates:

This is just a minor subheading.

A Table of Contents is generated automatically from the headings. It will appear if there is more than few sections on the page. See Help:Magic Words for more information on Table of Contents.

Line Breaks

Paragraphs are identified in wikicode by the simple expedient of leaving a blank line between paragraphs. This has the side effect that two lines of text without a blank line between them will remain on the same line on-screen. Also, <code>&lt;br /&gt;</code> can be used to force a line break (but not a paragraph break) at any time within a paragraph, though you shouldn't need to use this much.

Horizontal Lines

A horizontal lines can be created by adding four dashes in a row on a separate line.

This code in the edit window:

<nowiki>----</nowiki>

creates this horizontal line:


(Equivalently, the XHTML code <code>&lt;hr /&gt;</code> also creates a horizontal line.)

Also, the largest two section headers automatically create a horizontal line immediately below the heading title.

HTML and XHTML tags

What's the difference?

Background

<span style="text-decoration: underline;" title="HyperText Markup Language">HTML</span> is an interpreted language that is currently used to write web pages. HTML is now considered deprecated by the W3C, and is strongly discouraged. <span style="text-decoration: underline;" title="eXtensible HyperText Markup Language">XHTML</span> is a revised version of HTML, designed to counter problems within the HTML standard.

Compatability and Future Proofing

Older browers will rarely have issues with XHTML, but the same cannot be said of any browser in regards to regular HTML; the flaws within the original HTML specifications left too much room for ambiguity and both can, and often have been, misinterpreted.

The primary reason behind the stated strong preference for wikimarkup over either HTML or XHTML is future proofing. As stated earlier, HTML is deprecated and discouraged. One can imagine that backwards compatability with aging and defunct standards may eventually be discarded in order to reduce the size and complexity of browsers.

At present, wikimarkup can be likened to "shorthand" of XHTML, but will presumably take advantage of the capabilities of <span style="text-decoration: underline;" title="eXtensible Markup Language">XML</span> when it becomes reasonable. Therefore, it is strongly advised that wherever possible, wikimarkup should be used instead of HTML or XHTML.

Non-exhaustive List of HTML and XHTML Tags

Some more useful HTML formatting codes are as follows:

  • Using <code>&lt;tt&gt;&lt;/tt&gt;</code> and <code>&lt;code&gt;&lt;/code&gt;</code> to put items in <tt>typewriter font</tt>. These tags are often synonymous, but not in every case. The <code>&lt;code&gt;&lt;/code&gt;</code> tag is actually intended to delineate program source code from other text.
  • Using <code>&lt;s&gt;&lt;/s&gt;</code> or <code>&lt;strike&gt;&lt;/strike&gt;</code> to <s>strikethrough text</s>.
  • Using <code><nowiki><u></u></nowiki></code> to <u>underline text</u>.
  • Using <code><nowiki>&lt;span style="font-variant:small-caps"></span></nowiki></code> to put text in <span style="font-variant:small-caps">small caps</span>. Technically, this is using XHTML and <span style="text-decoration: underline;" title="Cascading Style Sheets">CSS</span>.
  • Using <code>&lt;sup&gt;&lt;/sup&gt;</code> and <code>&lt;sub&gt;&lt;/sub&gt;</code> to make text <sup>Superscript</sup> and <sub>subscript</sub> respectively.
  • As mentioned previously, <code>&lt;br /&gt;</code> generates a line break. Use blank lines wherever possible, try to use the <code>&lt;br /&gt;</code> tag as a last resort.
  • As mentioned previously <code>&lt;hr /&gt;</code> will generate a horizontal line. Again, use <code>&lt;hr /&gt;</code> as a last resort.
Personal tools