authors (basic)
The pages on this site are WikiWikiWeb pages, which means that pages can be created and edited by multiple authors. To edit a page, click the Edit link that exists somewhere on the page, usually in the header or footer. Some pages may be password-protected, depending on the system’s security policies, but many systems allow open editing of pages.
When editing a page, you see the markup text that describes the content of the page. The basic rules for page markup are simple:
''text''
for italics or '''text'''
for bold.
[[basic editing]]
links to this page. Links to nonexistent pages are displayed specially, to invite others to create the page.
If you want to experiment with editing a page, try it on the WikiSandbox. You can edit the WikiSandbox without affecting anything important on this site. If you do edit other pages, it’s courteous to sign your contribution; using ~~~ effectively ‘signs’ the name that you provide in the Author field on the Page Edit form.
The table below demonstrates many of the common markups used to format pages. The left column shows the effect of the markup, the right column shows what to write to achieve the effect. More details are available from the text formatting rules and other documentation pages. An exhaustive list of default markup is available as the markup master index
What it looks like |
What to type |
An empty line starts a new paragraph. | An empty line starts a new paragraph. |
A single newline
usually doesn’t affect the layout.
Use two backslashes | A single newline usually doesn't affect the layout. Use two backslashes\\ to break a line. |
A single backslash joins the next line to the previous one. |
A single backslash \ joins the next line \ to the previous one. |
Use three backslashes | Use three backslashes\\\ for two line breaks. |
by the first line that is not a list
| * Lists are created by using asterisks ** More asterisks produce deeper lists *** The list is terminated by the first line that is not a list # Numbered lists # are also possible ** and lists can nest |
An arrow (→) indents content.
Line up text to continue the indent.
A reverse arrow (-<) creates a hanging indent, the first line is outdented and remaining lines are indented.
Longer reverse arrows indent further.
| -> An arrow (->) indents content. Line up text to continue the indent. -->Longer arrows (-->) indent further. -<A reverse arrow (-<) creates a \ hanging indent, the first line \ is outdented and remaining lines \ are indented. --< Longer reverse arrows indent \ further. |
| : Definition list : list of definitions : item : the item's definition : another item : that item's definition |
Lines that begin with a space are formatted exactly as typed, in a fixed-width font. Note that very long lines of preformatted text can cause the whole page to be wide. | Lines that begin with a space are formatted exactly as typed, in a fixed-width font. |
This text is centered. This text is right justified. | %center% This text is centered. %right% This text is right justified. |
Four or more dashes at the beginning of a line produce a horizontal line. | Four or more dashes at the beginning of a line ---- produce a horizontal line. |
What it looks like |
What to type |
Practice editing in the wiki sandbox.
| Practice editing in the [[wiki sandbox]]. |
Practice editing in the WikiSandbox. Which one? Oh, in the Main.WikiSandbox.
| Practice editing in the [[Main/WikiSandbox]]. Which one? Oh, in the [[Main.WikiSandbox]]. |
Practice editing in the practice area. Practice editing in the practice area. Practice editing in the practice area.
| Practice editing in the [[WikiSandbox | practice area]]. Practice editing in the [[Main.WikiSandbox | practice area]]. Practice editing in the [[practice area -> WikiSandbox]]. |
Practice editing in the wiki sandboxes. Practice editing in the sandbox.
| Practice editing in the [[wiki sandbox]]es. Practice editing in the [[(wiki) sandbox]]. |
What’s an aardvark, anyway?
| %newwin%What's an [[(Wikipedia:)aardvark]], anyway? |
Links to external sources can be entered
| Links to external sources can be entered # bare url: http://google.com # link text: [[http://google.com | Google]] # as reference: [[http://google.com |#]] |
Links can open in another window, as in http://www.pmwiki.org. | Links can open in another window, as in %newwin% http://www.pmwiki.org. |
Emphasize, strongly, very strongly.
| ''Emphasize'', '''strongly''', '''''very strongly'''''. |
This is a preformatted text block | @@Monospaced text@@ [@This is a preformatted text block@] |
| * Text with '^superscripts^' * Text with '_subscripts_' * deleted {-strikethrough-} text * inserted {+underline+} text * [+big+], [++bigger++] text * [-small-], [--smaller--] text |
WikiStyles allow text to be in different colors.
| [[WikiStyles]] allow %red% text %blue% to %green% be in %color=#ff7f00% different %%colors. |
Major SubheadingMajor Subheading With Smaller TextMinor SubheadingAnd MoreSubheadings
They’re not just for making big text. | !! Major Subheading !! [-Major Subheading With Smaller Text-] !!! Minor Subheading !!!! And More !!!!! Subheadings |
Page titles
Not shown
| (:title Basic Editing:) |
Block styles
All of the text in this block is purple.
| >>purple<< All of the text in this block is purple. * Purple cows and purple flowers * Purple people eater >>red<< * Now this list is red >>center<< * and this text is centered >>right<< * and this text is right justified >><< * And this is normal |
« | Documentation Index | Creating new pages »
Q I’m new to PmWiki, where can I find some basic help for getting started?
A The Basic Editing page is a good start. From there, you can just follow the navigational links at the bottom of the page (they are called WikiTrails) to the next pages, or to the Documentation Index page, which provides an outline style index of essential documentation pages, organized from basic to advanced.
Q How do I include special characters on my wiki pages?
A Use character codes to insert special characters, such as Copyright (©) and Trademark (® or ™) symbols, that don’t appear on your keyboard.
Q Why are separate lines of text in the markup combined into a single line on output?
A PmWiki normally treats consecutive lines of text as being a paragraph, and merges and wraps lines together on output. This is consistent with most other wiki packages. However, an author can use the (:linebreaks:)
directive to cause separate lines of markup text to be kept as separate lines in the output.
…