]> git.mjollnir.org Git - moodle.git/commitdiff
new help file from Howard Miller (needs a little editing still)
authormoodler <moodler>
Thu, 1 May 2003 03:44:30 +0000 (03:44 +0000)
committermoodler <moodler>
Thu, 1 May 2003 03:44:30 +0000 (03:44 +0000)
lang/en/help/wiki.html [new file with mode: 0644]

diff --git a/lang/en/help/wiki.html b/lang/en/help/wiki.html
new file mode 100644 (file)
index 0000000..835153b
--- /dev/null
@@ -0,0 +1,82 @@
+<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>&gt;</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>  
+