Справка: HTML в вики-тексте

Эта страница справки представляет собой практическое руководство . В нем подробно описаны процессы или процедуры некоторых аспектов норм и практики Википедии. Это не одна из политик или руководящих принципов Википедии и может отражать различные уровни консенсуса и проверки .

Ярлыки H: HTML WP: HTML

Программное обеспечение MediaWiki, который приводит в Википедию, позволяет использовать подмножество HTML 5 элементов или тегов и их атрибутов , для представления форматирования. ^[1] Но большую часть HTML можно включить с помощью эквивалентной разметки вики или шаблонов ; они обычно предпочтительны в статьях, поскольку иногда они проще для большинства редакторов и менее навязчивы в окне редактирования; но Руководство по стилю Википедии рекомендует использовать их в определенных случаях. (См . Справку: Wikitextдля вики-эквивалентов тегов HTML, не обсуждаемых ниже.) И HTML полезен вне статей, например для форматирования в шаблонах. Для получения справки по использованию каскадных таблиц стилей в Википедии см. Справка: каскадные таблицы стилей .

Некоторые теги выглядят как HTML, но на самом деле являются тегами синтаксического анализатора и расширений MediaWiki , и поэтому на самом деле являются разметкой вики. HTML на страницах можно проверить на соответствие HTML5 с помощью проверки . Некоторые элементы и атрибуты поддерживаются MediaWiki и браузерами, но устарели в HTML 5 и поэтому больше не должны использоваться.

Учебники

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

• Введение в HTML5 на developer.mozilla.org
• Введение в HTML5 на w3schools.com

Атрибуты

Атрибуты 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

Другие теги, например, <table>поддерживают определенные атрибуты - они перечислены в соответствующем разделе.

Это < span  style = "color: red;" > красный </ span > текст.

MediaWiki Sanitizer.phpделает некоторую очистку атрибутов. Лучше всего использовать правильный синтаксис.

• Отменяет атрибуты, отсутствующие в белом списке для данного элемента.
• Превращает поврежденные или недействительные объекты в открытый текст.
• Заключите все значения атрибутов в двойные кавычки.
• Атрибуты без значений получают имя как значение.
• Двойные атрибуты отбрасываются.
• Атрибуты небезопасного стиля отбрасываются.
• Добавляет пробел в начало, если есть атрибуты.

Элементы

Эти HTML-элементы поддерживаются программным обеспечением MediaWiki. В этом разделе дается краткий обзор элемента HTML, пример, соответствующая вики-разметка и шаблоны.

Базовый

h1, h2, h3, h4, h5, h6

<h1>...</h1>Через <h6>...</h6>тег Заголовки разделов , с которыми они связаны. <h1>используется для названия статьи. Заголовки оформляются с помощью CSS и добавляются в оглавление страницы .

<h1> Заголовок 1 </h1><h2> Заголовок 2 </h2><h3> Заголовок 3 </h3><h4> Заголовок 4 </h4><h5> Заголовок 5 </h5><h6> Заголовок 6 </h6>

Wikimarkup: окружите текст соответствующим количеством знаков равенства. Заголовки, отформатированные с помощью wikimarkup, добавляют ссылку [редактировать].

= Заголовок 1 === Заголовок 2 ===== Заголовок 3 ======= Заголовок 4 ========= Заголовок 5 =========== Заголовок 6 ======

Шаблоны: для использования в документации{{fake heading}}

п

<p>...</p> размещает контент в отдельный абзац.

<p> Язык разметки гипертекста </p> <p> Язык разметки гипертекста </p>

Wikimarkup: разделяйте абзацы одной пустой строкой.

Язык гипертекстовой разметкиЯзык гипертекстовой разметки

<p>...</p> особенно полезен в списках для элементов списка с несколькими абзацами:

*  <p> Это абзац. </p> <p> Это еще один абзац в том же элементе. </p> * Это другой предмет.

Обратите внимание, что закрывающий тег </p>не является строго обязательным для установок MediaWiki, выводящих HTML 5 (например, Wikipedia).

br

<br>или <br />вставляет разрыв строки. Обе версии перерыва поддерживаются HTML5. Следует избегать использования подсветки синтаксиса<br> без /разрывов . является недействительным. </br>

Гипертекст <br /> Язык разметки

Шаблоны:

• {{break}} добавляет несколько разрывов строки.
• {{crlf2}} добавляет настоящий возврат каретки и перевод строки.
• {{clear}} добавляет перерыв со стилем для очистки плавающих элементов.
• {{plainlist}} создает список без маркировки.

час

<hr>или <hr />представляет собой тематический разрыв на уровне абзаца и представляет собой горизонтальную линейку.

<час />

Wikimarkup: использование ----

----

Шаблоны: {{hr}}

Комментарии

<!--...--> форматирует заключенный текст как скрытый комментарий.

Гипертекст <! - Язык разметки ->

Будьте осторожны с интервалом между комментариями. Окружение комментария пустыми строками приведет к появлению пустого абзаца, воспринимаемого как дополнительные две пустые строки:

Строка содержания 1<! - Комментарий ->Строка содержания 2

Форматирование

abbr

<abbr>...</abbr>создает всплывающую подсказку для определения аббревиатуры или акронима, отображаемого при наведении курсора мыши.

<abbr title = "Язык разметки гипертекста"> HTML </abbr>

Шаблоны: {{abbr}}

б

<b>...</b> форматирует текст, стилистически смещенный относительно другого текста (жирный шрифт), не придавая особой важности

<b> Язык разметки гипертекста </b>

Wikimarkup: используйте, '''чтобы открывать и закрывать полужирный текст.

'''Язык гипертекстовой разметки'''

bdi

<bdi>...</bdi> изолирует содержимое от окружающих параметров направления текста.

اليمين إلى اليسار слева направо

اليمين إلى اليسار <bdi> слева направо </bdi>

Поддержка: Firefox, Chrome

бдо

<bdo>...</bdo> указывает направление текста.

Атрибуты и ценности:

• dir - Задает направление текста.
  • ltr
  • rtl

<bdo dir = "rtl"> Язык разметки гипертекста </bdo>

цитата

<blockquote>...</blockquote> представляет текст в блоке смещения.

<blockquote> Язык разметки гипертекста </blockquote>

Шаблоны: ; поддерживает предварительно отформатированные параметры атрибуции и источника. Для других специализированных шаблонов предложений см. Категория: Шаблоны предложений .{{quote}}

цитировать

<cite>...</cite>содержит название работы. Это новое определение в HTML5 - в предыдущей реализации XML <cite>использовалось для цитирования или ссылки на другие источники. При использовании этого тега форматирование не применяется.

<cite> Язык разметки гипертекста </cite>

<cite>...</cite>обычно не используется непосредственно в статьях Википедии и часто используется не по назначению; см. Википедию: HTML 5 # cite для инструкций по замене.

код

<code>...</code>форматирует раздел компьютерного кода. Стилизованный с помощью CSS через mediawiki.skinning/elements.cssкак моноширинном горбыль засечки с границей.

<code> Язык разметки гипертекста </code>

Шаблоны: использует . Дополнительные шаблоны разметки кода см. В разделе «См. Также» на странице шаблона.{{code}}<syntaxhighlight>

См. Разделы § samp и § kbd на этой странице для семантической разметки вывода и ввода, соответственно.

данные

<data>...</data> форматирует машиночитаемую версию содержания.

<data value = "978-0764502149"> HTML для чайников </data>

Атрибуты: value

дель

<del>...</del> форматирует удаленный текст.

<del> Язык разметки гипертекста </del>

dfn

<dfn>...</dfn> используется для указания определяющего экземпляра термина.

<dfn> Определение </dfn>

Шаблоны: {{dfn}}

Эм

<em>...</em>представляет собой отрезок текста с подчеркнутым ударением (т. е. смысловым ударением). В большинстве браузеров он отображается курсивом.

<em> Язык разметки гипертекста </em>

Шаблоны: {{em}}

я

<i>...</i> представляет собой отрезок текста, смещенный относительно окружающего его содержимого, не передавая лишнего акцента или важности, и для которого обычным типографским представлением является текст курсивом.

<i> Язык разметки гипертекста </i>

Wikimarkup: используйте, ''чтобы открывать и закрывать курсивный текст.

''Язык гипертекстовой разметки''

ins

<ins>...</ins>указывает диапазон добавленного текста. Стилизован как подчеркнутый текст. Используется на страницах обсуждения для обозначения отредактированного текста; см. WP: РЕДАКТИРОВАТЬ .

<ins> Язык разметки гипертекста </ins>

kbd

<kbd>...</kbd> обозначает ввод данных пользователем, например ввод с клавиатуры или голосовые команды.

Нажмите <kbd> Enter </kbd>

Шаблоны:

• {{kbd}}применяет моноширинный стиль и светло-серый фон для отличия от кода ( <code>) и вывода ( <samp>или ).{{samp}}
• {{key press}} отображает иллюстрированные клавиши и нажатия клавиш.

отметка

<mark>...</mark>представляет собой отрывок текста в одном документе, отмеченный или выделенный для справочных целей в связи с его релевантностью в другом контексте. Отмеченный текст по умолчанию отформатирован с желтым фоном.

<mark> Язык разметки гипертекста </mark>

<mark style = "background: lightblue;"> Язык разметки гипертекста </mark>

Поддержка: не поддерживается в Internet Explorer 8 и ниже.

предварительно

<pre>...</pre>Элемент представляет собой блок предварительно отформатированного текста. В MediaWiki это фактически тег парсера, а не HTML, но функция та же. Это также предотвращает синтаксический анализ шаблонов.<pre>

<pre> Язык разметки гипертекста </pre>

Язык гипертекстовой разметки

HTML-объекты

<pre>анализирует объекты HTML . Если вы хотите избежать этого, замените &на &или используйте вместо него.<source lang="text">

<pre> & amp; </pre>

&

<pre> & lt; </pre>

<

<pre> & amp; amp; </pre>

& amp;

<pre> & amp; lt; </pre>

& lt;

Шаблоны:

• {{pre}} переносит текст, выходящий за пределы страницы.
• {{pre2}} оборачивает или использует полосу прокрутки.

q

<q>...</q>используется для обозначения короткой цитаты. В Википедии пока очень мало реализации этого элемента.

<q> Язык разметки гипертекста </q>

MOS: QUOTATIONS говорит, что Википедия должна вместо этого использовать "", {{ quote }} или <blockquote>.

рп, рт, рубин

<ruby>...</ruby> помечает фрагменты фразировочного содержания рубиновыми аннотациями.

• <rt>...</rt>отмечает рубиновую текстовую составляющую рубиновой аннотации; рубиновый текст отображается в уменьшенном размере поверх обычных символов.
• <rp>...</rp> используется для предоставления круглых скобок вокруг рубинового текстового компонента рубиновой аннотации, который будет отображаться пользовательскими агентами, которые не поддерживают рубиновые аннотации.

Браузеры, не поддерживающие рубиновые символы, будут отображать рубиновый текст в нормальном размере, заключенном в круглые скобки и после обычного содержимого.

< рубин >東< rp > ( </ rp > < rt >と う</ rt > < rp > ) </ rp >京< rp > ( </ rp > < rt >き ょ う</ rt > < rp > ) < / rp > </ рубин >

Шаблоны:

• {{ruby}}
• {{ruby-ja}} для японцев
• {{Ruby-zh-p}} для китайского пиньинь
• {{Ruby-zh-b}} для китайского бопомофо

s

<s>...</s>используется для обозначения содержания, которое больше не является точным или релевантным и которое было удалено со страницы. Это не подходит для обозначения правок документа; чтобы отметить фрагмент текста как удаленный из документа, используйте <del>.

<s> Язык разметки гипертекста </s>

Шаблоны: {{strikethrough}}

самп

<samp>...</samp>указывает пример вывода из программы или вычислительной системы. Примеры включают: вывод программы, сценария или шаблона Википедии; отображение состояния или звуковые объявления, сделанные приложением или устройством; списки каталогов файловой системы и образцы из них, такие как пути и имена файлов.

<samp> Язык разметки гипертекста </samp>

Шаблоны: применяет моноширинный стиль и выделяет текст темно-серым цветом для отличия от кода ( ) и ввода ( или ).{{samp}}<code><kbd>{{kbd}}

небольшой

<small>...</small> форматировать мелкий текст.

<small> Язык разметки гипертекста </small>

Шаблоны:

• {{small}}использует <span style="font-size:85%;">. рекомендуется, поскольку имеет семантическое значение, предназначенное для мелкого шрифта , тогда как является чисто стилистическим.{{small}}<small><small>...</small>{{small}}

сильный

<strong>...</strong>форматирует фрагмент текста с большой важностью или необычным акцентом; в большинстве браузеров он отображается жирным шрифтом. Обычно это не следует использовать в статьях Википедии, согласно WP: Политика нейтральной точки зрения . См. MOS: BOLD об использовании этого элемента и других выделений жирным шрифтом. Наибольший смысловой акцент, в том числе в цитируемом материале, должен быть сделан с помощью этого <em>элемента.

<strong> Язык разметки гипертекста </strong>

Шаблоны: {{strong}}

суб

<sub>...</sub> форматирует фрагмент текста как нижний индекс.

Гипертекст <sub> Язык разметки </sub>

Шаблоны:

Как дела

<sup>...</sup> форматирует фрагмент текста как надстрочный индекс.

Гипертекст <sup> Язык разметки </sup>

Шаблоны:

• {{sub}}( _нижний текст)
• {{subsub}}( _{нижний индекс нижний} текст)
• {{ssub}}( _{нижний индекс, мелкий} текст)
• {{sup}}( ^{надстрочный} текст)
• {{su}} (^{надстрочный}
  _{подстрочный индекс} текст)
• {{sup sub}} (текст^sup
  _sub)
• {{e}}(1,23 × 10 ⁴ )

время

<time>...</time> определяет время (в 24-часовом формате) или дату в григорианском календаре, необязательно со смещением времени и часового пояса.

<time> 10:00 </time>

Атрибуты: datetime

Поддержка: не поддерживается в Internet Explorer 8 и ниже.

ты

<u>...</u>представляет собой отрезок текста, смещенный по отношению к окружающему его содержимому, без какого-либо дополнительного акцента или важности, и для которого обычное типографское представление подчеркивается; например, отрезок текста на китайском языке, который является собственным именем (знак китайского собственного имени), или отрезок текста, который, как известно, написан с ошибками.

<u> Язык разметки гипертекста </u>

Шаблоны: {{underline}}

вар

<var>...</var> форматирует текст курсивом, чтобы указать переменную в математическом выражении или контексте программирования, или текст-заполнитель, который читатель должен мысленно заменить другим буквальным значением.

* <var> E </var> = <var> m </var> c <sup> 2 </sup> (c - константа, а не переменная)* <code> <nowiki> {{</nowiki> <var> TemplateName </var> | <var> параметр </var> = <var> value </var> <nowiki>}} </nowiki> </ код>* Если <var> A </var>, то <var> B </var>

Шаблоны:

• {{var}}
• {{varserif}} отформатированы курсивом с засечками для различения символов

wbr

<wbr>возможность разрыва слова; то есть он указывает, где можно было бы добавить разрыв строки, если слово слишком длинное, или считается, что браузер прервет строку в неправильном месте.

Пришло время стать мощным редактором, изучив язык разметки гипертекста.

Пришло время стать мощным редактором, изучив Hyper <wbr> язык разметки текста.

Поскольку окно браузера становится более узким, второй пример переносится между Hyper и Text .

Списки

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

dl, dt, dd

<dl>...</dl>, <dt>...</dt>и <dd>...</dd>используются для создания списка описаний (ранее - списка определений) с терминами и описаниями. Термины выделены жирным шрифтом, а описания имеют отступ. Каждый термин должен включать одно или несколько описаний.

< dl > < dt > Термин </ dt > < dd > Определение 1 </ dd > < dd > Определение 2 </ dd > </ dl >

Wikimarkup: <dt>создается с использованием ;при автоматическом включении в <dl>...</dl>. <dd>создается с использованием :для каждого значения. Для одного или первого значения :можно поместить в ту же строку, после чего ;последующие значения должны быть размещены в отдельных строках.

; Срок: Определение 1: Определение 2

Шаблоны: {{defn}}

ол, ул, ли

<ol>...</ol>представляет упорядоченный список; <ul>...</ul>представляет собой неупорядоченный список; <li>...</li>представляет элемент списка в списке любого типа.

< ol > < li > Элемент 1 </ li > < li > Элемент 2 </ li > </ ol >

< ul > < li > Элемент 1 </ li > < li > Элемент 2 </ li > </ ul >

Wikimarkup: используйте *для элементов в неупорядоченном списке и #для упорядоченных списков.

# Пункт 1 # Пункт 2

* Пункт 1 * Пункт 2

Шаблоны: для различных специализированных целей см. Категория: Форматирование списков и шаблоны функций .

Контейнеры

div

<div>...</div> - это универсальный контейнер для потокового содержимого, отображаемый в виде блочного элемента.

Гипертекст <div> Язык разметки </div>

охватывать

<span>...</span> - это контейнер для потокового контента, который отображается как встроенный элемент.

Гипертекст <span> Язык разметки </span>

Столы

стол, тд, тр

<table>...</table> определяет таблицу.

• <tr>...</tr> определяет строку таблицы.
• <td>...</td> определяет ячейку данных с содержимым, которое может включать текст, ссылки, изображения, списки, формы, другие таблицы и т. д.

< table  border = 1 > < tr > < td > data </ td > < td > data </ td > </ tr > </ table >

Атрибуты:

• <table>:

  Разрешено, но не рекомендуется: border=""иborder="1"

  Допускается , но устаревший: border(с непустым другим значением от "1"), align, bgcolor, cellpadding, cellspacing, frame, rules, summary, width^[3]

• <td>: colspan, headers,rowspan

  Разрешено , но устаревшее: abbr, align, axis, bgcolor, scope, height, nowrap, valign, width^[3]

th

<th>...</th>определяет заголовок таблицы; оформлено как по центру и жирным шрифтом.

< table  border = "1" > < tr > < th > Заголовок </ th > < th > Заголовок </ th > </ tr > < tr > < td > data </ td > < td > data </ td > </ tr > </ table >

Атрибуты:

• <th>: colspan, headers, rowspan,scope

  Разрешено , но устаревшее: abbr, align, axis, bgcolor, height, nowrap, valign, width^[3]

подпись

<caption>...</caption> добавляет заголовок к таблице.

< table  border = 1 > < caption > Заголовок </ caption > < tr > < td > data </ td > < td > data </ td > </ tr > </ table >

Атрибуты:

• <caption>:

  Разрешено, но устарело: align^[3]

thead, tfoot, tbody

<thead>, <tfoot>и <tbody>не поддерживаются, но автоматически создаются при отображении страницы.

Устаревшие / устаревшие элементы

Эти элементы теперь устарели и либо устарели, либо удалены в HTML5, но по-прежнему поддерживаются браузерами. ^[3] Эти теги имеют либо альтернативный тег, либо шаблон, который заменяет их функцию на CSS. См. Википедия: HTML5 § Устаревшие элементы и атрибуты для получения дополнительных сведений об устаревших частях HTML и их заменах.

центр

<center>...</center> (устаревший) используется для центрирования текстовых элементов.

Шаблоны: использует CSS.{{center}}

шрифт

<font>...</font> (устаревший) используется для установки размера шрифта, начертания шрифта и цвета текста.

Шаблоны: использует CSS.{{font}}

rb

<rb>...</rb> (устаревший) Используется для обозначения основного текста в рубиновой аннотации

Для замены см .: Справка: HTML в wikitext # rp, rt, ruby

наносить удар

<strike>...</strike> (устаревший)форматы зачеркнутых символов; используйте <s>вместо этого.

тт

<tt>...</tt> (устаревший)форматирует текст шрифтом фиксированной ширины. Используйте <code>, <kbd>или <samp>вместо.

Шаблоны: использует CSS.{{mono}}

Неподдерживаемые элементы

Эти элементы не поддерживаются, но имеют эквивалентную вики-разметку. Попытка использовать любой элемент, не внесенный в белый список, Sanitizer.phpприведет к отображению разметки в виде обычного текста.

а

<a>используется для создания ссылок. Используйте [[ ]]вики-разметку для внутренних / внутривики-ссылок и меж-вики- ссылок , а также [ ]для внешних ссылок.

Вход

<input>используется для создания форм . Расширение тег используется для создания текстового поля с помощью кнопки.<inputbox>

HTML Tidy

HTML Tidy - это устаревшая библиотека HTML4, которую планируется удалить . Tidy анализирует вывод MediaWiki и очищает его, чтобы повысить вероятность отображения действительного HTML4. Например, при включенном Tidy, <br>, </br>, <br/>, <br.>все визуализируется как <br />. Tidy не включен для страниц интерфейса MediaWiki . Tidy никогда не была идеальной и, как известно, допускала ошибки.

Исключения

На некоторых страницах в пространстве имен MediaWiki , как правило, короткие сообщения, такие как метки кнопок, HTML не анализируются, и теги будут отображаться.

Пользовательские и общесайтовые страницы CSS и JavaScript интерпретируются так, как будто они находятся внутри <pre>блока. См. Справка: Пользовательский стиль .

Проверка

Программное обеспечение 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

Рекомендации

Внешние ссылки

• Спецификация HTML 4.01: элементы | атрибуты
• Спецификация HTML 5.2: элементы | атрибуты