phpgtk__legacy/wiki1/wikilib.d/PmWiki.TextFormattingRules

10 lines
7.1 KiB
Text

version=pmwiki-1.0.4
newline=²
text=This page provides a more complete list of some of the markup sequences available in PmWiki. Note that it's easy to create and edit pages without using any of the markups below, but if you ever need them, they're here.²²'''To experiment with the rules, please try editing the Main/WikiSandbox.'''²²----²!!!Paragraphs²²* Do not indent paragraphs²* Words wrap and fill as needed²* Use blank lines as separators²* Lines indented with one or more spaces (or tabs) are monospace font.²* Use [@\@] (single backslash) at the end of a line to join the next line to the current one (''{{line continuation}}'')²* Use [@\\@] (two backslashes) at the end of a line to force a line break, but keep the current ''environment'' (e.g. stay inside the current list item)²²----²!!!Indented Paragraphs ''(Quotes)''²²Arrows ([@->@]) at the beginning of a paragraph can be used to produce an indented paragraph. More hyphens at the beginning ([@--->@]) produce larger indents.²² [=->=]Four score and seven years ago our fathers placed upon this² continent a new nation, conceived in liberty and dedicated to the² proposition that all men are created equal.²²->Four score and seven years ago our fathers placed upon this continent a new nation, conceived in liberty and dedicated to the proposition that all men are created equal.²²----²!!! [[#BulletedLists]] Bulleted Lists²²Bullet lists are made by placing asterisks at the left margin. More asterisks increases the level of bullet:²² * First-level list item² ** Second-level list item² ** Another second-level item² * A first-level item² ** Second-level list item² *** Third-level list item² **** Fourth-level list item²²* First-level list item²** Second-level list item²** Another second-level item²* A first-level item²** Second-level list item²*** Third-level list item²**** Fourth-level list item²²----²!!!Horizontal Line²²Four or more dashes ([=----=]) at the beginning of a line produce a horizontal line.²²----²!!!Emphasis²²* Use doubled single-quotes ([=''=]), i.e., ''two apostrophes'', for emphasis (usually ''italics'')²* Use tripled single-quotes ([='''=]), i.e. ''three apostrophes'', for strong emphasis (usually '''bold''')²* Use five single-quotes ([='''''=]), or triples within doubles (''five apostrophes''), for some other kind of emphasis (usually '''''bold italics''''')²* Use doubled at-signs ([=@@=]) for @@monospace@@ text²* Use [=[+...+]=] for [+larger text+] and [=[-...-]=] for [-smaller text-]²* Emphasis can be used multiple times within a line, but cannot span across markup line boundaries (i.e., you can't put a paragraph break in the middle of bold text).²²See also WikiStyles for advanced text formatting options.²²----²!!!References²²* Join capitalized words ({{WikiWord}}s) to make references to other pages on this Wiki.²* Precede [=URLs=] with "http:", "ftp:", "gopher:", "mailto:", or "news:" to create links automatically, as in http://www.pmichaud.com/toast.²* [=URLs=] ending with .gif, .jpg, or .png are displayed as images in the page²** An image URL at the beginning of a line "floats left" with text wrapped around it.²** An image URL at the end of a line "floats right" with text wrapped around it.²** An image URL on a line by itself appears by itself in the output.²* [=URLs=] can be placed in double brackets [[''url'']] when the URL itself is not important to the text. For example, [=[[http://www.google.com/]]=] will appear as [[http://www.google.com/]].²* Links with arbitrary text can be created in double brackets as [[''url'' ''text'']] or [[''WikiWord'' ''text'']]. ''Text'' can be an image URL, in which case the image becomes the link to the remote ''url'' or ''WikiWord''.²* [[#Anchors]] Anchor targets within pages (#-links) can be created using [@[[#target]]@] and linked to with [@[[#target@] @@''text'']]@@.²²----²!!![=FreeLinks=]²²A {{free link|s}} is a page name reference that doesn't follow the WikiWord convention.²²Often, there is no natural WikiWord for naming a page. That's when @@[={{free links}}=]@@ (a page called {{free links}}) are useful. The @@[={{text}}=]@@ markup creates a link to a page called '''Text'''. The markup @@[={{basic editing}}=]@@ markup creates a link to a page called '''[=BasicEditing=]''' and displays as {{basic editing}}. Suffixes and plurals are also possible, thus @@[={{wiki word}}s=]@@ produces {{wiki word}}s.²²For more information please see the FreeLinks documentation.²²----²!!!Headings²²Headings are made by placing a exclamation mark ('''!''') at the left margin. More exclamation marks increases the level of heading. For example,² ! Level 1 Heading²! Level 1 Heading² !! Level 2 Heading²!! Level 2 Heading² !!! Level 3 Heading²!!! Level 3 Heading²²----²!!!Escape sequence²²Anything placed between [=[= and =]=] is not interpreted by PmWiki/PmWiki. This makes it possible to easily do [=WikiWords=] that are not links and turn off other special formatting interpretation. The [=[= and =]=] can span multiple input lines, allowing effects to be applied to multiple input lines. For example, space[[===] at the beginning of a line will cause the text up to the next =] to be monospace and uninterpreted by PmWiki/PmWiki (useful for program listings).²²Additionally, the special markup [=[@ and @]=] can be used as a shortcut for [=@@[= and =]@@=], or typewriter-font text that is not interpreted by the wiki.²²----²!!!Numbered Lists²²Numbered lists are made by placing number-signs (#) at the left margin.²²² # Prepare the experiment² ## Unwrap the pop-tart² ## Insert the pop-tart into the toaster² # Begin cooking the pop tart² # Stand back²²# Prepare the experiment²## Unwrap the pop-tart²## Insert the pop-tart into the toaster²# Begin cooking the pop tart²# Stand back²²----²²!!! [[#DefinitionLists]] Definition Lists²²²Definition lists are made by placing colons at the left margin:²² :term:definition of term² ::second-level item: definition of 2nd-level item²²:term:definition of term²::second-level item: definition of 2nd-level item²²----²!!!Tables²²Table are defined by enclosing cells with '||'. A cell with leading and trailing spaces is centered; a cell with leading spaces is right-aligned; all other cells are left-aligned. An empty cell will cause the previous cell to span multiple columns. (There is currently no mechanism for spanning multiple rows.) A line beginning with '||' specifies the table attributes for subsequent tables.²² [=² ||align=center border=1 width=50%² ||Left || Center || Right||² ||A || B || C||² || || single || ||² || || multi span ||||²=]²||align=center border=1 width=50%²||Left || Center || Right||²||A || B || C||²|| || single || ||²|| || multi span ||||²²For more information see SimpleTables, SimpleTables2 and AdvancedTables.²²----²[[include:SpecialCharacters]]²²----²!!!Comments²²Text following a @@[=%comment%=]@@ tag is not displayed, up until the end of the line or a subsequent @@[=%%=]@@.²² [=%comment% This is a hidden comment line that doesn't show.=]²²%trail%<<|PmWiki.DocumentationIndex|>>²
time=1089196881
host=212.69.245.89
agent=Nutscrape/9.0 (CP/M; 8-bit)
rev=151
post= Save
name=PmWiki.TextFormattingRules
author=