Содержание
Основные конструкции вики-разметки
Более подробно с вики-разметкой можно ознакомиться в справочном разделе «Руководство по Вики».
Разметка текста
Разметка | Результат |
---|---|
**жирный шрифт** | жирный шрифт |
//курсив// | курсив |
__подчёркнутый текст__ | подчёркнутый текст |
''моноширинный шрифт'' | моноширинный шрифт |
**//__''всё вместе''__//** | всё вместе |
<sup>над</sup> и <sub>под</sub> | над и под |
<del>зачеркнуть</del> | |
Абзацы отбиваются пустой строкой. Если нужно принудительно вставить перенос строки, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке.
Просто текст с разрывом строк
Обратите внимание,
что два обратных слэша действуют только в конце строки
или если за ними стоит
пробел. Если его не поставить, \\получится вот так.
- Вики-разметка:
Просто текст с разрывом строк\\ Обратите внимание, что два обратных слэша действуют только в конце строки\\ или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.
:!:Принудительные переносы следует использовать только в случае крайней необходимости.
Заголовки (разбивка на разделы)
Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку ~~NOTOC~~
.
Заголовок 3-го уровня
Заголовок 4-го уровня
Заголовок 5-го уровня
- Вики-разметка:
==== Заголовок 3-го уровня ==== === Заголовок 4-го уровня === == Заголовок 5-го уровня ==
Четыре и более тире ----
преобразуются в горизонтальную черту:
Типографские символы
Некоторые типографские символы могут быть созданы с помощью простых текстовых символов. Вот пример распознанных символов.
→ ← ↔ ⇒ ⇐ ⇔ » « – — '640x480' © ™ ® …
"Владимир Владимирович™ — это наше всё © Иа"
- Вики-разметка:
-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...\\ "Владимир Владимирович(tm) --- это наше всё (c) Иа"
Ссылки
Внешние ссылки | |
---|---|
https://duckduckgo.com | https://duckduckgo.com |
[[https://duckduckgo.com|«DuckDuckGo -- Конфиденциальная поисковая система»]] | «DuckDuckGo -- Конфиденциальная поисковая система» |
[[mailto:foo@example.com|Mr. Foo]] | Mr. Foo |
Внутренние ссылки | |
[[ru:grammar:Present Continuous]] | Present Continuous |
[[ru:grammar:present_continuous]] | present_continuous |
[[ru:grammar:present_continuous|Переход на стр. «Present Continuous»]] | Переход на стр. «Present Continuous» |
[[ru:grammar:Present Continuous#Употребление "Present Continuous"|Переход к заголовку «Употребление "Present Continuous"» страницы «Present Continuous»]] | Переход к заголовку «Употребление "Present Continuous"» страницы «Present Continuous» См. Ссылки на разделы страницы. |
Ссылки на разделы страницы
Ставить ссылки на определённый раздел (заголовок) на самой странице тоже можно. Просто добавьте через решётку # имя раздела.
Ссылка на раздел «Пространство имён», находящийся на текущей странице.
- Вики-разметка:
Ссылка на [[#Пространство имён|раздел «Пространство имён»]], находящийся на текущей странице.
Примечания:
- Ссылки на существующие статьи отображаются иначе, чем ссылки на несуществующие.
- Если изменить название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы. Ссылка на другую страницу будет работать, но не произойдёт перехода к разделу.
Пространство имён
См. основную статью Имя страницы и пространства имён.
Для организации вики в ней используется пространство имён.
Пространство имён указывается двоеточием.
Например, все страницы по теме «грамматика» находятся в пространстве ru:grammar:
.
В настоящий момент ESL.Wiki содержит следующие пространства:
:ru:grammar:
- содержит статьи по грамматике,
:ru:esp:
- пространство имён для статей по отраслевому английскому,
:ru:word_usage:
- пространство для статей по словоупотреблению.
:ru:wiki:
- пространство имён для статей касающихся вики
и её возможностей используемых в ESL.Wiki и статей о самом викиучебнике ESL.Wiki
:user:
- пространство имён личных страниц участников
Сама страница располагается в определённом пространстве имен, например:
страница "speak_talk_say_tell"
находится в пространстве ru:word_usage:
.
- Вики-разметка:
Сама страница располагается в определённом пространстве имен, например: страница "[[ru:word_usage:speak_talk_say_tell]]" находится в пространстве ''ru:word_usage:''.
Интервики
Интервики – это упрощенный способ представления ссылки на другие вики-сайты. Например, ссылка на статью русской Википедии о вики: Wiki, или так Вики, а это английской Wiki. Ссылка wiki:syntax ссылается на аналогичную этой статью в «ДокуВики» а эта ссылка wiki:syntax на статью на русском.
- Вики-разметка:
Интервики – это упрощенный способ представления ссылки на другие вики-сайты. Например, ссылка на статью русской Википедии о вики: [[wpru>Wiki]], или так [[wpru>Вики]], а это английской [[wp>Wiki]]. Ссылка [[doku>wiki:syntax]] ссылается на аналогичную этой статью в «ДокуВики» а эта ссылка [[dokuru>wiki:syntax]] на статью на русском.
Внутренняя интервики-ссылка на страницу пользователя jl_Alice, или та же ссылка с именем Администратор ESL.Wiki.
- Вики-разметка:
Внутренняя интервики-ссылка на страницу пользователя [[user>jl_Alice]], или та же ссылка с именем [[user>jl_alice|Администратор ESL.Wiki]].
Подробнее о поддерживаемых в ESL.Wiki интервики см. Интервики.
Сноски
Подробнее см. Синтаксис сносок.
Сноска — это помещаемые внизу страницы примечание, уточнение, ссылки на источники.1).
- Вики-разметка:
Сноска — это помещаемые внизу страницы примечание, уточнение, ссылки на источники.((Это сноска.)).
Сноске можно присвоить имя2) и обращаться к ней уже по имени3).
- Вики-разметка:
Сноске можно присвоить имя((name>Это именованная сноска.)) и обращаться к ней уже по имени((name)).
Имя сноски4) может быть расположено раньше её расшифровки5).
- Вики-разметка:
Имя сноски((name2)) может быть расположено раньше её расшифровки((name2>Это другая именованная сноска.)).
Подробнее см. Синтаксис сносок.
Списки
Вики-разметка поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом звёздочку (*) в случае маркированного списка, или дефис (-) — в случае нумерованного.
- Первый элемент маркированного списка
- Второй элемент списка
- Можно сделать вложенный список
- Ещё один элемент
Составной элемент списка
- Вложенный элемент составного списка
Продолжение составного списка
- Ещё вложенный элемент составного списка
- Тот же список, только нумерованный
- Ещё элемент
- Чем больше пробелов в начале, тем глубже вложенность
Составной элемент списка
- Вложенный элемент составного списка
Продолжение составного списка
- Ещё вложенный элемент составного списка
- Всё просто
- Вики-разметка:
* Первый элемент маркированного списка * Второй элемент списка * Можно сделать вложенный список * Ещё один элемент ** Составной элемент списка * Вложенный элемент составного списка .. Продолжение составного списка * Ещё вложенный элемент составного списка - Тот же список, только нумерованный - Ещё элемент - Чем больше пробелов в начале, тем глубже вложенность -- Составной элемент списка - Вложенный элемент составного списка .. Продолжение составного списка - Ещё вложенный элемент составного списка - Всё просто
Таблицы
Вики поддерживает упрощённый синтаксис создания таблиц. Нормальные ряды должны начинаться и заканчиваться вертикальной чертой — |, а заголовки «крышечкой» — ^:
Заголовок 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 Колонка 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 |
Примечание: вертикальное выравнивание не поддерживается.
Работа с изображениями и другими файлами
С помощью фигурных скобок можно вставлять в текст изображения. По желанию можно указать их размер.
Отмасштабированный до заданной ширины:
Отмасштабированный до заданных размеров:
- Вики-разметка:
Нормальный размер: {{чебурашка.jpg}} Отмасштабированный до заданной ширины: {{чебурашка.jpg?100}} Отмасштабированный до заданных размеров: {{чебурашка.jpg?200x100}}
Поставив слева или справа пробел, можно задать выравнивание изображения:
- Вики-разметка:
{{чебурашка.jpg?120x60 |изображение слева}} {{ чебурашка.jpg?120x60|справа}} {{ чебурашка.jpg?120x60 |посередине}}
И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).
- Вики-разметка:
{{ чебурашка.jpg |Это - Чебурашка.}}
Если задать имя файла, который не является изображением, оно будет отображаться в виде ссылки на файл.
Изображение в качестве ссылки
Для создания ссылки-изображения используйте обычный синтаксис ссылок, только после знака вертикальной черты '|' используйте синтаксис вставки изображений (двойные фигурные скобки).
- Вики-разметка:
Пример: [[https://ru.wikipedia.org/wiki/Будильник|{{будильник.jpg?105x95}}]]
Неформатируемые блоки
Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов, либо используя тэги <code>
или <file>
.
<code - Вики-разметка:>Это неформатированный текст, в котором сохранены все пробелы: вот <- так.</code>
- Вики-разметка:
Это неформатированный текст, в котором сохранены все пробелы: вот <- так.
<file - Вики-разметка:>В принципе то же самое, но этим выделением можно показать, что цитируется содержимое файла.</file>
- Вики-разметка:
В принципе то же самое, но этим выделением можно показать, что цитируется содержимое файла.
Чтобы вики-движок проигнорировал разметку (т. е. не форматировал его), либо заключите его в тэги <nowiki></nowiki>
, либо ещё проще — в двойные знаки процента %%
.
Это просто текст, в котором есть адрес http://www.splitbrain.org/ и **форматирование** — но ничего не происходит.
- Вики-разметка:
Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%% и %%**форматирование**%% --- но ничего не происходит.
Чтобы увидеть, как используются эти блоки, смотрите код статьи.
Комментарии в разметке
В разметку текста можно вставить комментарии, которые отображаются только при редактировании страницы.
- Вики-разметка:
В разметку текста можно вставить комментарии, /* вот так */ которые отображаются только при редактировании страницы.
Обсуждение