Документ взят из кэша поисковой машины. Адрес
оригинального документа
: http://www.mrao.cam.ac.uk/projects/OAS/pmwiki/pmwiki.php/PmWiki/TextFormattingRules?action=print
Дата изменения: Unknown Дата индексирования: Sat Mar 1 21:52:15 2014 Кодировка: Поисковые слова: п п п п п п п п п п п п п п п п п п п |
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 edit the Wiki Sandbox.
To create paragraphs, simply enter text. Use a blank line to start a new paragraph.
Words on two lines in a row will wrap and fill as needed (the normal XHTML behavior). To turn off the automatic filling, use the (:linebreaks:)
directive above the paragraph.
\
(single backslash) at the end of a line to join the current line to the next one.
\\
(two backslashes) at the end of a line to force a line break.
\\\
(three backslashes) at the end of a line to force 2 line breaks.
[[<<]]
to force a line break that will clear floating elements.
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.
|
Inverted Arrows (-<
) at the beginning of a paragraph can be used to produce a paragraph with a hanging indent. Adding hyphens at the beginning (---<
) causes all the text to indent.
-<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.
|
--<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. And that food would be good too. |
|
Blocks of text to which (:linebreaks:)
has been applied can be indented by preceding the first line of the block with indention arrows (->
) and aligning subsequent lines under the first. An unindented line stops the block indentation. See Cookbook:Markup Tricks for an example.
Bullet lists are made by placing asterisks at the beginning of the line. Numbered lists are made by placing number-signs (#) at the beginning of the line. More asterisks/number-signs increases the level of bullet:
* First-level list item ** Second-level list item ### Order this #### And this (optional) ### Then this ** Another second-level item * A first-level item: cooking ## Prepare the experiment ### Unwrap the pop-tart ### Insert the pop-tart into the toaster ## Begin cooking the pop tart ## Stand back |
|
# A list is terminated by the first line that is not a list. # Also terminate a list using the escape sequence [@[==]@] [==] # Continue a list item by lining up the text with leading whitespace. # Use a forced linebreak \\ to force a newline in your list item. |
by the first line that is not a list.
|
## Text between list items can cause numbering to restart ## %item value=3% this can be dealt with |
|
Also see: ListStyles, Cookbook:WikiStylesPlus.
Powerful new* feature
When you define terms using this markup
PmWiki will recognize them as PageTextVariables
that you can use on any page or PageList.
* Added in PmWiki version 2.2.0
Definition lists are made by placing colons at the left margin (and between each term and definition):
:term:definition of term ::second-level item: definition of 2nd-level item |
|
Whitespace indentation in lists. Any line that begins with whitespace and aligns with a previous list item (whether bulleted, numbers or definitional) is considered to be "within" that list item. Text folds and wraps as normal, and the (:linebreaks:)
directive is honored.
# First-level item\\ Whitespace used to continue item on a new line # Another first-level item # Whitespace combined with a single # to create a new item one level deeper |
|
Otherwise, lines that begin with whitespace are treated as preformatted text, using a monospace font and not generating linebreaks except where explicitly indicated in the markup. Note to administrators: Starting with version 2.2.0-beta41, this feature can be modified using $EnableWSPre
. (Another way to create preformatted text blocks is by using the [@...@] markup.)
Four or more dashes (----) at the beginning of a line produce a horizontal line.
monospace
text
Other styling
'+big+', '-small-', '^super^', '_sub_', {+insert or underscore+}, {-delete or strikethrough or strikeout-} |
big, small, super, sub, insert or underscore,
|
`WikiWord
WikiWord neutralisation
See also Wiki Styles for advanced text formatting options.
http:
", "ftp:
", "gopher:
", "mailto:
", or "news:
" to create links automatically, as in http://www.pmichaud.com/toast.
.gif
, .jpg
, or .png
are displayed as images in the page
[[#target]]
.
See Links for details.
Headings are made by placing an exclamation mark (!) at the left margin. More exclamation marks increase the level of heading. For example,
!! Level 2 Heading !!! Level 3 Heading !!!! Level 4 Heading !!!!! Level 5 Heading |
Level 2 HeadingLevel 3 HeadingLevel 4 HeadingLevel 5 Heading |
Note that level 1 heading is already used as page title (at least in the PmWiki skin), so you should start with level 2 headings to create well formed, search engine optimized web pages.
See Cookbook:Numbered Headers for numbered headings.
Anything placed between [= and =] is not interpreted by PmWiki, but paragraphs are reformatted. This makes it possible to turn off special formatting interpretations and neutralise WikiWords that are not links (even easier is to use a tick ` in front, like `WikiWord).
For preformatted text blocks, use the [@...@] markup. It does neither reformat paragraphs nor process wiki markup:
[@ Code goes here like [[PmWiki.PmWiki]] '$CurrentTime $[by] $AuthorLink: [=$ChangeSummary=]'; #just some code @] |
Code goes here like [[PmWiki.PmWiki]] '$CurrentTime $[by] $AuthorLink: [=$ChangeSummary=]'; #just some code |
The multiline [@...@]
is a block markup, and in order to change the styling of these preformatted text blocks, you need to apply a "block" WikiStyle.
%block blue%[@ The font color of this text is blue @] |
The font color of this text is blue |
It is also useful to use [= =]
within other wiki structures, as this enables the inclusion of new lines in text values. The example below shows how to include a multi-line value in a hidden form field.
(:input hidden message "[=Line1 Line2=]":)
(:comment Some information:)
can be very kind to subsequent authors, especially around complicated bits of markup.
When creating pages it's common to use commercial trademarks, copyright, umlaut, and other non-keyboard symbols. therefore it's important that you have the means to input these special characters.
PmWiki supports the HTML special character listings by the w3c. W3C Page of Special Character codes ISO standard.
Here are some samples:
© | ¼ | ½ | ® | µ | ¨ |
© | ¼ | ½ | ® | µ | ¨ |
Æ | 32° | Unïted Stätes | ¶ | ¥Yen | PmWiki™ |
Æ | 32° | Unïted Stätes | ¶ | ¥Yen | PmWiki™ |
For a nice table of the same codes that show the codes with the output go to the Noble Desktop special character page.
Find the "Character Map" utility in your computer's System Tools folder. Click the symbol you're interested in, and note the keystroke information at the bottom of the box. You execute these by holding "Alt" while keying the numbers on the numerical keypad of your keyboard (not the numbers across the top of the board).
© = Alt+0169 = © | ® = Alt+0174 = ® | ° = Alt+0176 = ° (degrees).
There's a list of special characters at PmWiki:SpecialCharactersList. There's another illustration at PmWiki:Characters
Tables 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. A '!' as the first character in a cell provides emphasis that can be used to provide headings.
||border=1 width=50% ||!Table||!Heading||!Example|| ||!Left || Center || Right|| ||A ||! a B || C|| || || single || || || || multi span |||| | |||||||||||||||
|
See Table Directives for advanced tables.
See Markup Master Index.
This page may have a more recent version on pmwiki.org: PmWiki:TextFormattingRules, and a talk page: PmWiki:TextFormattingRules-Talk.