phpgtk__legacy/wiki/wikilib.d/PmWiki.BasicEditing

version=pmwiki-2.1.9 ordered=1 urlencoded=1
agent=Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.0.3) Gecko/20060425 SUSE/1.5.0.3-7 Firefox/1.5.0.3
author=Pm
csum=added special characters question
host=24.1.26.255
name=PmWiki.BasicEditing
rev=172
targets=PmWiki.DocumentationIndex,PmWiki.WikiWikiWeb,PmWiki.Passwords,PmWiki.NonexistentPages,Main.WikiSandbox,PmWiki.TextFormattingRules,PmWiki.MarkupMasterIndex,PmWiki.Links,PmWiki.WikiSandbox,PmWiki.InterMap,PmWiki.WikiStyles,PmWiki.BasicEditing,PmWiki.WikiTrails,PmWiki.SpecialCharacters
text=%25audience%25 authors (basic)%0a%0a%25trail%25 %3c%3c|[[Documentation Index]]|>>%0a%0aThe 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(s)]]-protected, depending on the system's security policies, but many systems allow open editing of pages.%0a%0aWhen editing a page, you see the ''markup text'' that describes the content of the page.  The basic rules for page markup are fairly simple:%0a# Put a blank line between paragraphs%0a# To make a list, start each line with # for numbered (ordered) lists or * for bulleted (unordered) lists.%0a# To make a heading, start a line with two or more ! marks; !! is a subheading, and !!! is a sub-subheading.%0a# To emphasize text, enclose it in 2 or 3 ''single quotes''; [@''text''@] for italics or [@'''text'''@] for bold.%0a# To make a link to another page, enclose the page's name in double brackets; for example [@[[basic editing]]@] links to this page. Links to [[nonexistent pages]] are displayed specially, to invite others to create the page.%0a# To make a link to another site, type its address, such as http://www.example.com/ .%0a%0a'''If you want to experiment with editing a page, try it on the [[Main/WikiSandbox]].''' You can [[Main/WikiSandbox?action=edit | 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.%0a%0a!! Examples%0a%0aThe 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]]%0a%0a!!! General Usage%0a%0a(:table width='100%25' border='1' cellspacing='0' cellpadding='2':)%0a(:cellnr width='40%25':)%0a%25center%25 '''What it looks like'''%0a(:cell:)%0a%25center%25 '''What to type'''%0a(:cellnr:)%0aAn empty line%0a%0astarts a new paragraph.%0a(:cell:) [@%0aAn empty line%0a%0astarts a new paragraph.%0a@]%0a(:cellnr:)%0aA single newline%0ausually doesn't affect the layout.  %0aUse two backslashes\\%0ato break a line.%0a(:cell:) [@%0aA single newline%0ausually doesn't affect the layout.  %0aUse two backslashes\\%0ato break a line.%0a@]%0a(:cellnr:)%0aA single backslash \%0ajoins the next line \%0ato the previous one.%0a(:cell:)%0a[@%0aA single backslash \%0ajoins the next line \%0ato the previous one.%0a@]%0a(:cellnr:)%0aUse three backslashes\\\%0afor two line breaks.%0a(:cell:) [@%0aUse three backslashes\\\%0afor two line breaks.%0a@]%0a(:cellnr:)%0a* Lists are created by using asterisks%0a** More asterisks produce deeper lists%0a*** The list is terminated%0aby the first line that is not a list%0a%0a# Numbered lists%0a# are also possible%0a** and lists can nest%0a(:cell:) [@%0a* Lists are created by using asterisks%0a** More asterisks produce deeper lists%0a*** The list is terminated%0aby the first line that is not a list%0a%0a# Numbered lists%0a# are also possible%0a** and lists can nest@]%0a(:cellnr:)%0a-> An arrow (->) indents content.%0a%0a   Line up text to continue the indent.%0a%0a-->Longer arrows (-->) indent further.%0a%0a-%3cA reverse arrow (-%3c) creates a \%0ahanging indent, the first line \%0ais outdented and remaining lines \%0aare indented.%0a--%3c Longer reverse arrows indent \%0afurther.%0a(:cell:) [@%0a-> An arrow (->) indents content.%0a%0a   Line up text to continue the indent.%0a%0a-->Longer arrows (-->) indent further.%0a%0a-%3cA reverse arrow (-%3c) creates a \%0ahanging indent, the first line \%0ais outdented and remaining lines \%0aare indented.%0a--%3c Longer reverse arrows indent \%0afurther.%0a@]%0a(:cellnr:)%0a: Definition list : list of definitions%0a: item : the item's definition%0a: another item : that item's definition%0a(:cell:) [@%0a: Definition list : list of definitions%0a: item : the item's definition%0a: another item : that item's definition%0a@]%0a(:cellnr:)%0a Lines that begin with%0a a space are formatted exactly%0a as typed, in a fixed-width font.%0a%0aNote that very long lines of preformatted text%0acan cause the whole page to be wide.%0a(:cell:) [@%0a Lines that begin with%0a a space are formatted exactly%0a as typed, in a fixed-width font.@]%0a(:cellnr:)%0a%25center%25 This text is centered.%0a%0a%25right%25 This text is right justified.%0a(:cell:) [@%0a%25center%25 This text is centered.%0a%0a%25right%25 This text is right justified.@]%0a(:cellnr:)%0aFour or more dashes%0aat the beginning of a line%0a----%0aproduce a horizontal line.%0a(:cell:) [@%0aFour or more dashes%0aat the beginning of a line%0a----%0aproduce a horizontal line.%0a@]%0a(:tableend:)%0a%0a%0a!!! [[#links]] [[Links]]%0a%0a(:table width='100%25' border='1' cellspacing='0' cellpadding='2':)%0a(:cellnr width='40%25':)%0a%25center%25 '''What it looks like'''%0a(:cell:)%0a%25center%25 '''What to type'''%0a(:cellnr:)%0aPractice editing%0ain the [[wiki sandbox]].%0a%0a* Text in double brackets become links to other pages.%0a* Words are automatically capitalized in page titles.%0a(:cell:) [@%0aPractice editing%0ain the [[wiki sandbox]].%0a@]%0a(:cellnr:)%0aPractice editing%0ain the [[Main/WikiSandbox]].%0a%0aWhich one?%0aOh, in the [[Main.WikiSandbox]].%0a%0a* When linking to a page in a different wikigroup, provide the group name, followed by a separator, and then the page name.%0a* If the separator you use is a slash, only the page name will appear.%0a* If the separator you use is a dot, the full string will appear.%0a(:cell:) [@%0aPractice editing%0ain the [[Main/WikiSandbox]].%0a%0aWhich one?%0aOh, in the [[Main.WikiSandbox]].%0a@]%0a(:cellnr:)%0aPractice editing in the%0a[[WikiSandbox | practice area]].%0a%0aPractice editing in the%0a[[Main.WikiSandbox | practice area]].%0a%0aPractice editing in the%0a[[practice area -> WikiSandbox]].%0a%0a* Text after a pipe (|) is used as the link text, or use the alternate (and perhaps more understandable) arrow (text -> link) notation.%0a(:cell:) [@%0aPractice editing in the%0a[[WikiSandbox | practice area]].%0a%0aPractice editing in the%0a[[Main.WikiSandbox | practice area]].%0a%0aPractice editing in the%0a[[practice area -> WikiSandbox]].%0a@]%0a(:cellnr:)%0aPractice editing in the%0a[[wiki sandbox]]es.%0a%0aPractice editing in the%0a[[(wiki) sandbox]].%0a%0a* Endings become part of the link text.%0a* Parentheses hide parts of the link name.%0a(:cell:) [@%0aPractice editing in the%0a[[wiki sandbox]]es.%0a%0aPractice editing in the%0a[[(wiki) sandbox]].%0a@]%0a(:cellnr:)%0aWhat's an [[(Wikipedia:)aardvark]], anyway?%0a%0a* Pmwiki can use [[InterMap| InterMap prefixes]] that have specific meanings.%0a* Parentheses can hide those too.%0a(:cell:) [@%0a%25newwin%25What's an%0a[[(Wikipedia:)aardvark]], anyway?%0a@]%0a%0a(:cellnr:)%0aLinks to external sources can be entered%0a# bare url:  http://google.com%0a# link text: [[http://google.com | Google]]%0a# as reference: [[http://google.com |#]]%0a(:cell:) [@%0aLinks to external sources can be entered%0a# bare url:  http://google.com%0a# link text: [[http://google.com | Google]]%0a# as reference: [[http://google.com |#]]%0a@]%0a%0a(:cellnr:)%0aLinks can open in another window,%0aas in %25newwin%25 http://www.pmwiki.org.%0a(:cell:) [@%0aLinks can open in another window,%0aas in %25newwin%25 http://www.pmwiki.org.%0a@]%0a(:tableend:)%0a%0a!!! Character formatting%0a%0a(:table width='100%25' border='1' cellspacing='0' cellpadding='2':)%0a(:cellnr width='40%25':)%0a''Emphasize'', '''strongly''', %0a'''''very strongly'''''.%0a%0a* These are all apostrophes (single-quote marks), not double-quotes.%0a(:cell:) [@%0a''Emphasize'', '''strongly''', %0a'''''very strongly'''''. @]%0a%0a(:cellnr:)%0a@@Monospaced text@@%0a%0a[@This is a%0a  preformatted%0a    text block@]%0a(:cell:) [@%0a@@Monospaced text@@ @]%0a [=%0a[@This is a%0a  preformatted%0a    text block@]=]%0a(:cellnr:)%0a* Text with '^superscripts^'%0a* Text with '_subscripts_'%0a* deleted {-strikethrough-} text%0a* inserted {+underline+} text%0a* [+big+], [++bigger++] text%0a* [-small-], [--smaller--] text%0a(:cell:) [@%0a* Text with '^superscripts^'%0a* Text with '_subscripts_'%0a* deleted {-strikethrough-} text%0a* inserted {+underline+} text%0a* [+big+], [++bigger++] text%0a* [-small-], [--smaller--] text%0a@]%0a(:cellnr:)%0a[[WikiStyles]] allow %25red%25 text%0a%25blue%25 to %25green%25 be %0a%25color=#ff7f00%25 different %25%25colors.%0a%0a* Use lowercase letters for RGB colors (#ff7f00, not [=#FF7F00=]).%0a(:cell:) [@%0a[[WikiStyles]] allow %25red%25 text%0a%25blue%25 to %25green%25 be %0a%25color=#ff7f00%25 different %25%25colors.%0a@]%0a(:tableend:)%0a%0a!!! Headings and blocks%0a%0a(:table width='100%25' border='1' cellspacing='0' cellpadding='2':)%0a(:cellnr width='40%25':)%0a!! Major Subheading%0a!! [-Major Subheading With Smaller Text-]%0a!!! Minor Subheading%0a!!!! And More%0a!!!!! Subheadings%0a* Headings are useful for creating a "well-structured" page.%0a  They're not just for making big text.%0a(:cell:) [@%0a!! Major Subheading%0a!! [-Major Subheading With Smaller Text-]%0a!!! Minor Subheading%0a!!!! And More%0a!!!!! Subheadings%0a@]%0a(:cellnr:)%0a-%3c'''Page titles'''%0a''Not shown''%0a(:title Basic Editing:)%0a%0a* The [@(:title:)@] directive sets the page's title to something other than its name.%0a(:cell:) [@%0a(:title Basic Editing:)%0a@]%0a(:cellnr:)%0a-%3c'''Block styles'''%0a(:comment note you can't nest table and div :)%0a%25block purple%25All of the text in this block%0ais purple.%0a* %25item purple%25Purple cows and purple flowers%0a* %25item purple%25Purple people eater%0a* %25item red%25 Now this list is red%0a* %25item center%25 and this text is centered%0a* %25item right%25 and this text is right justified%0a* And this is normal%0a(:cell:) [@%0a>>purple%3c%3c%0aAll of the text in this block%0ais purple.%0a* Purple cows and purple flowers%0a* Purple people eater%0a>>red%3c%3c%0a* Now this list is red%0a>>center%3c%3c%0a* and this text is centered%0a>>right%3c%3c%0a* and this text is right justified%0a>>%3c%3c%0a* And this is normal@]%0a(:tableend:)%0a%0a%25trail%25 %3c%3c|[[Documentation Index]]|>>%0a%0a>>faq%3c%3c [[#faq]]%0a[[#beginning]]%0aQ: I'm new to PmWiki, where can I find some basic help for getting started?%0aA: This [[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.%0a%0aQ: How do I include special characters on my wiki pages?%0aA: Use character codes to insert [[special characters]], such as Copyright (©) and Trademark (® or ™) symbols, that don't appear on your keyboard.
time=1149272849
title=Basic Editing