1. HTML标签使用指南

内容授权： BSD 许可证
完成日期：2009-08-25

作者：史荣久(trydofor)
邮箱： trydofor@gmail.com
网址： www.trydofor.com

1.1. 为何HTML

选择了HTML格式的根本原因是为了方便读者，便于阅读和分享。 同时考虑到作者，我们对HTML标签进行了分类整理和用法约定后发现其 可以在学习曲线接近WIKI，功能上效仿DOCBOOK，操作上不依赖第三方工具。

1.2. 文档结构

文章 = 1*小节
小节 = 标题 1*段落
标题 = "<H#>" 序号 0X20 普通文本 "</H#>" ; #=[1-6]
序号 = 1*(数字 ".") ;数字=[0-9]
段落 = 段落标签 *(格式文本 / 普通文本)
段落标签 = ;详见， 1.3.2. 段落标签
内联标签 = ;详见， 1.3.3. 内联标签
格式文本 = 内联标签 普通文本
普通文本 = ;没有HTML标签的UNICODE字符

1.3. 标签分类

对文档中经常使用的ＨＴＭＬ标签及属性分类和说明，以统一文档结构和方便描述。

1.3.1. 标题标签

用来定义小节标题，以H#表示，具体包括，H1/H2/H3/H4/H5/H6。
其中的#等于标题序号中"."的个数，即标题的层次。
比如，"1.2.3."对应H3，而"1.2."对应H2.

建议采用以下格式：

<a name="1.3.2."></a>
<h3>1.3.2. 段落标签</h3>

1.3.2. 段落标签

段落标签是指可以产生空行或者单独成块的标签。 各小节描述了在源码中建议使用的格式和属性， 通常不建议在段落标签内使用段落标签。

1.3.2.1. <blockquote> </blockquote>

引述一段文字，不建议在其内使用其他段落标签（BR除外）。

建议采用以下格式：

<blockquote cite="URL">
引述块，不建议在其内使用其他段落标签（BR除外）。</blockquote>

效果如下：

引述块，不建议在其内使用其他段落标签（BR除外）。

1.3.2.2. <br/>

产生一个换行。

建议采用以下格式：

需要换行显示的文字结尾<br/>

1.3.2.3. <dl><dt></dt><dd></dd></dl>

对话的或定义的列表，其中，
dt，表示定义或发言者。
dd，表示定义或对话。

建议采用以下格式：

<dl>
<dt>定义或发言者1</dt><dd>解释或对话1</dd>
<dt>定义或发言者2</dt><dd>解释或对话2</dd></dl>

效果如下：

定义或发言者1

解释或对话1

定义或发言者2

解释或对话2

1.3.2.4. <ol><li></li></ol>

有序列表或步骤。
li，表示一个条目。

建议采用以下格式（不建议使用type属性）：

<ol type="A|a|I|i|1" start="X">
<li>条目1</li>
<li>条目2</li></ol>

效果如下：

1. 条目1
2. 条目2

1.3.2.5. <ul><li></li></ul>

一个无序列表。
li，表示一个条目。

建议采用以下格式（不建议使用type属性）：

<ul type="disc|square|circle">
<li>条目1</li>
<li>条目2</li></ul>

效果如下：

• 条目1
• 条目2

1.3.2.6. <p> </p>

声明一个段落。不建议在其内使用其他段落标签（BR除外）。

建议采用以下格式：

<p>
段落内的文字，不建议使用其他段落标记（BR除外）。</p>

效果如下：

段落内的文字，不建议使用其他段落标记（BR除外）。

1.3.2.7. <pre> </pre>

预格式文本，其内保留空格，换行等字符。不建议其内使用其他段落标签。

建议采用以下格式：

<pre>
段落内的文字，不建议使用其他段落标记（BR除外）。</pre>

效果如下：

 预格式化文本，一般使用等宽字体，并保留空格和换行效果。

1.3.2.8. <table><tr><td></td></tr></table>

绘制一个表格。其中，
tr表示一行。
td表示一列。
th表示一列（表头）。

建议采用以下格式（不建议使用colspan,rowspan属性）：

<table>
<tr>
<th colspan=X rowspan=X>Header 11</th>
<th>Header 12</th></tr>
<tr>
<td colspan=X rowspan=X>Cell 21A</td>
<td>Cell 22B</td></tr>
</table>

效果如下：

1.3.3. 内联标签

指不会产生换行，在行内起到修饰作用的标签。

1.3.3.1. a

超链接或锚点。

建议采用以下格式（不建议使用type属性）：

• 连接到外部：<a href="URL" target="_blank" >显示名</a>
• 连接到锚点：<a href="#ID" target="_blank" >显示名</a>
• 定义锚点：：<a href="ID" />

1.3.3.2. b/del/i/sub/sup

被修饰文本的效果分别是，加粗/删除线/倾斜/上标/下标。

<b>加粗</b> <del>删除线</del> <i>倾斜</i> _上标 ^下标

效果如下： 加粗 删除线 倾斜 _上标 ^下标

1.4. 字符转义

常用的HTML字符转义。

1.5. 参考资料

• http://www.w3schools.com/tags/html5.asp
• http://docbook.sourceforge.net/