Форматирование текста

DokuWiki поддерживает некоторые разметочные языки, которые пытаются сделать файлы данных как можно более читабельными. Эта страница содержит все возможные синтаксисы, которыми вы можете пользоваться когда редактируете страницы. Просто просмотрите исходный текст этой страницы нажатием кнопки Редактировать страницу вверху страницы. Если вы хотите что-нибудь попробовать, используйте для этой цели страницу Песочница. Более простая разметка также легко доступна через быстрые клавиши.

Основное форматирование текста

DokuWiki поддерживает жирный, наклонный, подчёркнутый и monospaced тексты. Конечно, вы можете комбинировать их всех.

DokuWiki поддерживает **жирный**, //наклонный//, __подчёркнутый__ и ''monospaced'' тексты.
Конечно, вы можете **__//''комбинировать''//__** их всех.

Вы также можете использовать subscript и superscript.

Вы также можете использовать <sub>subscript</sub> и <sup>superscript</sup>.

Вы можете помечать текст также удалённым.

Вы можете помечать текст также <del>удалённым</del>.

Параграфы создаются от пустых строк. Если вы хотите принудить новую строку без параграфа, вы можете использовать два бэкслеша с пробелом, следующий за ними, или концом строки.

Вот текст с некоторыми linebreaks
Заметьте, что два бэкслеша распознаются в конце строки
или с последующим
пробелом \\это происходит без него.

Вот текст с некоторыми linebreaks\\ Заметьте, что
два бэкслеша распознаются в конце строки\\
или с последующим\\ пробелом \\это происходит без него.

Вы должны использовать принудительный перевод строк только если это действительно необходимо.

Ссылки

DokuWiki имеет множество способов создания ссылок.

Внешние

Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com - Вы можете также добавить описание ссылки: Эта ссылка ведёт к Google. E-mail адреса подобно этому: andi@splitbrain.org также распознаются.

Внешние ссылки распознаются автоматически: http://www.google.com или просто
www.google.com - Вы можете также добавить описание ссылки:
[[http://www.google.com|Эта ссылка ведёт к Google]].
E-mail адреса подобно этому: <andi@splitbrain.org> также распознаются.

Внутренние

Внутренние ссылки создаются в прямоугольных скобках. Вы можете или просто задать wiki:pagename или как Заглавный текст. Страницы Wiki-ссылок автоматически конвертируются в нижний регистр, особые символы не поддерживаются.

Внутренние ссылки создаются в прямоугольных скобках. Вы можете или просто задать
[[doku>wiki:pagename]] или как [[doku>wiki:pagename|Заглавный текст]]. Страницы
Wiki-ссылок автоматически конвертируются в нижний регистр, особые символы
не поддерживаются.

Вы можете использовать wiki:namespaces с помощью двоеточия в страницах ссылок.

Вы можете использовать [[doku>wiki:namespaces]] с помощью двоеточия в страницах
ссылок.

Для подробной информации читайте wiki:namespaces.

Привязка к заданной секции тоже возможна. Просто добавьте её название после хэш-символа #. Эта ссылка к этой Секции.

Эта ссылка к [[syntax#Внутренние|этой Секции]].

Замечания:

Подсказка: если DokuWiki - это ссылка, то она разрешается.

  • Когда заголовок секции изменён, его закладка также изменяется. Поэтому не слишком полагайтесь на ссылки секций.

Интер-wiki

DokuWiki поддерживает Interwiki ссылки. Это быстрые ссылки к другим Вики. Например, эта ссылка к страничке Википедии о Вики: Wiki.

DokuWiki поддерживает [[doku>wiki:interwiki|Interwiki]] ссылки. Это быстрые ссылки
к другим Вики. Например, эта ссылка к страничке Википедии о Вики: [[wp>Wiki]].

Windows Shares

Windows shares, такие как эти, также распознаются. Учтите, что они имеют смысл только гомогенных группах пользователей, как корпоративный Intranet.

Windows shares, такие как [[\\server\share|эти]], также распознаются.

Замечания:

  • Из соображений безопасности прямой просмотр windows shares действует только в Microsoft Internet Explorer per default (и только в «локальной зоне»).
  • Для Mozilla и Firefox он может быть разрешён через опцию config security.checkloaduri, но это не рекомендуется.
  • Смотри 151 для подробной информации.

Ссылки картинок

Вы можете также использовать ссылку на другую внутреннюю или внешнюю страницу комбинированием синтаксиса для ссылок и картинок (смотрите ниже) подобно этому примеру:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Учтите, форматирование картинок осуществляется с помощью синтаксиса форматирования, принятого в именах ссылок.

Синтакс image и link полностью поддерживается (включая изменением размера картинок, внутренние и внешние картинки, URL'ы и интерwiki ссылки).

Сноски

Вы можете добавить сноски 1) с помощью двойных скобок.

Вы можете добавить сноски ((Это сноска)) с помощью двойных скобок.

Секционирование

Вы можете использовать до пяти разных уровней заголовков для структуризации вашего содержания. Если у вас есть больше чем три заголовка, автоматически генерируется таблица содержания – это может быть запрещено включением в документ строки »~~NOTOC~~».

Заголовок Уровня 3

Заголовок Уровня 4

Заголовок Уровня 5
==== Заголовок Уровня 3 ====
=== Заголовок Уровня 4 ===
== Заголовок Уровня 5 ==

С помощью четырёх и более тире можно создать горизонтальную линию:


Картинки и другие файлы

Вы можете включать внешние и внутренние картинки с фигурными скобками. Опционально, вы можете указать их размер.

Исходный размер:

Изменить размер до заданнной ширины:

Изменить размер до заданнной ширины и высоты:

Изменённый размер внешней картинки:

Исходный размер:                        {{wiki:dokuwiki-128.png}}
Изменить размер до заданнной ширины:            {{wiki:dokuwiki-128.png?50}}
Изменить размер до заданнной ширины и высоты: {{wiki:dokuwiki-128.png?200x50}}
Изменённый размер внешней картинки:           {{http://de3.php.net/images/php.gif?200x50}}

Добавлением пробела слева или справа (в фигурной скобке) вы выбираете тип выравнивания:

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Конечно, вы также можете добавить заголовок (отображается как подсказка большинством броузеров).

Это заголовок

{{ wiki:dokuwiki-128.png |Это заголовок}}

If you specify a filename (external or internal) that is not an image (gif,jpeg,png), then it will be displayed as a link instead.

For linking an image to another page see Image Links above.

Списки

Dokuwiki поддерживает упорядоченные и неупорядоченные списки. Для создания элемента списка отступите от начала строки на два пробела и вставьте * для неупорядоченного списка или же - для упорядоченного.

  • Это список
  • второй элемент
    • Вы можете иметь различные уровни вложенности
  • другой элемент
  1. Тот же список, но упорядоченный
  2. другой элемент
    1. Всего лишь отступите на два пробела для более глубокого уровня
  3. Это всё
  * Это список
  * второй элемент
    * Вы можете иметь различные уровни вложенности
  * другой элемент

  - Тот же список, но упорядоченный
  - другой элемент
    - Всего лишь отступите на два пробела для более глубокого уровня
  - Это всё

Смайлы

DokuWiki конвертирует общеиспользуемые иконки эмоций в их графические эквиваленты. Дополнительные смайлы (smiles) могут быть размещены и сконфигурированы в файле conf/smileys.conf . Вот описание смайлов, включённых в DokuWiki:

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME (исправь меня)
  • DELETEME DELETEME (удали меня)

Типография

DokuWiki может конвертировать простые текстовые символы в их типографически корректные аналоги (entities). Вот пример распознаваемых символов:

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® «He thought 'It's a man's world'…»

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

Учтите: эти конверсии могут быть отключены в конфигурационном файле.

Цитирование

Иногда вы хотите пометить некоторый текст, чтобы показать ответ или прокомментировать. Вы можете использовать следующий синтаксис:

Я думаю, нам нужно это сделать

> Нет, не нужно

>> Хорошо, а Я говорю, нужно

> Серьёзно?

>> Да!

>>> Тогда сделаем это!

Я думаю, нам нужно это сделать

Нет, не нужно
Хорошо, а Я говорю, нужно
Серьёзно?
Да!
Тогда сделаем это!

Таблицы

DokuWiki поддерживает простой синтаксис для создания таблиц.

Heading 1 Heading 2 Heading 3
Row 1 Col 1 Row 1 Col 2 Row 1 Col 3
Row 2 Col 1 some colspan (учтите двойной pipe)
Row 3 Col 1 Row 2 Col 2 Row 2 Col 3

Табличные строки начинаются и заканчиваются с | для обычных строк и с ^ для заголовков.

^ Heading 1      ^ Heading 2       ^ Heading 3          ^
| Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        |
| Row 2 Col 1    | some colspan (учтите двойной pipe) ||
| Row 3 Col 1    | Row 2 Col 2     | Row 2 Col 3        |

Чтобы связать клетки горизонтально, просто оставьте следующую клетку абсолютно пустой как показано выше. Убедитесь, что всегда имеете одинковое количество разделителей клеток!

Вертикальные заголовки таблиц также возможны.

Heading 1 Heading 2
Heading 3 Row 1 Col 2 Row 1 Col 3
Heading 4 на этот раз нет строчного спана
Heading 5 Row 2 Col 2 Row 2 Col 3

Как вы видите, этот разделитель клеток до клетки, которая решает форматирование:

|              ^ Heading 1            ^ Heading 2          ^
^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        |
^ Heading 4    | на этот раз нет строчного спана |                    |
^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |

Учтите: вертикальные спаны (спаны столбцов) невозможны.

Вы можете выровнять также содержимое таблицы. Всего лишь добавьте как минимум один пробел в начале и в конце вашего текста: добавьте два пробела слева для выравнивания справа, два пробела справа для выравнивания слева или по крайней мере два пробела с обоих концов для центрированного текста.

Таблица с выравниванием
right center left
left right center
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Как это выглядит в исходном тексте:

^           Таблица с выравниванием           ^^^
|         right|    center    |left          |
|left          |         right|    center    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Непарсируемые блоки

Вы можете включать непарсируемые (необрабатываемые) блоки в ваши документы или отступом как минимум двумя пробелами (как было показано в предыдущих примерах) или с помощью тегов code или file.

Это преформатированный код, в котором все пробелы сохраняются: подобно              <-этому
Это достаточно похоже, но вы можете использовать его, чтобы показать цитируемый файл.

Чтобы позволить парсеру полностью игнорировать (т.е. не форматировать его), обрамите его тегами nowiki, или даже проще, с двойными знаками процента %%.

Вот некоторый текст, который содержит адреса подобно этому: http://www.splitbrain.org и **форматирование**, но с ним ничего не происходит.

Смотри исходный текст этой страницы, чтобы понять как использовать эти блоки.

Подсветка синтаксиса

DokuWiki может подсвечивать исходный текст кода, который облегчает его чтение. Она использует GeSHi Generic Syntax Highlighter – так что любой язык, поддерживаемый GeSHi, поддерживается. Синтаксис похож на блок кода в предыдущей секции, но на этот раз вставляется название используемого языка внутрь тега. Т.е. <code java>.

/** 
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

Следующие строки языков распознаются: actionscript, actionscript-french, ada, apache, applescript, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, diff, d, div, dos, eiffel, freebasic, gml, html4strict, ini, inno, java, javascript, lisp, lua, matlab, mpasm, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, scheme, sdlbasic, smarty, sql, ruby, vb, vbnet, vhdl, visualfoxpro, xml

Внедрение HTML и PHP

Вы можете внедрить чистый код HTML или PHP в ваши документы с помощью тегов html или php вот так:

<html>
Вот некоторый <font color="red" size="+1">HTML</font>
</html>

Вот некоторый <font color="red" size="+1">HTML</font>

<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

echo 'A logo generated by PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';

Учтите: внедрение HTML и PHP по умолчанию запрещено в конфигурации. Если запрещено, то отображается код вместо исполнения.

Плагины Синтаксиса

Синтакс DokuWiki может быть расширен Плагинами. Как использовать установленные плагины описано на их соответствующих. Следующий синтакс доступен в этой частной установке:

1) Это сноска
 
wiki/syntax.txt · Последние изменения: 2006/08/29 11:30 От romtek
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki