- 追加された行はこの色です。
- 削除された行はこの色です。
#navi(:CategoryDev/Document)
[[:CategoryDev/Document]]~
[[PukiWiki/1.4/添付文書]]~
[[../FormatRule]]
-ええと、記録はどうしたらよいですかね？とりあえず前回からは、ほとんど進んでいません。
W3Cの勧告書を参考に翻訳中です。
-Table 部分修正しました --merlin &new{2003-09-21 (日) 17:59:01};
-とりあえず、マニュアルで使われる英語パターンは出し尽くしたと思います。
使ったことの無い機能も使ってみないと・・・。--Olorin &new{2003-10-01 (水) 22:59:01};
-添付についての部分を英訳してみました。訳語はよくわからない部分があったのでチェックをお願いします。--[[Tomos]]
-他に気になった点:"Horizon Line"は"Horizontal Line"でどうでしょう? Tomos
Japanese Version : [[PukiWiki/1.4/添付文書/FormattingRules]]
----
#nofollow
#norelated
*Text Formatting Rules [#te82f1fe]
Most text is displayed as it is written.
- HTML tags cannot be used. They are just displayed as texts (e.g., <font color="red">text</font>).
- Place an empty line after each paragraph. Lines without an empty line between them are interpreted and displayed as a single paragraph.
Use the formatting rules below to decorate texts. For the formatting with plugins, only the most commonly used ones are explained here. See [[PukiWiki/1.4/Manual/Plugin]] for the details of the plugin options.
#contents
#hr
*Text Formatting Rule [#te82f1fe]
#contents
Inputted words are usually exported as what they are typed. On the other hand,you can use following rules to enhance your texts.
-Empty line indicates the end of Elements and Child Element.
-HTML is prohibited.
The input text of [[PukiWiki]] is usually shown in the same way as it was entered. However, you can use the following rules to enhance your texts. The use of HTML tags is forbidden. Instead, special characters can be used to format text. Formatting rules usually apply to a certain part of the text. Such a part of a text is called a text Element.
**&aname(elements);Elements [#vec0ef3a]
First of all,let me describe the world of PukiWiki.
PukiWiki consists of 2 Elements:"Block Element",and "Inline Element".
And "Parent Element" and "Child Element"Block are also used to describe the relationship amang Block/Inline Elements,
First of all, let's describe the "world" of PukiWiki. PukiWiki treats text as a set of Elements. An empty line indicates the end of an Element. Elements can contain other Elements. Such contained Elements are called "Child Elements". The element which contains "Child Elements" is called a "Parent Element".
~This is the paragraph, which is the parent element that contains the emphasized.
''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 the emphasized.
''This is the emphasized text that is the child element of the paragraph element.''
Example:
These two lines:
~This is a paragraph. It is the parent element which contains an emphasized text element.
''This is emphasized text, which is the child element of the paragraph element.''
Will be formatted like this:
~This is a paragraph. It is the parent element which contains an emphasized text element.
''This is emphasized text, which is the child element of the paragraph element.''
There are two kinds of elements in PukiWiki: "Block Elements", and "Inline Elements".
Block Elements, as the name suggests, consist of a whole block of text. Inline Elements
only consist of a part of a text block. In essence, the difference between Block Elements and Inline Elements is as follows:
-A Block Element:
--Can contain other Block and Inline Elements.
--Can be the Child Element of another Block Element.
-An Inline Element:
--Is always the Child Element of another Element.
--''Can'' contain other Inline Elements as its Child Elements.
--''Cannot'' contain other Block Elements as its Child Elements.
As a very basic rule:
-Block Elements:
--can contain other Block and Inline Elements as its Child Elements.
--can be Child Elements of other Block Elements.
-Inline Elements:
--belongs to a Child Element without exception.
--''can'' contain other Inline Elements as its Child Element.
--''cannot'' contain onther Block Elements as its Child Element.
Next, we'll describe the two different kinds of elements in detail.
**&aname(block);Block Elements [#d2efdb6c]
-Block Elements can contain other Block Elements and Inline Elements as its Child Elements. Although the following Block Elements:Paragraph,Heading,Horizon,and #(Plugin[Block]), cannot contain other Block Elements as their Child Elements.
-Empty line closes all the Child Elements and Block Elements above at once.
-A Block Element can contain other Block Elements and Inline Elements as its Child Elements. However, a Paragraph, a Heading, a Horizontal Line, and a #(Plugin[Block]) cannot contain other Block Elements as their Child Elements.
-As we said before, an empty line after a Block Element closes all the Child Elements and Block Elements above at once.
-Block Elements can be Child Elements of other Block Elements.
--List and Quotation Element can contain other Block Elements as their Child Elements.Block Elements in Child Elements inherit the indent level of its Parent Content.Empty line closes the Block Element.
--List and Quotation have 3 levels,which are all independent.Thus if you want to contain a List Element in a Child Element of Quotation Element, or a Quotation Element in a Child Elements of List Element, you don't need to increase the level of Parent Element.
--List and Quotation Elements can contain other Block Elements as their Child Elements. Block Elements in Child Elements inherit the indent level of its Parent Element. As always, an empty line ends the Block Element.
--List and Quotation have three levels of depth, which are all independent. So, if you want to contain a List Element in a Quotation Element, or a Quotation Element in a List Element, you don't need to increase the indentation level of the Parent Element.
&br;&br;
But if you want to contain a List Element in a Child Element of another List Element ,or Quotation in another Quotation as its Child Elements,you need to increase the level of Parent Element.
But if you want to contain a List Element in another List Element, or Quotation in another Quotation as its Child Elements, you need to increase the indentation level of Parent Element.
&br;&br;
It's more simple than what you may expect.Please check "Nesting Elements" for concrete examples.
It may seem difficult explained like this, but it's probably more simple than it seems. Please check "Nesting Elements" for concrete examples.
-"<","<<",and "<<<" enable you to close a Quotation in a Child Element without closing the Parent Element it belongs to.
--"<" let you get out of the Quotation Level1 Element.
--"<<" let you get out of the Quotation Level2 Element.
--"<<<" let you get out of the Quotation Level3 Element.
--"<" lets you get out of the Quotation Level1 Element.
--"<<" lets you get out of the Quotation Level2 Element.
--"<<<" lets you get out of the Quotation Level3 Element.
-Empty Line closes not only the Quotation Element but also the Block Element it belongs to.
-# indicates the beginning of Plugin Block.(Plugiin has 2 modes:Block and Inline.)
-# indicates the beginning of Plugin Block. (Plugin has 2 modes:Block and Inline.)
***&aname(paragraph);Paragraph [#g3ebf1a7]
Inline Elements
It will be the begginning of a Paragraph as long as you don't suggest the beggining of other Block Elements.
PukiWiki assumes that each new Block is the beginning of a new paragraph, unless you instruct it to format the text differently, by using the formatting codes of other Block Elements.
~Inline Elements
Starting the line with "~",it also suggests the beginning of a Paragraph.
"~" also enables you to place 行頭書式の文字(Special Symbolsなんか良いネーミング無いですかね?)(~、-、+、:、>、|、#、//) as normal texts at the beginning of a Paragraph.(It is the only way to place them at the beggining of Child Elements since these symbols suggest the begginig of Elements.)
-The first line of a Paragraph and a Paragraph in a Definition List are indented.But it doesn't occer in a List(Unordered and Ordered) and Quotation.
-Paragraph continues until the apearance of a new Block Element.
-Paragraph ''can'' be Child Elements of other Block Elements.
-Paragraph ''cannot'' contain other Block Elements as its Child Elements.
A line that starts with "~" indicates the beginning of a new paragraph. "~" also enables you escape the special characters (~、-、+、:、>、|、#、//) that are normally used as "Formatting Characters". Normally, these characters indicate the beginning of another kind of Element. Thus, the only way to put the special characters as a normal text at the beginning of a Paragraph is by putting a "~" in front of them.
-The first line of a Paragraph and a Paragraph in a Definition List are indented. But neiher a List nor a Quotation are indented.
-Each Paragraph continues until the appearance of a new Block Element.
-Paragraphs ''can'' be Child Elements of other Block Elements.
-Paragraphs ''cannot'' contain other Block Elements as its Child Elements.
***&aname(quotation);Quotation [#j2411a69]
>Inline Element
">" suggests the beginning of Quotation.Quotation has 3 levels:">" ">>" ">>>"
-Quotaion can contain other Block Elements as its Child Elements.
-In a Block Element,its Child Elements automatically belong to Paragraph as long as other Block Elements are not suggested.
-Quotation continues until the next Empty Line.
-A Paragraph in a Quotation continues until the apearance of next Quotation or Block Element.
-Quotation can be Child Elements of Other Block Elements.(Nesting Elements for concrete examples.)
--When Quotation is a Child Element of another Quotation,you need to increase the level by 1.
--When Quotation is a Child Element of List,you don't need to increase the level.
-When Quotation contains List as its Child Element,you don't need to increase the level.
-If you want to close a Quotation in a List,and keep the List Element opened,you have to start a Quotation Element with "<","<<","<<<" instead of ">",">>",">>>".
A ">" character indicates the beginning of Quotation. Quotation has 3 indentation levels, indicated by: ">", ">>", and ">>>".
-A Quotation can contain other Block Elements as its Child Elements.
-As with all Block elements, a Quotation continues until the next empty line.
-A Paragraph in a Quotation continues until the beginning of another Quotation or Block Element.
-Quotations can be Child Elements of Other Block Elements. (Look at Nesting Elements for concrete examples.)
--When Quotation is a Child Element of another Quotation, you need to increase the identation level by 1.
--When Quotation is a Child Element of List, you don't need to increase the indentation level.
-When Quotation contains List as its Child Element, you don't need to increase the level.
-If you want to close a Quotation in a List, and keep the List Element opened, you have to start a Quotation Element with "<","<<","<<<" instead of ">",">>",">>>".
-"<","<<",and "<<<" enable you to close Quotation in List without closing the List it belongs to.
***&aname(lists);List [#adf32d50]
-Inline Element
At the beginning of a line,"-" suggests the beginning of Unordered List.List has 3 levels:"-" "--" "---".
-Unordered List can be a Child Element of other Block Elements.
-When Unordered List is a Child Element of List,you need to increase the level by 1.
-When Unordered List is a Child Element of Quotation,you don't need to increase the level.
- By inserting "~" after "-", List Element can contain Paragraph Element as its Child Element.
-Unordered List can contain Other Block Elements as its Child Elements by inserting one to the next line ''as long as the beginning of Child Element is Inline Element or Paragraph''.
At the beginning of a line,"-" indicates the beginning of an Unordered List. Unordered lists have three levels, namely:"-", "--", and "---".
-Unordered List may be contained by anoother Block Elements.
-Increase the level by one when it is contained by other List. If it is contained by a Quotation, you do not have to increase the indentation level.
-Unordered List may contain a Paragraph by writing "~" right after "-".
-Unordered List may contain another Block Element by writing it in the next line ''as long as the beginning of Child Element is Inline Element or Paragraph''.
+Inline Element
At the beginning of a line,"+" suggests the beginning of Ordered List.List has 3 levels:"+" "++" "+++".
-番号付きリストは、他のブロック要素の子要素になることができます。他のリスト構造の子要素にする場合は、レベルを1段増やして記述します。引用文の子要素にする場合は、レベルを増やさずに記述します。
-+の直後に ~を記述すると段落を子要素にすることができます。
-番号付きリストは、''リストの先頭がインライン要素または段落である場合に限り''、リストの次の行に他のブロック要素を記述することで、他のブロック要素を子要素にすることができます。
At the beginning of a line, "+" indicates the beginning of Numbered List. Numbered List has three levels namely:"+", "++", and "+++".
-Numbered List may be contained by another Block Elemnt.
-Increase the level by one when it is contained by other List. If it is contained by a Quotation, you do not have to increase the indentation level.
-Numbered List may contain a Paragraph by writing "~" right after "+".
-Numbered List may contain another Block Element by writing it in the next line ''as long as the beginning of Child Element is Inline Element or Paragraph''.
:Definition|Description
行頭を : で始め、| 記号で区切ると、定義リストになります。定義リストは :、::、::: の3段階あります。
:Item|Item's Definition
Definition List is a line starting with ":" and separated by "|" in the middle. There are three indentation levels for Definition List: ":", "::", and ":::".
定義リストの定義語、説明文は省略することができます。複数の連続した定義リストを記述し、2つ目以降の定義語を省略することで1つの定義語に対する複数の説明文を記述することができます。
-行中に | がないと定義リストにはなりません。
-定義語・説明文は、インライン要素のみ記述することができます。
-定義リストは、他のブロック要素の子要素になることができます。他のリスト構造の子要素にする場合は、レベルを1段増やして記述します。引用文の子要素にする場合は、レベルを増やさずに記述します。
-|の直後に ~を記述すると段落を子要素にすることができます。
-定義リストは、定義リストの次の行に他のブロック要素を記述することで、他のブロック要素を子要素にすることができます。
You may omit the Item or the Definition. You may give multiple definitions to an item by writing a sequence of Definition List and omitting the Item after the first one.
-Definition List must have "|" in the line.
-Item and Item's Definition must be an Inline Element.
-Definition List may be contained by another Block Element.
-Increase the indentation level by one when it is contained by other List. If it is contained by a Quotation, you do not have to increase the indentation level.
-Definition List may contain a Paragraph by writing "~" right after "|".
-Definition List may contain other Block Elements by writing a Block Element in the line right after the Definition List.
***&aname(preformed);Preformatted Texts [#x97a82ed]
"White Space" suggests the beginning of Formatted Texts.Any line breaks are not automatically inserted.
"White Space" at the beginning of a line indicates the beginning of Preformatted Text. Line breaks are not automatically inserted in Preformatted Text.
//#br
-Preformatted Text can be Child Elements of other Block Elements.
-Preformatted Text can be the Child Element of other Block Elements.
-Preformatted Text cannot contain other Block Elements as its Child Element.
-Preformatted Text Elements never be parsed.Thus its Contents are displayed as what they are.
-Preformatted Text Elements will never be parsed by PukiWiki. Thus its contents are displayed "as is".
***&aname(table);Table [#we5546ee]
|Inline Element|Inline Element|
Dividing Inline Elements by "|",it would be a Table.
Inline Elements that are separated by "|", will be formatted as a Table. Remember that there needs to be a "|" character as well before the first Element of the table.
-Incorrect
AAAA|BBB|CCC|DDD
-Correct
|AAA|BBB|CCC|DDD|
|AAA|BBB|CCC|DDD|
//#br
-Table,in conjunction with the following attributes placed at the beginning of Child Element,offers 3 text placements(Allignmentsのほうが良いかな?）.
-The following codes can be used in conjunction with a table. They are placed at the beginning of the Child Element, and yield three posible text alignments.
LEFT:
CENTER:
RIGHT:
BGCOLOR(colorcode):
COLOR(colorcode):
SIZE(unit:px):
--They assign Child Elements where they should be displayed.Default setting is Left
--These codes determine how and where Child Elements should be displayed. The default setting is Left
//#br
|Here is a Sample|regarding to the placements |of elements in each cell|
|Flush Left|CENTER:Centered|RIGHT:Flush Right|
|RIGHT:Flush Right|Flush Left|CENTER:Centered|
|aaaaa|foot|aaaaa|f
|bbbb|bbbb|H E A D|h
|rowapn|BGCOLOR(blue):BLUE|COLOR(red):RED|
|~|>|colspan|
//#br
-行末にcを記述すると、書式指定行となります。書式指定行では、次の記述子が指定できます。
-"c" at the end of the line indicates the line to be Formatting Row. The following code may be used in the Formatting Row.
LEFT:
CENTER:
RIGHT:
BGCOLOR(colorcode):
COLOR(colorcode):
SIZE(unit:px):
--Followed specific numbers, you can assin the width(px) to a cell.
-行末にhを記述すると、ヘッダ行(thead)になります。
-行末にfを記述すると、フッタ行(tfoot)になります。
-セル内のインライン要素の先頭に~を付けると、ヘッダ(th)になります。
-セル内に>を単独で記述すると右のセルと連結します(colspan)。
-セル内に~を単独で記述すると上のセルと連結します(rowapn)。
--By using these specific numbers, you can assign an exact width (in px units) to a cell.
-"h" at the end of the line indicates the line to be the Header Row (thead).
-"f" at the end of the line indicates the line to be the Footer Row (tfood).
-Cell containing Inline Element starting with "~" indicates the Cell to be a Header Cell (th).
-Cell containing only ">" will be concatenated with the Cell right next to it (colspan).
-Cell containing only "~" will be concatenated with the Cell above it (rowapn).
//#br
-表組みは、他のブロック要素の子要素になることができます。
-表組みは、原則として他のブロック要素を子要素にすることができません。
***&aname(csv);CSV Method Table [#b1645d3b]
,インライン要素,インライン要素,…
~行頭でカンマ(.)を記述し、インライン要素をカンマ区切りで記述すると表組みになります。
-Table may be contained by another Block Element.
-As a general rule, a Table may not contain other Block Element.
***&aname(csv);CSV Style Table [#b1645d3b]
,Inline Element,Inline Element,…
~Inline Elements that are separated by ","(comma), will be formatted as a Table. Note that you must write "," before the first Element of the CSV Style Table.
//#br
-インライン要素はダブルクォーテーション(")で囲むことができます。ダブルクォーテーションで囲むことで、カンマ(,)を含むインライン要素を記述できます。
-ダブルクォーテーション(")で囲んだインライン要素の中で、ダブルクォーテーションを2つ("")続けることで、ダブルクォーテーション(")を含むインライン要素を記述できます。
-インライン要素の代わりにイコールを2つ(==)記述すると、colspanを意味します。
-インライン要素の左に1つ以上の半角空白文字を記述すると右寄せに、インライン要素の左右に1つ以上の半角空白文字を記述するとセンタリングになります。
-You may enclose Inline Elements with Double Quotation ("), which enables you to contain comma(,) in Inline Elements.
-In the Inline Elements enclosed by Double Quotation ("), you may write two consecutive Double Quotations ("") to express Inline Element containing a Double Quotation (").
-Two consecutive Equal Signs (==) in the place of Inline Element indicates colspan.
-More than one white space on the left of Inline Element makes it right aligned; more than one white space on both right and left sides of Inline Element makes it center aligned.
,aaaaaaaaa,bbbbbbb,ccccccc
,left , center , right
,==,COLOR(red):<-- colspan
,==,COLOR(red):<-- colspan, test
//#br
-表組みは、他のブロック要素の子要素になることができます。
-表組みは、他のブロック要素を子要素にすることができません。
-CSV Style Table may be contained by another Block Element.
-CSV Style Table may not contain other Block Elements.
***&aname(headline);Heading [#a191d5ac]
*インライン要素
Starting the line with "*",it becomes Heading Element,which has 3 levels:"*","**",and "***".
*Inline Element
A line that starts wit an "*" character becomes a Heading Element. There are three levels of heading Elements, namely: "*", "**",and "***".
//#br
-Heading cannot be Child Elements of other Block Elements.
The apearance of Heading closes other Block Elements.
-見出しは、他のブロック要素を子要素にすることはできません。
-Heading may not be contained by other Block Elements.
Heading closes other Block Elements.
-Heading may not contain other Block Elements.
***&aname(contents);Table of Contents [#be7ec652]
#contents
行頭で#contensを記述すると、見出しに基づいて目次を作成します。一般的に#contentsはページの最初のほうに記述します。
"#contents" at the beginning of the line creates Table of Contents based on the Headings. Generally, "#contents" are written on the top part of the page.
//#br
-Table of Contents can be Child Elements of other Block Elements. But this Element is intended to be placed at the top Level.目次は、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
-Table of Contents cannot contain other Block Elements as its Chiled Element.
-Table of Contents should not be contained by other Block Elements. Although Table of Contents may be contained by other Block Elements, left margin is set, assuing it is placed at the top-level.
-Table of Contents may not contain other Block Elements.
***&aname(align);LEFT-CENTERED-RIGHT [#f3dbd6f2]
LEFT:インライン要素
CENTER:インライン要素)
RIGHT:インライン要素)
行頭でLEFT:、CENTER:、RIGHT:を記述すると、インライン要素が左寄せ、センタリング、右寄せされます。
LEFT:Inline Element
CENTER:Inline Element
RIGHT:Inline Element
Writing "LEFT:", "CENTER:", or "RIGHT:" at the beginning of the line aligns the Inline Element.
//#br
-3 of them can be Child Elements of other Block Elements.。
-3 of them cannot contain other Block Elements as its Child Element.
***&aname(horizon);Horizon Line[#a60a5ced]
-All three Elements may be contained by other Block Elements.
-All three Elements may not contain other Block Elements.
***&aname(horizon);Horizontal Rule[#a60a5ced]
----
4 "-" placed at the beginning of a line makes Horizon Line.
//#br
-Horizon Line cannot be Child Elements of other Block Elements. And the apearance of Horizon closes other Block Elements above.
-Horizon Line cannot contain other Block Elements as its Child Element.
Four or more "-" placed at the beginning of a line are shown as a horizontal rule.
-Horizontal Line may not be contained by other Block Elements. Horizontal Line terminates other Block Elements.
-Horizontal Line may not contain other Block Elements.
// #hr
"#hr" placed at the beginning of a line makes 区切線.区切り線 inherits 60% of the latest Block Element and will be centered.は上位のブロック要素の幅の60%の長さの水平線がセンタリングされて引かれます。
***&aname(space);Line Break [#oa1708ba]
#br
"#br" placed at the beginning of a line makes a line break in a block element or between block elements. ((#br placed right after an empty line next to a block element makes a line break that separates blocks. #br placed right after a block element makes a line break inside that block element. Unlike a line break in a wiki text, #br preserves the format of the line following it.))。
//#br
-区切り線 can be Child Elements of other Block Elements.
-区切り線 cannot contain other Block Elements as its Child Element.
-Line Break may not be contained by other Block Elements. Horizontal Line terminates other Block Elements.
-Line Break may not contain other Block Elements.
//***&aname(space);Line Break
// #br
//行頭で#brを記述すると、ブロック要素間またはブロック要素内で行間を開けることができます((#brをブロック要素の直後の空行の次に指定すればブロック要素間の行間、ブロック要素の直後に指定すればそのブロック要素内での行間を開けることになります。#brは、行末改行と違って、次の行の行頭書式を無効にはしません。))。
//#br
//-行間開けは、他のブロック要素の子要素になることができます。
//-行間開けは、他のブロック要素を子要素にすることはできません。
***&aname(ref);Embedding Files and Images [#y1fe2c06]
***&aname(ref);添付ファイル・画像の貼り付け [#y1fe2c06]
Attaching Files and Images
#ref(file name)
#ref(URL of the file)
You can attach a file by writing #ref(file name) at the beginning of a line.
You can place a hypertext link by writing #ref(URL of the file) at the beginning of a line.
If the file attached or linked is an image, the image is displayed.
#ref(添付ファイル名)
#ref(ファイルのURL)
行頭で#refを記述すると、添付ファイルまたは指定されたURLにあるファイルへのリンクを貼り付けることができます。ファイルが画像ファイルの場合は、その画像を表示します。
//#br
-You can specify certain parameters by dmarcating them by commas. When unspecified, the default values are used.
-You can specify certain parameters by demarcating them with commas. When unspecified, the default values are used.
Page of the attachment file
--You can specify page name where the attachment file exists. The name may be in WikiName or BracketName. When unspecified, the current page serves as the default.
--You can specify the page name of the attachment file. The name may be in WikiName or BracketName. When unspecified, the current page serves as the default.
--The following parameters can be specified immediately after the page name.
-
left
center
right
--It specifies the place of the link or the image within the page. Center by default.
--It specifies where to place the link or the image within the page. Center is the default.
-
wrap
no wrap
--Specifies if the link or the image should be placed in a box. No box by default.
--Specifies if the link or the image should be placed in a box. The default is to use no box.
-
around
--Specifies if the text should wrap around the link or image. No wrapping by default.
--Where you want to stop the wrapping, you can place #img(,clear).
--If you want to stop the wrapping, you can use "#img(,clear)".
-
nolink
--Nolink overrides and eliminates the default linking to the attached file.
-
Substitute Strings
--You can display a Substitute Strings instead of a file name and images. When unspecified, the file name is used by default.
--The Substitute Strings accept only String Inline Elements. WikiName, BracketName, and other things will be interpreted as a String.
--This option must be stated as the last parameter when you use this option.
-#ref can be a Child Element of another Block Element.
-#ref cannot accept other Block Element as a Child Element.
-#ref may be contained by other Block Elements.
-#ref may not accept other Block Element as a Child Element.
***&aname(clear);Disabling text wraparound [#w72effe8]
#clear
#clear placed at the beginning of the line cancels the text wraparound set in #ref. Wraparound is always cancelled at the end of the texts even without #clear.
//#br
-#refには、カンマで区切って下記のパラメタを指定できます。パラメタを省略した場合はデフォルト値となります。
添付ファイルのページ
--添付ファイルが存在するページ名(WikiName、 BracketName)を指定します。デフォルトは現在のページです。
--以下のパラメタを指定する場合は、ページ名の次に記述します。
-
left
center
right
--ファイルへのリンク・画像を表示する位置を指定します。デフォルトではセンタリングされます。
-
wrap
nowrap
--ファイルへのリンク・画像を枠で囲むかどうかを指定します。デフォルトは囲みません。
-
around
--テキストの回り込みを指定します。デフォルトでは回り込みを行ないません。
--テキストの回り込みを中止する部分に#img(,clear)を置きます。
-
nolink
--デフォルトでは添付ファイルへのリンクが張られますが、nolinkを指定するとリンクを張りません。
-
Substitute Strings
--You can display a Substitute Strings instead of a file name and images.ファイル名の代わりに表示する文字列や画像の代替文字列を指定できます。指定しない場合は、ファイル名になります。
--代替文字列には文字列以外のインライン要素を含めることはできません。WikiNameやBracketName、文字列以外のインライン要素を記述しても文字列として扱われます。
--This option must be stated as the last parameter when you use this option.
-#refは、他のブロック要素の子要素になることができます。
-#refは、他のブロック要素を子要素にすることはできません。
//***&aname(clear);テキストの回り込みの解除
// #clear
//行頭で#clearを記述すると、#refで指定したテキストの回り込みを解除します。#clearを指定しなくても、記事の末尾でテキストの回り込みが自動的に解除されます。
//#br
//-#clearは、他のブロック要素の子要素になることができます。
//-#clearは、他のブロック要素を子要素にすることができません。
***&aname(form);フォーム [#v55d5a1f]
-#clear may not be contained by other Block Elements. Horizontal Line terminates other Block Elements.
-#clear may not contain other Block Elements.
***&aname(form);Form [#v55d5a1f]
#comment
行頭でを記述すると、コメントを挿入するためのフォームが埋め込まれます。
When ''#comment'' is placed at the beginning of a line, it adds a form area to post comments.
"#comment" at the beginning of the line embeds a form to post comments.
//#br
-#comment can be Child Elements of other Block Elements. However,it's not a recommended useage because of the default left-margin setting.Thus it is not inteded to be Child Element.
-#commentは、他のブロック要素を子要素にすることはできません。
-#comment should not be contained by other Block Elements. Although #comment may be contained by other Block Elements, left margin is set, assuing it is placed at the top-level.
-#comment may not accept other Block Elments as Child Element.
#pcomment
行頭で#pcommentを記述すると、コメントを挿入するためのフォームが埋め込まれます。#commentとは異なり、コメントは別ページに記録されます。また、コメントに対するレスポンスを階層状に表示します。
"#pcomment" at the beginning of the line embeds a form to post comments. Unlike "#comment", posted comments are recorded on a seperate page. Also, responses to a comment is displayed as tree structure.
//#br
-#pcommentは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
-#pcommentは、他のブロック要素を子要素にすることはできません。
-#pcomment should not be contained by other Block Elements. Although #pcomment may be contained by other Block Elements, left margin is set, assuing it is placed at the top-level.
-#pcomment may not accept other Block Elements as Child Element.
#article
行頭で#articleを記述すると、簡易掲示板のフォームが埋め込まれます。
"#article" at the beginning of the line embeds a simple forum.
//#br
-#articleは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
-#articleは、他のブロック要素を子要素にすることはできません。
-#article should not be contained by other Block Elements. Although #article may be contained by other Block Elements, left margin is set, assuing it is placed at the top-level.
-#article may not accept other Block Elements as Child Element.
#vote(選択肢1,選択肢2,...)
行頭で#voteを記述すると、簡易投票フォームが埋め込まれます。
#vote(Option1,Option2,...)
"#vote" at the beginning of the line embeds a simple form for voting.
//#br
-選択肢は文字列、WikiName、BracketName、InterWiki、リンクを含めることができます。その他のインライン要素を含めることができません。
-#voteは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
-#voteは、他のブロック要素を子要素にすることはできません。
**&aname(inline);インライン要素 [#t1de0d4e]
-インライン要素は、必ずブロック要素の子要素になっています。
--行頭書式でブロック要素を明示しない場合は、段落の子要素となります。
--行頭書式でブロック要素を明示した場合は、指定したブロック要素の子要素になります。
-インライン要素は、インライン要素を子要素にすることができます。
-インライン要素はブロック要素を子要素にすることはできません。
-インライン要素となる拡張書式((PukiWiki原版でユーザー定義と呼んでいるもの。))は&～の形式になっています。
-The options may contain string, WikiName, BracketName, InterWiki, and link. Other Inline Elements may not be included as an option.
-#vote should not be contained by other Block Elements. Although #vote may be contained by other Block Elements, left margin is set, assuing it is placed at the top-level.
-#vote may not accept other Block Elements as Child Element.
**&aname(inline);Inline Elements [#t1de0d4e]
-Inline Element must be contained by a Block Element.
--If the parent Block Element is not explicitly specified at the beginning of the line, Inline Elements is silently contained by a Paragraph.
--If the parent Block Element is explicitly specified at the beginning of the line, Inline Elements is contained by the Block Element.
-Inline Element may accept other Inline Elements as a Child Element.
-Inline Elements follow the &foobar; format (user-defined format).
***&aname(string);Strings [#g6d1c119]
Strings
Strings are an Inline Element.
//#br
-文字列は、他のインライン要素の子要素になることができます。
-文字列は、他のインライン要素を子要素にすることができません。
***&aname(linefeed);改行 [#v1a2144b]
-Strings may be contained by other Inline Elements.
-Strings may not accept other Inline Elemnts as a Child Element.
***&aname(linefeed);Line Breaks [#v1a2144b]
Inline Element~
行末に~を書くと行末改行になります。行末改行はブロック要素内での改行になります。
Writing "~" at the end of the line inserts End of Line a line break. End of Line is a line break within a Block Element.
//#br
-行末改行の次の行の行頭書式は無効になり、文字列として扱われます。
-行末改行は、他のインライン要素の子要素になることはできません。
-行末改行は、他のインライン要素を子要素にすることはできません。
-行末改行は、定義リストの定義語、表組みの要素、#で始まるブロック要素のパラメタの中では使用できません。
-End of Line voids any Block Element specified at the beginning of the next line, and turns it into a String.
-End of Line may not be contained by other Inline Elements.
-End of Line may not accept other Inline Elements as a Child Element.
-End of Line may not be used within the Item of Definition List, Item of a Table, or in the parameter of Block Elements starting with "#".
&br;
行中に&br;を書くと行中改行になります。行末の ~と違い、定義リストの定義語や表組みの要素、#で始まるブロック要素のパラメタの中でも使用できます。
Writing &br; breaks the line. Unlike "~" at the end of the line, Line Break may be used within the Item of Definition List, Item of a Table, or in the parameter of Block Elements starting with "#".
//#br
-行中改行は、他のインライン要素の子要素になることができます。
-行中改行は、他のインライン要素を子要素にすることはできません。
***&aname(emphasis);強調 [#p46f371d]
''インライン要素''
行中のインライン要素を '' ではさむと、インライン要素が強調(太字)表示になります。
-Line Break may not be contained by other Inline Elements.
-Line Break may not accept other Inline Elements as a Child Element.
***&aname(emphasis);Emphasis [#p46f371d]
''Inline Element''
Enclosing Inline Element with '' puts emphasis on the element (Bold font).
//#br
-強調(太字)は、他のインライン要素の子要素になることができます。
-強調(太字)は、他のインライン要素を子要素にすることができます。
-Emphasis (Bold) may be contained by other Inline Elements.
-Emphasis (Bold) may accept other Inline Elements as a Child Element.
'''インライン要素'''
行中のインライン要素を ''' ではさむと、インライン要素が強調(斜体)表示になります。
'''Inline Element'''
Enclosing Inline Element with ''' puts emphasis on the element (Italics).
//#br
-強調(斜体)は、他のインライン要素の子要素になることができます。
-強調(斜体)は、他のインライン要素を子要素にすることができます。
***&aname(size);文字サイズ [#t6e5d501]
&size(サイズ){インライン要素};
行中に&sizeを書くとインライン要素の文字サイズを指定することができます。サイズはピクセル単位(px)で指定します。
-Emphasis (Italics) may be contained by other Inline Elements.
-Emphasis (Italics) may accept other Inline Elements as a Child Element.
***&aname(size);Font Size [#t6e5d501]
&size(Size){Inline Elements};
&size sets the size of inline elements in pixels (px).
//#br
-文字サイズは、他のインライン要素の子要素になることができます。
-文字サイズは、他のインライン要素を子要素にすることができます。
***&aname(color);文字色 [#le009418]
&color(色){インライン要素};
行中に&colorを書くとインライン要素の文字色を指定することができます。
-&size; may be contained by another inline elements.
-&size; may contain other inline elements.
***&aname(color);Font Color [#le009418]
&color(color){Inline Elements};
&color sets the color of inline elements.
//#br
-色の指定は、次のいずれかの形式で行ないます。
--[[色キーワード]]
--#16進数6桁
--#16進数3桁
-文字色は、他のインライン要素の子要素になることができます。
-文字色は、他のインライン要素を子要素にすることができます。
***&aname(delete);取消線 [#zaf0da74]
%%インライン要素%%
行中のインライン要素を%%ではさむと、インライン要素に取消線が付きます。
-The color can be specified by one of the following:
--Color Code
--#rrggbb
--#rgb
-&color; may be contained by another inline elements.
-&color; may contain other inline elements.
***&aname(delete);Line Strikethrough [#zaf0da74]
%%Inline Elements%%
Inline elements enclosed with %% makes texts with strikethrough.
//#br
-取消線は、他のインライン要素の子要素になることができます。
-取消線は、他のインライン要素を子要素にすることができます。
***&aname(note);注釈 [#o74286ea]
((インライン要素))
行中でインライン要素を((と))ではさむと、注釈が作成され、行中に注釈へのリンクが貼られます。注釈文の中では注釈を使用できません(ネストはできません)。
-Line strikethrough may be contained by another inline elements.
-Like strikethrough may contain other inline elements.
***&aname(note);Footnote [#o74286ea]
((Inline Elements))
Inline elements enclosed with (( and )) makes a footnote. A link to the footnote is created in the text. Footnotes cannot be nested.
//#br
-注釈は、他のインライン要素の子要素になることができます。親要素は注釈文ではなく、注釈へのリンクに反映されます。
-注釈は、他のインライン要素を子要素にすることができます。子要素は注釈文に反映されます。
-Footnote may be contained by another inline elements EXCEPT another footnote.
-Footnote may contain other inline elements.
// 原文意味不明・・・
//-注釈は、他のインライン要素の子要素になることができます。親要素は注釈文ではなく、注釈へのリンクに反映されます。
//-注釈は、他のインライン要素を子要素にすることができます。子要素は注釈文に反映されます。
// &p;
//注釈内に&p;を書くと改段落になります((注釈内改段落は、本来はブロック要素ですが、PukiWikiでは注釈をインラインで記述するため、インライン要素として記述する必要があります。他のインライン要素の子要素にはできないことに留意して使用する必要があります。))。
//&p; written inside a footnote breaks a paragraph. ((Although a paragraph break is supposed to be a block element, since PukiWiki treats a footnote as an inline element, it must be placed inline. It must not be contained in other inline elements.))。
//#br
//-注釈内改段落は、他のインライン要素の子要素になることはできません。
//-注釈内改段落は、他のインライン要素を子要素にすることはできません。
***&aname(ref2);添付ファイル・画像の貼り付け [#w04aa19e]
&ref(添付ファイル名);
&ref(ファイルのURL);
行中で&refを記述すると、添付ファイルまたは指定されたURLにあるファイルへのリンクを貼り付けることができます。ファイルが画像ファイルの場合は、その画像を表示します。
//-Paragraph break inside a footnot must not be contained by another inline elements.
//-Paragraph break inside a footnot must not contain other inline elements.
***&aname(ref2);Embedded Files and Images [#w04aa19e]
&ref(File Name);
&ref(URL);
&ref makes a link to an attachment file or a URL. If the attachment is an image file, the image is displayed.
//#br
-&refには、カンマで区切って下記のパラメタを指定できます。パラメタを省略した場合はデフォルト値となります。
添付ファイルのページ
--添付ファイルが存在するページ名(WikiName、 BracketName)を指定します。デフォルトは現在のページです。
--以下のパラメタを指定する場合は、ページ名の次に記述します。
-&ref can have the following parameters, separated by cammas. Default values are used for unspecified parameters.
The page where the attachment file is uploaded.
--This parameter defines the page (WikiName、 BracketName) where the attachment file is stored. The default is the current page.
--This parameter must be set right after the file name.
-
nolink
--デフォルトでは添付ファイルへのリンクが張られますが、nolinkを指定するとリンクを張りません。
--By default &ref creates the link to the attachment file. With nolink, the link is not created.
-
代替文字列
--ファイル名の代わりに表示する文字列や画像の代替文字列を指定できます。指定しない場合は、ファイル名になります。
--代替文字列には文字列以外のインライン要素を含めることはできません。WikiNameやBracketName、文字列以外のインライン要素を記述しても文字列として扱われます。
--このパラメタを指定する場合は、最後に記述します。
-&refは、他のインライン要素の子要素になることができます。
-&refは、他のインライン要素を子要素にはできません。
//***&aname(ruby);ルビ構造
// &ruby(ルビ){インライン要素};
//行中で&rubyを書くとインライン要素に対するルビをふることができます。ルビに対応していないブラウザではルビが本文中に ( と ) に囲まれて表示されます。
alternative string
--An alternative string is displayed instead of the file name. By default, the file name is displayed.
--The string must not contain any inline elements other than a simple string. WikiName, BracketName, or other inline elements are all treated as a simple string.
--This parameter must be the last of all parameters.
-&ref; may be contained by another inline elements.
-&ref; must not contain other inline elements.
***&aname(ruby);Ruby [#c74c4c49]
&ruby(ruby string){Inline Elements};
&ruby makes a ruby (short runs of text alongside the base text) for inline elements. In a browser does not support a ruby, it is displayed as texts surrounded by ( ).
//#br
//-ルビ構造のルビにはインライン要素を記述します。ただし、ルビの特性上、期待通りの表示になるとは限りません。
//-ルビ構造は、他のインライン要素の子要素になることができます。
//-ルビ構造は、他のインライン要素を子要素にすることができます。
//-ルビ構造をルビ構造の子要素にはできません(ネストはできません)。
//-注釈内や文字サイズを小さくしている部分での使用は、ルビが判読できなくなるので避けてください。
***&aname(anchor);アンカーの設定 [#x9c38f18]
&aname(アンカー名);
行中で&anameを記述するとリンクのアンカーを設定することができます。リンクの飛び先にしたい位置に記述します。
-Although any inline elements may become a ruby string, it may not be displayed as expected.
-&ruby; may be contained by other inline elements.
-&ruby; may contain other inline elements.
-A ruby must not be nested.
-The use of a ruby should be avoided inside a footnote or in other places with small text size.
***&aname(anchor);Anchor [#x9c38f18]
&aname(anchor name);
&aname(anchor name){Inline Elements};
&aname; makes an anchor for a link.
//#br
-アンカー名は、半角アルファベットから始まる半角アルファベット・数字・ハイフン・アンダースコアからなる文字列を指定します。
-アンカー名の中には、全角文字や半角空白文字、半角記号を含めることはできません。
-アンカー設定は、他のインライン要素の子要素になることができます。
-アンカー設定は、他のインライン要素を子要素にはできません。
***&aname(counter);カウンタ表示 [#p695e822]
-The anchor name must be a string beginning with an alphabet and consisting of alphabets, digits, hiphens, and underscores.
-The anchor name must not contain multi-byte characters, spaces, or other symbol characters.
-&anchor; may be contained by other inline elements.
-&anchor; may contain other inline elements.
***&aname(counter);Counter [#p695e822]
&counter;
&counter(オプション);
行中で&counterを記述するとそのページにアクセスした人の数を表示することができます。
&counter(options);
&counter; makes a counter that displays the number of accesses to the page.
//#br
-&counterには次のオプションを指定できます。オプションを省略した場合はallが指定されたものとみなされます。
-&counter; can have the following options. If no options are provided, "total" is used by default.
today
--今日のアクセス数を表示します。
--Displays the number of accesses of today
-
yesterday
--昨日のアクセス数を表示します。
--Displays the number of accesses of yesterday
-
all
--アクセス総数を表示します。
total
--Displays the total number of accesses
//#br
-カウンタ表示は、他のインライン要素の子要素になることができます。
-カウンタ表示は、他のインライン要素を子要素にはできません。
***&aname(online);オンライン表示 [#r8045aa7]
-&counter; may be contained by other inline elements.
-&counter; must not contain other inline elements.
***&aname(online);Online Viewers [#r8045aa7]
&online;
行中で&onlineを記述すると現在アクセス中の人数を表示することができます。
&online; displays the number of current accesses.
//#br
-オンライン表示は、他のインライン要素の子要素になることができます。
-オンライン表示は、他のインライン要素を子要素にはできません。
***&aname(version);バージョン表示 [#g4b02c96]
-&online; may be contained by other inline elements.
-&online; must not contain other inline elements.
***&aname(version);Version [#g4b02c96]
&version;
行中で&versionを記述するとPukiWikiのバージョンを表示することができます。
&version displays the version of PukiWiki.
//#br
-バージョン表示は、他のインライン要素の子要素になることができます。
-バージョン表示は、他のインライン要素を子要素にはできません。
-&version; may be contained by other inline elements.
-&version; must not contain other inline elements.
***&aname(wikiname);WikiName [#d89f7c04]
WikiName
行中で、1つの大文字→1つ以上の小文字→1つの大文字→1つ以上の小文字の組み合わせからなる半角文字列はWikiNameになります。
[[WikiName]] stands for two or more Capitalized Words joined together without spaces, muti-byte characters, symbols, and numbers.
//#br
-WikiNameの中には、全角文字や半角空白文字、記号、数字を含めることはできません。
-WikiNameは、PukiWiki内のページ名になります。すでに存在するページであればそのページへのリンクが自動的に貼られます。存在しない場合はWikiNameの後ろに?が自動的に付き、そのページを新規作成するためのリンクが貼られます。
-WikiNameは、他のインライン要素の子要素になることができます。
-WikiNameは、他のインライン要素を子要素にはできません。
-WikiName cannot contain multi-byte character, spaces, symbols, or numbers.
-WikiName indicates a link to a page in Pukiwiki. If the page already exists, the link is automatically made. And if it doesn't exist, the WikiName will have a ? mark behind it, which will be linked to to a page where you can add new contents for that name.
-WikiName can be a Child Element of other Inline Elements.
-WikiName cannot contain other Inline Elements as its Child Elements.
***&aname(bracketname);BracketName [#y97a88fc]
[[れいみぃ]]
行中で[[と]]で囲まれた文字列はBracketNameになります。
[[BracketName]]
A string enclosed with [[ and ]] makes [[BracketName]], which is another link style in Pukiwiki.
//#br
-BracketNameの中には、全角文字、記号、数字、半角空白文字を含めることができます。
-BracketNameの中には、"#&<>を含めることはできません。
-BracketNameは、PukiWiki内のページ名になります。すでに存在するページであればそのページへのリンクが自動的に貼られます。存在しない場合はWikiNameの後ろに?が自動的に付き、そのページを新規作成するためのリンクが貼られます。
-BracketNameは、他のインライン要素の子要素になることができます。
-BracketNameは、他のインライン要素を子要素にはできません。
-BracketName can contain multi-byte character, spaces, symbols, and numbers.
-BracketName cannot contain "#&<> .
-BracketName indicates a link to a page in Pukiwiki. If the page already exists, the link is automatically made. And if it doesn't exist, the BracketName will have a ? mark behind it, which will be linked to to a page where you can add new contents for that name.
-BracketName can be a Child Element of other Inline Elements.
-BracketName cannot contain other Inline Elements as its Child Elements.
***&aname(interwiki);InterWiki [#ccc1aafb]
[[InterWikiName:ページ名]]
行中のBracketNameの形式の文字列の中で、:で2つの文字列を区切るとInterWikiになります。:の前にはInterWikiNameのページで定義したInterWikiNameを、:の後ろにはWikiNameまたは[[と]]を取り去ったBracketNameを記述します。
[[InterWikiName:PageName]]
By seperating a BracketName with : , you can create an [[InterWiki]] block, which is another link style in Pukiwiki. The former part must contain an [[InterWikiName]] which is defined at InterWikiName which contains a list of defined InterWikiName. (What does this mean? It's not very clear.) The latter part must contain a WikiName or a BracketName without [[ and ]].
//#br
-InterWikiNameの中には、全角文字を含めることができます。
-InterWikiNameの中には、半角空白文字を含めるができます。
-InterWikiは、他のインライン要素の子要素になることができます。
-InterWikiは、他のインライン要素を子要素にはできません。
***&aname(link);リンク [#w8e3c0dc]
[[リンク名:URL]]
行中のInterWikiNameの形式の文字列の中で、:の前に任意のリンク名を、:の後ろにURLを記述すると、そのリンク名でURLに対するリンクを貼ることができます。
-InterWikiName can contain muti-byte characters and spaces.
-InterWiki can be a Child Element of other Inline Elements.
-InterWiki cannot contain other Inline Elements as its Child Elements.
***&aname(link);Link [#w8e3c0dc]
[[Link Name:URL]]
By seperating a BracketName with : , you can creat a Link block, which is yet another link style in Pukiwiki. The former part can contain a certain string which is used for the displayed name of a link. The latter part must contain a URL.
//#br
-リンク名には、全角文字や半角空白文字を含めることができます。
-Link Name can contain multi-byte characters and spaces in addition to alphabets, digits and a number of symbols.
http://～
https://～
ftp://～
news://～
mailto:～
行中に直接、URLを記述した場合は自動的にそのURLに対するリンクが貼られます。
http://...
https://...
ftp://...
news://...
mailto:...
-You can also make a direct link by using the styles listed above.
-If an image is linked, it is shown on the page. (I'm lazy. Please write the ideal way, to insert a link for image if you already know how. --- Olorin)
記述したURLが画像ファイルである場合は、その画像を表示します。
//#br
-リンクは、他のインライン要素の子要素になることができます。
-リンクは、他のインライン要素を子要素にはできません。
***&aname(alias);エイリアス [#u896260b]
[[エイリアス名>ページ名]]
行中のBracketNameの形式の文字列の中で、>で2つの文字列を区切るとエイリアスになります。>の前にはエイリアス名を、>の後ろにはWikiNameまたは[[と]]を取り去ったBracketNameを記述します。
-Link can be a Child Element of other Inline Elements.
-Link cannot contain other Inline Elements as its Child Elements.
エイリアスはPukiWiki内のページ名とは別のエイリアス名で、指定したページへのリンクを貼ります。
***&aname(alias);Alias [#u896260b]
[[Alias>PageName]]
By seperating a BracketName with > , you can creat an Alias, which is another link style in Pukiwiki. The former part can contain a certain string which is used for a name of a link. The latter part must contain a WikiName or a BracketName styled string without [[ and ]].
ページ名にアンカー名を付け加えてアンカーへのリンクを貼ることができます。ページ名とアンカー名の間には#をつけます。カレントページのアンカーへリンクを貼る場合はページ名を省略することができます。
:|
[[エイリアス名>ページ名#アンカー名]]
[[エイリアス名>#アンカー名]]
Alias enables you to make a link to a page in Pukiwiki with a different name.
You can also use an "anchor" to direct you to a certain part of a page. When you use an anchor as an internal link, you can omit a PageName.:|
[[Alias>PageName#anchor]]
[[Alias>#anchor]]
//#br
-エイリアス名の中には、全角文字を含めることができます。
-エイリアス名の中には、半角空白文字を含めることができます。
-階層化されたページでは、ページ名を相対指定することができます。
-エイリアスは、他のインライン要素の子要素になることができます。
-エイリアスは、他のインライン要素を子要素にできます。
-Alias can contain muti-byte characters and spaces.
-Relative link is available.
-Alias can be a Child Element of other Inline Elements.
-Alias can contain other Inline Elements as its Child Elements.
***&aname(entity);Entity [#ve8c2454]
****&aname(page);ページ名置換文字 [#b2f92a7e]
-Entity is converted to a certain value when you submit a page.
-Entity can be a Child Element of other Inline Elements.
-Entity cannot contain other Inline Elements as its Child Elements.
****&aname(page);Page Name Entity [#b2f92a7e]
&page;
行中で&page;と書くと、編集中のページ名に置換されます。
&page; is converted to the name of current editing page.
//#br
-ページ名置換文字は、記事が書き込まれるときに置換されて記録されます。
-ページ名置換文字は、他のインライン要素の子要素になることができます。
-ページ名置換文字は、他のインライン要素を子要素にはできません。
****&aname(date);Date[#g57b899a]
-Page Name Entity is converted when the artile saved.
-Page Name Entity can be a Child Element of other Inline Elements.
-Page Name Entity cannot contain other Inline Elements as its Child Elements.
****&aname(date);Date Entity [#g57b899a]
&date;
&time;
&now;
行中で&date;と書くと、更新時の日付に置換されます。
&date; is converted to the current date.
行中で&time;と書くと、更新時の時刻に置換されます。
&time; is converted to the current time.
行中で&now;と書くと、更新時の日時に置換されます。
&now; is converted to the current date and time.
//#br
-日時置換文字は、記事が書き込まれるときに置換されて記録されます。
-日時置換文字は、他のインライン要素の子要素になることができます。
-日時置換文字は、他のインライン要素を子要素にはできません。
****&aname(refer_string);Special Characters[#m072caf3]
&heart;
&heart; is recognized as a HartMark: &heart;
//行中で&star;と書くと、星マーク ☆ に置換されて出力されます。
// ©
行中で&copy;と書くと、著作権マーク © に置換されて出力されます。
®
行中で&reg;と書くと、登録商標マーク ® に置換されて出力されます。
™
行中で&trade;と書くと、商標マーク ™ に置換されて出力されます。
// &onsen;
//行中で&onsen;と書くと、温泉マーク &onsen; に置換されて出力されます。
²
行中で&sup2;と書くと、2乗記号 ² に置換されて出力されます。
³
行中で&sup3;と書くと、3乗記号 ³ に置換されて出力されます。
行中で&nbsp;と書くと、非改行空白文字 に置換されて出力されます。主に表組みのセル幅の調整に使用します。
// &free;
//行中で&free;と書くと、フリーソフトウエアマーク &free; に置換されて出力されます。
// &share;
//行中で&share;と書くと、シェアウエアマーク &share; に置換されて出力されます。
// &product;
//行中で&product;と書くと、商品マーク &product; に置換されて出力されます。
- Date Entity is converted when the artile saved.
- Date Entity may not be contained by other Inline Elements.
- Date Entity may not accept other Inline Elements as a Child Element.
****&aname(refer_string);Character Entities[#m072caf3]
In addition to the character entities defined in SGML (e.g., &copy;, &reg;, etc.), the following entities can be used.
&heart;
&smile;
&bigsmile;
&huh;
&oh;
&wink;
&sad;
&worried;
-&heart; is displayed as: &heart;
-&smile; is displayed as: ⌣
-&bigsmile; is displayed as: &bigsmile;
-&huh; is displayed as: &huh;
-&oh; is displayed as: &oh;
-&wink; is displayed as: &wink;
-&sad; is displayed as: &sad;
-&worried; is displayed as: &worried;
-Character entities are converted when displayed.
-Character entities may be contained by other Inline Elements.
-Character entities may not accept other Inline Elements as a Child Element.
****&aname(refer_numeral);Numeric Entity [#cdae2296]
&#Decimal-number;
&#xHexadecimal-number;
By writing a decimal number between &# and ; or a hexadecimal number between &#x and ;, a Unicode character can be displayed. You may use this inline element to insert characters which you cannot directly type with your keyboard.
Take a look at the examples in the following table:
|''Special entity''|''Code''|''Comments''|h
|世|&#19990;|You can use characters from all over the world!|
|∞|&#8734;|We could go on like this forever...|
|Ω|&#937;|But here it must end.|
//#br
-文字参照文字は、表示されるときに置換されます。
-文字参照文字は、他のインライン要素の子要素になることができます。
-文字参照文字は、他のインライン要素を子要素にはできません。
****&aname(refer_numeral);数値参照文字 Numeric Charcters[#cdae2296]

進数;
進数;
行中で&#と ;の間に10進数を、&#xと ;の間に16進数を書くと、Unicodeを数値参照して表示します。キーボードから直接入力できない文字やJIS第3水準・第4水準の文字などの表示に使用します。
-Numeric Entity are converted when display.
-Numeric Entity may be contained by other Inline Elements.
-Numeric Entity may not accept other Inline Elements as a Child Element.
-Hexadecimal number must be written in small letter. (XHTML 1.0 rev 2 or newer allows only small letters.)
たとえば、内田百&#38290;と入力すると、内田百閒と表示されます。
//#br
-数値参照文字は、表示されるときに置換されます。
-数値参照文字は、他のインライン要素の子要素になることができます。
-数値参照文字は、他のインライン要素を子要素にはできません。
-16進数は半角小文字で指定する必要があります(XHTML 1.0 第2版から小文字に限定されました)。
**&aname(etc);その他 [#ba8c703c]
***&aname(comment);コメント行 [#v455ee74]
**&aname(etc); Others [#ba8c703c]
***&aname(comment);Commnet line [#v455ee74]
// Comments
行頭で // を指定すると、コメント行になります。コメント行は出力されない行です。
A line beginning with // is a comment. It is not displayed on the wiki page.
//#br
-コメント行は、他の要素と無関係に行単位でどの位置にも記述できます。
-コメント行は、前後の他の要素に何ら影響を及ぼしません。
-The commnet line can be placed in any position.
-The commnet line doesn't affect other elements.
&br;
**Prohibition [#vc1bb6c0]
|LEFT:|CENTER:|CENTER:|c
|''Block Element''|''can contain other block elements''|''can be contained by other block elements''|h
|''Paragraph''|CENTER:no|CENTER:yes|
|''Prefpmatted''|CENTER:no|CENTER:yes|
|''Headings''|CENTER:no|CENTER:no|
|''Table''|CENTER:no|CENTER:yes|
|''Table(CSV)''|CENTER:no|CENTER:yes|
|''List(unordered)''|CENTER:yes*|CENTER:yes|
|''List(ordered)''|CENTER:yes*|CENTER:yes|
|''Quote''|CENTER:yes*²|CENTER:yes|
|''Horizontal Line''|CENTER:no|CENTER:yes|
|''LEFT:/CENTER:/RIGHT:''|CENTER:no|CENTER:yes|
|''#ref''|CENTER:no|CENTER:yes|
|''#contents''|CENTER:no|CENTER:yes*³|
|''#comment''|CENTER:no|CENTER:yes*³|
|''#pcomment''|CENTER:no|CENTER:yes*³|
|''#article''|CENTER:no|CENTER:yes*³|
|''#vote(choice1,choice2,...)''|CENTER:no|CENTER:yes*³|
~* As long as the beginning of Child Element is Inline Element or Paragraph,
you can insert a Block Element to the next line. (Please refer to "Nesting Element" for an example.)
~*²When Quotation is a Child Element of another Quotation, you need to increase the inentation level by 1.
~*³ Due to pukiwiki's default setting of left margin, this is not recommended.
&br;
**Compare Link Styles [#v3d91c05]
Here is a section to explain the differences between [[WikiName]], [[BracketName]], [[InterWiki]], Link, and Alias.
***WikiName and BracketName [#nce9618f]
As you know by now, all of them are used in Pukiwiki to make a link to a page.
And the difference betweem them is whether or not you can use spaces, multibyte-characters, symbols, and numbers. Thus, a BracketName would be a better choice if you want to avoid the typical WikiName capitalized link style. Usually, all Capitalized strings will be shown as a link. However, you can disable WikiNames in pukiwiki.ini.php if you think they are annoying.
***InterWiki, Link, and Alias [#aae92bd2]
These styles are very similar, so they might be confusing. But each of them has it's own purpose. If you understand the differences, they are all very useful.
First let's focus on their grammatical styles.
[[pukiwiki:Use PukiWiki]]..........[a]
[[whatever u like:http://pukiwiki.sourceforge.jp/?Use%20PukiWiki]]...[b]
[[Another Name>Text Formatting Rule]]......[c]
[a] is an InterWiki styled link. And [b] is a Link styled link.
Finaly, both of them will direct us the same page: http://pukiwiki.sourceforge.jp/?Use%20PukiWiki .
This is so, because pukiwi is defined in the InterWikiName as followins:
[http://pukiwiki.sourceforge.jp/? pukiwiki] utf8
Thus InterWiki combines two pieces of information. The first piece is a URL defined in InterWikiName, and the other is the information provided by the right side attribute.
InterWikiName is a kind of short cut. You can define any URL for an InterWikiName.
For example, when you create an link to external/internal wiki page, it is annoying to have to type the whole URL each time you want to use it. In this case, as an alternative, you can define an InterWikiName.
As you can see, [c] is a Alias styled link. You can use it to display a different link text for a link to a page in PukiWiki.
In conclusion, the most important difference you need to understand is
'' Which side is which?''
|Link Style|Left Side|Right Side|
|InterWiki|InterWikiName(Defined URL)|Additional URL|
|Link|Link text|Real URL|
|Alias|Link text|Real URL(WikiName/BracketName)|
&br;
**&aname(compare);Nesting Elements[#y4860837]
***Paragraph Element-Emphasize Element [#ned5fa77]
~This is the paragraph, which is the parent element that contains the emphasized.
''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 the emphasized.
''This is the emphasized text that is the child element of the paragraph element.''
***Quotation Element-List Element [#a0650018]
Level[0]
>Quotation Level[1]AAA
>Quotation Level[1]BBB
>>Quotation Level[2]AAA
>>Quotation Level[2]BBB
>>>Quotation Level[3]
-Chiled Element-List Level[1]
-Child Element-List Level[1]
|TABLE|ELEMENT|NEXT|to|inline|element|in list|
--Chiled Element-List Level[2]
--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
-Chiled Element-List Level[1]
--Chiled Element-List Level[2]
---Chiled Element-List Level[3]
-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]
-Chiled Element-List Level[1]
-Child Element-List Level[1]
|TABLE|ELEMENT|NEXT|to|the Inline|element|in a list|
--Chiled Element-List Level[2]
--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
-Chiled Element-List Level[1]
--Chiled Element-List Level[2]
---Chiled Element-List Level[3]
-Child Element-List Level[1]
--Child Element-List Level[2]
---Child Element-List Level[3]
----
(The texts below are for the discussion in the translation team. Don't worry if it's written in Japanese:)
-ええと、記録はどうしたらよいですかね？とりあえず前回からは、ほとんど進んでいません。
W3Cの勧告書を参考に翻訳中です。
-Table 部分修正しました --merlin &new{2003-09-21 (日) 17:59:01};
-とりあえず、マニュアルで使われる英語パターンは出し尽くしたと思います。
使ったことの無い機能も使ってみないと・・・。--Olorin &new{2003-10-01 (水) 22:59:01};
-添付についての部分を英訳してみました。訳語はよくわからない部分があったのでチェックをお願いします。--[[Tomos]]
-他に気になった点:"Horizon Line"は"Horizontal Line"でどうでしょう? Tomos
-"Horizontal Line"の方が普通ですね。＾＾；どんどん直しちゃってください。
あと「ブロック要素に他の～要素を含めます。」の訳は「contain "other" ～ Element"s"」
という形に統一しようかな？と思っていますがどうでしょうかね？（子要素にいくつも他の要素が入る可能性があるので。）
あと、プラグイン関係で行頭に＃？？？を指定すると～って所の訳もいろいろ考えたのですが、
W3Cとかのを参考にしたりした結果
「行頭でを記述すると」＝＞When ''#comment'' is assigned at the beginning of a line,
assignは結構堅い文で好まれる単語ですし、短くまとまっている？ので良いのではないかと思います。
あとは、アクセシビリティーも考えると強調タグよりダブル/シングルクオートでかこったほうがよいですかね？ 取り消し線訳しました。Deletion...微妙か？--- Olorin
-すみません、このページの日本語を分かりません。しかし、英語を直しました。 Sorry, I don't understand the Japanese on this page. But, I corrected the English. Note that all this talk about "child and parent elements" sounds quite strange to me. We should just use the words "contains" or "is contained by". ---Bjorn De Meyer
-Don't worry we can use English as a public language. Anyway, thank you for your help. As regards your suggestion(Child and parent elements), it's quite natural of you to think its's strange that you use the words "Parent and Children. Have you ever read the XHTML recomenndation at W3C? We reffer to this document. Probably this is the reason why "Parent and Child" is used in this Text Formatting Rule. To tell the truth, I also tried to describe the Pukiwiki grammar without using "Parent and Child". Although reimy who is the leader of this project suggested that I wanted to reffer to W3C documents. Im my opinion, I keep using "Child & Parent" even if it sounds like professional or strange. Since we also have another "Help Document", which would be more easy to understand, I suppose. Any suggestiong is welcome.^^---Olorin
-Well, yes, think I understand what you mean. But, I read the English version of the XHTML spec, and it doesn't use "Child and Parent" at all. On the contrary, look here: http://www.w3.org/TR/xhtml1/prohibitions.html
I think it would be a good idea to group the "prohibitions" of the elements of the PukiWiki formatting elements in a similar paragraph. It will make the documentation more simple and easy to understand. I think we shouldn't rely on that other "Help document" too much. Each page of documentation should be self-sufficient. Also, we need more examples. Examples are the best form of documentation. Finally, some small points to help you improve your English:
--When you write a comma or a point, always leave a space behind it.
--The expression "feel strange" can only be used for emotions or the body, not for ideas. The expression you need to use for thoughts is "think it is strange". Examples:
I think it is strange that you use the words "Parent and Children".
If I eat something wrong, I will feel strange.
Maybe I'm in love with her, because each time I see her, I feel strange. ^_^ ---Bjorn De Meyer
---Ah, I'm really ashamed of my ridiculous wrong usage...(>_<) We should really take it into consideration that we need to rebuild this "Text Formatting rule", and make it simpler. Because I also can see unpleasant repeats of "can contain/cannot contain". Actually, Parent and Child elements are used in the documents of W3C. [[Google result:http://www.google.co.jp/search?q=%22parent+elements%22+HTML+w3c&hl=ja&&lr=lang_en]]&br;&br;
Well, anyway, this document is definitely not friendly to pukiwiki-users since I had much difficulty to understand how to use some elements. So I investigated how table, and quotation elements are used at SandBox page... In my opinion, if I can seperate this page into 2 columns, it would be an ideal interface for new users as Wikipedia does. [[Wikipedia Help Page:http://www.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page]]&br;&br;
But, unfortunately, I have no idea how we can enable Block Elements in a Table Elements. I will ask Pukiwiki experts if we can imitate this page. Anyway,"Prohibition" section is a really nice idea. It should be included. And thank you for your good examples. Plus I also check my dictionary, too. So I never mistake how I should use "strange", maybe. lol --- Olorin &new{2003-10-08 (水) 18:50:01};
---Don't worry too much about your mistakes. My Japanese is far worse than your English. I'm easily ashamed too, because I make these errors. But, we also learn by making errors. So, let's overcome the shame, and turn it into our strength. ^_^ I agree, this document needs to be simplified. I like the Wikipedia documentation. I am going to try something similar in this FormattingSandbox. You are right, "parents" and "children" are used on the W3C web page, in places where I hadn't looked yet. -_- Maybe the prohibition section could be a table as well?
-Added "Prohibition" section. --- Olorin
-Added "Compare Link Styles". Finished InterWiki, BracketName, Link, and Alias. By the way, I think alias is not suitable for one of the Link Style name. Since it is especially used for CRIMINAL. What do you think about this? I know it's not much serious. But it's not good, in my opinion. (there was a critical misunderstanding. So i fixed my changes.) --- Olorin &new{2003-10-18 (土) 19:52:01};
--The word "alias" is indeed used for criminals in normal life. It means "also called" when talking about suspected criminals. However, when talking about informatics, it does not have a negative meaning. But something like "alternative name", or such could be used if you don't like that word. This link to a free online English dictionary may also help: http://www.dict.org ...
---If you think that there's no problem, there's no problem. :-) I made little progress in inline element-entity section. slow progress thesedays... --- Olorin &new{2003-10-26 (日) 23:12:33};
---I added some examples from the FormattingSandbox, and also corrected some of the English. Oh, and in that table, 'X' means 'no', and 'O' means 'yes', right? Because in Europe, we use 'X' for no, and 'V' for 'yes'. Even "scoring by X and O" is something typically Japanese. --- Bjorn
--- Yes. 'O' means 'yes'. Probably, we should discard this method. We can smiply use 'yes' and 'no', which seems to cause no misunderstanding. In the meantime, Pukiwiki-1.4-final will be released in a week, according to the announce of pukiwiki dev team. And I think every English document is going to be included even if it is not perfect.--- Olorin &new(2003-10-28 (火) 22:14:30);
- http://www.w3.org/TR/xhtml1/definitions.html#terms 「云々できます」を can とするのはマニュアルらしくないでしょう。 -- e.e 2003-11-26 (水) 15:14:53
-- 「云々できます、してもいいですよ」は may。「しなきゃだめ」は must。「云々すべき」は should。「#commentは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。」これとかshould.
-- http://en2.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page こことか参考になるかも。 -- e.e
-- とりあえず、まだ日本語な所はどんどん訳してみます。英語になれば、あとは友達に読んでもらっていくらでも推敲できるし。
--それと、下のパターンのところでも問題になっている？んですが・・・。僕のは訳したところは、ChildElementとBlockElementをかなり多用しています。（直訳）でも、be contained by other Block Elementsの方が分かりやすいですよね？日本語での「子要素」はどうしたらいいですかね？Bjornさんとも、前に話したんですけどね。＾＾； -- olorin
- いまさら、counter plugin のdefault 設定の記述ミスを修正 -- &new{2009-05-25 (月) 14:09:59};
#hr
*Translation patterns [#v4329df7]
-#comment should not be contained by other Block Elements. Although #comment may be contained by other Block Elements, left margin is set, assuing it is placed at the top-level.
-#ref may be contained by other Block Elements.
-#ref may not accept other Block Element as a Child Element.
#hr
![[PukiWiki]](image/pukiwiki-dev.png "[PukiWiki]")
