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

Инструменты сайта



wiki/разметка

Разметка

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

Основные конструкции форматирования

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]]. Адреса электронной почты
тоже распознаются: <[email protected]>.

Внутренние

Внутренние ссылки создаются посредством квадратных скобок. Можно либо просто указать имя_страницы, либо дополнительно прописать Текст ссылки. Имена Wiki-страниц автоматически переводятся в нижний регистр, спецсимволы использовать нельзя.

Внутренние ссылки создаются посредством квадратных скобок.
Можно либо просто указать [[имя_страницы]], либо дополнительно прописать
[[имя_страницы|Текст ссылки]]. Имена Wiki-страниц автоматически 
переводятся в нижний регистр, спецсимволы использовать нельзя.

Можно использовать в ссылке вложенные_папки (они же namespaces, пространства имён), указывая их через двоеточие.

Можно использовать в ссылке [[вложенные_папки]]
(они же namespaces, пространства имён),
указывая их через двоеточие.

Ставить ссылки на определённый раздел статьи тоже можно. Просто добавьте через решётку имя раздела, также как это делается в HTML. Ссылка на этот раздел.

Ссылка на [[разметка#внутренние|этот раздел]].

Примечания:

  • Ссылки на существующие страницы отображаются иначе, чем ссылки на несуществующие_страницы
  • Внутренние ссылки без указанного текста могут отображаться по разному в зависимости от настроек - в качестве текста может использоваться название страницы или заголовок первого уровня1). Так что лучше каждый раз указывать текст ссылки.
  • Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.

Интервики

DokuWiki поддерживает Интервики-ссылки. Это короткие ссылки на другие Wiki. Например, вот ссылка на страницу Википедии о Wiki: Wiki.

Например, вот ссылка на страницу Википедии о Wiki: [[wp>Wiki]].

Сетевые ресурсы Windows

Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном Интранете.

Ссылки на виндовые шары вида \\server\share тоже распознаются.

Примечания:

  • Из соображений безопасности непосредственный просмотр виндовых шар работает по умолчанию только в Internet Explorer (и только в “локальной зоне”).
  • В Mozilla и Firefox эту возможность можно включить с помощью опции security.checkloaduri, но делать это не рекомендуется.
  • Подробней читайте здесь: 151.

Картинки-ссылки

Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:

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

Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.

Сноски

С помощью двойных скобок можно добавить сноску2).

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

Разбивка на разделы

Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков 3-го уровня и выше, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку ~~NOTOC~~.

Заголовок 3-го уровня

Заголовок 4-го уровня

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

Четыре и более тире преобразуются в горизонтальную черту:



----

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

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

Нормальный размер:

Отмасштабированная до заданной ширины:

Отмасштабированная до заданных размеров:

Отмасштабированная внешняя картинка:

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

Поставив слева или справа пробел можно задать выравнивание картинки:

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

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

Название картинки

{{:: dokuwiki-128.png |Название картинки}}

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

Списки

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

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

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

Смайлики

DokuWiki преобразует наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию smiley и внести изменения в файл 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 может переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы.

→ ← ↔ ⇒ ⇐ ⇔ » « – — '640×480' © ™ ®
«Владимир Владимирович™ — это наше всё © не я»

-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r)
"Владимир Владимирович(tm) --- это наше всё (c) не я"

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

%%"%% или ''%%"%%''

Цитирование

Иногда нужно пометить некоторый текст в качестве ответа или комментария. Для этого можно использовать следующий синтаксис:

Я думаю, мы должны это сделать.
> Нет, мы не должны.
>> Ну, я говорю, что мы должны.
> Действительно?
>> Да!
>>> Тогда сделаем это!

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

Нет, мы не должны.
Ну, я говорю, что мы должны.

Действительно?

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

Таблицы

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  |

Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий ::: в объединяемые нижележащие ячейки.

Заголовок 1 Заголовок 2 Заголовок 3
Ряд 1 Колонка 1 эта ячейка объединена вертикально Ряд 1 Колонка 3
Ряд 2 Колонка 1 Ряд 2 Колонка 3
Ряд 3 Колонка 1 Ряд 2 Колонка 3

В этих ячейках не должно быть ничего, кроме синтаксиса объединения (:::).

^ Заголовок 1        ^ Заголовок 2                       ^ Заголовок 3            ^
| Ряд 1 Колонка 1    | эта ячейка объединена вертикально | Ряд 1 Колонка 3        |
| Ряд 2 Колонка 1    | :::                               | Ряд 2 Колонка 3        |
| Ряд 3 Колонка 1    | :::                               | Ряд 2 Колонка 3        |

Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа – если надо выравнять влево, и по два с каждой стороны — если по центру.

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

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

Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги <code> или <file>. При этом пробелы в начале строки являются эквивалентом применения тега <code> к одной строке, но без подсветки кода. Если несколько подряд идущих строк начинаются более чем с одного пробела, они объединяются в один блок <code>.

Пример использования <code>..</code>.

Это неформатированный текст, в котором сохранены все пробелы: вот             <- так.

Пример использования <file>..</file>.

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

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

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

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

Чтобы увидеть, как используются эти блоки, смотрите код страницы.

Скачиваемые блоки кода

Используя тэги <code> или <file>, как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так:

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>
myexample.php
<?php echo "hello world!"; ?>

Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (-) на месте кода языка: <code - myfile.foo>.

Управляющие макросы

Некоторый синтаксис влияет на то, как «ДокуВики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:

Макрос Описание
~~NOTOC~~ Если этот макрос присутствует в статье, оглавление не будет создано.
~~NOCACHE~~ «ДокуВики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, если включить некоторые расширенные возможности); добавление этого макроса заставит «ДокуВики» обрабатывать статью при каждом вызове.

Заметки

Плагин Note позволяет легко оформлять всевозможные комментарии и заметки:

Простая заметка

Важная

Предупреждение

Подсказка

<note>Простая заметка</note>
<note important>Важная</note>
<note warning>Предупреждение</note>
<note tip>Подсказка</note>

Форматирование с плагином Wrap

Выделения текста и блоки

Теги <wrap> и <WRAP> позволяют присваивать тексту некоторые предопределённые свойства - например, можно подсвечивать текст, отображать его как менее важный и как особенно важный.

<wrap hi>можно подсвечивать текст</wrap>,
<wrap lo>отображать его как менее важный</wrap>
<wrap em>и как особенно важный</wrap>.

Тег <wrap> (строчными буквами) действует на текст прямо в строке (подобно span и inline в языке html).

Тег <WRAP> (заглавными буквами) оформляет текст в виде отдельного блока с данными свойствами (как div в языке html).

Например, чтобы создать блок определённого класса, пишем

<WRAP имя_класса> ...здесь текст... </WRAP>

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

Цвета фона

Можно, таким образом, задавать некоторые цвета фона:


Цвет фона розово-лавандовый (#FFF0F5, LavenderBlush)


<WRAP fff0f5>
----

Цвет фона розово-лавандовый (#FFF0F5, LavenderBlush)

----
</WRAP>

В данный момент на этом сайте определены следующие 30 классов (цветовых стилей) для фона (не считая стилей Wrap для выделения, для особых блоков и т.п.):


FFFFFF White


F5FFFA MintCream


F0FFFF Azure


F0FFF0 Honeydew


F8F8FF GhostWhite


F0F8FF AliceBlue


F5F5F5 WhiteSmoke


E0FFFF LightCyan


E6E6FA Lavender


FFF0F5 LavenderBlush


FFE4E1 MistyRose


DCDCDC Gainsboro


D3D3D3 LightGrey


FFDEAD NavajoWhite


F5DEB3 Wheat


FFFAFA Snow


FFFFF0 Ivory


FFFAF0 FloralWhite


FFFFE0 LightYellow


FFFACD LemonChiffon


FFF8DC Cornsilk


FFF5EE Seashell


FAFAD2 LightGoldenrod


FAF0E6 Linen


FDF5E6 OldLace


F5F5DC Beige


FFEFD5 PapayaWhip


FFEBCD BlanchedAlmond


FAEBD7 AntiqueWhite


FFE4C4 Bisque

Названия этих классов состоят из 6 символов соответствующего букво-цифрового цветового кода: ffffff для белого цвета, f5f5f5 для цвета «белый дым» и т.д. Английские названия цветов приведены только для информации и именами этих классов не являются.

Применение: - бежевый фон -.

<wrap f5f5dc>- бежевый фон -</wrap>

Подробности

Можно также форматировать текст в колонки, задавать отступы и т.д. Подробнее возможности плагина Wrap изображены здесь: примеры использования

Интеграция с RSS/ATOM фидами

DokuWiki может отображать на своих страницах данные из внешних XML-фидов. Для парсинга XML-фидов используется библиотека SimplePie, соответственно, все форматы, распознаваемые этой библиотекой поддерживаются в DokuWiki. Вывод информации можно настроить, используя следующие параметры (параметры надо разделять пробелами):

Параметр Описание
любое число максимальное кол-во отображаемых элементов, по умолчанию - 8
reverse вывести список новостей в обратном порядке - самые старые записи выводятся первыми
author показывать имена авторов (если указаны в фиде)
date показывать даты записей (если указаны в фиде)
description показывать описание записи. Если в настройках DokuWiki выключено отображение HTML кодов, то из описания будут удалены все HTML коды
n[dhm] период обновления фида, где d=дни, h=часы, m=минуты. (т.е. 12h = 12 часов, а 2d = 2 дня).

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

Пример:

{{rss>http://wsrss.bbc.co.uk/russian/index.xml 7 author date 10h }}

Дополнительное форматирование (синтаксические плагины)

Синтаксис «ДокуВики» может быть расширен за счёт плагинов. Как их устанавливать и использовать — описывается на страницах описания. На этом сайте установлены следующие модули, которые расширяют стандартное форматирование DokuWiki:

1) именно такая настройка используется на этом сайте
2) Это сноска
Только авторизованные участники могут оставлять комментарии.

Боковая панель

Zen-Do.Ru

Инструкция | Разметка

Песочница | Руководство