About PukiWiki(English) FormatRule(English)
Это неоконченный перевод
それは未完成の翻訳です
Введенный текст в PukiWiki отображается так же, каким он был введен. Однако, можно использовать следующие правила для улучшения текста. Использование HTML-тегов запрещено. Вместо этого, можно пользоваться специальными символами для форматирования текста. Правила форматирования обычно относятся к определенной части текста, такая часть текста называется — элемент.
Элементы†
PukiWiki рассматривает текст как набор элементов. Пустая строка означает конец элемента. Элементы могут содержать другие элементы, такие элементы называют "дочерние элементы". Элемент, который содержит один или несколько дочерних элементов называется "родительским элементом".
Текст набранный таким образом
~Это параграф. Это родительский элемент содержащий выделенный текстовый элемент. ''Это выделенный текстовый элемент, он является дочерним элементом параграфа — родительского элемента.''
Будет выводиться так
Это параграф. Это родительский элемент содержащий выделенный текстовый элемент. Это выделенный текстовый элемент, он является дочерним элементом параграфа — родительского элемента.
В PukiWiki есть два вида элементов: "блочные элементы", и "строчные элементы". Блочные элементы, как следует из названия, состоят из целого блока текста, а строчные элементы могут состоять только из части текстового блока, разница между блочными и строчными элементами выглядит следующим образом:
- Блочный элемент
- может содержать другие блочные и встроенные элементы
- может быть дочерним элементом другого блочного элемента.
- Строчный элемент
- Всегда будет дочерним элементом другого элемента.
- Может содержать другие как строчные элементы так и их дочерние элементы.
- Не может содержать другие блочные элементы, в том числе и их дочерние элементы.
Тем не менее, параграф, заголовок, линия, и плагин #(Plugin[Block]) не могут содержать другие блочные элементы, как и дочерние элементы.
- Пустая строка после блочного элемента одновременно закрывает все дочерние элементы и элементы этого блока.
- Блочные элементы могут быть дочерними элементами других элементов блока.
- Элементы: Список и Цитата могут содержать другие блочные элементы, а их дочерние наследуют уровень отступа от родительского элемента, и как всегда, пустая строка заканчивает блочный элемент.
Далее, приводится описание двух различных видов элементов в деталях.
Блочные элементы†
- Блочный элемент может содержать другие блочные и строчные элементы, в том числе и их дочерние элементы.
- Список и Цитаты имеют три уровня глубины, все они независимы. Поэтому если необходимо совместить элементы списков в цитатах или наоборот, не требуется увеличивать уровень отступа родительского элемента.
Но если необходимо, чтобы элемент списка содержался в другом элементе списка или цитаты в другом элементе цитаты, потребуется увеличить уровень отступа родительского элемента.
Это может показаться трудным для объяснения, но это гораздо проще, чем кажется.
- "<","<<", и "<<<" позволяют закрыть цитаты в дочернем элементе без закрытия родительского элемента к которому он принадлежит. Уберите кавычки, чтобы увидеть как выглядит этот пример.
- "<" Первый уровень цитаты
- "<<" Второй уровень цитаты
- "<<<" Третий уровень цитаты
- Пустая строка закрывает не только элемент цитаты, но и блочный элемент, к которому он принадлежит.
- # указывает на начало плагина Block (У плагина есть 2 режима: блочный и строчный).
Параграф†
PukiWiki предполагает, что каждый новый блочный элемент начинается с нового абзаца, если вы не указываете другое форматирование текста, используя коды форматирования других блочных элементов.
Строчные элементы
Строка, начинающаяся с "~" обозначает начало нового абзаца. Символ "~" также позволяет прямое использование специальных символов (~, -, +, :, >, |, #, //), которые обычно используются в качестве символов для форматирования. Как правило, эти символы указывают на начало различных видов элементов. Единственный способ помещать в текст видимые специальные символы, в виде обычного текста поместив перед ними символ "~".
- Первая строка параграфа и параграфа в списке обозначается новым абзацем. Но ни список, ни цитата абзаца.
- Каждый параграф может продолжаться до начала нового блочного элемента.
- Параграфы могут быть дочерними элементами других блочных элементов.
- Параграфы не могут содержать другие блочные элементы, и их дочерние элементы.
Отступ цитирования†
Встроенный элемент
Символ ">" указывает на начало цитаты. Цитаты состоят из трех уровней отступов, обознаячаясь: ">", ">>", и ">>>".
- Цитата может содержать другие блочные элементы, как его дочерних элементов.
- Как и все элементы блока, цитаты продолжается до следующей пустой строке.
- Пункт в Цитата продолжается до начала другого элемента цитату или блока.
- Котировки могут быть дочерние элементы других элементов блока. (Посмотрите на Вложенные элементы для конкретных примеров.)
- Когда цитата дочерний элемент еще одну цитату, вам нужно увеличить уровень отступа на 1.
- Когда цитата дочерний элемент List, вам не нужно увеличить уровень отступа.
- Когда Цитата Список содержит в качестве дочернего элемента, вам не нужно, чтобы повысить уровень.
- Если вы хотите закрыть котировки в список, и сохранить элемент списка открыт, вам придется начинать с цитаты Элемент "<","<<","<<<" вместо ">",">> ",">>>".
- "<","<<", и "<<<" позволяют закрыть котировки в список, не закрывая список которой он принадлежит.
Список†
- Строчный элемент
В начале строки, "-" указывает на начало маркированного списка. Маркированный список может состоять из трех уровней, а именно :"-", "--", и "---".
- Маркированный список может содержаться в другом блочном элементе.
- Увеличение уровня отступа на один необходимо, когда список содержится другими списками. Если список содержится внутри цитат, увеличить уровень отступа не требуется.
- Маркированный список может содержать параграф с помощью символа "~" сразу после "-".
- Маркированный список может содержать другой блочный элемент, помещенный в следующей строке и продолжающися до тех пор, как не начнется дочерний элемент встроенный элемент или Абзац.
- Встроенный элемент
В начале строки, "+" указывает на начало Нумерованный список. Нумерованный список имеет три уровня именно :"+", "++", и "+++".
- Нумерованный список могут содержаться другого блочного элемента. -Повышение уровня один, когда он содержится другими список. Если он содержится на цитаты, вы не должны увеличить уровень отступа.
- Нумерованный список может содержать пункт, написав "~" сразу после "+".
- Нумерованный список может содержать другой блочный элемент, написанный в следующей строке и продолжающийся до начала дочернего элемента, встроенного элемента или абзаца''.
Пункт†
Пункт|Пункт Определение *1
Списком определений является строка, начинающаяся с ":" и разделенная символом "|" посередине. Существует три уровня отступов для списка определений *2 : ":", "::", и ":::".
Вы можете пропустить пункт или разрешения. Вы можете дать несколько определений пункта, записав последовательность определения списка и опуская Пункт после первого.
- Определение Список должен иметь "|" в строке.
- Item и определение Пункт должен быть встроенный элемент.
- Список определений могут содержаться другого блочного элемента.
- Повышение уровня отступа одним, когда он содержится другими список. Если он содержится на цитаты, вы не должны увеличить уровень отступа.
- Список определений может содержать пункт, написав "~" сразу после "|".
- Список определений может содержать другие блочные элементы, введенные в строке сразу после определения списка.
Неформатируемые тексты†
"Пробел" в начале строки обозначает начало неформатированного текста. Обыкновенный разрыв строки не вставляет неформатированный текст.
- Неформатированный текст может быть дочерним элементом других блочных элементов.
- Неформатированный текст не может содержать другие блочные элементы в том числе и их дочерние элементы.
- Элементы неформатированного текста никогда не преобразуются PukiWiki. Поэтому их содержание будет отображаться "как есть".
Таблицы†
|Строчный элемент|Строчный элемент|
Строчные элементы разделенные символом "|", форматируются как таблица. Запомните, что символ "|" должен стоять как перед первым знаком, так и после последнего знака элемента таблицы.
- Неправильный синтаксис
AAAA|BBB|CCC|DDD
- Правильный синтаксис
- Следующие коды могут использоваться для определения выравнивания содержания таблицы. Они вставляются в начале дочернего элемента, и задают три возможных варианта выравнивания.
- LEFT:
- CENTER:
- RIGHT:
- BGCOLOR(colorcode):
- COLOR(colorcode):
- SIZE(unit:px):
- Эти коды определяют как дочерний элемент должен форматироваться. По умолчанию используется выравнивание влево.
bbbb | bbbb | З А Г О Л О В О К |
aaaaa | Подвал | aaaaa |
Пример | расположения элементов | в каждой ячейке |
Выравнивание по левому краю ячейки | По центру | По правому краю ячейки |
По правому краю | По левому краю | По центру |
rowspan | BLUE | RED |
colspan |
- символ "c" в конце строки указывает на форматируемую строку таблицы. В форматируемой строке таблицы можно использовать следующие коды.
- LEFT:
- CENTER:
- RIGHT:
- BGCOLOR(colorcode):
- COLOR(colorcode):
- SIZE(unit:px):
- Используюя специальные номера, можно задать ширину (в единицах px) каждой ячейки.
- "h" в конце строки указывает на строку заголовка (thead).
- "f" на строку "подвала" (tfood).
- Ячейка содержащая строчный элемент начинается с "~" и указывает, что ячейка будет являться ячейкой-заголовком (th).
- ячейка содержащая только символ ">" будет обьединена со следующей справа ячейкой (colspan).
- Ячейка содержащая только символ "~" будет обьединена с ячейкой сверху (rowspan).
- Таблица может быть содержимым другого блочного элемента.
- Главное правило, таблица не содержит другие блочные элементы.
Таблицы CSV†
,Строчный элемент,Строчный элемент,…
Строчные элементы разделенные символом ","(comma), будут форматированны как таблица. Необходимо запомнить, что символ "," должен стоять перед первым элементом таблицы CSV.
- Вы можете включать строчные элементы с двойными кавычками ("), что позволит использовать обыкновенную заппятую (,) в строчных элементах.
- В строчных элементах закрытых двойными кавычками ("), можно использовать по две последовательные кавычки (""), чтобы отобразить элемент содержащий обыкновенные двойные кавычки (").
- Два последовательных символа равенства (==) помещенные в строчный элемент указывают на слияние колонок (colspan).
- Два пробела и более слева от строчного элемента выравнивают содержимое по правому краю ячейки; более чем один или более пробелов с обеих сторон выравнивают содержимое ячейки по центру.
aaaaaaaaa | bbbbbbb | ccccccc |
слева | по центру | справа |
<-- colspan | справа |
- Таблицы CSV могут быть содержимым других блочных элементов.
- Таблицы CSV Style Table не могут сами содержать блочные элементы.
Заголовки†
*Строчный элемент
Строка начинающаяся символом "*" форматируется как заголовок. Существует три уровня отступа заголоков: "*", "**", и "***".
- Заголовок не может быть содержимым блочных элементов.
Заголовок закрывает другие блочные элемеенты.
- Заголовок не может содержать другие блочные элементы.
Содержание†
#contents
"#contents" в начале строки создает элемент содержания текста на основе заголовков. В основном, "#contents" ставится в верхней части страницы.
- Элемент "содержание" не должно быть содержимым другого блочного элемента. Тем не менее "содержание" может быть содержимым других блочных элементов, установленное выравнивание влево, означает что содержание помещено на верх страницы.
- Содержание не может содержать в себе другие блочные элементы.
LEFT-CENTERED-RIGHT†
Слева
По центру
Справа
Написание "LEFT:", "CENTER:", или "RIGHT:" в начале строки выравнивает соответствующим образом каждый строчный элемент.
- Все три элемента могут содержаться другими блочными элементами.
- Все три элемента не могут содержать другие блочные элементы.
Линия†
----
Четыре символа "-" в начале строки создают горизонтальную линию.
- Линия не может быть содержимым других блочных элементов и не может содержать другие блочные элементы. Линия прерывает все блочные элементы.
Вставка рисунков†
Можно поместить ссылку на рисунок написав #ref(URL файла) в начале стороки.
Пример:
- Можно указать параметры рисунка с помощью запятых. Если ничего не указывать, используются параметры по умолчанию.
Страница прилагаемого файла
- Можно указать имя страницы прилагаемого файла. Имя может быть в двух стилях: WikiName or BracketName. Если не указанно, текущая страница работает по умолчанию.
- Следующие параметры могут быть указанны сразу после имени страницы.
- left
center
right
- Это указывает на место где ссылка или имидж дожен располагаться, по центру - по умолчанию.
wrap
no wrap
- Указывает на рамку. По умолчанию - без рамки.
around
- Указывает на обтекание текстом. По умолчанию - без обтекания.
- Прекратить обтекание, вставка "#img(,clear)".
nolink
- Nolink исключает возможность перехода по ссылке на файл или рисунок.
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 may be contained by other Block Elements.
- #ref may not accept other Block Element as a Child Element.
Заменитель
- Можно отобразить заменитель вместо имени файла или изображения. Когда заменитель не указан, используется имя файла по умолчанию.
- Заменитель поддерживает только в строчных элементах. WikiName, BracketName и другие, будут интерпретироваться как строка.
- Этот параметр должен быть указан в качестве последнего параметра, когда вы используете эту опцию.
- # ссылка может находиться внутри других блочных элементов.
- # ссылка не может содержать другой блочный элемент, как дочерний элемент.
Формы†
#comment
"#comment" в начале строки вставляет форму комментария.
- #comment не должен содержаться другим блочным элементом. Тем не менее #comment может содержаться другим блочным элементом, left margin is set, указывает что форма помещается на верх страницы.
- #comment не может содержать другой блочный элемент, как дочерний элемент.
#pcomment
"#pcomment" в начале строки вставляет форму комментария.
В отличие от "#comment", "#pcomment" сохраняются на отдельной странице. Так же создает дерево комментариев.
- #pcomment не должен содержаться другим блочным элементом. Тем не менее "#pcomment" может содержаться другим блочным элементом, left margin is set, указывает что форма помещается на верх страницы.
- #pcomment may не может содержать другой блочный элемент, как дочерний элемент.
#article
"#article" в начале строки вставляет простой форум.
- #article не должен содержаться другим блочным элементом. Тем не менее "#article" может содержаться другим блочным элементом, left margin is set, указывает что форма помещается на верх страницы.
- #article не может содержать другой блочный элемент, как дочерний элемент.
#vote(Выбор1,Выбор2,...)
"#vote" в начале строки вставляет форму голования.
- Кнопка выбора может содержать заменитель, WikiName, BracketName, InterWiki, и ссылку. Другие строчные элементы не могут содержаться как кнопка выбора.
- #vote should not be contained by other Block Elements. Although #vote may be contained by other Block Elements, left margin is set, assuming it is placed at the top-level.
- #vote may not accept other Block Elements as Child Element.
Строчные элементы†
- 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).
Strings†
Strings
Strings are an Inline Element.
- Strings may be contained by other Inline Elements.
- Strings may not accept other Inline Elements as a Child Element.
Line Breaks†
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.
- 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; вставляет разрыв строки. В отличие от "~" в конце строки,
может использоваться с пунктами, таблицами, или в параметрах блочных элементов начинающихся символом"#".
- Line Break не может содержаться другими строчными элементами.
- Line Break не поддерживает другие строчные элементы как дочерние.
Выделение†
Строчный элемент
Помещение строчного элемента с '' устанавливает выделение (Bold font).
- Выделение (Bold) может содержаться другими строчными элементами.
- Выделение (Bold) может поддерживаться другими строчными элементами как дочерний элемент.
Строчный элемент
Закрытие строчного элемента с помощью комбинации ''' устанавливает выделение курсивом (Italics).
- Выделение (Italics) может содержаться другими строчными элементами.
- Выделение (Italics) может поддерживаться другими строчными элементами как дочерний элемент.
Размер шрифта†
&size(px){Text you want to change};
&size указывает на размер знаков. Размер должен быть указан в пикселях (px).
- Font Size may be contained by other Inline Elements.
- Font Size may accept other Inline Elements as a Child Element.
Font Color†
Inline Element
&color defines the color of any Inline Element.
- The color of characters are defined as any of following format.
- color keyword
- #Hexadecimal number 6 figures
- #Decimal Number 3 figures
- Font Color can be a Child Element of other Inline Elements.
- Font Color can contain other Inline Elements as its Child Elements.
Deletion Line†
Inline Element
Enclosed with %(semicolons), the Inline Element has a line through the middle of the text.
- Deletion Line can be a Child Element of other Inline Elements.
- Deletion Line can contain other Inline Elements as its Child Elements.
Footnote†
*3
Enclosed with (( and ))(double parenthesis), the Inline Element becomes the footnote and the link to it is placed.
- Footnote can be a Child Element of other Inline Elements. Mother element effects to the link, not to the footnote.
- Footnote contain other Inline Elements as its Child Elements. Child Element effects to the footnote.
Embedding Files and Images†
&ref(): File not found: "Attached Filename" at page "FormatRuleRussian";
&ref(): File not found: "URL of File" at page "FormatRuleRussian";
You can attach a file by writing &(file name) at any place in paragraph. You can also place a hypertext link by writing #ref(URL of the file) . If the file attached or linked is an image, the image is displayed.
- 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 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.
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 may be contained by other Block Elements.
- &ref may not contain other Block Elements as Child Elements.
Anchor†
&aname: Invalid ID string: Anchor Name;
&aname makes the anchor for Hyperlink. Place this code where you want to set the link target to go.
- Anchor Name must be written in ASCII characters (alphanumeric characters, hyphenation and underscore) and be started by alphabetic characters.
- Anchor Name may not contain 2-byte characters, space and symbols.
- Anchor may be contained by other Inline Elements.
- Anchor may not accept other Inline Elements as a Child Element.
- To link to an Anchor Name, *****************
Counter†
&counter;
&counter(option);
&counter shows the number of access to the current page.
- You can specify following parameter as option. When unspecified, the values all are used by default.
today
- Show the number of accesses Today.
yesterday
- Show the number of accesses Yesterday.
all
- Show total accesses.
- Counter may be contained by other Inline Elements.
- Counter may not accept other Inline Elements as a Child Element.
Online Viewer†
&online;
&online shows the number of current accessors.
- Online Viewer may be contained by other Inline Elements.
- Online Viewer may not accept other Inline Elements as a Child Element.
Version†
&version;
&version shows the version of current running PukiWiki.
current version = &version;
- Version may be contained by other Inline Elements.
- Version may not accept other Inline Elements as a Child Element.
WikiName†
WikiName
WikiName stands for two or more Capitalized Words joined together without spaces, muti-byte characters, symbols, and numbers.
- 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. 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.
BracketName†
BracketName
A string enclosed with [[ and ]] makes a BracketName, which is another link style in Pukiwiki.
- 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. 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.
InterWiki†
InterWikiName:PageName
By separating a BracketName with a colon (:), 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 ]].
- InterWikiName can contain multi-byte characters and spaces.
- InterWiki can be a Child Element of other Inline Elements.
- InterWiki cannot contain other Inline Elements as its Child Elements.
Link†
[[Link Name:URL]]
Create a link block by separating a BracketName with a colon (:). The former part contains the string to be used for the displayed name of a link. The latter part must contain a URL.
- Link can be a Child Element of other Inline Elements.
- Link cannot contain other Inline Elements as its Child Elements.
Alias†
Alias
Alias enables you to link to a page in Pukiwiki without using the same name of the linked text, as in the case of a Link Block. This is useful when referencing a portion of a given page via an anchor.
Create an Alias by separating a BracketName with the ">" symbol. The former part contains the string to used as the link's name. The latter part must contain a WikiName or a BracketName styled string without [[ and ]].
Use the following syntax to make an "anchor" to direct to a certain part of a page. When using an anchor as an internal link, you can omit the PageName:
Alias
Alias
- Alias can contain multi-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.
Entity†
- 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.
*Page Name Entity†
FormatRuleRussian
&page; is converted to the name of current editing page.
- Page Name Entity is converted when the article 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.
*Date Entity†
&dare;
&time;
&now;
&date; is converted to the current date.
&time; is converted to the current time.
&now; is converted to the current date and time.
- Date Entity is converted when the article saved.
- Date Entity may not be contained by other Inline Elements.
- Date Entity may not accept other Inline Elements as a Child Element.
*Special Characters†
&heart;
&heart; is recognized as a Heart Mark: &heart;
©
© is recognized as a Copyright Mark: ©
®
® is recognized as a Registered Trademark: ®
™
™ is recognized as a Trademark: ™
²
² is recognized as a 2nd power sign: ²
³
³ is recognized as a 3rd power sign: ³
³ is recognized as a space : It is mainly used for adjusting sell width of table.
- Special Characters are converted when display.
- Special Characters may be contained by other Inline Elements.
- Special Characters may not accept other Inline Elements as a Child Element.
*Numeric Entity†
&#Decimal-number;
&#xHexadecimal-number;
If you insert a decimal number between &# and ; or a hexadecimal number between &# and ;, you can refer to Unicode entities. 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 |
世 | 世 | You can use characters from all over the world! |
♂ | ♂ | It is a man's world. |
☿ | ♀ | But it would be nothing without a woman. |
∞ | ∞ | We could go on like this forever... |
Ω | Ω | But here it must end. |
For example,
- For example 、内田百閒 is recognized as 内田百閒.
- 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.(After XHTML 1.0 rev 2,only small letter is allowed.)。
TAB Code†
&t; is recognized as TAB Code.
Usually,TAB code can't be written from the keyboard typing in any FORM.*4 But, &t; is converted to TAB Code when the page is stored.
- TAB Code is converted when the page is stored.
- TAB Code may be contained by other Inline Elements.
- TAB Code may not accept other Inline Elements as a Child Element.
Others †
Comment line†
// Comments
The line began with // at the first column means the comment line. It won't be displayed in the pursed page.
- The comment line can be placed in every position per line regardless of other elements.
- The comment line don't affect other elements of order at all.
Prohibition†
Block Element | can contain other block elements | can be contained by other block elements |
Paragraph | no | yes |
Preformatted | no | yes |
Headings | no | no |
Table | no | yes |
Table(CSV) | no | yes |
List(unordered) | yes* | yes |
List(ordered) | yes* | yes |
Quote | yes*² | yes |
Horizontal Line | no | yes |
LEFT:/CENTER:/RIGHT: | no | yes |
#ref | no | yes |
#contents | no | yes*³ |
#comment | no | yes*³ |
#pcomment | no | yes*³ |
#article | no | yes*³ |
#vote(choice1,choice2,...) | no | 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 indentation level by 1.
*³ Due to Pukiwiki's default setting of left margin, this is not recommended.
Compare Link Styles†
Here is a section to explain the differences between WikiName, BracketName, InterWiki, Link, and Alias.
WikiName and BracketName†
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†
These styles are very similar, so they might be confusing. But each of them has its own purpose. If you understand the differences, they are all very useful.
- First let's focus on their syntax.
pukiwiki:Use PukiWiki............................................[a]
whatever u like...[b]
Another Name................................[c]
[a] ссылка стилизованная InterWiki. [b] обыкновенная ссылка.
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 follows:
- pukiwiki utf8
Все InterWiki сочетают две информационные части. Первая URL указанная в InterWikiName слева, другая часть справа. InterWikiName что то вроде шортката. Можно указать любой адрес для InterWikiName.
Например, когда необходимо создать ссылку на внешнюю/внутреннюю wiki страницу, не обязательно печатать весь URL каждый раз. В этом случае, как альтернативу, можно указать InterWikiName.
Как видно, [c] является ссылкой стилизованной под Alias. Ее можно использовать it to display a отличный текст ссылки на страницу в PukiWiki.
Link Style | Left Side | Right Side |
InterWiki | InterWikiName(Defined URL) | Additional URL |
Link | Link text | Real URL |
Alias | Link text | Real URL(WikiName/BracketName) |
Nesting Elements†
Параграф с элементом выделенного текста†
Это параграф, который является родительским элементом содержащим дочерний элемент — выделенный текст.
Это параграф, который является родительским элементом содержащим дочерний элемент — выделенный текст.
Элемент цитаты-со списком†
- Уровень[0]
>Уровень цитаты[1]AAA
>Уровень цитаты[1]BBB
>>Уровень цитаты[2]AAA
>>Уровень цитаты[2]BBB
>>>Уровень цитаты[3]
-Дочерний элемент-уровень отступа списка[1]
ЭЛЕМЕНТ | ТАБЛИЦЫ | СЛЕДУЮЩИЙ | в | строчном | элементе | списка |
--Дочерний элемент-уровень отступа списка[2]
Разрыв строки внутри элемента
---Дочерний элемент-уровень отступа списка[3]
--Дочерний элемент-уровень отступа списка[2]
---Дочерний элемент-уровень отступа списка[3]
>Уровень отступа цитирования[1]
>>Уровень отступа цитирования[2]
<<Выход из элемента второго уровня отступа цитирования
>>>Уровень отступа цитирования[3]AAA
>>>Уровень отступа цитирования[3]BBB
-Дочерний элемент-уровень отступа списка[1]
--Дочерний элемент-уровень отступа списка[2]
---Дочерний элемент-уровень отступа списка[3]
- Уровень[0]
Уровень цитирования[1]AAA
Уровень цитирования[1]BBB
Уровень цитирования[2]AAA
Уровень цитирования[2]BBB
Уровень цитирования[3]
- Дочерний элемент-уровень списка[1]
ЭЛЕМЕНТ | ТАБЛИЦЫ | СЛЕДУЮЩИЙ | в | строчном | элементе | списка |
- Дочерний элемент-уровень списка[2]
Разрыв строки внутри элемента
- Дочерний элемент-уровень отступа списка[3]
- Дочерний элемент-уровень отступа списка[2]
- Дочерний элемент-уровень отступа списка[3]
Уровень отступа цитаты[1]
Уровень отступа цитаты[2]
Выход из элемента второго уровня цитирования
Уровень отступа цитаты[3]AAA
Уровень отступа цитаты[3]BBB
- Дочерний элемент-уровень отступа списка[1]
- Дочерний элемент-уровень отступа списка[2]
- Дочерний элемент-уровень отступа списка[3]