View source for Help:HTML in wikitext/zh

<languages/>
{{PD Help Page}}
{{NoteTA|G1=IT|G2=MediaWiki}}
MediaWiki可以解析'''维基文本中的一些HTML标签'''。用于其他标签的括号会被转义，这些标签会直接显示而非解析。

<span id="Allowed_HTML_tags"></span>
== 允许的HTML标签 ==

{| class="wikitable sortable"
|+在MediaWiki软件中允许的HTML标签
! scope="col"|{{LC zh|C|zh-hans=标签|zh-hant=標籤}}
! scope="col" class="unsortable" | 含义
! scope="col" style="width:5ex" | 开始时间…
! scope="col" class="unsortable" | 注释
|-
|scope="row"| {{tag|abbr|open}}
| 简称
| data-sort-value="16" | 1.16
|
|-
|scope="row"| {{tag|b|open}}
| 引起注意
| data-sort-value="1" | 1.1
| 维基文本：三层单引号，比如<code>-{}-注意<nowiki>'''</nowiki>这个文字<nowiki>'''</nowiki></code>。
|-
|scope="row"| {{tag|bdi|open}}
| 双向分离
| data-sort-value="20" | 1.20
|
|-
|scope="row"| {{tag|bdo|open}}
| 双向文本覆盖
| data-sort-value="22" | 1.22
|
|-
|scope="row"| {{tag|big|open}}
| 使文本更大
| data-sort-value="1" | 1.1
| big标签在HTML中已弃用，但在wikitext中仍可用（[[phab:T154067|T154067]]）
|-
|scope="row"| {{tag|blockquote|open}}
| 块状引用
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|br|open}}
| 折行
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|caption|open}}
| 表格标题
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|cite|open}}
| 引用，即对引用的创造性作品的引用。
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|code|open}}
| 内联计算机代码
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|data|open}}
| 数据，通过<code>value</code>属性链接到机器可读的翻译
| data-sort-value="21" | 1.21
|
|-
|scope="row"| {{tag|dd|open}}
| 描述项元素的描述细节，在一个描述列表内。
| data-sort-value="1" | 1.1
| 维基文本：一行以<code>:</code>开始，分别表述描述列表细节。
|-
|scope="row"| {{tag|del|open}}
| 删除的文本
| data-sort-value="3" | 1.3
|
|-
|scope="row"| {{tag|dfn|open}}
| 定义。包含一个被定义的术语或短语。
| data-sort-value="17" | 1.17
|
|-
|scope="row"| {{tag|div|open}}
| 内容分隔，对块应用CSS格式。
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|dl|open}}
| 描述列表。
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|dt|open}}
| 描述列表内的描述项。
| data-sort-value="1" | 1.1
| 维基文本：一行以<code>;</code>开始，分别表述描述列表项。
|-
|scope="row"| {{tag|em|open}}
| 强调
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|h1|open}}
| 段落标题——1级到6级
| data-sort-value="1" | 1.1
| 维基文本：一对等号（参见[[Special:MyLanguage/Help:Formatting|关于格式化的帮助]]）。
注意当你编辑由HTML标题开头的段落时，编辑摘要''不会''预先填写。
|-
|scope="row"| {{tag|hr|open}}
| 横线
| data-sort-value="1" | 1.1
| 维基文本：一行以4个以上的连字符（<code>----</code>）开始。
|-
|scope="row"| {{tag|i|open}}
| 惯用文本
| data-sort-value="1" | 1.1
| 维基文本：两层单引号，比如<code>-{}-<nowiki>''</nowiki>惯用文本<nowiki>''</nowiki></code>。
|-
|scope="row"| {{tag|ins|open}}
| 添加的文本
| data-sort-value="3" | 1.3
|
|-
|scope="row"| {{tag|kbd|open}}
| 键盘输入
| data-sort-value="17" | 1.17
|
|-
|scope="row"| {{tag|li|open}}
| 列表项
| data-sort-value="1" | 1.1
| 维基文本：一行以<code>#</code>或<code>*</code>开始，分别表示有序列表和无序列表。
|-
|scope="row"| {{tag|link|open}}
| 外部资源链接
| data-sort-value="27" | 1.27
| 必须设置<code>itemprop</code>和<code>href</code>属性。<ref name="validateTags">[[phab:source/mediawiki/browse/REL1_38/includes/parser/Sanitizer.php$488|Parser\Sanitizer::validateTag()]]</ref>
|-
|scope="row"| {{tag|mark|open}}
| 标记的或高亮的文本。
| data-sort-value="21" | 1.21
|
|-
|scope="row"| {{tag|meta|open}}
| 元数据
| data-sort-value="27" | 1.27
| 必须设置<code>itemprop</code>和<code>content</code>属性。<ref name="validateTags" />
|-
|scope="row"| {{tag|ol|open}}
| 有序列表
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|p|open}}
| 段落
| data-sort-value="1" | 1.1
| 维基文本：文本之间的空行。
|-
|scope="row"| {{tag|pre|open}}
| 预格式化的文本
| data-sort-value="1" | 1.1
| 内容不会解析，就像在{{tag|nowiki|open}}标签内。
维基文本：以空格开始的一行，例如<code>&nbsp;preformated text</code>。
|-
|scope="row"| {{tag|q|open}}
| 内联引用
| data-sort-value="22" | 1.22
|
|-
|scope="row"| {{tag|rp|open}}
| Ruby的备用括号
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|rt|open}}
| Rubye文本：在基础文本附近渲染的注解。在<code>ruby</code>标签内。
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|ruby|open}}
| Ruby注解。包围了<code>rt</code>和<code>rp</code>。
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|s|open}}
| 删除线，用于不再准确或相关的文本。
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|samp|open}}
| 样例输出，计算机程序的内联输出文本。
| data-sort-value="17" | 1.17
|
|-
|scope="row"| {{tag|small|open}}
| 旁注。
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|span|open}}
| 内容范围，用于给内联的文本应用CSS格式。
| data-sort-value="10" | 1.4
|
|-
|scope="row"| {{tag|strong|open}}
| 强调重要性。
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|sub|open}}
| 下标
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|sup|open}}
| 上标
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|table|open}}
| 表格，用于表格数据。
| data-sort-value="1" | 1.1
| 维基文本：[[Special:MyLanguage/Help:Tables|参见表格的帮助页面]]。
|-
|scope="row"| {{tag|td|open}}
| 表格数据单元格，在<code>tr</code>标签内。
| data-sort-value="1" | 1.1
| 维基文本：[[Special:MyLanguage/Help:Tables|参见表格的帮助页面]]。
|-
|scope="row"| {{tag|th|open}}
| 表头单元格，在<code>tr</code>标签内。
| data-sort-value="1" | 1.1
| 维基文本：[[Special:MyLanguage/Help:Tables|参见表格帮助页面]]。
|-
|scope="row"| {{tag|time|open}}
| 日期/时间
| data-sort-value="21" | 1.21
|
|-
|scope="row"| {{tag|tr|open}}
| 表格行，在<code>table</code>标签内。
| data-sort-value="1" | 1.1
| 维基文本：[[Special:MyLanguage/Help:Tables|参见表格帮助页面]]。
|-
|scope="row"| {{tag|u|open}}
| 不清晰的注解。
| data-sort-value="1" | 1.1
| 
|-
|scope="row"| {{tag|ul|open}}
| 无序列表。
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|var|open}}
| {{LC zh|C|zh-hans=变量|zh-hant=變數}}
| data-sort-value="1" | 1.1
|
|-
|scope="row"| {{tag|wbr|open}}
| 换行机会。
| data-sort-value="22" | 1.22
|
|}

<span id="Deprecated_tags"></span>
=== 弃用的标签 ===
以下标签会被MediaWiki解析，但是在HTML 5中是过时的。 这些标签应该用上面的标签取代。
你可能需要添加一个<code>style</code>属性以复现预期的显示效果。

{| class="wikitable sortable"
|+Mediawiki中弃用的HTML标签
!scope="col" |{{LC zh|C|zh-hans=标签|zh-hant=標籤}}
!scope="col" style="width:5ex" | 开始时间…
!scope="col" style="width:5ex" | 是否会输出[[Special:MyLanguage/Help:Lint_errors|Lint 错误]]？
!scope="col" class="unsortable" | 注释
|-
|scope="row"| {{tag|center|open}}
| data-sort-value="1" | 1.1
| {{yes}}
| 
|-
|scope="row"| {{tag|font|open}}
| data-sort-value="1" | 1.1
| {{yes}}
| 
|-
|scope="row"| {{tag|rb|open}}
| data-sort-value="1" | 1.1
| {{no}}
| 
|-
|scope="row"| {{tag|rtc|open}}
| data-sort-value="24" | 1.24
| {{no}}
| 
|-
|scope="row"| {{tag|strike|open}}
| data-sort-value="1" | 1.1
| {{yes}}
| 
|-
|scope="row"| {{tag|tt|open}}
| data-sort-value="1" | 1.1
| {{yes}}
| 
|}

<span id="Use_cases"></span>
== 用例 ==

<span id="Anchor"></span>
=== 锚点 ===

要创建一个[[Special:MyLanguage/Help:Links|可链接的]]锚点，你可以使用任何HTML标签并带有<code>id</code>属性。

例如，<syntaxhighlight lang=html inline><span id="note2"></span></syntaxhighlight>允许你使用{{tmpl|0=<code><nowiki>[[</nowiki>#note2{{!}}$1<nowiki>]]</nowiki></code>|参见有关注释}}创建链接到页面中的这个位置的链接。

<span id="CSS_formatting"></span>
=== CSS格式化 ===
==== 使用<code>style</code>属性 ====

使用HTML标签而非等价的维基文本以让你添加一个<code>style</code>属性以通过[[:zh:CSS|CSS语言]]定义自定义的显示。

==== 带有<code>class</code>和<code>id</code>属性 ====
由于有[[Special:MyLanguage/Help:TemplateStyles|TemplateStyles]]，你可以给文档添加自定义的CSS样式表。
因此，将<code>class</code>或<code>id</code>属性添加到要自定义其显示的元素是很有用的。

<span id="Overridden_HTML_syntax"></span>
== 覆盖了的HTML语法 ==

<span id="HTML_comments"></span>
=== HTML注释 ===

维基文本使用HTML注释语法用于自己的注释：解析器将其忽略，在呈现的HTML源代码中不会被渲染。

<syntaxhighlight lang=html>
<!-- 这个文本是一个维基文本注释。保存后，会留存在维基文本源代码中，但不会显示，也不会在HTML源代码中渲染。 -->
</syntaxhighlight>

=== <code>Pre</code>标签 ===

<code>pre</code>标签的内容不会被解析，就像在{{tag|nowiki|open}}标签内。

你可以使用等价的维基文本语法以允许内容解析，例如每行以空格开始：

  一些预格式化的文本包含维基文本，例如，''这个惯用文字''会被解析。
  另一行。

<span id="See_also"></span>
== 參見 ==
* {{ll|Help:Extension:Linter}} &mdash; 关于Linter扩展的帮助，在页面内提示HTML问题。
* {{ll|HTML restriction}} &mdash; 关于MediaWiki对HTML内容的默认限制和能扩充其支持的一些扩展。
* {{ll|Manual:$wgRawHtml#Related Extensions}} &mdash; 允许进一步HTML的扩展。

<span id="References"></span>
== 参考资料 ==
<references/>