wiki:syntax
Различия
Показаны различия между двумя версиями страницы.
| Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия | ||
| wiki:syntax [2022/12/22 13:04] – Михаил Яковлев | wiki:syntax [2025/09/09 22:14] (текущий) – внешнее изменение 127.0.0.1 | ||
|---|---|---|---|
| Строка 1: | Строка 1: | ||
| - | ====== Плагин WRAP ====== | ||
| - | https:// | ||
| - | |||
| - | ====== Синтаксис форматирования ====== | ||
| - | |||
| - | «Докувики» поддерживает простой язык разметки, | ||
| - | |||
| - | ===== Основные конструкции форматирования ===== | ||
| - | |||
| - | «Докувики» поддерживает выделение текста **жирным шрифтом**, | ||
| - | |||
| - | < | ||
| - | «Докувики» поддерживает выделение текста **жирным шрифтом**, | ||
| - | __подчёркнутый текст__ и вывод текста '' | ||
| - | Все эти конструкции можно **__//'' | ||
| - | </ | ||
| - | |||
| - | Также можно использовать < | ||
| - | |||
| - | < | ||
| - | Также можно использовать < | ||
| - | </ | ||
| - | |||
| - | Ещё можно < | ||
| - | |||
| - | < | ||
| - | Ещё можно < | ||
| - | </ | ||
| - | |||
| - | **Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, | ||
| - | |||
| - | Просто текст с разрывом строк\\ Обратите внимание, | ||
| - | что два обратных слэша действуют только в конце строки\\ | ||
| - | или если за ними стоит\\ пробел. Если его не поставить, | ||
| - | |||
| - | < | ||
| - | что два обратных слэша действуют только в конце строки\\ | ||
| - | или если за ними стоит\\ пробел. Если его не поставить, | ||
| - | </ | ||
| - | |||
| - | Принудительные переносы следует использовать только в случае крайней необходимости. | ||
| - | |||
| - | ===== Ссылки ===== | ||
| - | |||
| - | Ссылки в «Докувики» бывают разные и создавать их можно тоже по-разному. | ||
| - | |||
| - | ==== Внешние ==== | ||
| - | |||
| - | Внешние ссылки распознаются автоматически: | ||
| - | просто www.google.com --- также можно указывать текст ссылки: | ||
| - | [[http:// | ||
| - | тоже распознаются: | ||
| - | |||
| - | < | ||
| - | просто www.google.com --- также можно указывать текст ссылки: | ||
| - | [[http:// | ||
| - | тоже распознаются: | ||
| - | |||
| - | ==== Внутренние ==== | ||
| - | |||
| - | Внутренние ссылки создаются посредством квадратных скобок. | ||
| - | Можно либо просто указать [[ru: | ||
| - | дополнительно прописать [[ru: | ||
| - | вики-статей автоматически | ||
| - | спецсимволы использовать нельзя. | ||
| - | |||
| - | < | ||
| - | Можно либо просто указать [[ru: | ||
| - | дополнительно прописать [[ru: | ||
| - | вики-статей автоматически | ||
| - | спецсимволы использовать нельзя.</ | ||
| - | |||
| - | Можно использовать в ссылке [[ru: | ||
| - | |||
| - | < | ||
| - | |||
| - | Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, | ||
| - | |||
| - | < | ||
| - | |||
| - | Примечания: | ||
| - | |||
| - | * Ссылки на [[ru: | ||
| - | * «Докувики» по умолчанию не использует [[wp> | ||
| - | * Если меняется название раздела, | ||
| - | * Ссылки на разделы делаются именно на [[# | ||
| - | |||
| - | ==== Интервики ==== | ||
| - | |||
| - | «Докувики» поддерживает [[ru: | ||
| - | на другие вики. Например, | ||
| - | |||
| - | < | ||
| - | на другие вики. Например, | ||
| - | </ | ||
| - | |||
| - | ==== Сетевые ресурсы Windows ==== | ||
| - | |||
| - | Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, | ||
| - | |||
| - | < | ||
| - | |||
| - | Примечания: | ||
| - | |||
| - | * Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»). | ||
| - | * В браузерах Mozilla эту возможность можно включить с помощью опции [[http:// | ||
| - | * Подробней читайте здесь: [[bug> | ||
| - | |||
| - | ==== Картинки-ссылки ==== | ||
| - | |||
| - | Совместив синтаксис ссылки и [[# | ||
| - | |||
| - | < | ||
| - | |||
| - | [[http:// | ||
| - | |||
| - | Учтите: | ||
| - | |||
| - | ==== Сноски ==== | ||
| - | |||
| - | С помощью двойных скобок можно добавить сноску((Сноска — помещаемые внизу страницы примечание, | ||
| - | |||
| - | < | ||
| - | помещаемые внизу страницы примечание, | ||
| - | |||
| - | ===== Разбивка на разделы ===== | ||
| - | |||
| - | Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, | ||
| - | |||
| - | |||
| - | ==== Заголовок 3 уровня ==== | ||
| - | === Заголовок 4 уровня === | ||
| - | == Заголовок 5 уровня == | ||
| - | |||
| - | < | ||
| - | === Заголовок 4 уровня === | ||
| - | == Заголовок 5 уровня ==</ | ||
| - | |||
| - | Четыре и более тире преобразуются в горизонтальную черту: | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ===== Картинки и другие файлы ===== | ||
| - | |||
| - | См. также: «[[ru: | ||
| - | |||
| - | С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[ru: | ||
| - | |||
| - | Нормальный размер: | ||
| - | |||
| - | Отмасштабированная до заданной ширины: | ||
| - | |||
| - | Отмасштабированная до заданных размеров: | ||
| - | |||
| - | Отмасштабированная внешняя картинка: | ||
| - | |||
| - | < | ||
| - | Нормальный размер: | ||
| - | Отмасштабированная до заданной ширины: | ||
| - | Отмасштабированная до заданных размеров: | ||
| - | Отмасштабированная внешняя картинка: | ||
| - | </ | ||
| - | |||
| - | Поставив слева или справа пробел, | ||
| - | |||
| - | {{wiki: | ||
| - | {{ wiki: | ||
| - | {{ wiki: | ||
| - | |||
| - | < | ||
| - | {{ wiki: | ||
| - | {{ wiki: | ||
| - | </ | ||
| - | |||
| - | И, конечно, | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | < | ||
| - | |||
| - | Если задать имя файла (внутреннее или внешнее), | ||
| - | |||
| - | Узнать, | ||
| - | |||
| - | ===== Списки ===== | ||
| - | |||
| - | «Докувики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, | ||
| - | |||
| - | * Первый элемент маркированного списка | ||
| - | * Второй элемент списка | ||
| - | * Можно сделать вложенный список | ||
| - | * Ещё один элемент | ||
| - | |||
| - | - Тот же список, | ||
| - | - Ещё элемент | ||
| - | - Чем больше пробелов в начале, | ||
| - | - Всё просто | ||
| - | |||
| - | < | ||
| - | * Первый элемент маркированного списка | ||
| - | * Второй элемент списка | ||
| - | * Можно сделать вложенный список | ||
| - | * Ещё один элемент | ||
| - | |||
| - | - Тот же список, | ||
| - | - Ещё элемент | ||
| - | - Чем больше пробелов в начале, | ||
| - | - Всё просто | ||
| - | </ | ||
| - | |||
| - | См. также [[ru: | ||
| - | |||
| - | ===== Смайлики ===== | ||
| - | |||
| - | «Докувики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию '' | ||
| - | |||
| - | * 8-) %%8-)%% | ||
| - | * 8-O %%8-O%% | ||
| - | * :-( %%:-(%% | ||
| - | * :-) %%:-)%% | ||
| - | * =) %%=)%% | ||
| - | * :-/ %%:-/%% | ||
| - | * :-\ %%:-\%% | ||
| - | * :-? %%:-?%% | ||
| - | * :-D %%:-D%% | ||
| - | * :-P %%:-P%% | ||
| - | * :-O %%:-O%% | ||
| - | * :-X %%:-X%% | ||
| - | * :-| %%:-|%% | ||
| - | * ;-) %%;-)%% | ||
| - | * ^_^ %%^_^%% | ||
| - | * :?: %%:?:%% | ||
| - | * :!: %%:!:%% | ||
| - | * LOL %%LOL%% | ||
| - | * FIXME %%FIXME%% | ||
| - | * DELETEME %%DELETEME%% | ||
| - | |||
| - | ===== Типографские символы ===== | ||
| - | |||
| - | «Докувики» может переделывать символы, | ||
| - | |||
| - | -> <- <-> => <= <=> >> << -- --- ' | ||
| - | " | ||
| - | |||
| - | < | ||
| - | -> <- <-> => <= <=> >> << -- --- ' | ||
| - | " | ||
| - | </ | ||
| - | |||
| - | Примечание: | ||
| - | |||
| - | ===== Таблицы ===== | ||
| - | |||
| - | «Докувики» поддерживает упрощённый синтаксис создания таблиц. | ||
| - | |||
| - | ^ Заголовок 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 | эта ячейка объединена вертикально | ||
| - | | Ряд 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 | | ||
| - | |||
| - | Примечание: | ||
| - | |||
| - | ===== Неформатируемые блоки ===== | ||
| - | |||
| - | Неформатируемые блоки можно вставлять в документ, | ||
| - | |||
| - | < | ||
| - | |||
| - | < | ||
| - | |||
| - | Чтобы парсер полностью проигнорировал некий текст (т. е. не форматировал его), либо заключите его в тэги '' | ||
| - | |||
| - | Это просто текст, в котором есть адрес %%http:// | ||
| - | и %%**форматирование**%% --- но ничего не происходит. | ||
| - | |||
| - | < | ||
| - | и %%**форматирование**%% --- но ничего не происходит.</ | ||
| - | |||
| - | Чтобы увидеть, | ||
| - | |||
| - | ===== Подсветка синтаксиса ===== | ||
| - | |||
| - | «Докувики» может подсвечивать программный код, чтобы его было проще читать. Для этого используется библиотека [[http:// | ||
| - | |||
| - | <code java> | ||
| - | /** | ||
| - | * The HelloWorldApp class implements an application that | ||
| - | * simply displays "Hello World!" | ||
| - | */ | ||
| - | class HelloWorldApp { | ||
| - | public static void main(String[] args) { | ||
| - | System.out.println(" | ||
| - | } | ||
| - | } | ||
| - | </ | ||
| - | |||
| - | На данный момент распознаются следующие языки: 4cs, 6502acme, | ||
| - | |||
| - | ==== Скачиваемые блоки кода ==== | ||
| - | |||
| - | Используя тэги '' | ||
| - | |||
| - | < | ||
| - | <file php myexample.php> | ||
| - | <?php echo "hello world!"; | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <file php myexample.php> | ||
| - | <?php echo "hello world!"; | ||
| - | </ | ||
| - | |||
| - | Если вам не нужна подсветка, | ||
| - | |||
| - | **Особенность: | ||
| - | <file php " | ||
| - | <?php echo "hello world!"; | ||
| - | </ | ||
| - | |||
| - | ===== Вставка HTML и PHP ===== | ||
| - | |||
| - | Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов '' | ||
| - | |||
| - | <code html> | ||
| - | < | ||
| - | Тут вставлен <font color=" | ||
| - | </ | ||
| - | |||
| - | < | ||
| - | <p style=" | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | Получается: | ||
| - | |||
| - | < | ||
| - | Тут вставлен <font color=" | ||
| - | </ | ||
| - | |||
| - | < | ||
| - | <p style=" | ||
| - | </ | ||
| - | |||
| - | ---- | ||
| - | |||
| - | < | ||
| - | <php> | ||
| - | echo ' | ||
| - | echo phpversion(); | ||
| - | echo ' (прямая вставка в HTML).'; | ||
| - | </ | ||
| - | |||
| - | <PHP> | ||
| - | echo '< | ||
| - | echo '< | ||
| - | echo '</ | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | Получается: | ||
| - | |||
| - | <php> | ||
| - | echo ' | ||
| - | echo phpversion(); | ||
| - | echo ' (прямая вставка в HTML).'; | ||
| - | </ | ||
| - | |||
| - | <PHP> | ||
| - | echo '< | ||
| - | echo '< | ||
| - | echo '</ | ||
| - | </ | ||
| - | |||
| - | **Примечание: | ||
| - | |||
| - | ===== RSS/ATOM Feed Aggregation ===== | ||
| - | |||
| - | [[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http:// | ||
| - | |||
| - | ^ Параметр | ||
| - | | any number | will be used as maximum number items to show, defaults to 8 | | ||
| - | | reverse | ||
| - | | author | ||
| - | | date | show item dates | | ||
| - | | description| show the item description. If [[doku> | ||
| - | | nosort | ||
| - | | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | | ||
| - | |||
| - | The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki: | ||
| - | |||
| - | By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the '' | ||
| - | |||
| - | **Example: | ||
| - | |||
| - | {{rss> | ||
| - | |||
| - | {{rss> | ||
| - | |||
| - | |||
| - | ===== Управляющие макросы ===== | ||
| - | |||
| - | Некоторый синтаксис влияет на то, как «Докувики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы: | ||
| - | |||
| - | ^ Макрос | ||
| - | | %%~~NOTOC~~%% | ||
| - | | %%~~NOCACHE~~%% | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, | ||
| - | |||
| - | ===== Синтаксические плагины ===== | ||
| - | |||
| - | Синтаксис «Докувики» может быть расширен за счёт [[ru: | ||
| - | |||
| - | ~~INFO: | ||
| - | |||
| - | |||
| - | |||
| - | ---- | ||
| - | |||
| - | ---- | ||
| - | |||
| ====== Formatting Syntax ====== | ====== Formatting Syntax ====== | ||
| Строка 605: | Строка 137: | ||
| Resize to given width and height((when the aspect ratio of the given width and height doesn' | Resize to given width and height((when the aspect ratio of the given width and height doesn' | ||
| - | Resized external image: {{https://secure.php.net/ | + | Resized external image: {{https://www.php.net/ |
| Real size: {{wiki: | Real size: {{wiki: | ||
| Resize to given width: | Resize to given width: | ||
| Resize to given width and height: {{wiki: | Resize to given width and height: {{wiki: | ||
| - | Resized external image: {{https://secure.php.net/ | + | Resized external image: {{https://www.php.net/ |
| Строка 905: | Строка 437: | ||
| If you don't want any highlighting but want a downloadable file, specify a dash ('' | If you don't want any highlighting but want a downloadable file, specify a dash ('' | ||
| - | |||
| - | |||
| - | ===== Embedding HTML and PHP ===== | ||
| - | |||
| - | You can embed raw HTML or PHP code into your documents by using the '' | ||
| - | |||
| - | HTML example: | ||
| - | |||
| - | < | ||
| - | < | ||
| - | This is some <span style=" | ||
| - | </ | ||
| - | < | ||
| - | <p style=" | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | < | ||
| - | This is some <span style=" | ||
| - | </ | ||
| - | < | ||
| - | <p style=" | ||
| - | </ | ||
| - | |||
| - | PHP example: | ||
| - | |||
| - | < | ||
| - | <php> | ||
| - | echo 'The PHP version: '; | ||
| - | echo phpversion(); | ||
| - | echo ' (generated inline HTML)'; | ||
| - | </ | ||
| - | <PHP> | ||
| - | echo '< | ||
| - | echo '< | ||
| - | echo '</ | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <php> | ||
| - | echo 'The PHP version: '; | ||
| - | echo phpversion(); | ||
| - | echo ' (inline HTML)'; | ||
| - | </ | ||
| - | <PHP> | ||
| - | echo '< | ||
| - | echo '< | ||
| - | echo '</ | ||
| - | </ | ||
| - | |||
| - | **Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed. | ||
| ===== RSS/ATOM Feed Aggregation ===== | ===== RSS/ATOM Feed Aggregation ===== | ||
| Строка 965: | Строка 446: | ||
| | author | | author | ||
| | date | show item dates | | | date | show item dates | | ||
| - | | description| show the item description. | + | | description| show the item description. |
| | nosort | | nosort | ||
| | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | | | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | | ||
wiki/syntax.1671703492.txt.gz · Последнее изменение: — Михаил Яковлев