Различия
Показаны различия между двумя версиями страницы.
как_пользоваться_справочником:синтаксис_форматирования [2021/07/30 09:20] wikiuser [Картинки и другие файлы] |
как_пользоваться_справочником:синтаксис_форматирования [2022/02/23 18:37] |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
- | ====== Синтаксис форматирования ====== | ||
- | «Докувики» поддерживает простой язык разметки, | ||
- | |||
- | ===== Основные конструкции форматирования ===== | ||
- | |||
- | «Докувики» поддерживает выделение текста **жирным шрифтом**, | ||
- | |||
- | < | ||
- | «Докувики» поддерживает выделение текста **жирным шрифтом**, | ||
- | __подчёркнутый текст__ и вывод текста '' | ||
- | Все эти конструкции можно **__//'' | ||
- | </ | ||
- | |||
- | Также можно использовать < | ||
- | |||
- | < | ||
- | Также можно использовать < | ||
- | </ | ||
- | |||
- | Ещё можно < | ||
- | |||
- | < | ||
- | Ещё можно < | ||
- | </ | ||
- | |||
- | **Абзацы** отбиваются пустой строкой. Если нужно **принудительно вставить перенос строки**, | ||
- | |||
- | Просто текст с разрывом строк\\ Обратите внимание, | ||
- | что два обратных слэша действуют только в конце строки\\ | ||
- | или если за ними стоит\\ пробел. Если его не поставить, | ||
- | |||
- | < | ||
- | что два обратных слэша действуют только в конце строки\\ | ||
- | или если за ними стоит\\ пробел. Если его не поставить, | ||
- | </ | ||
- | |||
- | Принудительные переносы следует использовать только в случае крайней необходимости. | ||
- | |||
- | ===== Ссылки ===== | ||
- | |||
- | Ссылки в «Докувики» бывают разные и создавать их можно тоже по-разному. | ||
- | |||
- | ==== Внешние ==== | ||
- | |||
- | Внешние ссылки распознаются автоматически: | ||
- | просто www.google.com --- также можно указывать текст ссылки: | ||
- | [[http:// | ||
- | тоже распознаются: | ||
- | |||
- | < | ||
- | просто www.google.com --- также можно указывать текст ссылки: | ||
- | [[http:// | ||
- | тоже распознаются: | ||
- | |||
- | ==== Внутренние ==== | ||
- | |||
- | Внутренние ссылки создаются посредством квадратных скобок. | ||
- | Можно либо просто указать [[ru: | ||
- | дополнительно прописать [[ru: | ||
- | вики-статей автоматически | ||
- | спецсимволы использовать нельзя. | ||
- | |||
- | < | ||
- | Можно либо просто указать [[ru: | ||
- | дополнительно прописать [[ru: | ||
- | вики-статей автоматически | ||
- | спецсимволы использовать нельзя.</ | ||
- | |||
- | Можно использовать в ссылке [[ru: | ||
- | |||
- | < | ||
- | |||
- | Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, | ||
- | |||
- | < | ||
- | |||
- | Примечания: | ||
- | |||
- | * Ссылки на [[wiki: | ||
- | * «Докувики» по умолчанию не использует [[wp> | ||
- | * Если меняется название раздела, | ||
- | * Ссылки на разделы делаются именно на [[# | ||
- | |||
- | ==== Интервики ==== | ||
- | |||
- | «Докувики» поддерживает [[interwiki|интервики]]-ссылки. Это короткие ссылки | ||
- | на другие вики. Например, | ||
- | |||
- | < | ||
- | на другие вики. Например, | ||
- | </ | ||
- | |||
- | |||
- | ==== Картинки-ссылки ==== | ||
- | |||
- | Совместив синтаксис ссылки и [[# | ||
- | |||
- | < | ||
- | |||
- | [[http:// | ||
- | |||
- | Учтите: | ||
- | |||
- | ==== Сноски ==== | ||
- | |||
- | С помощью двойных скобок можно добавить сноску((Сноска — помещаемые внизу страницы примечание, | ||
- | |||
- | < | ||
- | помещаемые внизу страницы примечание, | ||
- | |||
- | ===== Разбивка на разделы ===== | ||
- | |||
- | Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, | ||
- | |||
- | |||
- | ==== Заголовок 3 уровня ==== | ||
- | === Заголовок 4 уровня === | ||
- | == Заголовок 5 уровня == | ||
- | |||
- | < | ||
- | === Заголовок 4 уровня === | ||
- | == Заголовок 5 уровня ==</ | ||
- | |||
- | Четыре и более тире преобразуются в горизонтальную черту: | ||
- | |||
- | ---- | ||
- | |||
- | ===== Картинки и другие файлы ===== | ||
- | |||
- | См. также: «[[images|Работа с изображениями и медиа файлами]]». | ||
- | |||
- | С помощью фигурных скобок можно вставлять в текст внешние и внутренние [[images|картинки]]. По желанию можно указать их размер. | ||
- | |||
- | Нормальный размер: | ||
- | |||
- | Отмасштабированная до заданной ширины: | ||
- | |||
- | Отмасштабированная до заданных размеров: | ||
- | |||
- | Отмасштабированная внешняя картинка: | ||
- | |||
- | < | ||
- | Нормальный размер: | ||
- | Отмасштабированная до заданной ширины: | ||
- | Отмасштабированная до заданных размеров: | ||
- | Отмасштабированная внешняя картинка: | ||
- | </ | ||
- | |||
- | Поставив слева или справа пробел, | ||
- | |||
- | {{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 | | ||
- | |||
- | Примечание: |