wiki:syntax.my
Различия
Показаны различия между двумя версиями страницы.
| — | wiki:syntax.my [2025/12/06 19:58] (текущий) – создано - внешнее изменение 127.0.0.1 | ||
|---|---|---|---|
| Строка 1: | Строка 1: | ||
| + | ====== Синтаксис форматирования ====== | ||
| + | «Докувики» поддерживает простой язык разметки, | ||
| + | |||
| + | ===== Основные конструкции форматирования ===== | ||
| + | |||
| + | |||
| + | |||
| + | «Докувики» поддерживает выделение текста **жирным шрифтом**, | ||
| + | |||
| + | < | ||
| + | «Докувики» поддерживает выделение текста **жирным шрифтом**, | ||
| + | __подчёркнутый текст__ и вывод текста '' | ||
| + | Все эти конструкции можно **__//'' | ||
| + | </ | ||
| + | |||
| + | Также можно использовать < | ||
| + | |||
| + | < | ||
| + | Также можно использовать < | ||
| + | </ | ||
| + | |||
| + | Ещё можно < | ||
| + | |||
| + | < | ||
| + | Ещё можно < | ||
| + | </ | ||
| + | |||
| + | :!: Цветной текст при установленном плагине Color | ||
| + | |||
| + | < | ||
| + | <color green> | ||
| + | <color blue/ | ||
| + | <color # | ||
| + | <color /# | ||
| + | <color rgb(80%, | ||
| + | <color hsl(120, | ||
| + | </ | ||
| + | |||
| + | и вы увидите что-то вроде этого: | ||
| + | |||
| + | <fc green> | ||
| + | <fc blue/ | ||
| + | <fc # | ||
| + | <fc /# | ||
| + | <fc rgb(80%, | ||
| + | <fc hsl(120, | ||
| + | |||
| + | **Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, | ||
| + | |||
| + | Просто текст с разрывом строк\\ Обратите внимание, | ||
| + | что два обратных слэша действуют только в конце строки\\ | ||
| + | или если за ними стоит\\ пробел. Если его не поставить, | ||
| + | |||
| + | < | ||
| + | что два обратных слэша действуют только в конце строки\\ | ||
| + | или если за ними стоит\\ пробел. Если его не поставить, | ||
| + | </ | ||
| + | |||
| + | Принудительные переносы следует использовать только в случае крайней необходимости. | ||
| + | |||
| + | ===== Ссылки ===== | ||
| + | |||
| + | |||
| + | ==== Внешние ==== | ||
| + | |||
| + | Внешние ссылки распознаются автоматически: | ||
| + | просто www.google.com --- также можно указывать текст ссылки: | ||
| + | [[http:// | ||
| + | тоже распознаются: | ||
| + | |||
| + | < | ||
| + | просто www.google.com --- также можно указывать текст ссылки: | ||
| + | [[http:// | ||
| + | тоже распознаются: | ||
| + | |||
| + | ==== Внутренние ==== | ||
| + | |||
| + | Внутренние ссылки создаются посредством квадратных скобок. | ||
| + | Можно либо просто указать [[wiki: | ||
| + | дополнительно прописать [[wiki: | ||
| + | вики-статей автоматически | ||
| + | спецсимволы использовать нельзя. | ||
| + | |||
| + | < | ||
| + | Можно либо просто указать [[wiki: | ||
| + | дополнительно прописать [[wiki: | ||
| + | вики-статей автоматически | ||
| + | спецсимволы использовать нельзя.</ | ||
| + | |||
| + | Можно использовать в ссылке [[wiki: | ||
| + | |||
| + | < | ||
| + | |||
| + | Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, | ||
| + | |||
| + | < | ||
| + | |||
| + | Примечания: | ||
| + | |||
| + | * Ссылки на [[: | ||
| + | * «Докувики» по умолчанию не использует [[wp> | ||
| + | * Если меняется название раздела, | ||
| + | * Ссылки на разделы делаются именно на [[# | ||
| + | |||
| + | ==== Интервики ==== | ||
| + | |||
| + | «Докувики» поддерживает [[wiki: | ||
| + | на другие вики. Например, | ||
| + | |||
| + | < | ||
| + | на другие вики. Например, | ||
| + | </ | ||
| + | |||
| + | ==== Сетевые ресурсы Windows ==== | ||
| + | |||
| + | Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, | ||
| + | |||
| + | < | ||
| + | |||
| + | Примечания: | ||
| + | |||
| + | * Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»). | ||
| + | * В браузерах Mozilla эту возможность можно включить с помощью опции [[http:// | ||
| + | * Подробней читайте здесь: [[bug> | ||
| + | |||
| + | ==== Картинки-ссылки ==== | ||
| + | |||
| + | Совместив синтаксис ссылки и [[# | ||
| + | |||
| + | < | ||
| + | |||
| + | |||
| + | |||
| + | {{tablelayout? | ||
| + | ^ | ||
| + | |< | ||
| + | Учтите: | ||
| + | |||
| + | ==== Сноски ==== | ||
| + | |||
| + | С помощью двойных скобок можно добавить сноску((Сноска — помещаемые внизу страницы примечание, | ||
| + | |||
| + | < | ||
| + | помещаемые внизу страницы примечание, | ||
| + | |||
| + | ===== Разбивка на разделы ===== | ||
| + | |||
| + | Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, | ||
| + | |||
| + | |||
| + | ==== Заголовок 3 уровня ==== | ||
| + | === Заголовок 4 уровня === | ||
| + | == Заголовок 5 уровня == | ||
| + | |||
| + | < | ||
| + | === Заголовок 4 уровня === | ||
| + | == Заголовок 5 уровня ==</ | ||
| + | |||
| + | Четыре и более тире преобразуются в горизонтальную черту: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== Картинки и другие файлы ===== | ||
| + | |||
| + | См. также: «[[wiki: | ||
| + | |||
| + | С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[wiki: | ||
| + | |||
| + | Нормальный размер: | ||
| + | |||
| + | Отмасштабированная до заданной ширины: | ||
| + | |||
| + | Отмасштабированная до заданных размеров: | ||
| + | |||
| + | Отмасштабированная внешняя картинка: | ||
| + | |||
| + | < | ||
| + | Нормальный размер: | ||
| + | Отмасштабированная до заданной ширины: | ||
| + | Отмасштабированная до заданных размеров: | ||
| + | Отмасштабированная внешняя картинка: | ||
| + | </ | ||
| + | |||
| + | Поставив слева или справа пробел, | ||
| + | |||
| + | {{wiki: | ||
| + | {{ wiki: | ||
| + | {{ wiki: | ||
| + | |||
| + | < | ||
| + | {{ wiki: | ||
| + | {{ wiki: | ||
| + | </ | ||
| + | |||
| + | И, конечно, | ||
| + | |||
| + | {{ wiki: | ||
| + | |||
| + | < | ||
| + | |||
| + | Если задать имя файла (внутреннее или внешнее), | ||
| + | |||
| + | Узнать, | ||
| + | |||
| + | ===== Списки ===== | ||
| + | |||
| + | «Докувики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, | ||
| + | |||
| + | * Первый элемент маркированного списка | ||
| + | * Второй элемент списка | ||
| + | * Можно сделать вложенный список | ||
| + | * Ещё один элемент | ||
| + | |||
| + | - Тот же список, | ||
| + | - Ещё элемент | ||
| + | - Чем больше пробелов в начале, | ||
| + | - Всё просто | ||
| + | |||
| + | < | ||
| + | * Первый элемент маркированного списка | ||
| + | * Второй элемент списка | ||
| + | * Можно сделать вложенный список | ||
| + | * Ещё один элемент | ||
| + | |||
| + | - Тот же список, | ||
| + | - Ещё элемент | ||
| + | - Чем больше пробелов в начале, | ||
| + | - Всё просто | ||
| + | </ | ||
| + | |||
| + | См. также [[wiki: | ||
| + | |||
| + | ===== Смайлики ===== | ||
| + | |||
| + | «Докувики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию '' | ||
| + | * :?: %%:?:%% | ||
| + | * :!: %%:!:%% | ||
| + | |||
| + | |||
| + | ===== Типографские символы ===== | ||
| + | |||
| + | «Докувики» может переделывать символы, | ||
| + | |||
| + | -> <- <-> => <= <=> >> << -- --- ' | ||
| + | " | ||
| + | |||
| + | < | ||
| + | -> <- <-> => <= <=> >> << -- --- ' | ||
| + | " | ||
| + | </ | ||
| + | |||
| + | Примечание: | ||
| + | |||
| + | ===== Таблицы ===== | ||
| + | |||
| + | «Докувики» поддерживает упрощённый синтаксис создания таблиц. | ||
| + | |||
| + | ^ Заголовок 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(" | ||
| + | } | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | |||
| + | ==== Скачиваемые блоки кода ==== | ||
| + | |||
| + | Используя тэги '' | ||
| + | |||
| + | < | ||
| + | <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 '</ | ||
| + | </ | ||
| + | |||
| + | **Примечание: | ||
| + | |||
| + | ===== Вставка HTML страниц ===== | ||
| + | :!: при установленном плагине **htmlok** | ||
| + | |||
| + | <code html> | ||
| + | < | ||
| + | <iframe height=" | ||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | < | ||
| + | <iframe height=" | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | <code html> | ||
| + | < | ||
| + | <iframe height=" | ||
| + | |||
| + | </ | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | < | ||
| + | <iframe height=" | ||
| + | |||
| + | </ | ||
| + | </ | ||
| + | ===== Диаграммы ===== | ||
| + | :!: При установленном плагине diagram | ||
| + | \\ | ||
| + | < | ||
| + | < | ||
| + | | | | Dad |y| Mom | | |Dad=Папа|Mom=Мама | ||
| + | | |, | ||
| + | | Sys | | Me | | Bro |Sys=Сестра|Bro=Брат | ||
| + | | |, | ||
| + | | AAA |-| BBB |AAA=<fc # | ||
| + | | |:| | | | | | | ||
| + | | |L|~|~| CCC |CCC=2< | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | < | ||
| + | | | | Dad |y| Mom | | |Dad=Папа|Mom=Мама | ||
| + | | |, | ||
| + | | Sys | | Me | | Bro |Sys=Сестра|Bro=Брат | ||
| + | | |, | ||
| + | | AAA |-| BBB |AAA=<fc # | ||
| + | | |:| | | | | | | ||
| + | | |L|~|~| CCC |CCC=2< | ||
| + | </ | ||
| + | |||
| + | < | ||
| + | < | ||
| + | | AAA | | | | |F|~|~|~|7| |AAA{border-color: | ||
| + | | |!| | | | | CCC | | DDD |CCC{border-color:# | ||
| + | | BBB | | | | | | | | | | |BBB{border-color: | ||
| + | </ | ||
| + | </ | ||
| + | \\ | ||
| + | < | ||
| + | | AAA | | | | |F|~|~|~|7| |AAA{border-color: | ||
| + | | |!| | | | | CCC | | DDD |CCC{border-color:# | ||
| + | | BBB | | | | | | | | | | |BBB{border-color: | ||
| + | </ | ||
| + | ===== Скрытый текст ===== | ||
| + | |||
| + | :!: При установленном плагине Details Tag | ||
| + | \\ | ||
| + | |||
| + | <code php> | ||
| + | < | ||
| + | < | ||
| + | Скрытый текст | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | < | ||
| + | < | ||
| + | Скрытый текст | ||
| + | </ | ||
| + | |||
| + | <code php> | ||
| + | <details open> | ||
| + | < | ||
| + | Скрытый текст | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | <details open> | ||
| + | < | ||
| + | Скрытый текст | ||
| + | </ | ||
| + | |||
| + | ===== Ширина столбцов таблицы ===== | ||
| + | |||
| + | :!: При установленном плагине Tablelayout | ||
| + | \\ | ||
| + | |||
| + | < | ||
| + | {{tablelayout? | ||
| + | ^ header 1 ^ header 2 ^ | ||
| + | | cell A1 | cell B1 | | ||
| + | | cell A2 | cell B2 | | ||
| + | | cell A3 | cell B3 | | ||
| + | </ | ||
| + | |||
| + | {{tablelayout? | ||
| + | ^ header 1 ^ header 2 ^ | ||
| + | | cell A1 | cell B1 | | ||
| + | | cell A2 | cell B2 | | ||
| + | | cell A3 | cell B3 | | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | ===== RSS/ATOM Feed Aggregation ===== | ||
| + | |||
| + | ===== Агрегация каналов RSS/ATOM ===== | ||
| + | |||
| + | Докувики может интегрировать данные из внешних XML-каналов. Для анализа XML-каналов, | ||
| + | |||
| + | ^ Параметр | ||
| + | | any number | Отображается максимальное количество элиментов, | ||
| + | | reverse | ||
| + | | author | ||
| + | | date | Показывать даты элиментов | | ||
| + | | description| Покажите описание элиментов. Если HTML отключен, | ||
| + | | nosort | ||
| + | | //n//[dhm] | Период обновления, | ||
| + | |||
| + | Период обновления по умолчанию равен 4 часам. Любое значение ниже 10 минут будет рассматриваться как 10 минут. Докувики обычно пытается предоставить кэшированную версию страницы, | ||
| + | |||
| + | По умолчанию лента будет отсортирована по дате, сначала по самым новым элементам. Вы можете сначала отсортировать его по возрасту, | ||
| + | |||
| + | **Пример: | ||
| + | |||
| + | {{rss> | ||
| + | |||
| + | {{rss> | ||
| + | ===== Управляющие макросы ===== | ||
| + | |||
| + | Некоторый синтаксис влияет на то, как «Докувики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы: | ||
| + | |||
| + | ^ Макрос | ||
| + | | %%~~NOTOC~~%% | ||
| + | | %%~~NOCACHE~~%% | «Докувики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, | ||
| + | |||
| + | ===== Синтаксические плагины ===== | ||
| + | |||
| + | Синтаксис «Докувики» может быть расширен за счёт [[wiki: | ||
| + | |||
| + | ~~INFO: | ||
wiki/syntax.my.1692409964.txt.gz · Последнее изменение: (внешнее изменение)
