Date: Sat, 24 Jan 2009 20:18:24 +0100 Mime-Version: 1.0 (Produced by PhpWiki 1.3.14-20080124) X-Rcs-Id: $Id$ Content-Type: application/x-phpwiki; pagename=Help%2FTextFormattingRules; flags=PAGE_LOCKED; markup=2; charset=iso-8859-1 Content-Transfer-Encoding: binary ---- ! Synopsis [Help:TextFormattingRules]
*Emphasis:* ~_ for _italics_, ~* for *bold*, ~_~* for _*both*_, ~= for =fixed width=.%%% *Lists:* ~* for bullet lists, # for numbered lists, _Term~:~ definition_ for definition lists.
*Preformatted text:* Enclose text in ~
~
or ~~.%%% *Indented text:* Indent the paragraph with whitespaces.%%% *References:* ~JoinCapitalizedWords or use square brackets for a ~[page link] or URL ~[~http~://cool.wiki.int/~].
*Preventing linking:* Prefix with "~~": ~~~DoNotHyperlink, name links like ~[text | URL or pagename~].%%% *Misc:* "!", "!!", "!!!" make headings, "~%%%", "~\~\" or "~
" makes a linebreak, "~----" makes a horizontal rule.%%% *Allowed HTML tags:* b big i small tt em strong s strike abbr acronym cite code dfn kbd samp var sup sub ---- !!! Character Formatting * All special non-whitespace HTML characters are displayed as-is. Exceptions below. * See [Emphasis|Help:TextFormattingRules#Emphasis]. * There's no syntax for font tags. * The tilde '~~' is the _Escape Character_: ** A single tilde '~~' followed by nothing gets rendered as a single tilde. => ~ ** Two tilde '~~~~' get rendered as a single tilde. => ~~ ** A single tilde before a link ('~~http~:~/~/foo.bar') prevents linking. => ~http://foo.bar ** Two tildes before a link ('~~~~http~:~/~/foo.bar') produce a tilde followed by the hyperlinked URL. => ~~http://foo.bar ** A tilde inside an URL gets removed, unless it's formatted inside ~[ ~] brackets. Two tildes inside an URL (without brackets) become a single tilde. => [http://foo.bar/~user] or http://foo.bar/~~user * Special non-ascii or non-latin characters are printed as-is only if supported by the native wiki CHARSET. Add such characters on a non-supported CHARSET with the [Help:RawHtmlPlugin] if it is enabled by the Admin and e.g. the &#num; syntax. %%% E.g. These japanese euc-jp chars 'から 新規ページ' on this == wiki. And with the plugin: %%% And this is how it should look: [http://phpwiki.sourceforge.net/demo/images/chars-releasenotes-japanese.png] !!! Paragraphs * Don't indent paragraphs * Words wrap and fill as needed * Use blank lines as separators * Four or more minus signs make a horizontal rule * =~%%%=", =~\~\= or =~
= makes a linebreak (in headings and lists too) !!! Lists * asterisk for first level * indented asterisk (indent at least two spaces) for second level, etc. * Use ~*, -, + or o for bullet lists, # for numbered lists (mix at will) * Definition lists:
  Term:
    definition
  
gives Term: definition as in the =
= list * Items may contain multiple paragraphs and other multi-lined content, just indent the items !!! Headings !! Classic Phpwiki syntax * '=!!!=' at the start of a line makes a large heading (h2) * '=!!=' at the start of a line makes a medium heading (h3) * '=!=' at the start of a line makes a small heading (h4) !! Wikicreole syntax * '~=~=' at the start of a line makes a large heading (h2) * '~=~=~=' at the start of a line makes a medium heading (h3) * '~=~=~=~=' at the start of a line makes a small heading (h4) * '~=~=~=~=~=' at the start of a line makes a smaller heading (h5) * '~=~=~=~=~=~=' at the start of a line makes a tiny heading (h6) !!! Preformatted text * Place preformatted lines inside =~
=:
  
  
  Preformatted text. WikiLinks still work.
  
gives
  Preformatted text. WikiLinks still work.
  
* If you want text with no Wiki interaction, use the =~= tag:
  
  Preformatted text. ~WikiLinks do not work.
  
  
gives Preformatted text. WikiLinks do not work. !!!Indented Paragraphs * Two or more whitespaces signal indented text. Indents may be nested. This is an indented block of text. This block is even more indented. * E-mail style block-quoting is supported as well:
  > This is block-quoted text.
  
renders as > This is block-quoted text. !!! Emphasis * Use an underscore (~_) for emphasis (usually _italics_) * Use an asterisk (~*) for strong emphasis (usually *bold*) * Mix them at will: *_bold italics_* * _Emphasis_ can be used _multiple_ times within a paragraph, but _cannot_ cross paragraph boundaries: _this will not work_ !!! References * 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) * Hyperlinks to external pages are done like this: [http://www.wcsb.org/] * 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] * You can suppress linking to old-style references and URIs by preceding the word with a '~~', e.g. ~NotLinkedAsWikiName, ~http~://not.linked.to/ * 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/ * 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] * In-page #[hyperlinks] are made by placing a named anchor and referring to the anchor in a hyperlink: * Named anchors: * ~#~[foo]: An anchor around the text "foo" with id "foo". * ~#~[|foo]: An empty anchor with id "foo". * ~#~[howdy|foo]: An anchor around the text "howdy" with id "foo". * References to name anchors are made thusly:%%% ~[~#[#hyperlinks]], ~[~OtherPage#foo], ~[named|~OtherPage#foo]. * Semantic links are named links like: is_a::WikiPage and attributes like size:-4000. * A pagelink within square brackets starting with ":" is not backlinked. !!! Tables * Definition list style tables are written just like definition lists, except that you replace the trailing colon on the term with a "pipe" (|).
  Term 1 |
     Definition 1 begins here.
     Term 1.1 |
        Definition 1.1
     Term 1.2 |
        Definition 1.2
     This is part of definition 1.
  Term 2 |
     Here's definition 2.
  
Term 1 | Definition 1 begins here. Term 1.1 | Definition 1.1 Term 1.2 | Definition 1.2 This is part of definition 1. Term 2 | Here's definition 2. * Old-style tables are supported through the [Help:OldStyleTablePlugin] !!! HTML Mark-Up Language * Some in-line markup is allowed through the use of HTML tags: b, big, i, small, tt, em, strong, abbr, acronym, cite, code, dfn, kbd, samp, var, sup and sub * < and > are themselves * The & characters will not work !!! Creating various kinds of special links * See [Help:MagicPhpWikiURLs] for gory details on how to write various kind of wiki maintenance and other special links. !!! Inserting plugins * Several plugins permit embedding additional functionality to Wiki pages. For example, gives * For more information on plugins see [WikiPlugin|Help:WikiPlugin], and [PluginManager] for a list of all plugins. ---- [[PhpWikiDocumentation]]