# HTML 开发规范指南
HTML 开发规范指南
## 1.文档目录结构
```
.
├── assets
│ ├── css
│ ├── fonts
│ ├── images
│ ├── js
│ └── pic
├── favicon.ico
├── index.html
```
## 2.文档类型
统一使用HTML5的标准文档类型：\
```markup
```
## 3.语言属性
对不同语言文件使用正确的语言设定。
```markup
```
## 4.移动端设置
```markup
```
## 5.meta设定
了解各种meta的设定，针对具体项目取舍。
```markup
value
```
## 6.缩进
使用tab（4个空格宽度）来进行缩进，可以在IDE里进行设置
## 7.语义化标签
* 根据HTML元素的本身用途去使用它们；
* 禁止使用被废弃的用于表现的标签，如 center, font 等；
* 部分在XHTML1中被废弃的标签，在HTML5中被重新赋予了新的语义，在选用时请先弄清其语义，如:b, i, u等。
不允许：
```markup
标题
```
应该：
```markup
标题
```
> 虽然使用p标签，也可以通过CSS去定义它的外观和标题相同，但p标签本身的并不是表示标题，而是表示文本段落
## 8.模块化
* 每个模块必须有一个模块名；
* 每个模块的基本组成部分应该一致；
* 模块的子节点类名需带上模块名（防止模块间嵌套时产生不必要的覆盖）；
* 孙辈节点无需再带模块名。
代码如：
```markup
```
> 其中 `.m-detail-hd`, `.m-detail-bd`, `.m-detail-ft` 为可选，视具体模块情况决定是否需要抽象为这种 **头，中，尾** 的结构
## 示例文件
[HTML示例文件](https://github.com/thus/doc/tree/106d01ce2108410907eda3021a8184317a3dc334/code/chapter-1/01-html.html)