Язык разметки, называемый викитекстом , также известный как вики-разметка или викикод , состоит из синтаксиса и ключевых слов, используемых программным обеспечением MediaWiki для форматирования страницы. (Обратите внимание на написание этих терминов строчными буквами.) [a] Чтобы узнать, как просмотреть эту гипертекстовую разметку и сохранить изменения, см. раздел «Справка:Редактирование» . Как правило, код можно копировать и вставлять без написания нового кода. Краткий список разметки и советы можно найти на странице Help:Cheatsheet .
Помимо викитекста, для форматирования презентации также разрешены некоторые элементы HTML . Дополнительную информацию об этом см. в разделе «Справка:HTML» в викитексте .
Разделы статьи на странице будут следовать заголовку или вступлению этой страницы , а если их четыре или более, - оглавлению .
Сквозная разметка — это заголовки разделов, с которыми они связаны =
.======
[edit]
ссылки. См. этот раздел для получения информации о соответствующем CSS.
Шаблоны: {{ поддельный заголовок }} для использования в документации.
Горизонтальная линия представляет собой тематический разрыв на уровне абзаца. Не используйте в содержании статьи, так как правила используются только после основных разделов, и это происходит автоматически.
HTML-эквивалент: <hr />
(который может иметь отступ, тогда как ---- всегда начинается с левого поля.)
Если на странице имеется как минимум четыре заголовка, оглавление (TOC) автоматически появится после заголовка и перед первым заголовком. Оглавлением можно управлять с помощью волшебных слов или шаблонов:
__FORCETOC__
заставляет оглавление появляться в обычном месте независимо от количества заголовков.__TOC__
заставляет оглавление появляться в том месте, где вставлено волшебное слово, вместо обычного места.__NOTOC__
полностью отключает TOC.Разрывы строк или новые строки используются для добавления пробелов между строками, например, для разделения абзацев.
HTML-эквивалент: <br>
или <br />
может использоваться для разрыва макета строки.
Шаблоны разрывов строк:
Немаркированный список:
Отступы чаще всего используются на страницах обсуждения.
Шаблоны: {{ outdent }}, {{ outdent2 }}
Когда возникает необходимость разделения блока текста. Это полезно для (как следует из названия) вставки блоков цитируемого (и цитируемого) текста.
При этом используется тег HTML; template {{ quote }} приводит к тому же рендерингу.
Шаблон {{ center }} использует ту же разметку. Чтобы центрировать таблицу, см. Help:Table#Центрирование таблиц . Пожалуйста, не используйте <center>...</center>
теги, так как они устарели.
Вы можете выровнять контент в отдельный контейнер:
Или; заставить текст плавать вокруг него:
Не оставляйте пустые строки между элементами списка, если для этого нет причины, поскольку это приводит к тому, что программное обеспечение MediaWiki интерпретирует каждый элемент как начало нового списка.
Чтобы перечислить термины и определения, начните новую строку с точки с запятой (;), за которой следует термин. Затем введите двоеточие (:) и определение. Формат также можно использовать для других целей, например, для определения марки и модели транспортных средств и т. д.
Списки описаний (ранее — списки определений или списки ассоциаций ) состоят из имен групп, соответствующих значениям. Названия групп (термины) выделены жирным шрифтом. Значения (определения) располагаются с отступом. Каждая группа должна включать одно или несколько определений. Для одного или первого значения :
можно разместить его в той же строке после ;
, но последующие значения должны быть размещены в отдельных строках.
HTML-эквивалент: <dl>
<dt>...</dt>
,<dd>...</dd>
</dl>
Шаблоны: {{ defn }}
Программное обеспечение MediaWiki подавляет одиночные символы новой строки и преобразует строки, начинающиеся с пробела, в предварительно отформатированный текст в пунктирном поле. HTML подавляет несколько пробелов. Часто желательно сохранить эти элементы в стихах, текстах песен, девизах, клятвах и т.п. Расширение Poem добавляет HTML-подобные <poem>...</poem>
теги для поддержки символов новой строки и пробелов. Эти теги могут использоваться внутри других тегов, таких как <blockquote>...</blockquote>
; шаблон обеспечивает удобное сокращение. К этому тегу можно применить стили CSS , например: .{{poemquote}}
<poem style="margin-left: 2em;">
Стихи и их перевод могут быть представлены рядом, а язык может быть указан с помощью lang="xx"
. После последнего параллельного блока необходимо использовать для отмены и восстановления нормального потока. Обратите внимание, что для этого метода не требуется таблица и ее столбцы для параллельного представления.{{Clear|left}}
"float:left;"
Разметка
< стихотворение lang = "fr" style = "float:left;" > Брат Жак, брат Жак, Дормез-ву? Дормез-ву?Sonnez les matines! Sonnez les matines!Дин, дан, дон. Дин, дан, дон. </ поэма > < стиль стихотворения = "margin-left:2em; float:left;" > Ты спишь? Ты спишь? Брат Джон, Брат Джон,Звонят утренние колокола! Звонят утренние колокола!Дин, дан, дон. Дин, дан, дон. </ стихотворение >{{ Очистить | левый }}
Отображается как
Брат Жак, брат Жак,
Дормезву? Дормез-ву?
Sonnez les matines! Sonnez les matines!
Дин, дан, дон. Дин, дан, дон.
Ты спишь? Ты спишь?
Брат Джон, Брат Джон,
Звонят утренние колокола! Звонят утренние колокола!
Дин, дан, дон. Дин, дан, дон.
Специальные символы часто могут отображаться с помощью числовых ссылок на символы или ссылок на символьные сущности . Дополнительную информацию см. в разделе Кодировки символов в HTML . Например, и то, À
и À
другое отображает À (A- могила ). Процентное кодирование использовать нельзя, поскольку оно работает только с URL-адресами .
Диакритические знаки с использованием ссылок на символьные сущности.
Использование ссылок на символьные сущности.
Также доступны теги разметки <pre>, <nowiki> и <code>, например, для написания «[», «{», «&», «}», «]». Эти теги не позволяют распознавать эти символы как разметку вики, что возможно в некоторых случаях.
Использование ссылок на символьные сущности.
Использование ссылок на символьные сущности.
WikiHiero — это программное расширение, которое отображает египетские иероглифы в виде изображений PNG с использованием <hiero>
тегов HTML.
Пример:
Например, ♔ отображает ♔
<sub>
и <sup>
, например . Поэтому это следует использовать в большинстве случаев.x<sub>1</sub>
По возможности следует избегать невидимых символов и символов PUA (частное использование) . При необходимости их следует заменить значениями их (шестнадцатеричных) десятичных кодов (например, «&#(x)...;»). Это делает невидимые символы видимыми для редактирования вручную и позволяет AWB обрабатывать страницы с символами PUA. Последний также должен быть помечен шаблоном {{ PUA }} для отслеживания и дальнейшего обслуживания.
×
не следует использовать простую букву x
. См. форматирование математических шрифтов . Полный набор символов и сравнение <math>
тегов и шаблона {{ math }} см. в разделе TeX и HTML .<math>
набирается с использованием разметки LaTeX , [b] , которая может отображаться как изображение или HTML, в зависимости от настроек среды. Тег <math>
лучше всего подходит для сложной формулы на отдельной строке в формате изображения. Если вы используете этот тег для помещения формулы в строку с текстом, поместите ее в шаблон {{ nowrap }}.=
знаку, поэтому не забудьте заменить =
его на при вводе шаблона или начать ввод с . Используйте вики-разметку и внутри шаблона {{ math }}, а также другие объекты HTML . Шаблон {{ math }} лучше всего подходит для набора формул в соответствии с текстом.{{=}}
1=
''
'''
для предотвращения разрыва строки не требуется; шаблон {{ math }} в любом случае предотвратит разрывы строк; вы можете использовать <br />
, если вам нужен явный разрыв строки внутри формулы.<math>
.<math display=block>...</math>
Создание отступов с использованием символа двоеточия (:) (т. е. использование вместо ) не рекомендуется из соображений доступности .:<math></math>
<math display=block></math>
Викиссылки используются в разметке викитекста для создания внутренних ссылок между страницами. Вы создаете вики-ссылки, заключая в двойные квадратные скобки текст, обозначающий заголовок страницы, на которую вы хотите дать ссылку. Таким образом, будет отображаться как Техас . При желании вы можете использовать вертикальную полосу (|), чтобы настроить заголовок ссылки. Например, при вводе будет создана ссылка «Штат одинокой звезды» , которая отображается как « Штат одинокой звезды », но на самом деле ведет на Техас .[[Texas]]
[[Texas|Lone Star State]]
en.wikipedia.org/wiki/Help:Wikitext/Public_transport
, который представляет собой статью Википедии под названием «Общественный транспорт». См. также Канонизация .[[language code:Foreign title]]
[[Category:Example]]
https://
(желательно) и http://
поддерживаться всеми браузерами; irc://
, ircs://
, ftp://
, news://
, mailto:
, и gopher://
потребуется плагин или внешнее приложение. Адреса IPv6 в URL-адресах в настоящее время не поддерживаются.%20
. Кодирование может быть достигнуто путем:{{urlencode:}}
Музыкальная нотация добавляется с помощью расширения HTML-тега. Например:<score>...</score>
Можно использовать только изображения, загруженные в Википедию или Wikimedia Commons. Чтобы загрузить изображения, используйте мастер загрузки Commons для сделанных вами фотографий и страницу загрузки Википедии , если могут возникнуть проблемы с авторскими правами. Вы можете найти загруженное изображение в списке изображений .
Ознакомьтесь с политикой использования изображений Википедии, чтобы узнать о политике, используемой в Википедии.
Дополнительную информацию по изображениям, включая некоторые более универсальные возможности, см. в руководстве по изображениям и расширенном синтаксисе изображений .
Существует два способа построения таблиц:
<table>
, <tr>
, <td>
или <th>
.Используйте шаблоны {{ colbegin }} и {{ colend }} для создания столбцов.
Сделать ссылку со ссылкой на печатный или онлайн-источник можно с помощью <ref>
тегов разметки wiki. Внутри этих тегов добавляются сведения о ссылке.
Подробности о цитировании можно предоставить, используя структуру, предоставляемую различными шаблонами; в таблице ниже перечислены некоторые типичные компоненты цитирования.
Примеры шаблонов: {{pad|...}}, {{math|...}}, {{на момент |...}}, {{edit}}
Шаблоны — это сегменты вики-разметки, которые предназначены для автоматического копирования («включения») на страницу. Они указываются путем помещения имени шаблона в {{двойные скобки}}. Большинство шаблонов представляют собой страницы в пространстве имен Template , но можно включить страницы основного пространства (статьи), используя {{:двоеточие и двойные скобки}}.
В викитексте можно использовать три пары тегов для управления тем, как включение влияет на части шаблона или статьи. Они определяют, будет ли отображаться викитекст: либо в отдельной статье, которую мы назовем « здесь », либо в другой статье, в которую он включен, и которую мы назовем « там ».
Таких разделов « элементы » может быть несколько . Кроме того, они могут быть вложенными. Все возможные визуализации достижимы. Например, чтобы отобразить здесь один или несколько разделов страницы, используйте теги <onlyinclude> . Чтобы добавить туда текст , оберните это дополнение тегами <includeonly> до, внутри или после раздела. Чтобы пропустить части раздела, вставьте в него теги <noinclude> .
Если страница включена без разметки включения, это может привести к непреднамеренной категоризации . Любая страница, исключающая ее, будет содержать ту же категорию, что и исходная страница. Оберните разметку категории тегами <noinclude> , чтобы предотвратить неправильную категоризацию.Некоторые шаблоны также принимают параметры|
, которые разделяются символом вертикальной черты .
Они, вероятно, будут полезны на страницах обсуждений и проектов .
Семейство шаблонов можно использовать для выделения примера текста . Эти шаблоны не работают в основном пространстве, то есть в обычных статьях, они предназначены для использования на страницах проектов (таких как Wikipedia:Manual of Style ), страницах справки и страницах пользователей.{{xt}}
<del>...</del>
<ins>...</ins>
Шаблон {{ Strikethrough }} отмечает фрагмент текста тегом <s>...</s>
. Обычно это визуализируется путем рисования через него горизонтальной линии. За пределами статей его можно использовать, чтобы пометить что-то как устаревшее или неактуальное, не удаляя его из поля зрения. Однако не используйте его для обозначения изменений документа. Для этого используйте <del>...</del>
тег. Подробности см. в разделе «Показать удаленный или вставленный текст».
Несколько различных типов форматирования заставят вики отображать данные по мере их ввода — что вы видите, то и получаете!
<nowiki>...</nowiki>
(разметка вики, содержащаяся между этими двумя тегами, отображается как обычный текст)<nowiki />
(разметка вики, прерываемая этим тегом, отображается как обычный текст, как подробно показано в примерах ниже)Эти два типа новики действуют по-разному, но оба нейтрализуют рендеринг разметки вики, как показано в примерах ниже. Например, символы, имеющие значение вики - разметки в начале строки ( *
, и ), могут отображаться в обычном тексте. Редакторы могут нормализовать шрифт символов, следующих за викиссылкой, которые в противном случае отображались бы в шрифте викиссылки. А новые строки, добавленные в викитекст для удобства чтения, можно игнорировать. #
;
:
Примечание для редакторов шаблонов: тег <nowiki>
работает только на исходной странице, а не на целевой.
Остальная часть раздела состоит из простых живых примеров, показывающих, как один тег nowiki экранирует целые структуры связей, за пределами и :[[wikilink]]
{{template}}
Если вы не используете два «сбалансированных» тега nowiki, устранение ошибок маркера полосы и несоответствий обработки параметров шаблона представляет собой риск. Кроме того, ошибка рендеринга может возникнуть, когда две [[...]]квадратные скобки находятся на одной строке или две {{...}}фигурные скобки находятся в одном разделе, но только тогда, когда разметка nowiki размещена в них непоследовательно.
(Это все живые примеры.)
Для вложенных структур экранирование внутренней структуры также позволяет избежать и ее внешней структуры.
Для двух первых пайпов требуются два тега nowiki:
Для шаблонов поместите nowiki перед первой трубой. Если у параметра есть вики-ссылка, поместите ее в самую внутреннюю позицию.
Для входных параметров {{{1}}}, {{{2}}} просто запишите их, если только они не имеют значения по умолчанию (которое находится за их каналом): {{<nowiki />{1|default}} } → {{{1|по умолчанию}}}
Для функции синтаксического анализатора nowiki идет между символами пары скобок или где-нибудь до двоеточия :.
Поведенческие переключатели ожидают тег где угодно:
Теги не отображаются; это просто разметка. Если вы этого хотите, вставьте <nowiki />
после <
открывающей угловой скобки; оно идет только в самом переднем плане. Открывающие и закрывающие теги следует рассматривать отдельно.
Используйте шаблон {{ tag }} вместо тегов nowiki для отображения тегов парсера:
Сущности персонажей , новики не могут сбежать. Чтобы экранировать объекты HTML или специальные символы, замените &
на &
. Например, &lt;
→<
Чтобы отобразить тег nowiki , вы можете (1) использовать {{ tag }}, (2) заменить левую угловую скобку < ее символом HTML или (3) вложить теги nowiki друг в друга:
Теги Nowiki не вложены друг в друга, поэтому отображаются второй и четвертый:
Они просто сканируют слева направо. Парные теги не могут перекрываться, поскольку самое первое совпадение пары аннулирует все промежуточные теги внутри. Несбалансированные теги отображаются всегда.
Теги Nowiki не отображают разметку таблицы, используйте расширение <pre>...</pre>
.
<pre>
— это тег синтаксического анализатора, который имитирует <pre>
тег HTML. Он определяет предварительно отформатированный текст, который отображается шрифтом фиксированной ширины и заключен в пунктирную рамку. Теги HTML-подобной и вики-разметки экранируются, пробелы и разрывы строк сохраняются, но HTML-элементы анализируются.
Как <pre>
и тег парсера, он экранирует теги викитекста и HTML. Этого можно избежать с помощью <includeonly></includeonly> внутри <pre>
, что сделает его более похожим на его HTML-эквивалент:
Невидимые <pre>
теги HTML также можно вставлять, предваряя текст пробелом, например:
вики- разметка и
В качестве альтернативы рассмотрите возможность использования шаблона {{ pre<syntaxhighlight lang="text">...</syntaxhighlight>
}} или .
Редко, но иногда допустимо для заметок другим редакторам, добавлять скрытый комментарий в текст статьи. Эти комментарии видны только при редактировании или просмотре исходного кода страницы. Большинство комментариев должно размещаться на соответствующей странице обсуждения . Формат заключается в том, чтобы окружить скрытый текст символами " <!--
" и " -->
" и может занимать несколько строк, например:
<!-- Пример скрытых комментариев Это не будет видно, кроме как в режиме «редактирования». -->
Другой способ включить комментарий в разметку вики — использовать шаблон {{ Void }}, который можно сократить до {{ ^ }}. Этот шаблон «расширяется» до пустой строки, не создавая вывода HTML; он виден только людям, редактирующим исходный код вики. Таким образом действует аналогично комментарию . Основное отличие состоит в том, что версия шаблона может быть вложенной, а попытка вложить комментарии HTML приводит к странным результатам.{{^|A lengthy comment here}}
<!-- A lengthy comment here -->
{{NUMBEROFARTICLES}} — количество страниц в основном пространстве имен, содержащих ссылку и не являющихся перенаправлением. Сюда входят полные статьи, незавершенные статьи, содержащие ссылки, и страницы со значениями.
{{CURRENTMONTHNAMEGEN}} — это родительный (притяжательный) грамматический падеж названия месяца, используемый в некоторых языках, но не в английском; {{CURRENTMONTHNAME}} — это именительный падеж (подлежащее), обычно встречающийся в английском языке.
В языках, где это имеет значение, вы можете использовать конструкции, например, для преобразования слова из именительного падежа в какой-либо другой падеж. Например, означает то же, что и . {{grammar:case|word}}
{{grammar:genitive|{{CURRENTMONTHNAME}}}}
{{CURRENTMONTHNAMEGEN}}
Многие HTML- теги можно использовать в разметке вики. Вы можете проверить свой HTML с помощью проверки разметки .
Дополнительные ссылки см. в разделе «Кодирование вики-разметки» в навигационном окне «Справка» ниже.