GitHub倡导的CSS编写风格及文件目录部署指南

这个CSS风格指南是在GitHub内部用于应用程序的指南。我们鼓励您建立一个适合你自己团队的风格指南。在你阅读这个之前，你需要大致了解SCSS语法和KSS文档。虽然我们通过KSS文档把风格移植到了SCSS上，但请务必立刻升级整个元素的CSS。不要混合少量SCSS和无格式的CSS。

编码风格：

1.用两个空格的“soft-tabs”来缩进
2.在属性声明的“：”后加上空格
3.在规则声明后的“{”前加上空格
4.使用十六进制颜色代码#000,如果不使用RGBA
5.使用//来做注释块（而不是/**/）
6.文档风格与KSS相同
7.这里有个好的语法示例：

CSS Code复制内容到剪贴板

// This is a good example! .styleguide-format {
border: 1px solid #0f0; color: #000;
background: rgba(0,0,0,0.5); }

SCSS 风格：

任何会在多个文件中使用的$variable 或者 @mixin应该放在globals/下。其他的应该放在使用它的文件的顶部。
作为一个经验法则，不要使用超过3层的嵌套。如果你发现你将要使用超过三层，想想重新组织你的规则。
文件组织：

一般来说，CSS文件组织应该想下面这样：

styles
├── components
│   ├── comments.scss
│   └── listings.scss
├── globals
│   ├── browser_helpers.scss
│   ├── responsive_helpers.scss
│   ├── variables.scss
├── plugins
│   ├── jquery.fancybox-1.3.4.css
│   └── reset.scss
├── sections
│   ├── issues.scss
│   ├── profile.scss
└── shared
    ├── forms.scss
    └── markdown.scss
使用Spockets来获取文件。但是，你应该明确地导入任何在特定的SCSS文件中不会产生样式（globals/）的SCSS。下面是个好的例子：