ru:syntax
Различия
Показаны различия между двумя версиями страницы.
Предыдущая версия справа и слеваПредыдущая версияСледующая версия | Предыдущая версия | ||
ru:syntax [2012-09-25 20:35] – 2001:778:200:4100:200:e8ff:fe21:9812 | ru:syntax [2016-01-15 08:59] (текущий) – Aleksandr | ||
---|---|---|---|
Строка 1: | Строка 1: | ||
- | ====== | + | Страница перемещена: |
- | + | ||
- | «ДокуВики» поддерживает простой язык разметки, | + | |
- | + | ||
- | + | ||
- | ===== Основные конструкции форматирования ===== | + | |
- | + | ||
- | «ДокуВики» поддерживает выделение текста **жирным шрифтом**, | + | |
- | + | ||
- | < | + | |
- | «ДокуВики» поддерживает выделение текста **жирным шрифтом**, | + | |
- | __подчёркнутый текст__ и вывод текста '' | + | |
- | Все эти конструкции можно **__//'' | + | |
- | </ | + | |
- | + | ||
- | Также можно использовать < | + | |
- | + | ||
- | < | + | |
- | Также можно использовать < | + | |
- | </ | + | |
- | + | ||
- | Ещё можно < | + | |
- | + | ||
- | < | + | |
- | Ещё можно < | + | |
- | </ | + | |
- | + | ||
- | **Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, | + | |
- | + | ||
- | Просто текст с разрывом строк\\ Обратите внимание, | + | |
- | что два обратных слэша действуют только в конце строки\\ | + | |
- | или если за ними стоит\\ пробел. Если его не поставить, | + | |
- | + | ||
- | < | + | |
- | что два обратных слэша действуют только в конце строки\\ | + | |
- | или если за ними стоит\\ пробел. Если его не поставить, | + | |
- | </ | + | |
- | + | ||
- | Принудительные переносы следует использовать только в случае крайней необходимости. | + | |
- | + | ||
- | ===== Ссылки ===== | + | |
- | + | ||
- | Ссылки в «ДокуВики» бывают разные и создавать их можно тоже по-разному. | + | |
- | + | ||
- | ==== Внешние ==== | + | |
- | + | ||
- | Внешние ссылки распознаются автоматически: http:// | + | |
- | просто www.google.com --- также можно указывать текст ссылки: | + | |
- | [[http:// | + | |
- | тоже распознаются: | + | |
- | + | ||
- | < | + | |
- | просто www.google.com --- также можно указывать текст ссылки: | + | |
- | [[http:// | + | |
- | тоже распознаются: | + | |
- | + | ||
- | ==== Внутренние ==== | + | |
- | + | ||
- | Внутренние ссылки создаются посредством квадратных скобок. | + | |
- | Можно либо просто указать [[pagename|имя страницы]], | + | |
- | дополнительно прописать [[pagename|текст ссылки]]. Имена | + | |
- | вики-статей автоматически | + | |
- | спецсимволы использовать нельзя. | + | |
- | + | ||
- | < | + | |
- | Можно либо просто указать [[pagename|имя страницы]], | + | |
- | дополнительно прописать [[pagename|текст ссылки]]. Имена | + | |
- | вики-статей автоматически | + | |
- | спецсимволы использовать нельзя.</ | + | |
- | + | ||
- | Можно использовать в ссылке | + | |
- | + | ||
- | < | + | |
- | + | ||
- | Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, | + | |
- | + | ||
- | < | + | |
- | + | ||
- | Примечания: | + | |
- | + | ||
- | * Ссылки на [[syntax|существующие статьи]] отображаются иначе, чем ссылки на [[nonexisting|несуществующие]]. | + | |
- | * «ДокуВики» по умолчанию не использует [[wp> | + | |
- | * Если меняется название раздела, | + | |
- | + | ||
- | ==== Interwiki ==== | + | |
- | + | ||
- | «ДокуВики» поддерживает [[interwiki|интервики]]-ссылки. Это короткие ссылки | + | |
- | на другие вики. Например, | + | |
- | + | ||
- | < | + | |
- | на другие вики. Например, | + | |
- | </ | + | |
- | + | ||
- | ==== Сетевые ресурсы Windows ==== | + | |
- | + | ||
- | Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, | + | |
- | + | ||
- | < | + | |
- | + | ||
- | Примечания: | + | |
- | + | ||
- | * Из соображений безопасности непосредственный просмотр сетевых ресурсов работает по умолчанию только в Internet Explorer (и только в «локальной зоне»). | + | |
- | * В браузерах Mozilla эту возможность можно включить с помощью опции [[http://www.mozilla.org/quality/ | + | |
- | * Подробней читайте здесь: [[bug> | + | |
- | + | ||
- | + | ||
- | ==== Картинки-ссылки ==== | + | |
- | + | ||
- | Совместив синтаксис ссылки и [[# | + | |
- | + | ||
- | < | + | |
- | + | ||
- | [[http:// | + | |
- | + | ||
- | Учтите: | + | |
- | + | ||
- | ==== Сноски ==== | + | |
- | + | ||
- | С помощью двойных скобок можно добавить сноску((Сноска — помещаемые внизу страницы примечание, | + | |
- | + | ||
- | < | + | |
- | помещаемые внизу страницы примечание, | + | |
- | + | ||
- | ===== Разбивка на разделы ===== | + | |
- | + | ||
- | Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, | + | |
- | + | ||
- | ==== Заголовок 3-го уровня ==== | + | |
- | === Заголовок 4-го уровня === | + | |
- | == Заголовок 5-го уровня == | + | |
- | + | ||
- | < | + | |
- | === Заголовок 4-го уровня === | + | |
- | == Заголовок 5-го уровня ==</ | + | |
- | + | ||
- | Четыре и более тире преобразуются в горизонтальную черту: | + | |
- | + | ||
- | ---- | + | |
- | + | ||
- | ===== Картинки и другие файлы ===== | + | |
- | + | ||
- | См. также: «[[images|Работа с изображениями и медиафайлами]]». | + | |
- | + | ||
- | С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[images|картинки]]. По желанию можно указать их размер. | + | |
- | + | ||
- | Нормальный размер: | + | |
- | + | ||
- | Отмасштабированная до заданной ширины: | + | |
- | + | ||
- | Отмасштабированная до заданных размеров: | + | |
- | + | ||
- | Отмасштабированная внешняя картинка: | + | |
- | + | ||
- | < | + | |
- | Нормальный размер: | + | |
- | Отмасштабированная до заданной ширины: | + | |
- | Отмасштабированная до заданных размеров: | + | |
- | Отмасштабированная внешняя картинка: | + | |
- | </ | + | |
- | + | ||
- | Поставив слева или справа пробел, | + | |
- | + | ||
- | {{wiki: | + | |
- | {{ wiki: | + | |
- | {{ wiki: | + | |
- | + | ||
- | < | + | |
- | {{ wiki: | + | |
- | {{ wiki: | + | |
- | </ | + | |
- | + | ||
- | И, конечно, | + | |
- | + | ||
- | {{ wiki: | + | |
- | + | ||
- | < | + | |
- | + | ||
- | Если задать имя файла (внутреннее или внешнее), | + | |
- | + | ||
- | Узнать, | + | |
- | + | ||
- | + | ||
- | ===== Списки ===== | + | |
- | + | ||
- | «ДокуВики» поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, | + | |
- | + | ||
- | * Первый элемент маркированного списка | + | |
- | * Второй элемент списка | + | |
- | * Можно сделать вложенный список | + | |
- | * Ещё один элемент | + | |
- | + | ||
- | - Тот же список, | + | |
- | - Ещё элемент | + | |
- | - Чем больше пробелов в начале, | + | |
- | - Всё просто | + | |
- | + | ||
- | < | + | |
- | * Первый элемент маркированного списка | + | |
- | * Второй элемент списка | + | |
- | * Можно сделать вложенный список | + | |
- | * Ещё один элемент | + | |
- | + | ||
- | - Тот же список, | + | |
- | - Ещё элемент | + | |
- | - Чем больше пробелов в начале, | + | |
- | - Всё просто | + | |
- | </ | + | |
- | + | ||
- | См. также [[faq: | + | |
- | + | ||
- | ===== Смайлики ===== | + | |
- | + | ||
- | «ДокуВики» переделывает наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию '' | + | |
- | + | ||
- | * 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> | + | |
- | < | + | |
- | echo ' | + | |
- | echo '< | + | |
- | </ | + | |
- | </ | + | |
- | + | ||
- | < | + | |
- | echo ' | + | |
- | echo '< | + | |
- | </ | + | |
- | + | ||
- | **Примечание**: | + | |
- | + | ||
- | ===== Управляющие макросы ===== | + | |
- | + | ||
- | Некоторый синтаксис влияет на то, как «ДокуВики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы: | + | |
- | + | ||
- | ^ Макрос | + | |
- | | %%~~NOTOC~~%% | + | |
- | | %%~~NOCACHE~~%% | «ДокуВики» помещает всё выводимое в кэш по умолчанию. Иногда это нежелательно (например, | + | |
- | + | ||
- | ===== Синтаксические плагины ===== | + | |
- | + | ||
- | Синтаксис «ДокуВики» может быть расширен за счёт [[doku> | + | |
- | Как их устанавливать и использовать --- описывается на страницах описания. Следующие плагины доступны в инсталляции «ДокуВики» на этом сайте: | + | |
- | + | ||
- | ~~INFO: | + | |
- | ---- | + | |
- | * - Элемент ненумерованного списка{{: | + |
ru/syntax.1348598153.txt.gz · Последнее изменение: 2012-09-25 20:35 — 2001:778:200:4100:200:e8ff:fe21:9812