завершено на 25%

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

Материал из Викиучебника — открытых книг для открытого мира
Перейти к навигации Перейти к поиску

В данном учебнике мы рассмотрим вики-разметку — облегчённый язык разметки, который часто используется на википроектах. Определённого стандарта вики-разметки не существует, поэтому в этом учебнике будет рассмотрен вариант разметки MediaWiki.

Часть 1. Основы[править]

Форматирование[править]

Полужирным текст делается с помощью конструкции '''Ваш текст''', а курсивом текст выделяется ''так''. Также текст можно сделать и полужирным, и курсивом — для этого нужно всего лишь совместить два вышеприведённых способа. Остальные изменения вида текста выполняются с помощью HTML-тегов. Для зачёркивания — <s></s>, для подчёркивания — <u></u>, для преобразования текста в моноширинный — <tt></tt>, для остальных трансформаций — тег <span style="<!-- CSS-код -->"></span>. Заголовки формируются с помощью конструкции (кол-во "=" = уровень раздела) Название раздела (столько же "=", сколько и в начале). Например, для формирования заголовка третьего уровня с названием «Форматирование» нужен такой код: === Форматирование ===.

Ссылки[править]

Внутренние ссылки (которые ссылаются на другие страницы википроекта) создаются с помощью конструкции [[название страницы, на которую ведёт ссылка|текст, который отображается]]. Например, ссылка на заглавную страницу Викиучебника будет выглядеть так: [[Заглавная страница|какой-то текст]]. А можно и вот так: [[Заглавная страница]], тогда будет отображаться название страницы, на которую ведёт ссылка. Также возможно использовать специальные префиксы, которые обозначают другие википроекты Фонда Викимедия или языковые разделы, например en: (ссылка на английский раздел) или wikt: (префикс Викисловаря).

Внешние ссылки создаются с помощью другой конструкции: [URL отображаемый текст]. Вот как, например будет выглядеть ссылка на страницу о вики-разметке на Википедии, если её задать с помощью внешней ссылки: [https://ru.wikipedia.org/wiki/Вики-разметка О разметке]. А так она будет выглядеть при использовании префиксов: [[w:Вики-разметка|О разметке]] или [[wikipedia:Вики-разметка|О разметке]] или даже [[wikipedia:ru:Вики-разметка|О разметке]]. А результат всё равно один...

Шаблоны[править]

Шаблоны — это некое подобие функций в языках программирования. Их назначение соответствует названию — они используются для «импортирования» часто используемого кода со страницы шаблона. Синтаксис шаблона прост:

{{Название шаблона|параметр 1 = значение 1|...|параметр n = значение n}}
<!-- Однако шаблон может заполняться так: -->
{{Название шаблона|значение 1|...|значение n}}
<!-- Если название параметра - порядковый номер от 1
А также шаблон может не иметь ни одного параметра, например, навбокс
-->
{{Название шаблона}}
<!-- Кстати, конструкция в которой написано это предложение - комментарий -->

То есть шаблон начинается с {{Название шаблона, затем идут параметры, которые разделяются |, а шаблон заканчивается }} после последнего параметра. Параметры могут быть и пустыми, тогда вместо них в шаблоне будет отображаться значение «по умолчанию».

Вставка файлов на страницу[править]

Больше: Help:Images/ru

В детстве наверняка все читали детские книжки, а смотрели на картинки в них. Вот и в длинной статье будет скучно без картинок... Конструкция для вставки файлов на страницу, похожа на конструкцию ссылок, только вот тут всё немного сложнее.

[[Файл:Название.расширение|параметры|подпись]]

Основные параметры[править]

Формат
Форматирует изображение и определяет, как оно будет расположено в оставшейся части страницы. Чаще всего не заполняется или заполняется параметром thumb (миниатюра).
Размер
  • width ({width}px) — определяет ширину изображения.
  • heigth (x{heigth}px) — определяет высоту изображения.
  • width и height ({width}x{height}px) — определяет ширину и высоту изображения.
Выравнивание
по горизонтали
Определяет горизонтальное выравнивание (и inline/block или floating styles) изображения в пределах текста. Не имеет значения по умолчанию.
по вертикали
Определяет вертикальное выравнивание невсплывающего изображения в блоке текста. По умолчанию вертикально выравнивается по центру (middle).
Ссылка
  • link={цель} — указывает, куда ведёт ссылка при клике на неё. Поддерживает как внешние, так и внутренние ссылки.
  • link= — если значение пустое, то при клике на картинку ничего не произойдёт (при клике на картинку без параметра link произойдёт расширение картинки).

Если параметр не соответствует ни одному из возможных, предполагается, что это подпись.Текст подписи отображается ниже изображения в форматах thumb и frame, или как текст подсказки в других форматах. Текст подписи в форматах thumb и frame может содержать вики-ссылки и другие элементы форматирования. Расширения MediaWiki могут иметь дополнительные параметры.

Часть 2. Теги[править]

Список тегов, которые могут использованы в редакторы.

HTML-теги[править]

  • <abbr>
  • <acronym> (устарел)
  • <b>
  • <big> (устарел)
  • <blockquote>
  • <br />
  • <caption>
  • <center> (устарел)
  • <cite>
  • <code>
  • <dd>
  • <del>
  • <div>
  • <dl>
  • <dt>
  • <em>
  • <font> (устарел)
  • <h1>
  • <h2>
  • <h3>
  • <h4>
  • <h5>
  • <h6>
  • <hr>
  • <i>
  • <ins>
  • <li>
  • <ol>
  • <p>
  • <pre>
  • <q>
  • <rb>
  • <rp>
  • <rt>
  • <ruby>
  • <s>
  • <small>
  • <span>
  • <strike> (устарел)
  • <strong>
  • <sub>
  • <sup>
  • <table>
  • <td>
  • <th>
  • <tr>
  • <tt> (устарел)
  • <u>
  • <ul>
  • <var>
  • <!-- -->

Теги расширений[править]

Часть 3. Создание шаблона[править]

Для создания шаблонов на википроекте с MediaWiki нужно создать страницу под названием Template:Название шаблона (также возможно указать в качестве пространства имён название ПИ на языке вики, на русских вики это Шаблон), где вместо Название шаблона нужно написать название шаблона.

По факту, шаблоны — это обычные страницы вики, которые можно вставить на страницу с помощью {{ ... }}. Главная особенность шаблонов — это наличие переменных параметров, которые можно задавать при каждой вставке шаблона на страницу. На самой странице шаблона параметры объявляются с помощью конструкции {{{Название параметра|значение, если параметр не заполнен}}}. Названием параметра может быть какая угодно строка. Кстати, если задать параметру название 1, то при вставке шаблона ему можно будет задать значение не указывая «ключ» (об этом было рассказано выше).

Теги шаблонов[править]

Специально для шаблонов есть три специальных тега: <noinclude>, <onlyinclude> и <includeonly>.

  • <noinclude> — всё, что обёрнуто этим тегом, не будет импортироваться на страницу. Полезно при категоризации страниц, добавлении документации и т. д.
  • <onlyinclude> — антипод <noinclude>. При его добавлении на страницу, импортироваться на страницу будет только код, который обёрнут этим тегом. Может быть полезен при малом размере кода самого шаблона и обширной документации к нему.
  • <includeonly> — код, который обёрнут этим тегом, будет импортироваться на страницу, но не будет обрабатываться движком на странице самого шаблона. Полезен, если, например, при добавлении категории на страницу с помощью шаблона, но когда категория не должна содержать страницу шаблону.

См. также[править]

Примечания[править]