mirror of
https://github.com/moodle/moodle.git
synced 2025-01-24 00:58:33 +01:00
83 lines
3.7 KiB
HTML
83 lines
3.7 KiB
HTML
<p align="center"><b>Help on writing Wiki Formatted Pages</b></p>
|
|
|
|
<p>
|
|
Wiki formatted pages provide a facility for marking up plain text with intutive human readable
|
|
conventions that will be converted to XHTML when displayed. The big advantages are that you
|
|
do not need to learn HTML to produce quite complex results, and that the text you write
|
|
<em>looks</em> right to the eye even before conversion.
|
|
</p>
|
|
|
|
<p>You should enter basically plain text. There are a number of <em>special</em> characters you
|
|
can add to insert formatting</p>
|
|
|
|
<h3>Block level formatting</h3>
|
|
|
|
<p>
|
|
Paragraph blocks are separated by at least one blank line. To add special formatting to a paragraph
|
|
add one of the following special characters in the first character of the first line of the block followed
|
|
by a space...
|
|
</p>
|
|
|
|
<table>
|
|
<tr><th>Character</th><th>Block Type</th></tr>
|
|
<tr><td>No character</td><td>Ordinary paragraph</td></tr>
|
|
<tr><td>></td><td>Quotation</td></tr>
|
|
<tr><td>Space</td><td>Preformatted Text (Monospaced)</td></tr>
|
|
<tr><td>%</td><td>Preformatted <em>and</em> Wikki formatting is ignored</td></tr>
|
|
<tr><td>!#</td><td>Heading - where # is 1-6, the heading level (1 is biggest)</td></tr>
|
|
</table>
|
|
|
|
<h3>List formatting</h3>
|
|
|
|
<p>simple lists can be constructed easily by placing a special character at the start of each line in the list followed by a space.
|
|
The list is terminated by a blank line. At present lists cannot be intermixed or nested. Definition list
|
|
definitions and text types maybe freely intermixed to obtain the desired effect however. The special characters
|
|
are as follows...</p>
|
|
|
|
<table>
|
|
<tr><th>Character</th><th>List itme type</th></tr>
|
|
<tr><td>*</td><td>Unordered List (bullet points)</td></tr>
|
|
<tr><td>#</td><td>Ordered List (1,2,3 etc)</td></tr>
|
|
<tr><td>:</td><td>Definition list, definition</td></tr>
|
|
<tr><td>;</td><td>Definition list, text</td></tr>
|
|
</table>
|
|
|
|
<h3>Inline formatting</h3>
|
|
|
|
<p>Inline formmating allows part of a line to be marked as having a particular style. The special
|
|
characters used can appear anywhere on a line, but note that the formatting cannot
|
|
cross lines. Codes are as follows...</p>
|
|
|
|
<table>
|
|
<tr><th>Example</th><th>Example</th><th>Formatting</th></tr>
|
|
<tr><td>*hello world*</td><td><strong>hello world</strong></td><td>Strong or Bold</td></tr>
|
|
<tr><td>/hello world/</td><td><em>hello world</em></td><td>Emphasis or Italics</td></tr>
|
|
<tr><td>+hello world+</td><td><ins>hello world</ins></td><td>Inserted text</td></tr>
|
|
<tr><td>-hello world-</td><td><del>hello world</del></td><td>Deleted or Strikethrough</td></tr>
|
|
<tr><td>hello ~world~</td><td>hello <sub>world</sub></td><td>Subscript</td></tr>
|
|
<tr><td>hello ^world^</td><td>hello <sup>world</sup></td><td>Superscript</td></tr>
|
|
<tr><td>"hello world"</td><td><q>hello world</q></td><td>Quoted</td></tr>
|
|
<tr><td>%hello world%</td><td><code>hello world</code></td><td>Code or Monospaced</td></tr>
|
|
<tr><td>@hello world@</td><td><cite>hello world</cite></td><td>Cite</td></tr>
|
|
</table>
|
|
|
|
<h3>Acronyms</h3>
|
|
|
|
<p>Acronym tagging is acheived by placing the acronym in capital letters followed by the description
|
|
is parenthesis. There must be no space between the acronym and the parenthesis. Example...</p>
|
|
|
|
<p>HTML(Hypertext Markup Language) <br /> <acronym title="Hypertext Markup Language">HTML</acronym></p>
|
|
|
|
<h3>Automatic reformattion</h3>
|
|
|
|
<p>Many commonly used functions are converted into their XHTML equivalents automatically.. The main ones are as
|
|
follows...</p>
|
|
|
|
<ul>
|
|
<li>HTTP links are converted into active links
|
|
<li> ..., (R), (TM), (C), 1/4, 1/2, 3/4 are all converted to the correct character
|
|
<li> digits x digits converts to correct multiply symbol
|
|
<li>A line starting with at least four dashes is converted into a horizontal line
|
|
</ul>
|
|
|