README

Jasny Bootstrap是著名的Bootstrap的扩展，增加了以下组件

• 按钮标签
• 抽屉式导航菜单
• 固定警报
• 行链接
• 文件输入小部件

要开始使用，请查看http://jasny.github.io/bootstrap！

快速开始

提供四种快速开始选项

• 下载最新版本.
• 克隆仓库： git clone git://github.com/jasny/bootstrap.git。
• 使用cdnjs。
• 使用Meteor安装： meteor add jasny:bootstrap。

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

包含内容

在下载中，您将找到以下目录和文件，逻辑分组常见资源，并提供编译和最小化版本。您将看到如下内容

jasny-bootstrap/
├── css/
│   ├── jasny-bootstrap.css
│   ├── jasny-bootstrap.min.css
└── js/
    ├── jasny-bootstrap.js
    └── jasny-bootstrap.min.js

我们提供编译的CSS和JS（jasny-bootstrap.*），以及编译和最小化的CSS和JS（jasny-bootstrap.min.*）。

Jasny Bootstrap应该在vanilla Bootstrap之后加载。

错误和功能请求

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

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

文档

Jasny Bootstrap的文档包含在此仓库的根目录中，使用Jekyll构建，并在GitHub Pages上公开托管于http://jasny.github.io/bootstrap。文档还可以在本地运行。

在本地运行文档

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

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

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

通过阅读其文档来了解更多关于使用Jekyll的信息。

先前版本的文档

在人们过渡到Bootstrap 3的同时，v2.3.1的文档目前可在http://jasny.github.io/bootstrap/2.3.1/找到。

以前的版本及其文档也可供下载。

编译CSS和JavaScript

Bootstrap 使用方便的 Grunt 工具来处理框架。这就是我们编译代码、运行测试等的方式。要使用它，按照指示安装所需的依赖项，然后运行一些 Grunt 命令。

安装 Grunt

从命令行

1. 使用 npm install -g grunt-cli 命令全局安装 grunt-cli。
2. 导航到根目录 /bootstrap，然后运行 npm install。npm 会查看 package.json 文件并自动安装其中列出的必要本地依赖项。

完成后，您将能够在命令行中运行各种 Grunt 命令。

不熟悉 npm？还没有安装 node.js 吗？ 没关系。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

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

监控 - grunt watch

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

解决依赖项问题

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

贡献

请阅读我们的 贡献指南。其中包括打开问题的说明、编码标准和开发说明。

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

编辑器首选项在 editor config 中可用，便于在常见的文本编辑器中使用。更多信息请访问 http://editorconfig.org。

社区

跟踪开发和社区新闻。

• 关注 @ArnoldDaniels 在 Twitter 上的动态。
• 如果您有一个不是功能请求或错误报告的问题？请在 Stack Overflow 上提问。

版本控制

为了提高发布周期的透明度并努力保持向后兼容性，Jasny Bootstrap 依据语义版本控制指南进行维护。有时我们会犯错，但我们会尽可能遵守这些规则。

发布将按照以下格式编号

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

以下是一些构建指南

• 破坏向下兼容性会增加主版本，同时重置次版本和修订号
• 在不破坏向后兼容性的情况下添加新功能会增加次版本，同时重置修订号
• 错误修复和其他更改只会增加修订号

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

主版本将遵循Bootstrap的主版本。这意味着只有当Bootstrap这样做时，才会破坏向后兼容性。

作者

Arnold Daniels

• twitter.com/ArnoldDaniels
• github.com/jasny
• jasny.net
• fiestainfo.com

版权和许可

版权所有2013 Jasny BV，在Apache 2.0许可下。