Справка:Разметка

Материал из Мракопедии
Перейти к: навигация, поиск

Вики-разметка — это то, что вы можете впечатывать в окошко при редактировании состоит из следующих частей:

  1. Просто текста — буковок, циферок, пробелов, знаков препинания. На сайте поддерживается кодировка Unicode. Также можно использовать мнемоники &чтототам;, практически полезны из них &lt; (<), &gt; (>), &quot; (") и &amp; (&).
  2. Разметка HTML — тэги типа <s>S</s>, <span style="color:red;background:black">SPAN</span>, <br/> и т. д. Элементы HTML и стили CSS применяются с некоторыми ограничениями (основное — нельзя напрямую вставить тэг <a>), не будем подробно на этом останавливаться.
  3. Собственно вики-разметка, которая применяется вместо HTML для удобства (в случае создания ссылок — принудительно). Частично её можно вставить кнопочками сверху от окна редактирования. О ней чуть ниже.
  4. Волшебные слова MediaWiki — конструкции вида __КАКОЙТОБРЕД__ либо {{какойтобред:параметр1|параметр2}}. Например, {{lc:ЗаБоРчЕГ}} = заборчег.
  5. Функции расширений — аналогичная вещь, но навешанная на движок дополнительно. Например, тут работает расширение ParserFunctions, и поэтому {{#expr: 1 + 1}} = 2.
  6. Шаблоны — тоже в двойных фигурных скобках, но представляют собой страницы этой вики (по умолчанию расположенные в пространстве имён Шаблон:), включаемые таким образом в другие страницы. Например, на большинстве страниц написано {{main}}, что подставляет на них Шаблон:main. У шаблонов могут быть параметры: {{имя шаблона|параметр1|имя параметра2=параметр2}}. Подробнее см. Справка:Шаблоны.
  7. Тэги MediaWiki — выглядят в коде как HTML-тэги, но делают что-либо специальное. Наиболее известен тэг <spoiler>. Чтобы кунсткамера из пунктов 2—7 не мешала вам жить, её можно убрать в тэг <nowiki> (зачёркнутая буква W в панельке редактирования).

Список поддерживаемых в вики расширений, их тэгов и функций парсера можно увидеть на странице Special:Version. Перед некоторыми функциями ещё надо ставить символ #, например, {{#tag}}.

И пожалуйста, используйте предварительный просмотр!

Подстановка[править]

Если к любой конструкции в двойных фигурных скобках дописать после открывающих фигурных скобок subst:, то результат будет вычислен один раз перед тем, как страница будет записана. Например, если вы набираете {{subst:#expr: 1 + 1}}, то эффект получается ровно такой же, как если бы вы просто ввели 2. О тонкостях подстановки шаблонов см. Справка:Шаблоны#Подстановка. Кроме того, если вы введёте [[Пространство имён:Название статьи (уточнение)|]], то запишется [[Пространство имён:Название статьи (уточнение)|Название статьи]].

Порядок выполнения страницы[править]

Немного теории, как работает движок.

Сначала рассматриваются тэги MediaWiki в том порядке, в каком они открываются. В некоторых из них викиразметка может работать не так, как обычно (например, в тэгах ref не работает подстановка). Дальше (при редактировании статьи) обычно срабатывает подстановка (при этом неподставляемые конструкции в фигурных скобках рассматриваются подставляемыми как обычный текст), и если после раскрытия шаблонов образуется ещё что-то, что надо подставить — это опять подставляется. Дальше также циклически срабатывают просто конструкции в фигурных скобках. В обоих случаях сначала срабатывают глубже вложенные фигурные скобки. Затем вики-разметка преобразуется в HTML, а HTML проверяется на допустимость и упрощается так, как движок это понимает.

Параметры в шаблонах разделяются символами "|", а необязательное имя параметра — это всё до первого символа "=" вне вложенных фигурных скобок. Чтобы вставить в шаблоны соответствующие символы, а также применить в тексте собственно двойные фигурные скобки, нужны специальные шаблончики {{!}}, {{=}}, {{ХХ}} и {{ЪЪ}}. И, кстати, для ссылок на шаблоны удобен шаблон {{T}}.

Чтобы выполнить тэг расширения позже, чем функцию парсера, используйте функцию #tag. Например, так делаются примечания к примечаниям (поскольку тэги ref друг из друга не работают):

{{#tag:ref|Одно примечание<ref>Другое примечание.</ref>.}}

Вики-разметка[править]

Разделы, абзацы, списки и строки[править]

Как это выглядит Что нужно набрать HTML-аналог


Начните раздел со строки заголовка:

Новый раздел


Подраздел

Под-подраздел

Начните раздел со строки заголовка:

== Новый раздел ==

=== Подраздел ===

==== Под-подраздел ====
h2—h6


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

Но пустая строка начинает новый абзац.

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

Но пустая строка
начинает новый абзац.
p


С помощью тега «br» можно разрывать строки,
не начиная новый абзац.
С помощью тега «br» можно разрывать строки,<br />
не начиная новый абзац.
br


Сделать список очень просто:

  • каждая строка начинается со звёздочки;
    • чем больше звёздочек — тем глубже уровень;
      отступ внутри можно делать и с помощью двоеточия.
Сделать список очень просто:
* каждая строка начинается со звёздочки;
** чем больше звёздочек — тем глубже уровень;
**: отступ внутри можно делать и с помощью двоеточия.
ul, li


  1. Нумерованные списки тоже хороши:
    1. очень организованные;
    2. легко читаются.
# Нумерованные списки тоже хороши:
## очень организованные;
## легко читаются.
ol, li


  • Можно также делать смешанные списки:
    1. и вкладывать их
      • как, например,
    2. здесь.
* Можно также делать смешанные списки:
*# и вкладывать их
*#* как, например,
*# здесь.
ul, ol, li


Tочка с запятой в начале строки
и затем двоеточие
создают
двухуровневый список.
;Tочка с запятой в начале строки: и затем двоеточие
;создают: двухуровневый список.
dl, dt, dd


Двоеточие в начале строки делает отступ абзаца.

Простой перенос строки при этом начинает новый абзац.

Примечание: это применяется в основном на страницах обсуждения.

:Двоеточие в начале строки делает отступ абзаца.
Простой перенос строки при этом начинает новый абзац.
dl dd


ЕСЛИ строка начинается с пробела, ТОГДА
  она будет отформатирована так же,  
    как и набрана;
  шрифтом фиксированной ширины;
  без переноса строк;
   [[без ссылок]];
КОНЕЦЕСЛИ
Это можно применять для:
  * вставки преформатированного текста;
  * описания алгоритмов;
  * исходного кода программ
  * ascii art (создание изображений при помощи 
    текстовых символов).

ВНИМАНИЕ! Если вы сделаете такую строку длинной, у неё появится полоса прокрутки. Никогда не начинайте обычные строки с пробела.

 ЕСЛИ строка начинается с пробела, ТОГДА
   она будет отформатирована так же, 
     как и набрана;
   шрифтом фиксированной ширины;
   без переноса строк;
    [[без ссылок]];
 КОНЕЦЕСЛИ
Это можно применять для:
  * вставки преформатированного текста;
  * описания алгоритмов;
  * исходного кода программ
  * ascii art (создание изображений
    при помощи текстовых символов);
pre


Центрированный текст.
<center>Центрированный текст.</center>
center


Горизонтальная разделительная линия:

четыре дефиса подряд

Горизонтальная разделительная линия: 
----
четыре дефиса подряд
hr


Этот абзац отцентрирован.

Этот абзац выровнен по левому краю.

Этот абзац выровнен по правому краю.

Вы можете управлять выравниванием текста абзаца, используя теги <p> с указанием в атрибуте style параметра text-align, со значением

  • center для выравнивания по центру,
  • left для выравнивания по левому краю,
  • right для выравнивания по правому краю.

По умолчанию принято выравнивание по левому краю.

Например, для выравнивания по правому краю используйте такую конструкцию:

<p style="text-align:right;">Текст</p>
p



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

Как это выглядит Что надо набрать

Мне приснился страшный сон.

  • Первая буква точки назначения автоматически делается большой.
  • Внутренние пробелы автоматически представляются как подчёркивания (набор подчёркивания имеет тот же эффект, что и набор пробела, но не рекомендуется).

Таким образом, приведённая выше ссылка ведёт на https://mrakopedia.org/wiki/Страшный_сон, которая является статьёй с названием «Страшный сон».


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

Пример: Я такого и в страшном сне не видел.

Мне приснился [[страшный сон]].

Я такого и в [[Страшный сон|страшном сне]] не видел.
Та же ссылка, но с другим именем: справочная информация.
Та же ссылка, но с другим именем: 
[[Справка:Содержание|справочная информация]]
Окончания сливаются со ссылкой:

лесники, в 2012 году

Окончания сливаются со ссылкой: [[лесник]]и, в [[2012 год]]у

Автоматически скрывается заключённое в круглых скобках: Камень.

Автоматически скрывается пространство имён: Портал сообщества.

Сервер заполняет часть после | в момент сохранения страницы.

Автоматически скрывается заключённое в круглых скобках:
[[Камень (бретонская легенда)|]]. 
Автоматически скрывается пространство имён: 
[[Мракопедия:Портал сообщества|]].
Можно ссылаться на подраздел в самой статье, указав его после «решётки»: Работа начинается.
Можно ссылаться на подраздел в самой статье,
 указав его после «решётки»:
[[Пещера Тэда#Работа начинается|Работа начинается]].

Если вы хотите просто создать ссылку на категорию, не добавляя в неё текущую страницу, используйте ссылки следующего вида: Категория:Избранное. Не забывайте добавлять : в начало ссылки.

Если вы хотите просто создать ссылку на [[special:AllPages/Категория:|категорию]],
не добавляя в неё текущую страницу,
используйте ссылки следующего вида:
[[:Категория:Избранное]].
При добавлении комментариев к странице обсуждения следует их подписать. Это можно сделать, добавив три тильды для получения имени пользователя:
Montrealais

или четыре для получения имени пользователя плюс дата/время:

Montrealais 08:10 Oct 5, 2002 (UTC)
При добавлении комментариев к странице обсуждения,
следует их подписать. Это можно сделать, добавив
три тильды для получения имени пользователя:
: ~~~
или четыре для получения имени пользователя плюс
дата/время:
: ~~~~
Именно вариант с датой и временем является предпочтительным.
Медведи на улицах Москвы — это страница, которая ещё не создана.

Вы можете создать её, кликнув по ссылке. Подробнее см. Мракопедия:Добавление новой истории.

[[Медведи на улицах Москвы]] — это 
страница, которая ещё не создана.

Если на один текст надо ссылаться по различным названиям страниц, создайте на него перенаправление, поместив следующий текст в первую строку. См. mw:Help:Redirects/ru для более подробной информации.

#REDIRECT [[Соединённые Штаты Америки]]

Внешняя ссылка: Nupedia

  • В URL могут быть только следующие символы: буквы от a до z и от A до Z, цифры от 0 до 9, символы с кодами от \x80 до \xFF, символы ._\/~%-+&#?!=()@ . Если URL содержит другие символы, их следует преобразовать: например, вместо [ записать %5В, а ] заменить на %5D (распространённые коды см. в статье URL, полный список кодов — в статье ASCII).
  • Также не следует указывать закрывающий символ / в URL.
Внешняя ссылка: [http://www.nupedia.com Nupedia];
если материалы по ссылке предоставлены на другом языке, этот язык 
желательно указывать явно: [http://www.nupedia.com Nupedia]{{ref-en}} 
Или просто укажите URL: http://www.nupedia.com.


Или просто укажите URL: 
http://www.nupedia.com.
Указать e-mail можно так:

[email protected]

  • Этот адрес приведён для примера, не используйте его.
Указать e-mail можно так:
[mailto:[email protected] [email protected]]

Для ссылки на RFC используйте:

RFC 1234

RFC 1234

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

Как это выглядит Что следует набрать

Чтобы поставить ударе́ние, поcле ударной гласной напишите {{subst:'}}.

ударе{{subst:'}}ние

Полужирное и курсивное начертания используются в следующих случаях:

логическое ударение
структурное выделение
логическое ударение в структурном выделении (или наоборот)

Это двойные и тройные апострофы, а не кавычки.

''логическое ударение''<br />
'''структурное выделение'''<br />
'''''логическое ударение в структурном выделении (или наоборот)'''''.

Вы также можете писать курсивом и жирным, если вас интересует определённый стиль шрифта, а не логическое выделение, например, в математических формулах:

F = ma

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

Вы также можете писать ''курсивом'' и '''жирным''',
если вас интересует определённый стиль шрифта, 
а не логическое выделение, например, в математических формулах:

:'''F''' = ''m'''''a'''
Моноширинный шрифт для технических терминов.
Моноширинный шрифт для <tt>технических терминов</tt>.
Специальное форматирование для фрагментов кода программы.
Специальное форматирование для фрагментов 
<code>кода программы.</code>
Вы можете использовать маленький текст для комментариев.
Вы можете использовать <small>маленький текст</small> для комментариев.
Вы можете перечёркивать удалённый материал

и подчёркивать новый материал.

Вы можете <strike>перечёркивать удалённый материал</strike>
и <u>подчёркивать новый материал</u>.
x²   ≥   0 true

Для разделения пробелами используйте знак пробела: &nbsp;. Это также предотвращает переносы строк посреди текста, что полезно в формулах.

''x''<sup>2</sup>&nbsp;&nbsp;&ge;&nbsp;&nbsp;0 true.
Нижний индекс: x2

Верхний индекс: x2 или x²

Второй метод не может использоваться в общем случае, но при возможности (например, для единиц измерения) следует использовать именно его, поскольку большинство браузеров при этом лучше форматируют строки:

ε0 = 8.85 × 10−12

C² / J m.
Нижний индекс: x<sub>2</sub>
Верхний индекс: x<sup>2</sup> или x&sup2;
&epsilon;<sub>0</sub> =
8.85 &times; 10<sup>&minus;12</sup>
C&sup2; / J m.

Подавление интерпретации разметки:
Link → (''to'') the [[Мракопедия:Справка]]

  • Используется для изображения данных, содержащих символы со специальным значением.
  • Игнорирует всю разметку wiki, включая ту, что выглядит как теги HTML.
  • Не игнорирует символьные последовательности HTML.
<nowiki>Link &rarr; (''to'') 
the [[Мракопедия:Справка]]</nowiki>

Комментарий в исходном тексте страницы:
не отображается на странице

Используется для внесения в исходный текст страницы комментария для последующих редакторов.

<!-- комментарий -->

Таблицы[править]

Вкратце, таблицы проще всего делать, указывая в начале строк определённые последовательности символов. Соответствие между ними и тэгами HTML:

 {|   <table>
 |-   <tr>
 !    <th/>
 |    <td/>
 |}   </table>

Несколько ячеек можно размещать в одной строке; элементам таблиц можно назначать стили и атрибуты, как показано в примере ниже.

{| rules=all border=1
|-
!Заголовок1!!Заголовок2
!style="color:yellow"|Заголовок3
|- style="color:green"
|Ячейка1||Ячейка2||Ячейка3
|-
|align=right|Ячейка4
|align=center|Ячейка5
|style="vertical-align:bottom;text-align:left;color:red;background:yellow"|Ячейка6
|}
Заголовок1 Заголовок2 Заголовок3
Ячейка1 Ячейка2 Ячейка3
Ячейка4 Ячейка5 Ячейка6

Оглавление статьи[править]

Если в статье содержится по меньшей мере четыре раздела, то панель «Содержание» (с оглавлением статьи) автоматически появляется на странице, непосредственно перед первым заголовком (то есть сразу после вступительного раздела).

  • Если вы хотите, чтобы «Содержание» появилось в каком-либо другом месте статьи (а не там, где оно появляется по умолчанию), то поместите ключевое слово __TOC__ в этом месте.
  • Если вы не хотите нумерации пунктов оглавления, но, возможно, хотите, чтобы они шли по горизонтали, используйте в нужном месте шаблон {{notocnumber}}.
  • А для того, чтобы «Содержание» вообще нигде не появлялось, достаточно поместить ключевое слово __NOTOC__ где угодно на странице.

Категории[править]

На каждой странице, кроме заглавной и Категория:Крипи, по-хорошему должна быть хотя бы одна уместная там категория. Категории показываются внизу каждой страницы, а на странице категории появляется список страниц, которые в неё добавили. Для категоризации где угодно (но традиционно в конце кода, отбив пустой строкой от остального) ставится одна или несколько ссылок вида [[Категория:Название категории]]. Часто категории добавляются неявно шаблонами, такими, как {{main}}.

В категории страницы отсортированы по названию без префикса пространства имён. Если страницу надо в её категориях сортировать по какому-то другому слову, надо на ней написать {{#DEFAULTSORT:ключ сортировки}}; а если только в одной категории она сортируется как-то не так, то ссылку на неё надо указывать в виде [[Категория:Название категории|ключ сортировки]].

Изображения[править]

Изображения можно брать только из загруженных на mrakopedia.org (загрузить файл могут представившиеся участники).

Простейший синтаксис вставки: [[Файл:Имя файла]]. Дополнительно можно добавить замещающий текст, например, [[Файл:uboa.png|Убоа]]Убоа (внимание:регистр расширения имеет значение!).

Если добавить параметр |мини, изображение сожмётся в рамку с подписью и уплывёт в сторону: [[Файл:uboa.png|мини|мини-Убоа]]
мини-Убоа
Как полные изображения, так и миниатюры можно регулировать по размеру в пикселях (например, |100px или 200x100px) и сдвигать вправо (|справа, по умолчанию для миниатюр), влево (|слева) или на середину (центр). [[Файл:uboa.png|слева|мини|100px|мини-Убоа-100px слева]][[Файл:uboa.png|справа|100px|Убоа-100px справа]]
мини-Убоа-100px слева
Убоа-100px справа
Вместо указания ширины можно использовать |upright=N.NN, где N.NN — цифры (по умолчанию 0.75), доля стандартной ширины. Также можно использовать параметр link для указания, на что переходить при щелчке по картинке. [[Файл:Dog whip.jpg|link=пещера Тэда|upright=0.4|центр|собак]]
собак

Галереи[править]

Галерея — это удобный способ показать несколько изображений.

<gallery>
Файл:HEX Znak.jpg
Файл:HEX Katamaran.jpg|подпись
Файл:Angedufoyer.jpg|[[НЁХ]]
</gallery>

Специальные тэги[править]

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

Про административные настройки расширения Cite см. здесь.

Для вставки примечаний<ref>раз</ref><ref name=dva>два</ref> используйте тэги &lt;ref&gt; и &lt;references&gt;<ref name=dva/>.

<references/>

Для вставки примечаний[1][2] используйте тэги <ref> и <references>[2].

  1. раз
  2. 2,0 2,1 два
Можно группировать примечания<ref group="g1">прим1 группы g1</ref><ref>прим1 (предыдущие примечания без групп ушли в предыдущий тэг references)</ref> в различные группы<ref group=g1>прим2 группы g1</ref>, а можно описывать примечания внутри тэга references<ref name="п2"/>.

<references><ref name="п2">прим2</ref></references>
<references group=g1/>

Можно группировать примечания[g1 1][1] в различные группы[g1 2], а можно описывать примечания внутри тэга references[2].

  1. прим1 (предыдущие примечания без групп ушли в предыдущий тэг references)
  2. прим2
  1. прим1 группы g1
  2. прим2 группы g1

Постраничный CSS[править]

С помощью тэга <css> или функции {{#css:}} можно добавлять стили для данной страницы; эти тэги невидимы, но влияют на отображение других элементов. Использовать с осторожностью, если что-то надо лично вам, притом везде, добавьте это на special:MyPage/common.css.

Следующий код...

<css>#myboo:hover::before, #myboo:hover::after {
    content:'~~~';
    color: green;
}
#myboo:hover {
    display: inline-block;
    font-size: xx-large;
    color: red;
    background-color: black;
    line-height: 1.5;
}</css>

<div id="myboo">Наведи курсор сюда.</div>

...даст результат:


Наведи курсор сюда.