[[:CategoryDev/Document/Text Formatting Rule]] -This is a testing document for PukiWiki's Formatting rules. It may be used as examples for the documentation later on. ---Bjorn -Oh! It's a very useful format for summarizing Text Formatting Rule. --[[merlin]] &new{2003-10-15 (水) 12:35:09}; -Wow. Your immediate work is astonishing to me! Added the description for "line breaking at end of the line". I think this is what you reffered, Bjorn. And ,probably, you can use include plug-in to insert formatted headings. But it requires another page to be included... I also added Nesting Elements from [[Text Formatting Rule:http://pukiwiki.sourceforge.jp/dev/index.php?cmd=search&word=%3ACategoryDev%2FDocument%2FText%20Formatting%20Rule]]. ---Olorin &new{2003-10-16 (木) 01:11:09}; -Thanks, both of you for the compliments. ^_^ I have cleaned up a little a bit more.----Bjorn #hr *Inline Elements [#v2f727fb] In the following table you can see how to use the inline text elements of PukiWiki |''Format example''|''Formatting code''|''Comment''|h |''Emphasised text''|''Emphasised text''|Put the text between two single quotes.| |'''Italic text'''|'''Italic text'''|Put the text between three single quotes.| |Text with&br;a break|Text with &br; a break|| |&size(24){Text in font size 24};| &size(24){Text in font size 24};|| |&color(purple){Purple text};| &color(purple){Purple text};|| |&color(#123456){Colored text};| &color(#123456){Colored text};|| |&color(red,yellow){Red text with yellow backbround};| &color(red,yellow){Red text with yellow background};|| |%%Strikethrough text%%| %%Strikethrough text%%|| |((This is the footnote's text))|((This is the footnote's text))|This inserts a footnote with the given text at the bottom of the page.| |&ref(http://www.example.com);&br;&ref(pukiwiki.png,alt-title-puki-img);|&ref(http://www.example.com);&br;&ref(pukiwiki.png,alt-title-puki-img);|This inserts a reference.&br;It also inserts attached images.| |&aname(Anchor);|&aname(Anchor);|This inserts an invisible anchor for hyperlinking.| |&counter;|&counter;|This inserts a counter. What does it count, in fact?| |&online;|&online;|What does this do, in fact?| |&version;|&version;|I guess this inserts the current version number of PukiWiki itself?| |WikiName|WikiName|This create a link to another pages on the same Pukiwiki site.| |[[BracketName]]|[[BracketName]]|This creates a link to another page on a same Pukiwiki site.| |[[External link:http://www.example.com]]|[[External link:http://www.example.com]]|This creates links to pages on other web sites.| |[[InterWikiLink:page name]]|[[InterWikiLink:page name]]|This creates a link to another Wiki, right?| |[[Alias>FrontPage]]|[[Alias>FrontPage]]|This enables you to make a link to a page in Pukiwiki with a different name.| |[[Alias>InterWikiLink:page name]]|[[Alias>InterWikiLink:page name]]|Advanced Link style: the combination of Alias and InterWiki| |Inline text&br;Inline text| Inline text&br;Inline text|&br; is replaced with a line break.| |Inline text~&br;#plug-in| Inline text~&br;#plug-in|The ~, followed by a line break works as an escape character that disables the # character, which normally activates a plugin.&br;cf.[[Paragraph(Block Elements)>#a6ab3c0e]]| &br; *Block Elements [#veaf1193] ~In what follows, examples for the block elements will be given. First, you will see the example as it should be entered into PukiWiki,and next is the result you'll get. **Preformatted text [#v6d2a929] Preformatted text. There is a space in front of this text. Preformatted text. There is a space in front of this text. &br; **Headings [#n6275890] *Heading level 1 **Heading level 2 ***Heading level 3 There are no examples of how the heading looks like here, because they would disturb the structure of this document. But take a look at the headings above and below to see how it might look. &br; **Paragraphs and the tilde as and escape character [#a6ab3c0e] ~Paragraph ~*This will not be displayed as a heading ~Paragraph ~*This will not be displayed as a heading Line break escape example~ #comment (disables first letter formatting rule, which is used to activate plug-ins.) Line break escape example~ #comment (disables first letter formatting rule, which is used to activate plug-ins.) &br; **Quotes [#q0849799] >Quote Level 1 >>Quote Level 2 >>>Quote Level 3 >Quote Level 1 >>Quote Level 2 >>>Quote Level 3 &br; **Unordered lists [#kbd4d759] -Unordered list level 1 --Unordered list level 2 ---Unordered list level 3 -Unordered list level 1 --Unordered list level 2 ---Unordered list level 3 &br; **Ordered lists [#z291b8c3] +Ordered list level 1 ++Ordered list level 2 +++Ordered list level 3 +Ordered list level 1 ++Ordered list level 2 +++Ordered list level 3 &br; **Definition lists [#z93a6096] :Definition|Description :Definition|Description &br; **Comments [#l279ee0b] A comment is hidden here: //Comment A comment is hidden here: //Comment &br; **Horizontal Rule [#s0439a0c] ---- ---- **Table [#jecf0233] *** Simple [#v90083b4] |aaa|bbb|ccc| |111|222|333| |aaa|bbb|ccc| |111|222|333| *** Advanced [#n6c24e02] |RIGHT:100|CENTER:|SIZE(20)|c -------------- format definition line |~Header|Header2|Header3|h ----------------- header line |CENTER:lowspan|COLOR(red):bbb|ccc| |~|222|COLOR(#ff0000):BGCOLOR(yellow):333| |footer|>|CENTER:colspan|f ----------------- footer line |RIGHT:100|CENTER:|SIZE(20)|c |~Header|Header2|Header3|h |CENTER:lowspan|COLOR(red):bbb|ccc| |~|222|COLOR(#ff0000):BGCOLOR(yellow):333| |footer|>|CENTER:colspan|f **CSV Table [#pece650e] ,aaa , bbb , ccc ,1111,2222,3333 ,aaa , bbb , ccc ,1111,2222,3333 //**Plug-ins // #contents // (This is the table of contents plugin) // //#contents //(This is the table of contents plugin) // The above does not work? *Special entities : [#nb14c38a] // These expressions do not work with the default settings. // See pukiwiki.ini.php and default.ini.php. //|FormattingSandbox|&page;|This one doesn't seem to work?| //|2003-10-28|&date;|This one doesn't seem to work?| //|03:33:43|&time;|This one doesn't seem to work?| //|2003-10-28 (火) 03:33:43|&now;|This one doesn't seem to work?| //|2003-10-15|date ?| This one is replaced when editing is finished.| //|12:35:09|time ?| This one is replaced when editing is finished.| //|2003-10-15 (水) 12:35:09|now ?| This one is replaced when editing is finished.| |''Special entity''|''Code''|''Comments''|h |&heart;|&heart;|| |©|&copy;|| |®|&reg;|| |™|&trade;|| |²|&sup2;|| |³|&sup3;|| | |&nbsp;|You may not be able to see it,&br;but there is a non-breaking space in the first column. &br; It prevents a line from being broken at that point.| | |&#10;|You can define any unicode character up to #32000 using this code. Please note that you need a font that supports the character, or you will not be able to see it.| |世|&#19990;|You can use characters from all over the world!| |♂|&#9794;|It is a man's world.| |☿|&#9792;|But it would be nothing without a woman.| |∞|&#8734;|We could go on like this forever...| |Ω|&#937;|But here it must end.| &br; *Nesting Elements [#vd8a37d7] **Paragraph Element-Emphasize Element [#n053ef8b] ~This is the paragraph, which is the parent element that contains emphasized text. ''This is the emphasized text, that is the child element of the paragraph element.'' ~This is the paragraph, which is the parent element that contains emphasized text. ''This is the emphasized text, that is the child element of the paragraph element.'' **Quotation Element-List Element [#a8c9880d] Level[0] >Quotation Level[1]AAA ~Quotation Level[1]BBB >>Quotation Level[2]AAA ~Quotation Level[2]BBB >>>Quotation Level[3] -Child Element-List Level[1] |TABLE|ELEMENT|NEXT|to|the Inline|element|in a list| --Child Element-List Level[2] &br;Line Break in a Element ---Child Element-List Level[3] --Child Element-List Level[2] ---Child Element-List Level[3] <<Quotation Level[1] >>Quotation Level[2] <<Get out of the Quotation Level2 Element >>>Quotation Level[3]AAA >>>Quotation Level[3]BBB -Child Element-List Level[1] --Child Element-List Level[2] ---Child Element-List Level[3] Level[0] >Quotation Level[1]AAA ~Quotation Level[1]BBB >>Quotation Level[2]AAA ~Quotation Level[2]BBB >>>Quotation Level[3] -Child Element-List Level[1] |TABLE|ELEMENT|NEXT|to|the Inline|element|in a list| --Child Element-List Level[2] &br;Line Break in a Element ---Child Element-List Level[3] --Child Element-List Level[2] ---Child Element-List Level[3] <<Quotation Level[1] >>Quotation Level[2] <<Get out of the Quotation Level2 Element >>>Quotation Level[3]AAA >>>Quotation Level[3]BBB -Child Element-List Level[1] --Child Element-List Level[2] ---Child Element-List Level[3] This section needs to be brushed up. *Enhancements with Plug-in [#v2f727fb] **How can I attach/upload files and images? [#x7a9d23f] :Required Plug-ins| ~"Attach" and "Ref" :How to| +First, you need to upload the file or image by using "attach plug-in". You can recognise the icon of "clip"- something like these:&ref(http://pukiwiki.org/image/attach.png,nolink); or &ref(http://pukiwiki.sourceforge.jp/dev/image/file.png,nolink);, at the bottom of the page. Or there may exist a "text link" which leads you to the upload page at the top, but it depends on the "skin". +If you fihish uploading the file or image, you can call the uploaded ones by using "ref plug-in" **How to make a link [#vd962292] First let's focus on their grammatical styles. [[pukiwiki:Use PukiWiki]]..........[a]&br; [[whatever u like:http://pukiwiki.org/?Use%20PukiWiki]]...[b]&br; [[http://pukiwiki.org/pukiwiki.png:http://pukiwiki.org/?Use%20PukiWiki]][b']&br; [[&ref(pukiwiki.png,nolink,Pukiwiki);:http://pukiwiki.org/]]...[b'']&br; [[Another Name(Alias)>FormattingSandbox]]......[c]&br; [[http://pukiwiki.org/pukiwiki.png>FormattingSandbox]]...[c']&br; [[&ref(pukiwiki.png,nolink,Pukiwiki);>FormattingSandbox]]...[c'']&br; [[external Alias>http://pukiwiki.org/]]...[d]&br; [[http://pukiwiki.org/pukiwiki.png>http://pukiwiki.org/]]...[d']&br; [[&ref(pukiwiki.png,nolink,Pukiwiki);>http://pukiwiki.org/]]...[d'']&br; [[pukiwiki:Use PukiWiki]]..........[a]&br; [[whatever u like:http://pukiwiki.org/?Use%20PukiWiki]]...[b]&br; [[http://pukiwiki.org/pukiwiki.png:http://pukiwiki.org/?Use%20PukiWiki]][b']&br; [[&ref(pukiwiki.png,nolink,Pukiwiki);:http://pukiwiki.org/]]...[b'']&br; [[Another Name(Alias)>FormattingSandbox]]......[c]&br; [[http://pukiwiki.org/pukiwiki.png>FormattingSandbox]]...[c']&br; [[&ref(pukiwiki.png,nolink,Pukiwiki);>FormattingSandbox]]...[c'']&br; [[external Alias>http://pukiwiki.org/]]...[d]&br; [[http://pukiwiki.org/pukiwiki.png>http://pukiwiki.org/]]...[d']&br; [[&ref(pukiwiki.png,nolink,Pukiwiki);>http://pukiwiki.org/]]...[d'']&br; http://pukiwiki.org/pukiwiki.png [a] is an InterWiki styled link. [b] is a Link styled link with a text link. [b'] is a Link styled link with an image link. Eventually, each of them will direct us the same page: http://pukiwiki.org/?Use%20PukiWiki . Because "pukiwiki" is defined in the InterWikiName as following: [http://pukiwiki.org/? pukiwiki] utf8 |Link Style|Left Side|Right Side| |InterWiki|InterWikiName(Defined URL)|Additional URL| |Link|Link text|Real URL| |Alias|Link text|Real URL(WikiName/BracketName)|