0
点赞
收藏
分享

微信扫一扫

google编码规范之htmlcssguide.html其一

IT影子 2022-02-08 阅读 47
html

一.背景

对于HTML和CSS,这些文档定义了格式和样式规则。他目的是在提升协作、代码质量和能够支持基本设施。它应用于使用HTML和CSS原始的的工作文件夹,包括GSS文件夹。只要维持一般的代码质量,工具就可以自由的去模糊、缩小和编译。

---------------------------------------------不认识单词---------------------------------------------------------------------

document:文档;记录            defines:定义            formatting:格式化              style:样式

aims:目的;目的是      collaboration:合作;协作       code:代码       infrastructure:基础设施

applies:应用;申请                raw:未经加工的;原始的                     files:文件夹

obfuscate:混淆;模糊不清           minify:缩小            compile:编译                                   

as long as:只要               maintained:维持;保持

---------------------------------------------------------------------------------------------------------------------------------

二.普遍的

2.1 General Style Rules 普遍的样式风格

2.1.1 Protocol 协议

尽可能的对于嵌入式资源使用HTTPS。

对于图像和其他的媒体文件,样式表和笔迹经常使用HTTPS (https:) ,除非各自的文件不可用在HTTPS之上。

---------------------------------------------不认识单词---------------------------------------------------------------------

embedded:嵌入      resources :资源;资料       media:媒体         sheets:一张;薄片

scripts:笔迹;剧本         respective:分别的                   available:可用

---------------------------------------------------------------------------------------------------------------------------------

2.2 General Formatting Rules 普遍的格式风格

2.2.1 Indentation 首行缩进

每次缩进两个空格。

首行缩进时不要使用制表符或者混合制表符和空格。

--------------------------------------------------不认识的单词-------------------------------------------------------------

Indent:缩进          at a time:每次

---------------------------------------------------------------------------------------------------------------------------------

2.2.2 Capitalization 用大写,资本化

只使用小写。

所有的代码必定是小写:这是应用于HTML的要素名称,属性,属性值(除非文本/CDATA),CSS的选择器,特性,和特性值(字符串例外)

--------------------------------------------------不认识的单词-------------------------------------------------------------

lowercase:小写     have to be:必定是        element:要素       attributes:属性;性质

selectors:选择器     properties:特性       with the exception of:除...外

strings:字符串;一系列

---------------------------------------------------------------------------------------------------------------------------------

2.2.3 Trailing Whitespace 尾随空格

移动尾随的空格。 尾随空格是不必要的和复杂的差别。

--------------------------------------------------不认识的单词-------------------------------------------------------------

Trailing:后面的          Whitespace:空格,空白符         unnecessary:不必要的,多余

complicate:复杂化

---------------------------------------------------------------------------------------------------------------------------------

2.3 General Meta Rules 普遍的标签风格

2.3.1 Encoding 编码,字符编码

使用UTF-8 编码(不需要BOM表明字节顺序)

确保编辑器使用UTF-8作为字符编码,不是一个字节顺序标记。

在HTML模板和文件通过<meta charset="utf-8">具体说明编码。

没有具体说明的编码样式表作为这个假定的UTF—8。

(更多的编码信息何时,以及如何去具体说明更多的编码信息,能够在HTML和css的操作特性里找到)

---------------------------------不认识的单词------------------------------------------------------------------------------

UTF逐渐成为电子邮件、网页及其他存储或传送文字的应用中,优先采用的编码

BOM:Byte Order Mark 节序标记       editor:编辑        Specify :具体说明     

encoding:编码       templates :模板          documents:文件          via:通过

---------------------------------------------------------------------------------------------------------------------------------

2.3.2 Comments    注解

在可能的情况下,根据需要解释代码。

使用注解来解释代码:它包括了什么,它提供了什么用途,为什么是用各自习惯的或者更喜欢的解决方案?

这个选项是可选择的,因为它不强烈要求完整的文件代码。对于HTML和CSS代码的用处或许不同,取决于项目的复杂程度。

--------------------------不认识的单词--------------------------------------

purpose:目的      respective:各自的         realistic:切实可行的   


2.3.3 Action Items    动作项

标记所有的动作项到待办的事。

只使用关键词来强调显示全部内容,而不是用常见的格式,如@@。

在圆括号中附加一个联系人(用户名或者邮件列表),例如格式TODO(联系人)。

在冒号后面附加动作项,例如TODO:动作项。

-------------------不认识的单词------------------------------------------------------

todos:全部       TODO:待办事项        Highlight:强调   

 common formats:常见格式       Append:附加       mailing list:邮件列表    

parentheses:圆括号       colon:冒号

举报

相关推荐

0 条评论