Показаны различия между двумя версиями страницы.
wiki:syntax [2014/01/27 15:49] mac [Внешние] |
wiki:syntax [2020/10/19 04:48] |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
- | ====== Синтаксис форматирования ====== | ||
- | «ДокуВики» поддерживает простой язык разметки, | ||
- | |||
- | ===== Основные конструкции форматирования ===== | ||
- | |||
- | «ДокуВики» поддерживает выделение текста **жирным шрифтом**, | ||
- | |||
- | < | ||
- | «ДокуВики» поддерживает выделение текста **жирным шрифтом**, | ||
- | __подчёркнутый текст__ и вывод текста '' | ||
- | Все эти конструкции можно **__//'' | ||
- | </ | ||
- | |||
- | Также можно использовать < | ||
- | |||
- | < | ||
- | Также можно использовать < | ||
- | </ | ||
- | |||
- | Ещё можно < | ||
- | |||
- | < | ||
- | Ещё можно < | ||
- | </ | ||
- | |||
- | **Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, | ||
- | |||
- | Просто текст с разрывом строк\\ Обратите внимание, | ||
- | что два обратных слэша действуют только в конце строки\\ | ||
- | или если за ними стоит\\ пробел. Если его не поставить, | ||
- | |||
- | < | ||
- | что два обратных слэша действуют только в конце строки\\ | ||
- | или если за ними стоит\\ пробел. Если его не поставить, | ||
- | </ | ||
- | |||
- | Принудительные переносы следует использовать только в случае крайней необходимости. | ||
- | |||
- | ===== Ссылки ===== | ||
- | |||
- | Ссылки в «ДокуВики» бывают разные и создавать их можно тоже по-разному. | ||
- | |||
- | ==== Внешние ==== | ||
- | |||
- | Внешние ссылки распознаются автоматически: | ||
- | просто www.ulanovka.ru --- также можно указывать текст ссылки: | ||
- | [[http:// | ||
- | тоже распознаются: | ||
- | |||
- | < | ||
- | просто www.ulanovka.ru --- также можно указывать текст ссылки: | ||
- | [[http:// | ||
- | тоже распознаются: | ||
- | |||
- | ==== Внутренние ==== | ||
- | |||
- | Внутренние ссылки создаются посредством квадратных скобок. | ||
- | Можно либо просто указать [[pagename|имя страницы]], | ||
- | дополнительно прописать [[pagename|текст ссылки]]. Имена | ||
- | вики-статей автоматически | ||
- | спецсимволы использовать нельзя. | ||
- | |||
- | < | ||
- | Можно либо просто указать [[pagename|имя страницы]], | ||
- | дополнительно прописать [[pagename|текст ссылки]]. Имена | ||
- | вики-статей автоматически | ||
- | спецсимволы использовать нельзя.</ | ||
- | |||
- | Можно использовать в ссылке [[some: | ||
- | |||
- | < | ||
- | |||
- | Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, | ||
- | |||
- | < | ||
- | |||
- | Примечания: | ||
- | |||
- | * Ссылки на [[wiki: | ||
- | * «ДокуВики» по умолчанию не использует [[wp> | ||
- | * Если меняется название раздела, | ||
- | |||
- | ==== Интервики ==== | ||
- | |||
- | «ДокуВики» поддерживает [[doku> | ||
- | |||
- | < | ||
- | на другие вики. Например, | ||
- | </ | ||
- | |||
- | ==== Сетевые ресурсы Windows ==== | ||
- | |||
- | Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, | ||
- | |||
- | < | ||
- | |||
- | Примечания: | ||
- | |||
- | * Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»). | ||
- | * В браузерах Mozilla эту возможность можно включить с помощью опции [[http:// | ||
- | |||
- | ==== Картинки-ссылки ==== | ||
- | |||
- | Совместив синтаксис ссылки и [[# | ||
- | |||
- | < | ||
- | |||
- | [[http:// | ||
- | |||
- | Учтите: | ||
- | |||
- | ==== Сноски ==== | ||
- | |||
- | С помощью двойных скобок можно добавить сноску((Сноска — помещаемые внизу страницы примечание, | ||
- | |||
- | < | ||
- | помещаемые внизу страницы примечание, | ||
- | |||
- | ===== Разбивка на разделы ===== | ||
- | |||
- | Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, | ||
- | |||
- | ==== Заголовок 3-го уровня ==== | ||
- | === Заголовок 4-го уровня === | ||
- | == Заголовок 5-го уровня == | ||
- | |||
- | < | ||
- | === Заголовок 4-го уровня === | ||
- | == Заголовок 5-го уровня ==</ | ||
- | |||
- | Четыре и более тире преобразуются в горизонтальную черту: | ||
- | |||
- | ---- | ||
- | |||
- | ===== Картинки и другие файлы ===== | ||
- | |||
- | С помощью фигурных скобок можно вставлять в текст внешние и внутренние картинки. По желанию можно указать их размер. | ||
- | |||
- | Нормальный размер: | ||
- | |||
- | Отмасштабированная до заданной ширины: | ||
- | |||
- | Отмасштабированная до заданных размеров: | ||
- | |||
- | Отмасштабированная внешняя картинка: | ||
- | |||
- | < | ||
- | Нормальный размер: | ||
- | Отмасштабированная до заданной ширины: | ||
- | Отмасштабированная до заданных размеров: | ||
- | Отмасштабированная внешняя картинка: | ||
- | </ | ||
- | |||
- | Поставив слева или справа пробел, | ||
- | |||
- | {{wiki: | ||
- | {{ wiki: | ||
- | {{ wiki: | ||
- | |||
- | < | ||
- | {{ wiki: | ||
- | {{ wiki: | ||
- | </ | ||
- | |||
- | И, конечно, | ||
- | |||
- | {{ wiki: | ||
- | |||
- | < | ||
- | |||
- | Если задать имя файла (внутреннее или внешнее), | ||
- | |||
- | Узнать, | ||
- | |||
- | ===== Списки ===== | ||
- | |||
- | «ДокуВики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, | ||
- | |||
- | * Первый элемент маркированного списка | ||
- | * Второй элемент списка | ||
- | * Можно сделать вложенный список | ||
- | * Ещё один элемент | ||
- | |||
- | - Тот же список, | ||
- | - Ещё элемент | ||
- | - Чем больше пробелов в начале, | ||
- | - Всё просто | ||
- | |||
- | < | ||
- | * Первый элемент маркированного списка | ||
- | * Второй элемент списка | ||
- | * Можно сделать вложенный список | ||
- | * Ещё один элемент | ||
- | |||
- | - Тот же список, | ||
- | - Ещё элемент | ||
- | - Чем больше пробелов в начале, | ||
- | - Всё просто | ||
- | </ | ||
- | |||
- | ===== Смайлики ===== | ||
- | |||
- | «ДокуВики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию '' | ||
- | |||
- | * 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 | эта ячейка объединена вертикально | Ряд 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 | | ||
- | |||
- | Примечание: | ||
- | |||
- | ===== Неформатируемые блоки ===== | ||
- | |||
- | Неформатируемые блоки можно вставлять в документ, | ||
- | |||
- | < | ||
- | |||
- | < | ||
- | |||
- | Чтобы парсер полностью проигнорировал некий текст (т. е. не форматировал его), либо заключите его в тэги '' | ||
- | |||
- | Это просто текст, в котором есть адрес %%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;, **a**bap, actionscript-french, | ||
- | |||
- | ==== Скачиваемые блоки кода ==== | ||
- | |||
- | Используя тэги '' | ||
- | |||
- | < | ||
- | <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=" | ||
- | </ | ||
- | </ | ||
- | |||
- | < | ||
- | Тут вставлен <font color=" | ||
- | </ | ||
- | |||
- | <code php> | ||
- | <php> | ||
- | echo ' | ||
- | echo '< | ||
- | </ | ||
- | </ | ||
- | |||
- | <php> | ||
- | echo ' | ||
- | echo '< | ||
- | </ | ||
- | |||
- | **Примечание**: | ||
- | |||
- | ===== Управляющие макросы ===== | ||
- | |||
- | Некоторый синтаксис влияет на то, как «ДокуВики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы: | ||
- | |||
- | ^ Макрос | ||
- | | %%~~NOTOC~~%% | ||
- | | %%~~NOCACHE~~%% | «ДокуВики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, | ||
- | |||
- | ===== Синтаксические плагины ===== | ||
- | |||
- | Синтаксис «ДокуВики» может быть расширен за счёт [[doku> | ||
- | |||
- | ~~INFO: |