如果本文档中有任何错误的、不符合行规的，敬请斧正。

引言

不管有多少人共同参与同一项目，一定要确保每一行代码都像是同一个人编写的。

若您对本文档中任何内容有不明白的，或者感觉不合行规的，请您按以下格式向我邮件说明，同时也欢迎任何人参与讨论，共同完善本文档。本文档中很多也是根据我自己现在的公司需求来定的。

邮件不是QQ，请尽可能清晰的组织你的语言，将问题描述得更清楚，同时，不要使用过多的样式化，合乎文档排版标准，谢谢。

项目文件结构

前端项目文件结构

前端项目统一按以下目录结构管理项目文件：

/path/to/PROJECT_NAME/  scss/    base.scss    main.scss    _module_name.scss  scripts/    build.js  gulp.js  build/    vendor/      THIRD_PARTY_LIBRARY_NAME/        VERSION/          MINIFIED_FILE_NAME/    assets/      css/        base.min.css        base.min.map        main.min.css        main.min.map      img/        logo.png        logo@2x.png        logo@3x.png      js/        main.min.js        main.min.map    index.html    layout.html    PAGE_NAME.html  template/    vendor/      THIRD_PARTY_LIBRARY_NAME/        VERSION/          MINIFIED_FILE_NAME/    assets/      css/        base.css        main.css      img/        logo.png      js/        main.js    index.html    layout.html    PAGE_NAME.html

在上面的目录结构中，大写的名称为可变的，即根据具体需求随时更换，它们的语义分别为：

• PROJECT_NAME

  当前项目的英文名称（若叮当钱包官方无法给出标准翻译，或者拼音即是其名称，则使用拼音全称，或者使用其官方定义的短名称），由纯小写字母 a-z 或者数字 0-9 以及中划线 - 组成的字符串

• template

  模板目录，用于开发使用

• build

  构建目录

• vendor

  所有第三方的文件均存放在 vendor 目录中，在 vendor 中，任何第三方库、样式、脚本等均需要遵守以下规则存放：任何一个第三方库均需要存放在其名称下，在开发过程中，使用 bower 安装。

HTML标准说明

文档类型

任何一个HTML页面，均必须使用下面这个文档类型声明：

在叮当钱包的任何项目的 HTML 界面中，不允许出现该声明之外的任何声明。

合法性验证

合法的使用HTML，并利用w3c的工具（W3C HTML validator）进行检查。

语义性

根据目的合理使用HTML标签，例如 header、footer、nav、section 等标签，跟 div 十分类似，但是在语义上却有天壤之别，比如下面这样：

  
    
读《双城记》
  
  
    
《双城记》（英语：A Tale of Two Cities）是英国作家查尔斯·狄更斯所著的一部以法?大革命为背景所写成的长篇历史小说，情?感人肺腑，是世界文??典名著之一，故事中?巴黎、?敦??大城市??起?，围绕着曼奈特医生一家和以德法奇夫妇为首的圣安东尼区展开故事。小说里描写了贵族如何败坏、如何残害百姓，人民心中积压对贵族的刻骨仇恨，导致了不可避免的法国大革命。本书的主要思想是为了爱而自我牺牲，?名中的「?城」指的是巴黎??敦。
    
人物介?
    
      
曼奈特?生（Dr. Alexandre Manette），一位老政治犯。
      
露西·曼奈特（Lucie Manette），曼奈特?生的女?。
      
查?斯·丹尼（Charles Darney），厄弗?蒙地侯爵的?子，?上露西·曼奈特。
      
雪尼?卡?（Sydney Carton），一位?世嫉俗的律?，?上露西·曼奈特。
      
德法奇（Ernest Defarge），曼奈特?生?日的?人。
      
德法奇夫人（Madame Defarge/Teresa Defarge），一位?定的女革命者。
      
?翰·拔沙（John Barsad），一位??。他的真?名字是索??（Solomon Pross） ，是波希小姐（Miss Pross）的哥哥。
      
波希小姐（Miss Pross），露西的保姆。
      
??·?利（Roger Cly），另一位??，?翰·拔沙的夥伴