Основные конструкции вики-разметки

Более подробно с вики-разметкой можно ознакомиться в справочном разделе «Руководство по Вики».

Абзацы отбиваются пустой строкой. Если нужно принудительно вставить перенос строки, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке.

Просто текст с разрывом строк
Обратите внимание, что два обратных слэша действуют только в конце строки
или если за ними стоит
пробел. Если его не поставить, \\получится вот так.

Вики-разметка:

Просто текст с разрывом строк\\ Обратите внимание,
что два обратных слэша действуют только в конце строки\\
или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.

Принудительные переносы следует использовать только в случае крайней необходимости.

Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку ~~NOTOC~~.

Вики-разметка:

==== Заголовок 3-го уровня ====
=== Заголовок 4-го уровня ===
== Заголовок 5-го уровня ==

Четыре и более тире ---- преобразуются в горизонтальную черту:

Некоторые типографские символы могут быть созданы с помощью простых текстовых символов. Вот пример распознанных символов.

→ ← ↔ ⇒ ⇐ ⇔ » « – — '640x480' © ™ ® …
"Владимир Владимирович™ — это наше всё © Иа"

Вики-разметка:

-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...\\
"Владимир Владимирович(tm) --- это наше всё (c) Иа"

Ставить ссылки на определённый раздел (заголовок) на самой странице тоже можно. Просто добавьте через решётку # имя раздела.

Ссылка на раздел «Пространство имён», находящийся на текущей странице.

Вики-разметка:

Ссылка на [[#Пространство имён|раздел «Пространство имён»]], находящийся на текущей странице.

Примечания:

• Ссылки на существующие статьи отображаются иначе, чем ссылки на несуществующие.
• Если изменить название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы. Ссылка на другую страницу будет работать, но не произойдёт перехода к разделу.

См. основную статью Имя страницы и пространства имён.

Для организации вики в ней используется пространство имён. Пространство имён указывается двоеточием. Например, все страницы по теме «грамматика» находятся в пространстве 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. Ещё элемент
   1. Чем больше пробелов в начале, тем глубже вложенность

   2. Составной элемент списка

      1. Вложенный элемент составного списка

      Продолжение составного списка

      1. Ещё вложенный элемент составного списка
3. Всё просто

Вики-разметка:

  * Первый элемент маркированного списка
    * Второй элемент списка
      * Можно сделать вложенный список
    * Ещё один элемент
    ** Составной элемент списка
      * Вложенный элемент составного списка
    .. Продолжение составного списка
      * Ещё вложенный элемент составного списка

  - Тот же список, только нумерованный
  - Ещё элемент
    - Чем больше пробелов в начале, тем глубже вложенность
    -- Составной элемент списка
      - Вложенный элемент составного списка
    .. Продолжение составного списка
      - Ещё вложенный элемент составного списка
  - Всё просто

Вики поддерживает упрощённый синтаксис создания таблиц. Нормальные ряды должны начинаться и заканчиваться вертикальной чертой — |, а заголовки «крышечкой» — ^:

Вики-разметка:

^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
| Ряд 2 Колонка 1  | Объединение клеток (обратите внимание на двойную вертикальную черту)  ||
| Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 3        |

Чтобы объединить две соседние клетки в ряду, просто оставьте соседнюю клетку полностью пустой, как показано выше. Следите, чтобы количество разделителей клеток (т.е. вертикальных черт или «крышечек») было одинаковым.

Вертикальные заголовки тоже можно сделать:

Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий ::: в объединяемые нижележащие ячейки.

В этих ячейках не должно быть ничего, кроме синтаксиса объединения (:::).

Вики-разметка:

^ Заголовок 1        ^ Заголовок 2                       ^ Заголовок 3            ^
| Ряд 1 Колонка 1    | эта ячейка объединена вертикально | Ряд 1 Колонка 3        |
| Ряд 2 Колонка 1    | :::                               | Ряд 2 Колонка 3        |
| Ряд 3 Колонка 1    | :::                               | Ряд 2 Колонка 3        |

Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа — если надо выравнять влево, и по два с каждой стороны — если по центру.

Вики-разметка:

^           Таблица с выравниванием        ^^^
|        вправо|   по центру  |влево         |
|влево         |        вправо|   по центру  |
| 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/%%
и %%**форматирование**%% --- но ничего не происходит.

Чтобы увидеть, как используются эти блоки, смотрите код статьи.

В разметку текста можно вставить комментарии, которые отображаются только при редактировании страницы.

Вики-разметка:

В разметку текста можно вставить комментарии, /* вот так */
которые отображаются только при редактировании страницы.