wiki:syntax
Различия
Показаны различия между двумя версиями страницы.
— | wiki:syntax [2020/10/02 17:52] (текущий) – создано - внешнее изменение 127.0.0.1 | ||
---|---|---|---|
Строка 1: | Строка 1: | ||
+ | ====== Синтаксис форматирования ====== | ||
+ | «Докувики» поддерживает простой язык разметки, | ||
+ | |||
+ | ===== Основные конструкции форматирования ===== | ||
+ | |||
+ | «Докувики» поддерживает выделение текста **жирным шрифтом**, | ||
+ | |||
+ | < | ||
+ | «Докувики» поддерживает выделение текста **жирным шрифтом**, | ||
+ | __подчёркнутый текст__ и вывод текста '' | ||
+ | Все эти конструкции можно **__//'' | ||
+ | </ | ||
+ | |||
+ | Также можно использовать < | ||
+ | |||
+ | < | ||
+ | Также можно использовать < | ||
+ | </ | ||
+ | |||
+ | Ещё можно < | ||
+ | |||
+ | < | ||
+ | Ещё можно < | ||
+ | </ | ||
+ | |||
+ | **Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, | ||
+ | |||
+ | Просто текст с разрывом строк\\ Обратите внимание, | ||
+ | что два обратных слэша действуют только в конце строки\\ | ||
+ | или если за ними стоит\\ пробел. Если его не поставить, | ||
+ | |||
+ | < | ||
+ | что два обратных слэша действуют только в конце строки\\ | ||
+ | или если за ними стоит\\ пробел. Если его не поставить, | ||
+ | </ | ||
+ | |||
+ | Принудительные переносы следует использовать только в случае крайней необходимости. | ||
+ | |||
+ | ===== Ссылки ===== | ||
+ | |||
+ | Ссылки в «Докувики» бывают разные и создавать их можно тоже по-разному. | ||
+ | |||
+ | ==== Внешние ==== | ||
+ | |||
+ | Внешние ссылки распознаются автоматически: | ||
+ | просто www.google.com --- также можно указывать текст ссылки: | ||
+ | [[http:// | ||
+ | тоже распознаются: | ||
+ | |||
+ | < | ||
+ | просто www.google.com --- также можно указывать текст ссылки: | ||
+ | [[http:// | ||
+ | тоже распознаются: | ||
+ | |||
+ | ==== Внутренние ==== | ||
+ | |||
+ | Внутренние ссылки создаются посредством квадратных скобок. | ||
+ | Можно либо просто указать [[ru: | ||
+ | дополнительно прописать [[ru: | ||
+ | вики-статей автоматически | ||
+ | спецсимволы использовать нельзя. | ||
+ | |||
+ | < | ||
+ | Можно либо просто указать [[ru: | ||
+ | дополнительно прописать [[ru: | ||
+ | вики-статей автоматически | ||
+ | спецсимволы использовать нельзя.</ | ||
+ | |||
+ | Можно использовать в ссылке [[ru: | ||
+ | |||
+ | < | ||
+ | |||
+ | Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, | ||
+ | |||
+ | < | ||
+ | |||
+ | Примечания: | ||
+ | |||
+ | * Ссылки на [[wiki: | ||
+ | * «Докувики» по умолчанию не использует [[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: |
wiki/syntax.txt · Последнее изменение: 2020/10/02 17:52 — 127.0.0.1