README

Bootstrap是一个时尚、直观且强大的前端框架，由Mark Otto和Jacob Thornton创建和维护，用于更快、更简单地开发Web。

这是Bootstrap的Sass版本。它是从Less迁移到Sass的Bootstrap。该项目专注于成为原始版本的1:1迁移。请勿提交有关Bootstrap本身的任何问题或pull requests。这些问题应该在上游的Less版本中推进。

要开始使用，请访问https://bootstrap.ac.cn！

快速开始

有三个快速开始选项可供选择

• 下载最新版本.
• 克隆存储库： git clone git://github.com/jlong/sass-bootstrap.git。
• 使用Bower安装：bower install --save sass-bootstrap。

使用方法

您可以通过将编译后的CSS放入任何新项目来使用Sass Bootstrap并开始开发。

因为SASS始终输出标准CSS，所以只需像平常一样链接到最终输出即可

<link rel="stylesheet" type="text/css" href="./dist/css/bootstrap.css">

有关更多信息，请参阅文档！

基本修改

您可以在以下位置了解更多关于Sass的信息：

sass-lang.com

Sass在您的系统上作为本地GEM运行。您可以使用sass --watch lib/bootstrap.scss:dist/css/bootstrap.css运行它

错误和功能请求

请勿提交有关Bootstrap本身的任何问题或pull requests。这些问题应该在上游的Less版本中推进。请打开新问题。在打开任何问题之前，请搜索现有问题并阅读由Nicolas Gallagher撰写的问题指南。

您可以使用此JS Bin作为错误报告模板。

文档

Bootstrap的文档包含在此存储库的根目录中，使用Jekyll构建并公开托管在GitHub Pages上，网址为https://bootstrap.ac.cn。文档也可以在本地运行。

在本地运行文档

1. 如有必要，请安装Jekyll（需要v1.x）。
2. 从根目录/bootstrap，在命令行中运行jekyll serve。

• Windows用户：首先运行chcp 65001以更改命令提示符的字符编码（代码页），以便Jekyll无错误地运行。

1. 在浏览器中打开http://localhost:9001。

通过阅读他们的文档来了解如何使用Jekyll。

以前版本的文档

在人们过渡到Bootstrap 3的同时，已将v2.3.2的文档制作可用，网址为https://bootstrap.ac.cn/2.3.2/。

前一个版本的发布及其文档也都可以下载。

编译CSS和JavaScript

Bootstrap使用Grunt来提供方便的框架操作方法。这是我们编译代码、运行测试等方法。要使用它，按照指示安装所需的依赖，然后运行一些Grunt命令。

安装Grunt

从命令行

1. 使用npm install -g grunt-cli全局安装grunt-cli。
2. 通过npm install安装必要的本地依赖。

完成后，您将能够从命令行运行提供的各种Grunt命令。

不熟悉npm？没有安装node.js？没关系。npm代表node packaged modules，它通过node.js管理开发依赖。在继续之前，请先下载并安装node.js。

可用的Grunt命令

构建 - grunt

运行grunt来在本地运行测试并将CSS和JavaScript编译到/dist目录。需要recess和uglify-js。

仅编译CSS和JavaScript - grunt dist

grunt dist会创建包含编译文件的/dist目录。需要recess和uglify-js。

测试 - grunt test

在phantomjs（用于CI）中无头运行jshint和qunit测试。需要phantomjs。

监控 - grunt watch

这是一个用于仅监控Less文件并在保存时自动构建它们的方便方法。

解决依赖问题

如果您在安装依赖或运行Grunt命令时遇到问题，请卸载所有以前的依赖版本（全局和本地）。然后重新运行npm install。

贡献

请阅读我们关于为Bootstrap贡献的指南。包括打开问题的说明、编码标准和开发笔记。

此外，如果您的pull请求包含JavaScript补丁或功能，您必须包括相关的单元测试。所有HTML和CSS应符合Code Guide，由Mark Otto维护。

编辑器首选项在编辑器配置中可用，以便在常见的文本编辑器中轻松使用。了解更多信息并下载插件请访问http://editorconfig.org。

社区

跟踪开发和社区新闻。

• 关注@twbootstrap在Twitter上的动态。
• 阅读并订阅The Official Bootstrap Blog。
• 如果您有不是功能请求或错误报告的问题？在邮件列表上提问。
• 在IRC上与Bootstrap爱好者聊天。在irc.freenode.net服务器上的##twitter-bootstrap频道。

版本控制

为了提高透明度和对我们发布周期的洞察，以及努力保持向后兼容性，Bootstrap将在可能的情况下遵循语义版本控制指南进行维护。

版本号将按照以下格式编号：

<主版本>.<次版本>.<修订版>

并遵循以下指南：

• 破坏向后兼容性将增加主版本（并重置次版本和修订版）
• 在不破坏向后兼容性的情况下添加新功能将增加次版本（并重置修订版）
• 错误修复和其他更改将增加修订版

有关SemVer的更多信息，请访问 http://semver.org/。

SASS: 开发者

我们包含了一个Rakefile，其中包含与SASS Bootstrap库一起工作的便捷方法。

• 构建 - rake build 这将在bootstrap库上运行less编译器并重新生成docs目录。此命令需要lessc编译器。

• 监控 - rake watch 这是一个用于监控Sass文件并在您保存时自动构建它们的便捷方法。

作者

Mark Otto

• http://twitter.com/mdo
• http://github.com/mdo

Jacob Thornton

• http://twitter.com/fat
• http://github.com/fat

SASS: 将less转换为Sass

Twitter Bootstrap被精心转换为Sass，由以下人员完成：

John W. Long

• http://twitter.com/johnwlong
• http://github.com/jlong

Jeremy Hinegardner

• http://twitter.com/copiousfreetime
• http://github.com/copiousfreetime

m5o

• http://twitter.com/m5o
• http://github.com/m5o

smt

• http://twitter.com/tudorstudio
• http://github.com/smt

以及其他人员

SASS: 转换快速提示

• 将@替换为$
• 将.替换为@include用于混入
• 将spin替换为adjust-hue
• 在变量定义中添加!default
• 将#gradient > .vertical替换为@include gradient-vertical
• 将#grid > .style替换为@include grid-style
• 使用grid-core和grid-fluid混入而不是#grid > .core和#grid > .fluid
• 使用font-shorthand而不是#font > .shorthand
• 将fadein替换为fade-in
• 将@import移动到混入下方，因为它在bootstrap.scss中使用tab-focus混入
• 显式提供.cleafix、.hide-text和.input-block-level以与LESS输出兼容
• 将grid-*混入参数传递给生成器，否则生成器混入将使用默认变量

Sass: 通过Composer安装

如果您已经使用Composer（php依赖管理器），安装sass-twitter-bootstrap非常简单，只需输入

composer.phar require jlong/sass-bootstrap:x.y.z

这将从packagist.org安装版本x.y.z

您可能想确保您获得次要更新，例如

composer.phar require jlong/sass-bootstrap:~x.y.z

或例如

composer.phar require jlong/sass-bootstrap:x.y.*

版权和许可

版权所有（C）2012 Twitter, Inc。在Apache 2.0许可下。