Программное обеспечение MediaWiki , которое управляет Wikipedia, позволяет использовать подмножество элементов HTML 5 или тегов и их атрибутов для форматирования представления. [1] Но большую часть HTML можно включить, используя эквивалентную вики-разметку или шаблоны ; они, как правило, предпочтительны в статьях, так как они иногда проще для большинства редакторов и менее навязчивы в окне редактирования; но Руководство по стилю Wikipedia рекомендует их использовать в определенных случаях. (См. Help:Wikitext для эквивалентов вики для тегов HTML, которые не обсуждаются ниже.) HTML также полезен за пределами статей, например, для форматирования в шаблонах. Для получения справки по использованию каскадных таблиц стилей в Wikipedia см. Help:Cascading Style Sheets .
Некоторые теги выглядят как HTML, но на самом деле являются тегами парсера и расширения MediaWiki, и поэтому на самом деле являются разметкой wiki. HTML на страницах можно проверить на соответствие HTML5 с помощью валидации. Некоторые элементы и атрибуты поддерживаются MediaWiki и браузерами, но были объявлены устаревшими HTML5 и, следовательно, больше не должны использоваться.
Эта страница справки дает только обзор разрешенной разметки. Для получения дополнительной помощи и подробных спецификаций:
Атрибуты HTML предоставляют дополнительную информацию об элементе и всегда указываются в начальном теге. Они форматируются как пара имя/значение, например name="value".
Глобальные атрибуты применяются ко всем тегам. Атрибуты, не перечисленные здесь, не допускаются MediaWiki [1] :
class: одна или несколько классификаций, к которым принадлежит элемент. См. Wikipedia:Catalogue of CSS classes .dir: направление текста — "ltr"(слева направо), "rtl"(справа налево) или "auto".id: уникальный идентификатор элемента.lang: основной язык для содержимого элемента согласно BCP 47 .style: применяет стили CSS к содержимому элемента.title: справочная информация, связанная с элементом.Атрибуты микроданных HTML5 применяются ко всем тегам: [2]
data-itemiditempropitemrefitemscopeitemtypeДругие теги, такие как <table>поддержка определенных атрибутов, перечислены в соответствующем разделе.
MediaWiki Sanitizer.phpделает некоторую очистку атрибутов. Лучше всего использовать правильный синтаксис.
Эти элементы HTML поддерживаются программным обеспечением MediaWiki. В этом разделе дается краткий обзор элемента HTML, пример, соответствующая вики-разметка и шаблоны.
Сквозные теги являются заголовками разделов, с которыми они связаны. <h1>...</h1>используется для заголовка статьи. Заголовки стилизуются через CSS и добавляются в оглавление страницы .<h6>...</h6><h1>
Wikimarkup: окружите текст соответствующим количеством знаков равенства. Заголовки, отформатированные с помощью wikimarkup, добавляют ссылку [редактировать].
Шаблоны: для использования в документации{{fake heading}}
<p>...</p>тег помещает содержимое в отдельный абзац.
Wiki-разметка: разделяйте абзацы одной пустой строкой.
<p>...</p>особенно полезно в списках, для элементов списка с несколькими абзацами:
Обратите внимание, что закрывающий тег </p>не является строго обязательным для установок MediaWiki, которые выводят HTML 5 (например, Wikipedia).
<br>вставляет перенос строки. См. H:BR для других 4 версий, в которые программное обеспечение MediaWiki преобразует <br />HTML, считываемый браузерами.
Шаблоны:
{{break}}добавляет несколько переносов строк.{{crlf2}}добавляет настоящий возврат каретки и перевод строки.{{clear}}добавляет разрыв со стилем для очистки плавающих элементов.{{plainlist}}создает немаркированный список.<hr>или <hr />представляет собой тематическую паузу на уровне абзаца и представлено в виде горизонтальной линии.
Вики-разметка: использование----
Шаблоны:{{hr}}
<!--...-->форматирует вложенный текст как скрытый комментарий.
Будьте осторожны с пробелами вокруг комментариев. Окружение комментария пустыми строками приведет к пустому абзацу, воспринимаемому как дополнительные две пустые строки:
<abbr>...</abbr>создает подсказку для определения аббревиатуры или акронима, которая отображается при наведении курсора мыши.
Шаблоны:{{abbr}}
<b>...</b>форматирует текст, стилистически смещенный относительно другого текста (жирный), не передавая при этом особой важности.
Wikimarkup: используется '''для открытия и закрытия жирного текста.
<bdi>...</bdi>изолирует содержимое от окружающих настроек направления текста.
Поддержка: Firefox, Chrome
<bdo>...</bdo>определяет направление текста.
Атрибуты и значения:
dir– Задает направление текста.ltrrtl<blockquote>...</blockquote>представляет текст в смещенном блоке.
Шаблоны: ; поддерживает предварительно отформатированные параметры атрибуции и источника. Для других специализированных шаблонов цитат см. Категория:Шаблоны цитат .{{quote}}
<cite>...</cite>содержит название работы. Это новое определение в HTML5 — в предыдущей реализации XML <cite>использовалось для содержания цитаты или ссылки на другие источники. При использовании этого тега форматирование не применяется.
<cite>...</cite>обычно не используется напрямую в статьях Википедии и часто используется неправильно; инструкции по замене см. на странице Wikipedia:HTML 5#cite .
<code>...</code>форматирует раздел компьютерного кода. Стилизовано с помощью CSS как mediawiki.skinning/elements.lessчерный моноширинный шрифт с серым фоном (#F8F9FA) и границей (#EAECF0).
Шаблоны: использует . Дополнительные шаблоны разметки кода см. в разделе «См. также» на странице шаблонов.{{code}}<syntaxhighlight>
См. § samp и § kbd на этой странице для семантической разметки вывода и ввода соответственно.
<data>...</data>форматирует машиночитаемую версию содержимого.
Атрибуты:value
<del>...</del>форматирует удаленный текст.
<dfn>...</dfn>используется для указания определяющего примера термина.
Шаблоны:{{dfn}}
<em>...</em>представляет собой фрагмент текста с эмфатическим ударением (т.е. семантическим акцентом). В большинстве браузеров он отображается курсивом.
Шаблоны:{{em}}
<i>...</i>представляет собой фрагмент текста, смещенный относительно окружающего его содержимого, не придавая ему дополнительного акцента или важности, и для которого общепринятым типографским представлением является курсивный текст.
Wikimarkup: используется ''для открытия и закрытия курсивного текста.
<ins>...</ins>указывает на диапазон текста, который был добавлен. Оформляется как подчеркнутый текст. Используется на страницах обсуждения для обозначения рефакторинга текста; см. WP:REDACT .
<kbd>...</kbd>указывает на пользовательский ввод, такой как ввод с клавиатуры или голосовые команды (но не gray background как в шаблоне ).{{kbd}}
Шаблоны:
{{kbd}}применяется моноширинный стиль и светло-серый фон для отличия от кода ( <code>) и выходных данных ( <samp>или ).{{samp}}{{key press}}отображает проиллюстрированные клавиши и нажатия клавиш.<mark>...</mark>представляет собой фрагмент текста в одном документе, отмеченный или выделенный для справочных целей, в связи с его релевантностью в другом контексте. Отмеченный текст по умолчанию форматируется с желтым фоном.
Поддержка: Не поддерживается Internet Explorer 8 и более ранними версиями.
<pre>...</pre>элемент представляет собой блок предварительно отформатированного текста. В MediaWiki на самом деле является тегом парсера, а не HTML, но функция та же. Он также предотвращает парсинг шаблонов.<pre>
<pre>анализирует HTML сущности . Если вы хотите избежать этого, замените &на &, или используйте <syntaxhighlight lang="text">вместо этого.
Шаблоны:
{{pre}}обтекает текст, выходящий за пределы страницы.<q>...</q>используется для обозначения короткой цитаты. В Википедии пока очень мало реализаций этого элемента.
MOS:QUOTATIONS говорит, что Википедия должна вместо этого использовать "", {{ quote }} или <blockquote>.
<ruby>...</ruby>отмечает фрагменты фразового контента аннотациями Ruby.
<rt>...</rt>обозначает компонент текста Ruby в аннотации Ruby; текст Ruby отображается в уменьшенном размере поверх обычных символов.<rp>...</rp>используется для заключения в скобки текстового компонента Ruby аннотации Ruby, которая отображается пользовательскими агентами, не поддерживающими аннотации Ruby.Браузеры, не поддерживающие символы Ruby, будут отображать текст Ruby обычного размера, заключенный в скобки и расположенный после обычного содержимого.
Шаблоны:
{{ruby}}{{ruby-ja}}для японского{{Ruby-zh-p}}для китайского пиньинь{{Ruby-zh-b}}для китайского бопомофо<s>...</s>используется для обозначения контента, который больше не является точным или релевантным и который был вычеркнут со страницы. Он не подходит для обозначения изменений в документе; чтобы отметить фрагмент текста как удаленный из документа, используйте <del>.
Шаблоны:{{strikethrough}}
<samp>...</samp>указывает на пример выходных данных программы или вычислительной системы. Примеры включают: выходные данные программы, скрипта или шаблона Википедии; дисплеи состояния или звуковые объявления, сделанные приложением или устройством; списки каталогов файловой системы и примеры из них, такие как пути и имена файлов.
Шаблоны: применяет моноширинный стиль и выделяет текст темно-серым цветом, чтобы отличить его от кода ( ) и входных данных ( или ).{{samp}}<code><kbd>{{kbd}}
<small>...</small>форматировать мелкий текст.
Шаблоны:
{{small}}использует <span style="font-size:85%;">. рекомендуется использовать , поскольку имеет семантическое значение, предназначенное для мелкого шрифта , тогда как является чисто стилистическим.{{small}}<small><small>...</small>{{small}}<strong>...</strong>форматирует фрагмент текста с сильным значением или необычным акцентом; в большинстве браузеров он отображается жирным шрифтом. Обычно его не следует использовать в статьях Википедии, согласно политике точки зрения WP:Neutral . См. MOS:BOLD об использовании этого элемента и других жирных шрифтах. Большая часть семантического акцента, включая цитируемый материал, должна отображаться с помощью этого <em>элемента.
Шаблоны:{{strong}}
<sub>...</sub>форматирует фрагмент текста как нижний индекс.
Шаблоны:
<sup>...</sup>форматирует фрагмент текста как верхний индекс.
Шаблоны:
{{sub}}( подстрочный текст){{subsub}}( подстрочный текст с нижним индексом ){{ssub}}( подстрочный, мелкий текст){{sup}}( надстрочный текст){{su}}(верхний индекс нижний индекс{{sup sub}}(текстsup {{e}}(1,23 × 104 )<time>...</time>определяет либо время (в 24-часовом формате), либо дату по григорианскому календарю, опционально с указанием времени и смещения часового пояса.
Атрибуты:datetime
Поддержка: Не поддерживается Internet Explorer 8 и более ранними версиями.
<u>...</u>представляет собой фрагмент текста, смещенный относительно окружающего его содержимого, не придавая ему дополнительного акцента или важности, и для которого в традиционном типографском представлении используется подчеркивание; например, фрагмент текста на китайском языке, представляющий собой имя собственное (знак китайского имени собственного), или фрагмент текста, который, как известно, написан с ошибкой.
<u>был презентационным элементом HTML , который изначально использовался для подчеркивания текста; это использование было отменено в HTML4 в пользу стиля CSS{text-decoration: underline} . [4] В HTML5 тег появился снова, но его значение было существенно изменено: теперь он «представляет собой промежуток встроенного текста, который должен быть отображен таким образом, чтобы указывать на то, что он имеет нетекстовую аннотацию». [4] Эта возможность предназначена, например, для предоставления подчеркивания красной волнистой линией для обозначения орфографических ошибок во время ввода, но которые не должны быть встроены в какой-либо сохраненный файл (в отличие от знака подчеркивания, который был бы).
Шаблоны: (которые предоставляют рекомендуемый стиль CSS){{underline}}
<var>...</var>форматирует текст курсивом для обозначения переменной в математическом выражении или контексте программирования, или текста-заполнителя, который читатель должен мысленно заменить каким-либо другим буквенным значением.
Шаблоны:
{{var}}{{varserif}}отформатирован курсивом с засечками для различения символов<wbr>возможность переноса слова; то есть он указывает, где можно добавить перенос строки, если слово слишком длинное или если предполагается, что браузер перенесет строку в неправильном месте.
Поскольку окно браузера сужается, второй пример переходит между Hyper и Text .
Не оставляйте пустые строки между элементами списка, если на то нет причины, так как это приведет к тому, что программное обеспечение MediaWiki будет интерпретировать каждый элемент как начало нового списка.
<dl>...</dl>, <dt>...</dt>и <dd>...</dd>используются для создания списка описаний (ранее списка определений) с терминами и описаниями. Термины отображаются жирным шрифтом, а описания имеют отступ. Каждый термин должен включать одно или несколько описаний.
Wikimarkup: <dt>создается с использованием , ;а автоматически заключен в <dl>...</dl>. <dd>создается с использованием :для каждого значения. Для одного или первого значения :может быть размещено на той же строке после ;, а последующие значения должны быть размещены на отдельных строках.
Шаблоны:{{defn}}
<ol>...</ol>представляет упорядоченный список; <ul>...</ul>представляет неупорядоченный список; <li>...</li>представляет элемент списка в любом типе списка.
Wikimarkup: используется *для элементов в неупорядоченных и #упорядоченных списках.
Шаблоны: для разнообразного специализированного использования см. Категория: Форматирование списков и шаблоны функций .
<div>...</div>— это универсальный контейнер для потокового содержимого, отображаемый как блочный элемент.
<span>...</span>представляет собой контейнер для потокового содержимого, отображаемого как встроенный элемент.
<table>...</table>определяет таблицу.
<tr>...</tr>определяет строку таблицы.<td>...</td>определяет ячейку данных, содержимое которой может включать текст, ссылки, изображения, списки, формы, другие таблицы и т. д.Атрибуты:
<table>:border=""иborder="1"border(с непустым значением, отличным от «1»), align, bgcolor, cellpadding, cellspacing, frame, rules, summary, width[5]<td>: colspan, headers,rowspanabbr, align, axis, bgcolor, scope, height, nowrap, valign, width[5]<th>...</th>определяет заголовок таблицы; выравнивается по центру и выделяется жирным шрифтом.
Атрибуты:
<th>: colspan, headers, rowspan,scopeabbr, align, axis, bgcolor, height, nowrap, valign, width[5]<caption>...</caption>добавляет подпись к таблице.
Атрибуты:
<caption>:align[5]<thead>и не поддерживаются, <tfoot>но <tbody>автоматически генерируются при отображении страницы.
Эти элементы теперь устарели и либо объявлены устаревшими, либо удалены в HTML5, хотя они все еще поддерживаются браузерами. [5] Их использования следует избегать в Википедии. Эти теги либо имеют альтернативный тег, либо шаблон, который заменяет их функцию на CSS; теги заменяются редакторами на страницах по всей Википедии (см. Wikipedia:Linter для получения более подробной информации). См. Wikipedia:HTML5 § Устаревшие элементы и атрибуты для получения более подробной информации об устаревших частях HTML и их заменах.
<center>...</center>(устаревший)
Шаблоны: использует CSS.{{center}}
<font>...</font>(устаревший)
Шаблоны: использует CSS.{{font}}
<rb>...</rb>(устаревший)
О заменах см.: Справка:HTML в викитексте#rp, rt, Ruby.
<strike>...</strike>(устаревший)<s>...</s>или <del>...</del>, в зависимости от контекста.
<tt>...</tt>(устаревший)<code>, <kbd>или <samp>вместо этого, в зависимости от контекста.
Шаблоны: использует CSS.{{mono}}
Эти элементы не поддерживаются, но имеют эквивалентную разметку вики. Попытка использовать любой элемент, не внесенный в белый список, Sanitizer.phpприведет к отображению разметки в виде простого текста.
<a>используется для создания ссылок. Используйте [[ ]]вики-разметку для внутренних/интравики-ссылок и интервики-ссылок , а также [ ]для внешних ссылок.
<input>используется для создания форм . <inputbox>Тег расширения используется для создания текстового поля с кнопкой.
HTML Tidy — устаревшая библиотека HTML4, которая должна быть удалена. Tidy анализирует вывод MediaWiki и очищает его, чтобы повысить вероятность отображения корректного HTML4. Например, при включенном Tidy , <br>, </br>, <br/>все <br.>отображается как <br />. Tidy не включен для страниц интерфейса MediaWiki . Tidy никогда не был идеальным и, как известно, вносил ошибки.
На некоторых страницах в пространстве имен MediaWiki короткие сообщения, такие как подписи к кнопкам, HTML-код не анализируется, а теги отображаются.
Пользовательские и общесайтовые CSS и JavaScript- страницы интерпретируются как внутри <pre>блока. См. Help:User style .
Программное обеспечение MediaWiki пытается исправить ошибки HTML, но не все из них оно улавливает. Там, где используется HTML, полезно проверить его с помощью W3C Markup Validation Service .
Для машинно-сгенерированного списка см. Special:Version#mw-version-parser-extensiontags . Он может включать теги, не описанные здесь.
<gallery>, , , , ,<includeonly><noinclude><nowiki><onlyinclude><pre><categorytree>, <charinsert>, (псевдоним ), , , , , , , , , , , , , , , , (псевдоним ), , ,<chem><ce><graph><hiero><imagemap><indicator><inputbox><mapframe><maplink><math><math chem><poem><ref><references><score><section><syntaxhighlight><source><templatedata><templatestyles><timeline>Sanitizer.phpмодуле.