Полезная информация

Список ответов на каверзные вопросы можно получить в FAQ-разделе форума.
 

Синтаксис форматирования

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

  • Эта страница содержит весь синтаксис, который вы можете использовать для оформления статей.
  • Более простое решение для оформления доступно через quickbuttons.
  • Для комфортного форматирования текста в Wiki используйте расширение WikiCode.

Вы можете посмотреть исходный текст страницы нажав кнопку Показать исходный текст сверху или снизу страницы. Редатировать статью можно нажав кнопку Редактировать. Если вы хотите проверить что-то, используйте страницу playground.

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

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

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

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

Вы можете также использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> текст.

Ещё вы можете пометить что-то как зачёркнутое.

Ещё вы можете пометить что-то как <del>зачёркнутое</del>.

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

Это текст написан в несколько строк. Помните, что только два бэкслеша стоящих в конце строки или с имеющимся после них пробелом опознаются как начало новой строки

Это текст написан в несколько строк. Помните, что 
только два бэкслеша стоящих в конце строки или с 
имеющимся после них пробелом опознаются как начало новой строки

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

Ссылки

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

Внешние

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

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

Внутренние

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

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

Вы можете использовать namespaces с помощью ссылки на страницу с двоеточиями. В MozillaWiki такие ссылки лучше не использовать, т.к. в этом случае возможны только английские названия ссылок.

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

Информацию про namespaces вы можете найти на wiki:namespaces.

Ссылки на отдельную секцию страницы также возможны. Всего лишь добавьте название секции после символа # известного из HTML. Это ссылка на эту секцию.

Это ссылка на [[syntaxru#5|эту секцию]].

Секции, названия которых состоят из не-ASCII символов последовательно нумеруются начиная с 1. Если название секции состоит из ASCII символов (не содержит киррилицу), то ссылка выглядит так:

 [[syntaxru#name_of_section|....]]

Пробелы в названии секции заменяются на знак подчёркивания.

Примечания:

  • Ссылки на существующие страницы отображаются в стиле отличном от несуществующих.
  • DokuWiki не использует CamelCase для автоматического создания ссылок по умолчанию, но это настраивается в файле config. Хинт: Если DokuWiki - ссылка, значит CamelCase включён.
  • Когда название секции меняется, ссылка на неё тоже меняется. Так что не злоупотребляйте ссылками на секции.

Interwiki

DokuWiki поддерживает ссылки на wiki:interwiki. Это быстрые ссылки на другие Wiki. Для примера вот ссылка на страницу Wikipedia о Wiki: Wiki.

DokuWiki поддерживает ссылки на [[doku>wiki:interwiki]]. Это быстрые ссылки
на другие Wiki. Для примера вот линк на страницу Wikipedia о Wiki:  [wp>Wiki]].

Windows Shares

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

Windows shares, например [[servershare|это]] тоже поддерживаются.

Примечания:

  • По причинам безопасности прямой просмотр windows shares возможен по умолчанию только в Microsoft Internet Explorer’e (и только в “local zone” (местная интрасеть, локальная зона)).
  • В Mozilla и Firefox это можно включить через параметр security.checkloaduri, но делать это не рекомендуется
  • Смотрите 151 для большей информации

Ссылки на изображениях

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

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

Пожалуйста, учтите: Форматирование изображений - единственный синтаксис форматирования, разрешённый в ссылках.

Сноски

Вы можете добавлять сноски1) используя двойные круглые скобки.

Вы можете добавлять сноски ((Это сноска)) используя двойные круглые скобки.

Структурирование

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

Заголовок 3

Заголовок 4

Заголовок 5
==== Заголовок 3 ====
=== Заголовок 4 ===
== Заголовок 5 ==

Используя четыре или более дефиса, вы можете создать горизонтальную линию:


Изображения и другие файлы

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

Реальный размер:

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

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

Внешнее изображение с изменённым размером:

Реальный размер:                        {{wiki:php-powered.png}}
Изменение размера до заданной ширины:             {{wiki:php-powered.png?100}}
Изменение размера до заданной ширины и высоты: {{wiki:php-powered.png?100x100}}
Внешнее изображение с изменённым размером:           {{http://de3.php.net/images/php.gif?100x100}}

Используя пробелы справа и слева вы можете выровнять изображение на странице

{{ wiki:php-powered.png}}
{{wiki:php-powered.png }}
{{ wiki:php-powered.png }}

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

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

Если вы укажете имя файла, который не является изображением (gif,jpeg,png), он отобразится как ссылка.

Списки

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

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

  - Такой же список, но упорядоченный
  - Ещё пункт
    - Используйте отступ для более глубоких уровней
  - Вот так

Эмотиконы

DokuWiki конвертирует часто используемые emoticonы в графическую форму. Дополнительные смайлики могут быть помещены в директорию smiley и настроены в файле conf/smileys.conf. Вот обзор смайликов включённых в DokuWiki.

  • :) :)
  • =) =)
  • :| :|
  • =| =|
  • :( :(
  • =( =(
  • :D :D
  • =D =D
  • :o :o
  • :O :O
  • ;) ;)
  • :/ :/
  • :P :P
  • :lol: :lol:
  • :mad: :mad:
  • :rolleyes: :rolleyes:
  • :cool: :cool:

Типография

DokuWiki может конвертировать простые текстовые символы в их типографически корректные сущности. Это примеры опознаваемых символов.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “Он подумал ‘Это мужской мир’…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"Он подумал 'Это мужской мир'..."

Пожалуйста, учтите: Эта замена может быть отключена в файле конфигурации.

Таблицы

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

Заголовок 1 Заголовок 2 Заголовок 3
Строка 1 Столбец 1 Строка 1 Столбец 2 Строка 1 Столбец 3
Строка 2 Столбец 1 двойной столбец
Строка 3 Столбец 1 Строка 2 Столбец 2 Строка 2 Столбец 3

Строки таблицы должны начинаться и заканчиваться символом | для обычных строк и ^ для заголовков.

^ Заголовок 1       ^ Заголовок 2       ^ Заголовок 3       ^
| Строка 1 Столбец 1| Строка 1 Столбец 2| Строка 1 Столбец 3|
| Строка 2 Столбец 1| Объединение столбцов                 ||
| Строка 3 Столбец 1| Строка 2 Столбец 2| Строка 2 Столбец 3|

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

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

Заголовок 1 Заголовок 2
Заголовок 3 Строка 1 Столбец 2 Строка 1 Столбец 3
Заголовок 4 Нет объединения столбцов
Заголовок 5 Строка 2 Столбец 2 Строка 2 Столбец 3

Как вы видите, здесь есть разделитель ячеек перед ячейкой, что определяется форматированием:

|              ^ Заголовок 1              ^ Заголовок 2        ^
^ Заголовок 3  | Строка 1 Столбец 2       | Строка 1 Столбец 3 |
^ Заголовок 4  | Нет объединения столбцов |                    |
^ Заголовок 5  | Строка 2 Столбец 2       | Строка 2 Столбец 3 |

Примечание: Объединение вертикальных ячеек невозможно.

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

Таблица с выравниванием
справа по центр слева
слева справа по центру
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

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

^           Таблица с выравниванием             ^^^
|          справа|     по центру     |слева            |
|слева           |             справа|    по центру    |
| xxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxx | xxxxxxxxxxxxxxx |

Неформатированые блоки

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

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

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

Это текст, в котором есть адрес: http://www.splitbrain.org и **форматирование**, но с ним ничего не произошло.

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

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

DokuWiki может “подсвечивать” исходные коды, что делает их более удобными для чтения. DokuWiki использует для этого GeSHi Generic Syntax Highlighter – то есть, поддерживается подсветка любого языка, поддерживаемого GeSHi. Для подсветки синтаксиса используется тег code с указанием строки, идентифицирующей язык. Например: <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, ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, nsis, objc, oobas, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml

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

Вы можете внедрять код HTML или PHP в Ваши документы, используя теги html или php примерно так:

<html>
This is some <font color="red" size="+1">HTML</font>
</html>
This is some <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 запрещено конфигурацией по умолчанию. Если внедрение кода HTML и PHP запрещено, код просто отображается вместо выполнения.

1) Это сноска
 
  wiki/syntaxru.txt · Последние изменения: 2006/05/28 00:17
 

Board footer

Powered by PunBB
Modified by Mozilla Russia
Copyright © 2004–2011 Mozilla Russia
Язык отображения форума: [Русский] [English]