:CategoryDev/Document/FormattingSandbox の変更点

追加された行はこの色です。
削除された行はこの色です。
:CategoryDev/Document/FormattingSandbox へ行く。
:CategoryDev/Document/FormattingSandbox の差分を削除
[[:CategoryDev/Document]]~
[[: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
-Some updates. "contents plugin" which usually shows the table of contents is disabled here. --- olorin
-This page is almost finished! Thank you for your making the nice base page, Bjorn. The rest is Plugin... --- olorin
#hr
#contents
#hr
Here are examples.

*Inline Elements [#m7791eef]
In the following table you can see how to use the inline text elements of PukiWiki
**Text Decorations [#a4c2798d]
The expressions are supposed to work with the default settings. 
The first 5 expressions are defined in ''default.ini.php''.
The others which starts with "&amp;" and "footnote" is powered by respective ''plugins''.
See ''default.ini.php'' to change the settings for the former ones.
See respective ''plugins'' for the latter ones.
|''Format example''|''Formatting code''|''Comment''|h
|''Emphasised text''|&#39;&#39;Emphasised text&#39;&#39;|Put the text between two single quotes.|
|'''Italic text'''|&#39;&#39;&#39;Italic text&#39;&#39;&#39;|Put the text between three single quotes.|
|%%Strikethrough text%%| &#37;&#37;Strikethrough text&#37;&#37;||
|%%%Underlined text%%%| &#37;&#37;&#37;Underlined text&#37;&#37;&#37;||
|Text with&br;a break|Text with &amp;br; a break||
|&size(24){Text in font size 24};| &amp;size(24){Text in font size 24};||
|&color(purple){Purple text};| &amp;color(purple){Purple text};||
|&color(#663466){Colored text};| &amp;color(#123456){Colored text};||
|&color(yellow,black){yellow text with black backbround};| &amp;color(yellow,black){yellow text with black background};||
|((This is the footnote's text))|&#40;&#40;This is the footnote's text&#41;&#41;|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);|&amp;ref(http:&#47;&#47;www.example.com);&br;&amp;ref(pukiwiki.png,alt-title-puki-img);|This inserts a reference.&br;It also inserts attached images.|
|&aname(Anchor);|&amp;aname(Anchor);|This inserts an invisible anchor for hyperlinking.|

**Link Styles [#v232da88]
|''Format example''|''Formatting code''|''Comment''|h
|WikiName|&#87;ikiName|This creates a link to another page on the same Pukiwiki site.|
|[[BracketName]]|&#x5b;&#x5b;&#x42;racketName&#x5d;&#x5d;|This creates a link to another page on the same Pukiwiki site.|
|http://www.example.com|http://www.example.com|The easiest way to make an external link, as you can see. :-P|
|[[External link:http://www.example.com]]|&#91;&#91;External link:http:&#47;&#47;www.example.com]]|This creates links to pages on other web sites.|
|[[http://example.com/pukiwiki.png:http://www.example.com]]|&#91;&#91;the image's URL:http:&#47;&#47;www.example.com]]|This creates image-links to pages on other web sites.|
|[[pukiwiki:FrontPage]]|&#91;&#91;pukiwiki:FrontPage]]|InterWiki Styled Link|
|[[Alias>FrontPage]]|&#91;&#91;Alias>FrontPage]]|This enables you to make a link to a page in Pukiwiki with a different name.|
|[[Alias>pukiwiki:FrontPage]]|&#91;&#91;Alias>pukiwiki:FrontPage]]|Advanced Link style: the combination of Alias and InterWiki|
|[[http://example.com/pukiwiki.png>FrontPage]]|&#91;&#91;the image's URL>FrontPage]]|This enables you to make an imagw-link to a page in Pukiwiki with a different name.|
|[[&ref(pukiwiki.png,nolink,Pukiwiki);>FrontPage]]|&#91;&#91;ref-plugin>FrontPage]]|Of course, you can use an attached file for the image-link.|


**Special entities : [#nb14c38a]
These expressions are supposed to work with the default settings. 
See ''rules.ini.php'' to change the definition, and see ''pukiwiki.ini.php'' to change the date/time format.
|''Special entity''|''Code''|''Comments''|h
|FormattingSandbox|&amp;page;|This returns the name of current page.&br;(i.e. if the page name is "Pukiwiki/1.4", this returns "1.4".)|
|:CategoryDev/Document/FormattingSandbox|&amp;fpage;|This returns the full name of current page.&br;(i.e. if the page name is "Pukiwiki/1.4", this returns "Pukiwiki/1.4".)|
|2004-01-16|&amp;date;|This returns date according to the defined date format in rules.ini.php&br;Reffer to "$date_format" in the file.|
|17:28:19|&amp;time;|This returns date according to the defined date format in rules.ini.php&br;Reffer to "$time_format" in the file.|
|2004-01-16 (金) 17:28:19|&amp;now;|This returns the current time.|
|2004-01-16 (Fri) 17:28:19|&amp;now;|This returns the current time.|
|2004-01-16|date ?| This returns date according to the defined date format in rules.ini.php&br;Reffer to "$date_format" in the file.|
|17:28:19|time ?| This returns date according to the defined date format in rules.ini.php&br;Reffer to "$time_format" in the file.|
|2004-01-16 (金) 17:28:19|now ?| This returns the current time.|
|2004-01-16 (Fri) 17:28:19|now ?| This returns the current time.|
|&heart;|&amp;heart;||
|&copy;|&amp;copy;||
|&reg;|&amp;reg;||
|&trade;|&amp;trade;||
|&sup2;|&amp;sup2;||
|&sup3;|&amp;sup3;||
|&nbsp;|&amp;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.|

**Numeric entities : [#nb14c38a]
|''Numeric entity''|''Code''|''Comments''|h
|&#10;|&amp;#10;|This a normal space,|
|&#8734;|&amp;#8734;|We could go on like this forever...|
|&#937;|&amp;;|But here it must end.|
|&#229;|&amp;#229; (in decimal)| represents the letter "a" with a small circle above it (used, for example, in Norwegian).|
|&#xe5;|&amp;#xe5; (in hexadecimal)| represents the letter "a" with a small circle above it.|
|&#1048;|&amp;#1048; (in decimal)|represents the Cyrillic capital letter "I": И.|
|&#x6c34;|&amp;#x6c34; (in hexadecimal)|represents the Chinese character for water: 水.|
|&#x5b;|&amp;#x5b;|represents the [ sign.|
|&#x5d;|&amp;#x5d;|represents the ] sign.|
|&#1111;|&amp;#1111;|As you can se, you're able to define any unicode character up to #32000 like this. |
**Misc [#v656944d]
|''Format example''|''Formatting code''|''Comment''|h
|Inline text&br;Inline text| Inline text&amp;br;Inline text|&amp;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]]|
|&counter;|&amp;counter;|Shows the access log counter.|
|&online;|&amp;online;|Shows the curecnt number of the visiters.|
|&version;|&amp;version;|Shows the version number of PukiWiki itself|


&br;

*Block Elements [#vab576d9]
~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 [#n759c266]
  Preformatted text. There is a space in front of this text.

 Preformatted text. There is a space in front of this text. 
&br;

**Headings [#ac5978ad]
 *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 [#qf934edb]
 ~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 [#kca2e842]
 >Quote Level 1
 >>Quote Level 2
 >>>Quote Level 3
>Quote Level 1
>>Quote Level 2
>>>Quote Level 3
&br;
**Unordered lists [#z49f05aa]
 -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 [#z5776714]
 +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 [#ld3bf7de]
 :Definition|Description
:Definition|Description
&br;
**Comments [#s7e1dcef]
 A comment is hidden here: 
 //Comment
A comment is hidden here: 
//Comment
&br;
**Horizontal Rule [#jc7b1972]
 ----
----
**Table [#pca8d4bc]
*** Simple [#xb7f0c4f]
 |aaa|bbb|ccc|
 |111|222|333|
|aaa|bbb|ccc|
|111|222|333|
*** Advanced [#lfad6154]
 |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 [#bc0b7e1f]
 ,aaa , bbb , ccc
 ,1111,2222,3333
,aaa , bbb , ccc
,1111,2222,3333

**Plug-ins [#vaf81370]
 #contents 
~(This is the table of contents plugin) 

&br;

*Nesting Elements [#f4c3cb27]
**Paragraph Element-Emphasize Element [#nb6b7452]
 ~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 [#t029cf44]
 Level[0]
 -List Level 1
 >Quote Level 1(List Level 1)
 <Quite Quote Level 1(List Level 1)//quite Quote Block without finishing List Block
 >Quote Level 1-a(List Level 1)
 >>Quote Level 2(List Level 1)
 <<Quite Quote Level 2(List Level 1)
 <Quite Quote Level 1-a(List Level 1)
 |back|to|List Level 1|with|table|
 --List Level 2 (List Level 2) 
 |back|to|List Level 2|with|table|//add a table block to a list block
 --List Level 2 (List Level 2) &br; Line Break(List Level 2)
 ---List Level 3
 >Quote Level 1-a(List Level 3)
 >>Quote Level 2-a(List Level 3)
 -List Level 1(Quote Level 2-a/List Level 3)
 <<Quite Quote Level 2(List Level 3)
 <Quite Quote Level 1(List Level 3)
 -List Level 1

Level[0]
-List Level 1
>Quote Level 1(List Level 1)
<Quite Quote Level 1(List Level 1)
>Quote Level 1-a(List Level 1)
>>Quote Level 2(List Level 1)
<<Quite Quote Level 2(List Level 1)
<Quite Quote Level 1-a(List Level 1)
|back|to|List Level 1|with|table|
--List Level 2 (List Level 2)
|back|to|List Level 2|with|table|
--List Level 2 (List Level 2) &br; Line Break(List Level 2)
---List Level 3
>Quote Level 1-a(List Level 3)
>>Quote Level 2-a(List Level 3)
-List Level 1(Quote Level 2-a/List Level 3)
<<Quite Quote Level 2(List Level 3)
<Quite Quote Level 1(List Level 3)
-List Level 1

*Enhancements with Plug-in [#s20a3a69]
**How can I attach/upload files and images? [#r42919d4]
: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://example.com/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"