ESL.WikiESL.Wiki

English as a Second Language Wikibook

Инструменты пользователя

Инструменты сайта


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

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

Разметка текста

Разметка Результат
**жирный шрифт** жирный шрифт
//курсив// курсив
__подчёркнутый текст__ подчёркнутый текст
''моноширинный шрифт'' моноширинный шрифт
**//__''всё вместе''__//** всё вместе
<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. Ещё элемент
    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 Колонка 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

Отмасштабированный до заданных размеров: чебурашка.jpg

Вики-разметка:
Нормальный размер:                        {{чебурашка.jpg}}

Отмасштабированный до заданной ширины:    {{чебурашка.jpg?100}}

Отмасштабированный до заданных размеров:  {{чебурашка.jpg?200x100}}

Поставив слева или справа пробел, можно задать выравнивание изображения:

изображение слева справа посередине

Вики-разметка:
{{чебурашка.jpg?120x60 |изображение слева}}
{{ чебурашка.jpg?120x60|справа}}
{{ чебурашка.jpg?120x60 |посередине}}

И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).

Это - Чебурашка.

Вики-разметка:
{{ чебурашка.jpg |Это - Чебурашка.}}

Если задать имя файла, который не является изображением, оно будет отображаться в виде ссылки на файл.

Изображение в качестве ссылки

Для создания ссылки-изображения используйте обычный синтаксис ссылок, только после знака вертикальной черты '|' используйте синтаксис вставки изображений (двойные фигурные скобки).

Пример: будильник.jpg

Вики-разметка:
Пример: [[https://ru.wikipedia.org/wiki/Будильник|{{будильник.jpg?105x95}}]]

Неформатируемые блоки

Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов, либо используя тэги <code> или <file>.

<code - Вики-разметка:>Это неформатированный текст, в котором сохранены все пробелы: вот <- так.</code>

Вики-разметка:
Это неформатированный текст, в котором сохранены все пробелы: вот             <- так.

<file - Вики-разметка:>В принципе то же самое, но этим выделением можно показать, что цитируется содержимое файла.</file>

Вики-разметка:
В принципе то же самое, но этим выделением можно показать, что цитируется содержимое файла.

Чтобы вики-движок проигнорировал разметку (т. е. не форматировал его), либо заключите его в тэги <nowiki></nowiki>, либо ещё проще — в двойные знаки процента %%.

Это просто текст, в котором есть адрес http://www.splitbrain.org/ и **форматирование** — но ничего не происходит.

Вики-разметка:
Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%%
и %%**форматирование**%% --- но ничего не происходит.

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

Комментарии в разметке

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

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

1) Это сноска.
2), 3) Это именованная сноска.
4), 5) Это другая именованная сноска.

Обсуждение

Ваш комментарий. Вики-синтаксис разрешён:
  ____    ____   __  ___   ___    ____
 / __ \  / __/  /  |/  /  / _ \  /  _/
/ /_/ / _\ \   / /|_/ /  / // / _/ /  
\____/ /___/  /_/  /_/  /____/ /___/