diff --git a/docs/coding/html.md b/docs/coding/html.md index 21547a7..19ad9c5 100644 --- a/docs/coding/html.md +++ b/docs/coding/html.md @@ -5,6 +5,26 @@ order: 1 # HTML Coding Specification +## 0. Boilerplate + +```html + + + + + + My Site - There are a lot of fun! + + + + + +
+ + + +``` + ## 1. DOCTYPE ### 1.1. `mandatory` Must have doctype at the beginning @@ -149,19 +169,47 @@ If a part of the document is written in another language, add `lang` attribute t ``` -- 1.3.1 `recommended` 使用 UTF-8 字符编码。 - - 声明一个明确的字符编码,可以让浏览器更快速高效地确定适合网页内容的渲染方式。 +## 3. `` elements - 由于历史原因,不同浏览器采用了不同的字符编码。但对于新业务,如无特殊要求,统一使用 UTF-8 字符编码,以便统一。 +### 3.1. `mandatory` `` element must be contained in `` element - 在 HTML 中使用 `` 声明文档的编码方式: +```html + + + + + ... + + + + + - ```html + + + - ``` + + ... + + +``` + +### 3.2. `mandatory` 使用 UTF-8 字符编码 + +声明一个明确的字符编码,可以让浏览器更快速高效地确定适合网页内容的渲染方式。 + +由于历史原因,不同浏览器采用了不同的字符编码。但对于新业务,如无特殊要求,统一使用 UTF-8 字符编码,以便统一。 + +在 HTML 中使用 `` 声明文档的编码方式: + +```html + + + +``` - 1.3.2 `recommended` 页面提供给移动设备使用时,需要设置 [viewport](https://drafts.csswg.org/css-device-adapt/#viewport-meta)。 @@ -432,28 +480,6 @@ If a part of the document is written in another language, add `lang` attribute t 了解更多 HTML 可访问性的知识,可以阅读[这篇 MDN 的文章](https://developer.mozilla.org/zh-CN/docs/learn/Accessibility)。 -## 3. 脚手架模板 - -根据以上规约,建议的 HTML 脚手架模板如下: - -```html - - - - - - - - 淘宝网 - - - -
- - - -``` - ## Credits - [Guo Yunhe](https://github.com/guoyunhe) diff --git a/docs/coding/html.zh.md b/docs/coding/html.zh.md index 105cbde..e163b5a 100644 --- a/docs/coding/html.zh.md +++ b/docs/coding/html.zh.md @@ -5,6 +5,26 @@ order: 1 # HTML 编码规约 +## 0. 文件样板 + +```html + + + + + + My Site - There are a lot of fun! + + + + + +
+ + + +``` + ## 1. DOCTYPE ### 1.1. `强制` 文档开头必须有 doctype @@ -149,7 +169,7 @@ order: 1 ``` -## 3. +## 3. `` 元素 - 1.3.1 `推荐` 使用 UTF-8 字符编码。 @@ -434,28 +454,6 @@ order: 1 了解更多 HTML 可访问性的知识,可以阅读[这篇 MDN 的文章](https://developer.mozilla.org/zh-CN/docs/learn/Accessibility)。 -## 3. 脚手架模板 - -根据以上规约,建议的 HTML 脚手架模板如下: - -```html - - - - - - - - 淘宝网 - - - -
- - - -``` - ## 作者署名 - [郭云鹤(鹤仙)](https://github.com/guoyunhe)