Вики/Техническое: различия между версиями

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


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


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


=== Шаблоны ===
=== Шаблоны ===
Шаблоны — это некое подобие функций в языках программирования. Их назначение соответствует названию — они используются для «импортирования» часто используемого кода со страницы шаблона. Синтаксис шаблона прост:
Шаблоны — это некое подобие функций в языках программирования. Их назначение соответствует названию — они используются для «импортирования» часто используемого кода со страницы шаблона. Синтаксис шаблона прост:
<syntaxhighlight lang=moin>
<pre>
{{Название шаблона|параметр 1 = значение 1|...|параметр n = значение n}}
{{Название шаблона|параметр 1 = значение 1|...|параметр n = значение n}}
<!-- Однако шаблон может заполняться так: -->
<!-- Однако шаблон может заполняться так: -->
Строка 21: Строка 21:
{{Название шаблона}}
{{Название шаблона}}
<!-- Кстати, конструкция в которой написано это предложение - комментарий -->
<!-- Кстати, конструкция в которой написано это предложение - комментарий -->
</syntaxhighlight>
</pre>
То есть шаблон начинается с <tt><nowiki>{{Название шаблона</nowiki></tt>, затем идут параметры, которые разделяются <tt>|</tt>, а шаблон заканчивается <tt>}}</tt> после последнего параметра. Параметры могут быть и пустыми, тогда вместо них в шаблоне будет отображаться значение «по умолчанию».
То есть шаблон начинается с <tt><nowiki>{{Название шаблона</nowiki></tt>, затем идут параметры, которые разделяются <tt>|</tt>, а шаблон заканчивается <tt>}}</tt> после последнего параметра. Параметры могут быть и пустыми, тогда вместо них в шаблоне будет отображаться значение «по умолчанию».


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


<nowiki>[[Файл:Название.расширение|параметры|подпись]]</nowiki>
<syntaxhighlight lang=moin inline>[[Файл:Название.расширение|параметры|подпись]]</syntaxhighlight>


==== Основные параметры ====
==== Основные параметры ====

Версия от 08:53, 8 декабря 2019

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

См. также

Примечания