哪个语义HTML标记用于显示附注和警告？

Question

我正在写一个在线教程，带有一些旁注，或者他们称之为“警告”，类似于Django教程中的那些：https://docs.djangoproject.com/en/dev/intro/tutorial01/ (我指的是带有绿色边框和注释图标的盒子)。

我应该使用哪个HTML标记来包含这样的注释，以添加注释的语义含义，该注释在教程的给定点可能对阅读很有用，但不是主要教程流程的一部分？

值得注意的是，标记必须允许包含块元素。

Answer 1

在HTML5 (所有现代浏览器都支持)中，标记是aside。

来自http://www.whatwg.org/specs/web-apps/current-work/multipage/sections.html#the-aside-element

元素表示页面的一部分，该部分由内容组成，该内容与围绕该元素的内容相切相关，并且可以被认为是与该内容分离的。在印刷排版中，这样的部分通常表示为侧栏。

元素可以用于排版效果，如拉引号或侧边栏，用于广告，用于导航元素组，以及用于被认为与页面主要内容分开的其他内容。

仅用于括号是不合适的，因为它们是文档主流的一部分。

这是一个块级元素，包含了块级元素通常可以包含的任何内容(即几乎任何内容)。它本质上是一个“语义div”。

Answer 2

我认为公认的答案并不完全正确。根据HTML5 working draft的说法，<aside>元素在某些情况下但不是所有情况下都可以用来标记附注：

如果边注“可以被考虑与内容分开”，例如，在更长的新闻故事中关于瑞士的背景材料，或者在更长的文章中的引述，则

1. <aside>是合适的。(如果侧注是"a parenthetical“，则不适用于W3C document)
2. <aside>中的示例。W3C没有举例说明它的含义。狭义解释是指放在括号里、逗号之间或短划线之间的任何东西。

如果您想严格地解释W3C规范，并不是Django tutorial中的所有附注都可以用<aside>标记。例如，标题为“与您看到的不匹配？”不能真正考虑与内容分开，因为没有旁边的内容就没有意义。可以说，“这段代码应该放在哪里？”也不是<aside>，因为它提到了“这个代码”，这将它与内容联系在一起。

在我看来，W3C的定义是不必要的混乱和限制性的。aside的字典定义是“暂时偏离主要主题或主题”，规范应该坚持这一点，而不是引入微妙的区别。当然，如果<aside>能让您的代码变得更简单，那么您没有理由不能对所有的旁注都使用它。把它想象成公民抗命吧。:)

相关报价：

元素表示页面的一部分，该部分由内容组成，该内容与围绕该元素的内容相切相关，并且可以被认为是与该内容分离的。在印刷排版中，这样的部分通常表示为侧栏。

元素可以用于排版效果，如拉引号或侧边栏，用于广告，用于导航元素组，以及用于被认为与页面主要内容分开的其他内容。

注意:不适合仅将旁注元素用于括号，因为它们是文档主流的一部分。