Программное обеспечение MediaWiki, который приводит в Википедию, позволяет использовать подмножество HTML 5 элементов или тегов и их атрибутов , для представления форматирования. [1] Но большую часть HTML можно включить, используя эквивалентную разметку вики или шаблоны ; они обычно предпочтительны в статьях, поскольку иногда они проще для большинства редакторов и менее навязчивы в окне редактирования; но Руководство по стилю Википедии рекомендует использовать их в определенных случаях. (См . Справку: Wikitextдля вики-эквивалентов тегов HTML, не обсуждаемых ниже.) И HTML полезен вне статей, например, для форматирования в шаблонах. Для получения справки по использованию каскадных таблиц стилей в Википедии см. Справка: каскадные таблицы стилей .
Некоторые теги выглядят как HTML, но на самом деле являются тегами синтаксического анализатора и расширений MediaWiki , а значит, и разметкой вики. HTML на страницах можно проверить на соответствие HTML5 с помощью проверки . Некоторые элементы и атрибуты поддерживаются MediaWiki и браузерами, но устарели в HTML 5 и поэтому больше не должны использоваться.
Учебники
Эта страница справки дает только обзор разрешенной разметки. Для получения дополнительной помощи и подробных спецификаций:
Атрибуты
Атрибуты HTML предоставляют дополнительную информацию об элементе и всегда указываются в начальном теге. Они отформатированы как пара имя / значение, например name="value"
.
Глобальные атрибуты применяются ко всем тегам. Атрибуты, не перечисленные здесь, не разрешены MediaWiki [1] :
class
: одна или несколько классификаций, к которым принадлежит элемент. См. Википедию: Каталог классов CSS .dir
: направление текста -"ltr"
(слева направо),"rtl"
(справа налево) или"auto"
.id
: уникальный идентификатор элемента.lang
: основной язык содержания элемента согласно BCP 47 .style
: применяет стили CSS к содержимому элемента.title
: консультативная информация, связанная с элементом.
Атрибуты микроданных HTML5 применяются ко всем тегам: [2]
- Любой атрибут, начинающийся с
data-
itemid
itemprop
itemref
itemscope
itemtype
Другие теги, например,
поддерживают определенные атрибуты - они перечислены в соответствующем разделе.
Разметка | Отображается как |
---|---|
| Это красный текст. |
MediaWiki Sanitizer.php
делает некоторую очистку атрибутов. Лучше всего использовать правильный синтаксис.
- Отменяет атрибуты, отсутствующие в белом списке для данного элемента.
- Превращает поврежденные или недействительные объекты в открытый текст.
- Заключите все значения атрибутов в двойные кавычки.
- Атрибуты без значений получают имя как значение.
- Двойные атрибуты отбрасываются.
- Атрибуты небезопасного стиля отбрасываются.
- Добавляет пробел в начало, если есть атрибуты.
Элементы
Эти элементы HTML поддерживаются программным обеспечением MediaWiki. В этом разделе дается краткий обзор элемента HTML, пример, соответствующая вики-разметка и шаблоны.
Базовый
h1, h2, h3, h4, h5, h6
Через
тег Заголовки разделов , с которыми они связаны. ...
используется для заголовка статьи. Заголовки оформляются с помощью CSS и добавляются в оглавление страницы .
Разметка | Отображается как |
---|---|
| |
Wikimarkup: окружите текст соответствующим количеством знаков равенства. Заголовки, отформатированные с помощью wikimarkup, добавляют ссылку [редактировать].
Разметка | Отображается как |
---|---|
= Заголовок 1 === Заголовок 2 ===== Заголовок 3 ======= Заголовок 4 ========= Заголовок 5 =========== Заголовок 6 ====== | |
Шаблоны: для использования в документации{{fake heading}}
п
...
размещает контент в отдельный абзац.
Разметка | Отображается как |
---|---|
| Язык гипертекстовой разметки Язык гипертекстовой разметки |
Wikimarkup: разделяйте абзацы одной пустой строкой.
Разметка | Отображается как |
---|---|
Язык гипертекстовой разметкиЯзык гипертекстовой разметки | Язык гипертекстовой разметки Язык гипертекстовой разметки |
...
особенно полезен в списках для элементов списка с несколькими абзацами:
Разметка | Отображается как |
---|---|
|
|
Обратите внимание, что закрывающий тег
br
или
вставляет разрыв строки. Обе версии перерыва поддерживаются HTML5. Следует избегать использования подсветки синтаксиса
без /
разрывов . является недействительным.
Разметка | Отображается как |
---|---|
Гипертекст |
|
Шаблоны:
{{break}}
добавляет несколько разрывов строки.{{crlf2}}
добавляет настоящий возврат каретки и перевод строки.{{clear}}
добавляет перерыв со стилем для очистки плавающих элементов.{{plainlist}}
создает список без маркировки.
час
или
представляет собой тематический разрыв на уровне абзаца и представляет собой горизонтальную линейку.
Разметка | Отображается как |
---|---|
<час /> | |
Wikimarkup: использование ----
Разметка | Отображается как |
---|---|
---- |
|
Шаблоны: {{hr}}
Комментарии
форматирует заключенный текст как скрытый комментарий.
Разметка | Отображается как |
---|---|
Гипертекст | Гипертекст |
Будьте осторожны с интервалом между комментариями. Окружение комментария пустыми строками приведет к появлению пустого абзаца, воспринимаемого как дополнительные две пустые строки:
Разметка | Отображается как |
---|---|
Строка содержания 1Строка содержания 2 | Строка содержания 1
|
Форматирование
abbr
...
создает всплывающую подсказку для определения аббревиатуры или акронима, отображаемого при наведении курсора мыши.
Разметка | Отображается как |
---|---|
HTML | HTML |
Шаблоны: {{abbr}}
б
...
форматирует текст, стилистически смещенный относительно другого текста (жирный шрифт), не придавая особой важности
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
Wikimarkup: используйте, '''
чтобы открывать и закрывать полужирный текст.
Разметка | Отображается как |
---|---|
'''Язык гипертекстовой разметки''' | Язык гипертекстовой разметки |
bdi
...
изолирует содержимое от окружающих параметров направления текста.
Разметка | Отображается как |
---|---|
اليمين إلى اليسار слева направо | اليمين إلى اليسار слева направо |
اليمين إلى اليسار слева направо | اليمين إلى اليسارслева направо |
Поддержка: Firefox, Chrome
бдо
...
указывает направление текста.
Атрибуты и ценности:
dir
- Задает направление текста.ltr
rtl
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
цитата
представляет текст в блоке смещения. ...
Разметка | Отображается как |
---|---|
Язык разметки гипертекста |
|
Шаблоны: ; поддерживает предварительно отформатированные параметры атрибуции и источника. Для других специализированных шаблонов предложений см. Категория: Шаблоны предложений .{{quote}}
cite
...
содержит название работы. Это новое определение в HTML5 - в предыдущей реализации XML использовалось для цитирования или ссылки на другие источники. При использовании этого тега форматирование не применяется.
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
...
обычно не используется непосредственно в статьях Википедии и часто используется не по назначению; см. Википедию: HTML 5 # cite для инструкций по замене.
код
форматирует раздел компьютерного кода. Стилизованный с CSS через ...
mediawiki.skinning/elements.less
как моноширинный шрифт с серым фоном и границей.
Разметка | Отображается как |
---|---|
|
|
Шаблоны: использует . Дополнительные шаблоны разметки кода см. В разделе «См. Также» на странице шаблона.{{code}}
<syntaxhighlight>
См. § samp и § kbd на этой странице для семантической разметки вывода и ввода соответственно.
данные
...
форматирует машиночитаемую версию содержания.
Разметка | Отображается как |
---|---|
HTML для чайников | HTML для чайников |
Атрибуты: value
дель
форматирует удаленный текст. ...
Разметка | Отображается как |
---|---|
|
|
dfn
...
используется для указания определяющего экземпляра термина.
Разметка | Отображается как |
---|---|
Определение | Определение |
Шаблоны: {{dfn}}
Эм
...
представляет собой отрезок текста с подчеркнутым ударением (т. е. смысловым ударением). В большинстве браузеров он отображается курсивом.
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
Шаблоны: {{em}}
я
...
представляет собой отрезок текста, смещенный относительно окружающего его содержимого, не передавая лишнего акцента или важности, и для которого обычным типографским представлением является текст курсивом.
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
Wikimarkup: используйте, ''
чтобы открывать и закрывать курсивный текст.
Разметка | Отображается как |
---|---|
''Язык гипертекстовой разметки'' | Язык гипертекстовой разметки |
ins
...
указывает диапазон добавленного текста. Стилизован как подчеркнутый текст. Используется на страницах обсуждения для обозначения отредактированного текста; см. WP: РЕДАКТИРОВАТЬ .
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
kbd
...
обозначает ввод данных пользователем, например ввод с клавиатуры или голосовые команды.
Разметка | Отображается как |
---|---|
Нажмите Enter | Нажмите Enter |
Шаблоны:
{{kbd}}
применяет моноширинный стиль и светло-серый фон для отличия от кода () и вывода (
или ).
{{samp}}
{{key press}}
отображает иллюстрированные клавиши и нажатия клавиш.
отметка
...
представляет собой отрывок текста в одном документе, отмеченный или выделенный для справочных целей в связи с его релевантностью в другом контексте. Отмеченный текст по умолчанию отформатирован с желтым фоном.
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
Язык разметки гипертекста | Язык гипертекстовой разметки |
Поддержка: не поддерживается в Internet Explorer 8 и ниже.
предварительно
Элемент представляет собой блок предварительно отформатированного текста. В MediaWiki это фактически тег парсера, а не HTML, но функция та же. Это также предотвращает синтаксический анализ шаблонов....
<pre>
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
HTML-объекты
анализирует объекты HTML . Если вы хотите избежать этого, замените
&
на &
или используйте вместо него.<source lang="text">
Разметка | Отображается как |
---|---|
& amp; | & |
& lt; | < |
& amp; amp; | & amp; |
& amp; lt; | & lt; |
Шаблоны:
{{pre}}
переносит текст, выходящий за пределы страницы.{{pre2}}
оборачивает или использует полосу прокрутки.
q
используется для обозначения короткой цитаты. В Википедии пока очень мало реализации этого элемента....
Разметка | Отображается как |
---|---|
Язык разметки гипертекста |
|
MOS: QUOTATIONS говорит, что Википедия должна вместо этого использовать "", {{ quote }} или
.
рп, рт, рубин
...
помечает фрагменты фразировочного содержания рубиновыми аннотациями.
отмечает рубиновую текстовую составляющую рубиновой аннотации; рубиновый текст отображается в уменьшенном размере поверх обычных символов.
используется для предоставления круглых скобок вокруг рубинового текстового компонента рубиновой аннотации, который будет отображаться пользовательскими агентами, которые не поддерживают рубиновые аннотации.
Браузеры, не поддерживающие рубиновые символы, будут отображать рубиновый текст в нормальном размере, заключенном в круглые скобки и после обычного содержимого.
Разметка | Отображается как |
---|---|
| 東 京 |
Шаблоны:
{{ruby}}
{{ruby-ja}}
для японцев{{Ruby-zh-p}}
для китайского пиньинь{{Ruby-zh-b}}
для китайского бопомофо
s
используется для обозначения содержания, которое больше не является точным или релевантным и которое было удалено со страницы. Это не подходит для обозначения правок документа; чтобы отметить фрагмент текста как удаленный из документа, используйте ...
.
Разметка | Отображается как |
---|---|
|
|
Шаблоны: {{strikethrough}}
самп
...
указывает пример вывода из программы или вычислительной системы. Примеры включают: вывод программы, сценария или шаблона Википедии; отображение состояния или звуковые объявления, сделанные приложением или устройством; списки каталогов файловой системы и образцы из них, такие как пути и имена файлов.
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
Шаблоны: применяет моноширинный стиль и выделяет текст темно-серым цветом для отличия от кода ( ) и ввода ( или ).{{samp}}
{{kbd}}
небольшой
...
форматировать мелкий текст.
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
Шаблоны:
{{small}}
использует. рекомендуется, поскольку имеет семантическое значение, предназначенное для мелкого шрифта , тогда как является чисто стилистическим.
{{small}}
...
{{small}}
сильный
...
форматирует фрагмент текста с большим значением или необычным акцентом; в большинстве браузеров он отображается жирным шрифтом. Обычно это не следует использовать в статьях Википедии, согласно WP: Политика нейтральной точки зрения . См. MOS: BOLD об использовании этого элемента и других выделений жирным шрифтом. Наибольший смысловой акцент, в том числе в цитируемом материале, должен быть сделан с помощью этого элемента.
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
Шаблоны: {{strong}}
суб
...
форматирует фрагмент текста как нижний индекс.
Разметка | Отображается как |
---|---|
Гипертекст Язык разметки | Язык разметки гипертекста |
Шаблоны:
{{sub}}
( нижний текст){{subsub}}
( нижний индекс нижний текст){{ssub}}
( нижний индекс, мелкий текст){{sup}}
( надстрочный текст){{su}}
(надстрочный
подстрочный индекс текст){{sup sub}}
(текстsup
sub){{e}}
(1,23 × 10 4 )
Как дела
...
форматирует фрагмент текста как надстрочный индекс.
Разметка | Отображается как |
---|---|
Гипертекст Язык разметки | Язык разметки гипертекста |
Шаблоны:
{{sub}}
( нижний текст){{subsub}}
( нижний индекс нижний текст){{ssub}}
( нижний индекс, мелкий текст){{sup}}
( надстрочный текст){{su}}
(надстрочный
подстрочный индекс текст){{sup sub}}
(текстsup
sub){{e}}
(1,23 × 10 4 )
время
определяет время (в 24-часовом формате) или дату в григорианском календаре, необязательно со смещением времени и часового пояса.
Разметка | Отображается как |
---|---|
Атрибуты: datetime
Поддержка: не поддерживается в Internet Explorer 8 и ниже.
ты
...
представляет собой отрезок текста, смещенный по отношению к окружающему его содержимому, без какого-либо дополнительного акцента или важности, и для которого обычное типографское представление подчеркивается; например, отрезок текста на китайском языке, который является собственным именем (знак китайского собственного имени), или отрезок текста, который, как известно, написан с ошибками.
Разметка | Отображается как |
---|---|
Язык разметки гипертекста | Язык гипертекстовой разметки |
Шаблоны: {{underline}}
вар
...
форматирует текст курсивом, чтобы указать переменную в математическом выражении или контексте программирования, или текст-заполнитель, который читатель должен мысленно заменить другим буквальным значением.
Разметка | Отображается как |
---|---|
* E = m c 2 (c - константа, а не переменная)* |
|
Шаблоны:
{{var}}
{{varserif}}
отформатированы курсивом с засечками для различения символов
wbr
возможность разрыва слова; то есть он указывает, где можно было бы добавить разрыв строки, если слово слишком длинное, или считается, что браузер прервет строку в неправильном месте.
Разметка | Отображается как |
---|---|
Пришло время стать мощным редактором, изучив язык разметки гипертекста. | Пришло время стать мощным редактором, изучив язык разметки гипертекста. |
Пришло время стать мощным редактором, изучив Hyper | Пришло время стать мощным редактором, изучив |
Поскольку окно браузера становится более узким, второй пример переносится между Hyper и Text .
Списки
Не оставляйте пустые строки между элементами в списке, если для этого нет причины, поскольку это заставляет программное обеспечение MediaWiki интерпретировать каждый элемент как начало нового списка.
dl, dt, dd
, ...
и
используются для создания списка описаний (ранее - списка определений) с терминами и описаниями. Термины выделены жирным шрифтом, а описания имеют отступ. Каждый термин должен включать одно или несколько описаний.
Разметка | Отображается как |
---|---|
|
|
Wikimarkup: создается с использованием
;
при автоматическом включении в
. ...
создается с использованием
:
для каждого значения. Для одного или первого значения :
можно поместить в ту же строку, после чего ;
последующие значения должны быть размещены в отдельных строках.
Разметка | Отображается как |
---|---|
; Срок: Определение 1: Определение 2 |
|
Шаблоны: {{defn}}
ол, ул, ли
представляет собой упорядоченный список; ...
представляет собой неупорядоченный список; ...
представляет элемент списка в любом типе списка.
Разметка | Отображается как |
---|---|
|
|
|
|
Wikimarkup: используйте *
для элементов в неупорядоченном списке и #
для упорядоченных списков.
Разметка | Отображается как |
---|---|
|
|
|
|
Шаблоны: для различных специализированных целей см. Категория: Форматирование списков и шаблоны функций .
Контейнеры
div
- это универсальный контейнер для потокового содержимого, отображаемый в виде блочного элемента.
Разметка | Отображается как |
---|---|
Гипертекст | Гипертекст Разметка Язык |
охватывать
...
- это контейнер для потокового контента, который отображается как встроенный элемент.
Разметка | Отображается как |
---|---|
Гипертекст Язык разметки | Язык гипертекстовой разметки |
Таблицы
стол, тд, тр
определяет таблицу. ...
определяет строку таблицы....
определяет ячейку данных с содержимым, которое может включать текст, ссылки, изображения, списки, формы, другие таблицы и т. д....
Разметка | Отображается как | ||
---|---|---|---|
|
| ||
Атрибуты:
:- Разрешено, но не рекомендуется:
border=""
иborder="1"
- Допускается , но устаревший:
border
(с непустым другим значением от "1"),align
,bgcolor
,cellpadding
,cellspacing
,frame
,rules
,summary
,width
[3]
- Разрешено, но не рекомендуется:
:colspan
,headers
,rowspan
- Разрешено , но устаревшее:
abbr
,align
,axis
,bgcolor
,scope
,height
,nowrap
,valign
,width
[3]
- Разрешено , но устаревшее:
th
определяет заголовок таблицы; оформлен как по центру и жирным шрифтом....
Разметка | Отображается как | ||||
---|---|---|---|---|---|
|
| ||||
Атрибуты:
:colspan
,headers
,rowspan
,scope
- Разрешено , но устаревшее:
abbr
,align
,axis
,bgcolor
,height
,nowrap
,valign
,width
[3]
- Разрешено , но устаревшее:
добавляет заголовок к таблице.
Разметка | Отображается как | ||
---|---|---|---|
|
| ||
Атрибуты:
:- Разрешено, но устарело:
align
[3]
- Разрешено, но устарело:
thead, tfoot, tbody
,
и
не поддерживаются, но автоматически создаются при отображении страницы.
Устаревшие / устаревшие элементы
Эти элементы теперь устарели и либо устарели, либо удалены в HTML5, но по-прежнему поддерживаются браузерами. [3] Эти теги имеют либо альтернативный тег, либо шаблон, который заменяет их функцию на CSS. См. Википедия: HTML5 § Устаревшие элементы и атрибуты для получения дополнительных сведений об устаревших частях HTML и их заменах.
центр
используется для центрирования текстовых элементов.
(устаревший)
Шаблоны: использует CSS.{{center}}
шрифт
используется для установки размера шрифта, начертания шрифта и цвета текста. ...
(устаревший)
Шаблоны: использует CSS.{{font}}
rb
Используется для обозначения основного текста в рубиновой аннотации
(устаревший)
Для замены см .: Справка: HTML в wikitext # rp, rt, ruby
наносить удар
форматы зачеркнутых символов; используйте
(устаревший)...
вместо этого.
тт
форматирует текст шрифтом фиксированной ширины. Используйте ...
(устаревший),
или
вместо.
Шаблоны: использует CSS.{{mono}}
Неподдерживаемые элементы
Эти элементы не поддерживаются, но имеют эквивалентную вики-разметку. Попытка использовать любой элемент, не внесенный в белый список, Sanitizer.php
приведет к отображению разметки в виде обычного текста.
а
используется для создания ссылок. Используйте
[[ ]]
вики-разметку для внутренних / внутривики-ссылок и меж-вики- ссылок , а также [ ]
для внешних ссылок.
Вход
используется для создания форм . Расширение тег используется для создания текстового поля с помощью кнопки.
<inputbox>
HTML Tidy
HTML Tidy - это устаревшая библиотека HTML4, которую планируется удалить . Tidy анализирует вывод MediaWiki и очищает его, чтобы повысить вероятность отображения действительного HTML4. Например, при включенном Tidy,
, ,
,
все визуализируется как
. Tidy не включен для страниц интерфейса MediaWiki . Tidy никогда не была идеальной и, как известно, допускала ошибки.
Исключения
На некоторых страницах в пространстве имен MediaWiki , как правило, короткие сообщения, такие как метки кнопок, HTML не анализируются, и теги будут отображаться.
Пользовательские и общесайтовые страницы CSS и JavaScript интерпретируются так, как будто они находятся внутри блока. См. Справка: Пользовательский стиль .
Проверка
Программа MediaWiki пытается исправить ошибки HTML, но не все из них. Если используется HTML, полезно проверить его с помощью службы проверки разметки W3C .
Теги парсера и расширения
Список, сгенерированный компьютером, см. В разделе 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>
Смотрите также
- Справка: разметка вики
- Википедия: HTML5
Рекомендации
- ^ a b Допустимые элементы и атрибуты определены в
Sanitizer.php
модуле. - ^ "Модель микроданных" . Уровень жизни HTML .
- ^ а б в г д «HTML5: словарь и связанные API для HTML и XHTML: устаревшие функции» . W3C . 31 июля 2014 г.