提交 bd2404d0 编写于 作者: C Catouse

* ajust markdown format.

上级 ac2891ba
......@@ -14,14 +14,14 @@
5. 尽量忽略(Omit)协议:如 `background: url(http://www.zui.com/images/example)`; 应该写`background: url(//www.zui.com/images/example)`;以方便http与https协议切换,除非必须使用某个协议;
6. 在保证可读性及与规范不冲突的情况下,尽可能使用语法允许的缩写形式,以减少网络传输中的字节数。
### 1.2 HTML规范 ##
### 1.2 HTML规范 ###
1. 使用HTML5规范,使用`<!DOCTYPE html>`,而不是XHTML(application/xhtml+xml)。这样可以使得代码更加简洁而且所有浏览器都支持。
2. 正确使用HTML标签,使用工具如[W3C HTML](http://validator.w3.org/nu/)验证;使用合法的HTML标签是可被衡量的规范,有助于编码者学习的技术要求和限制,并保证代码质量。
3. 使用语义话的标签,比如文章内容使用`<atricle>`,文字段落使用`<p>`,导航使用`<nav>`等。语义化地使用HTML有助于网页的可访问性,复用性,和优化代码效率。尽量少的为元素增加id和class属性,如果需要增加请使用正确的命名。
4. 不再使用type属性,因为在HMLT5中已经规定默认type值,无必要再次指定。
### 1.3 CSS规范 ##
### 1.3 CSS规范 ###
1. 尽可能使用CSS验证,除非因为修正浏览器解析差异而编写私有属性,否则都应该使用合法的CSS代码。可以使用[W3C CSS validator](http://jigsaw.w3.org/css-validator/)测试你的CSS。使用合法的CSS同样是一个可被衡量的规则,它能标记出那些不起作用和可被删除的代码,并确保CSS的正确使用。
2. 为样式赋予合适的类名,尽量不要使用`.red``.big-text`等与内容无关的命名方式(如果确实要使用,这时应该反思是否是采用的UI框架缺陷)。当类名代表的意义有广泛任何的缩写形式,则可以采用缩写,例如`navigation`可以缩写为`nav`。类名中采用分词形式时(包含多个单词时)请使用间隔号`-`来连接。
......@@ -33,7 +33,7 @@
8. 使用空行来划分规则的相关性。
9. 使用正确且精简的选择器,id与类名之前不需要加标签名称,例如`ul.nav {color: red}`应写为`.nav {color: red}`
### 1.4 Javascript规范 ##
### 1.4 Javascript规范 ###
1. 字符串优先使用单引号。
......@@ -59,6 +59,6 @@
├── _layouts/ // 文档模版
└── _includes/ // 文档内容
### 2.2 开发约定
### 2.2 开发约定 ###
- 不在框架文档中加入与框架当前无关的资源;
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册