pgsrc/Help%2FOldTextFormattingRules

   1 Date: Sat, 24 Jan 2009 20:18:24 +0100
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.3.14-20080124)
   3 X-Rcs-Id: $Id$
   4 Content-Type: application/x-phpwiki;
   5   pagename=Help%2FOldTextFormattingRules;
   6   flags=PAGE_LOCKED;
   7   markup=2;
   8   charset=iso-8859-1
   9 Content-Transfer-Encoding: binary
  10
  11 ! Synopsis
  12 [Help:OldTextFormattingRules] <br>
  13 <strong>Emphasis:</strong> '<strong></strong>' for <em>italics</em>, _<em></em>~_ for <strong>bold</strong>, '<strong></strong>'_<em></em>~_ for <em><strong>both</strong></em>.%%%
  14 <strong>Lists:</strong> * for bullet lists, # for numbered lists, <em><strong>;</strong> term <strong>~:</strong> definition</em> for definition lists.%%%
  15 <strong>References:</strong> ~JoinCapitalizedWords or use square brackets for a ~[page link] or URL ~[~http~://cool.wiki.int/~].%%%
  16 <strong>Footnotes:</strong> Use ~[1],~[2],~[3],...%%%
  17 <strong>Preventing linking:</strong> Prefix with "~!": ~!~DoNotHyperlink, name links like ~[~[text | URL] (double up on the "[").%%%
  18 <strong>Misc:</strong> "~!", "~!~!", "~!~!~!" make headings, "%%<em></em>%" makes a linebreak, "-<em></em>-<em></em>-<em></em>-" makes a horizontal rule.%%%
  19 <strong>Tables:</strong> »|« as first char, »|« for more columns, »|>« align right, »|<« align left, »|^« centered (default), »||« span columns, »|v« span rows
  20
  21 ----
  22 ! Paragraphs
  23
  24 * Don't indent paragraphs
  25 * Words wrap and fill as needed
  26 * Use blank lines as separators
  27 * Four or more minus signs make a horizontal rule
  28 * %%<em></em>% makes a linebreak (in headings and lists too)
  29
  30
  31 ! Lists
  32
  33 * asterisk for first level
  34      * asterisk-asterisk for second level, etc.
  35 * Use * for bullet lists, # for numbered lists (mix at will)
  36 * semicolon-term-colon-definition for definition lists:
  37 ;term here:definition here, as in the <DL><DT><DD> list
  38 * One line for each item
  39 * Other leading whitespace signals preformatted text, changes font.
  40
  41 ! Headings
  42
  43 * '~!' at the start of a line makes a small heading
  44 * '~!~!' at the start of a line makes a medium heading
  45 * '~!~!~!' at the start of a line makes a large heading
  46
  47 ! Fonts
  48
  49 * Indent with one or more spaces to use a monospace font:
  50
  51 <pre>
  52  This is in monospace
  53 </pre>
  54 This is not
  55
  56 !Indented Paragraphs
  57
  58 * semicolon-colon -- works like <BLOCKQUOTE>
  59
  60 ;:this is an indented block of text
  61
  62 ! Emphasis
  63
  64 * Use doubled single-quotes ('<strong></strong>') for emphasis (usually <em>italics</em>)
  65 * Use doubled underscores (_<em></em>_) for strong emphasis (usually <strong>bold</strong>)
  66 * Mix them at will: <strong><em>bold italics</em></strong>
  67 * <em>Emphasis</em> can be used <em>multiple</em> times within a line, but <em>cannot</em> cross line boundaries:
  68
  69 ''this
  70 will not work''
  71
  72 ! References
  73 * Hyperlinks to other pages within the Wiki are made by placing the page name in square brackets: [this is a page link] or UsingWikiWords (preferred)
  74 * Hyperlinks to external pages are done like this: [http://www.wcsb.org/]
  75 * You can name the links by providing a name, a bar (|) and then the hyperlink or pagename: [PhpWiki home page | http://phpwiki.sourceforge.net/]  - [the front page | HomePage]
  76 * You can suppress linking to old-style references and URIs by preceding the word with a '~!', e.g. ~NotLinkedAsWikiName, ~http://not.linked.to/
  77 * You can create footnotes by using ~[1], ~[2], ~[3], ... like this here #[|ftnt_ref_1]<sup>~[[1|#ftnt_1]~]</sup>. See footnote for counterpart.  (If the ~[ is in the first column, it is a footnote <em>definition</em> rather than a footnote <em>reference</em> #[|ftnt_ref_1]<sup>~[[1|#ftnt_1]~]</sup>.)
  78 * Also, the old way of linking URL's is still supported: precede URLs with "http:", "ftp:" or "mailto:" to create links automatically as in: http://c2.com/
  79 * URLs ending with .png, .gif, or .jpg are inlined if in square brackets, by themselves: [http://phpwiki.sourceforge.net/demo/themes/default/images/png.png]
  80 * Semantic links are named links like: is_a::WikiPage and attributes like size:-4000.
  81 * A pagelink within square brackets starting with ":" is not backlinked.
  82
  83 ! Tables
  84
  85 * Simple tables are available.  A table row is introduced by a <strong>|</strong> in the first column.  It is best described by example:
  86 <pre>
  87       ||  _<em></em>_Name_<em></em>~_               |v _<em></em>_Cost_<em></em>~_   |v _<em></em>_Notes_<em></em>~_
  88       | _<em></em>_First_<em></em>~_   | _<em></em>_Last_<em></em>~_
  89       |> Jeff       |< Dairiki   |^  Cheap     |< Not worth it
  90       |> Marco      |< Polo      | Cheaper     |< Not available
  91 </pre>
  92 ;:will generate
  93 <?plugin OldStyleTable
  94 ||  <strong>Name</strong>               |v <strong>Cost</strong>   |v <strong>Notes</strong>
  95 | <strong>First</strong>   | <strong>Last</strong>
  96 |> Jeff       |< Dairiki   |^  Cheap     |< Not worth it
  97 |> Marco      |< Polo      | Cheaper     |< Not available
  98 ?>
  99
 100 ;:Note that multiple <strong>|</strong>'s lead to spanned columns, and <strong>v</strong>'s can be used to span rows.  A <strong>></strong> generates a right justified column, <strong><</strong> a left justified column and <strong>^</strong> a centered column (which is the default.)
 101 ;:With the new [Help:TextFormatingsRules] tables are only supported with the [Help:OldStyleTablePlugin].
 102
 103
 104 ! HTML Mark-Up Language
 105
 106 * Don't bother
 107 * < and > are themselves
 108 * The & characters will not work
 109 * If you really must use HTML, your system administrator can enable this feature. Start each line with a bar (|). Note that this feature is disabled by default.
 110
 111
 112 -----
 113
 114 ! Footnotes:
 115
 116 #[|ftnt_1]~[[1|#ftnt_ref_1]~]  By using ~[1] a second time (in the first column) the footnote itself is <em>defined</em>.  You may refer to a footnote as many times as you want, but you may only define it once on the page.  Note the the ~[1] in the footnote links back to the first reference, if there are multiple references there will be +'s after the ~[1] which will link to the other references.  (References which come <em>after</em> the footnote <em>definition</em> will not be linked to.)
 117 ----
 118 [[PhpWikiDocumentation]]