README

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

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

快速开始

提供三种快速开始选项

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

阅读 入门页面 获取框架内容、模板和示例等信息。

包含内容

在下载中，您将找到以下目录和文件，逻辑分组常用资产，并提供编译和压缩版本。您将看到类似以下的内容

bootstrap/
├── css/
│   ├── bootstrap.css
│   ├── bootstrap.min.css
│   ├── bootstrap-theme.css
│   └── bootstrap-theme.min.css
├── js/
│   ├── bootstrap.js
│   └── bootstrap.min.js
└── fonts/
    ├── glyphicons-halflings-regular.eot
    ├── glyphicons-halflings-regular.svg
    ├── glyphicons-halflings-regular.ttf
    └── glyphicons-halflings-regular.woff

我们提供了编译后的CSS和JS（bootstrap.*），以及编译和压缩后的CSS和JS（bootstrap.min.*）。包含了Glyphicons字体，以及可选的Bootstrap主题。

错误和功能请求

有错误或功能请求？ 请创建新问题。在创建任何问题之前，请搜索现有问题并阅读由 Nicolas Gallagher 编写的 问题指南。

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

文档

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

在本地运行文档

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

• Windows用户：首先运行 chcp 65001 以更改命令提示符的字符编码（代码页）为UTF-8，以便Jekyll运行时不会出现错误。

1. 在浏览器中打开 https://: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. 导航到根目录 /bootstrap，然后运行 npm install。npm 会查看 package.json 并自动安装其中列出的必需本地依赖。

完成安装后，您可以从命令行运行提供的各种 Grunt 命令。

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

可用的 Grunt 命令

构建 - grunt

运行 grunt 来在本地运行测试，并将 CSS 和 JavaScript 编译到 /dist 目录。使用 recess 和 UglifyJS。

仅编译 CSS 和 JavaScript - grunt dist

grunt dist 会创建 /dist 目录并包含编译后的文件。使用 recess 和 UglifyJS。

测试 - grunt test

运行 JSHint 和 QUnit 测试，在 PhantomJS 中无头运行（用于 CI）。

监视 - grunt watch

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

依赖项故障排除

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

贡献

请阅读我们的 贡献指南。其中包含有关提交问题、编码标准和开发说明的指南。

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

编辑器首选项在 editor config 中提供，便于在常用文本编辑器中使用。了解更多信息和下载插件请访问 http://editorconfig.org。

从 v3.1 版本开始，Bootstrap 代码将从 Apache 2 协议迁移到 MIT 许可协议（文档除外）。有关更多信息，请参阅 贡献指南。

社区

跟踪开发和社区新闻。

• 关注 @twbootstrap 在推特上的动态。
• 阅读并订阅 官方 Bootstrap 博客。
• 您有关于不是功能请求或错误报告的问题吗？ 在邮件列表中提问。
• 与 Bootstrap 同仁在 IRC 中聊天。在 irc.freenode.net 服务器上，在 ##twitter-bootstrap 频道。

版本控制

为了提高透明度和了解我们的发布周期，并努力保持向后兼容性，Bootstrap 将尽可能地按照语义化版本控制指南进行维护。

版本号将采用以下格式

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

并遵循以下指南

• 破坏向后兼容性会导致主版本号增加（并重置次版本号和修订版本号）
• 不破坏向后兼容性的新功能会增加次版本号（并重置修订版本号）
• 错误修复和其它变动会增加修订版本号

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

作者

Mark Otto

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

Jacob Thornton

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

版权和许可

版权所有 2013 Twitter, Inc，在Apache 2.0 许可证下。