bourbon

截至2024年9月13日弃用

该项目不再维护。我们鼓励人们利用现代本地CSS功能代替该图书馆。您可以参考我们有关如何更换或重新考虑每个助手的博客文章。

轻巧的SASS工具集

波旁威士忌是一个杂物和功能的库，旨在使您成为更有效的样式表作者。

这是…

• 无依赖性：波旁威士忌是纯净的。
• 人类可读：我们的目标是要清楚简洁。
• 轻量级：零输出后安装，没有视觉意见。

有用的链接

• 文档
• 更改日志
• 叽叽喳喳
• 堆栈溢出

目录

• 要求
• 安装
• 命令行接口
• 浏览器支持
• 贡献
• 执照
• 关于

要求

• SASS 3.4+或Libsass 3.3+

安装

1. 使用RubyGems软件包管理器安装波旁宝石：

   gem install bourbon

2. 将波旁威士忌库安装到当前目录中：

   bourbon install

   专家提示：您可以使用path标志将目标安装到特定目录中：

   bourbon install --path my/custom/path/

3. 在样式表的开头导入波旁威士忌：

    @import " bourbon/bourbon " ;

   不建议您直接修改波旁威士忌的文件，因为它会通过覆盖自定义更改或引起合并冲突来使将来版本变得困难。

Ruby在Rails 4.2+上安装

1. 将波旁威士忌添加到您的Gemfile：

    gem "bourbon"

2. 然后运行：

   bundle install

3. 重新启动您的服务器并重命名application.css to application.scss ：

   mv app/assets/stylesheets/application.css app/assets/stylesheets/application.scss

4. 删除application.scss中的所有链轮指令（ require ， require_tree and require_self ），然后使用SASS的本机@import （为什么？）。

5. 在application.scss开始时导入波旁威士忌。利用波旁威士忌功能的任何项目样式都必须在波旁威士忌之后进口。

    @import " bourbon " ;
   @import " home " ;
   @import " users " ;

使用NPM安装并使用基于节点的资产管道

1. 将波旁威士忌添加为一种依赖性：

   npm install --save bourbon

2. 如果您使用的是眼镜，请跳过步骤3。否则，您需要将波旁威士忌添加到node-sass includePaths选项中。 require("bourbon").includePaths是一系列目录，您应该将其传递给节点sass。您如何做到这取决于如何将节点萨斯集成到您的项目中。

3. 将波旁威士忌导入您的SASS文件：

    @import " bourbon " ;

安装旧版本的波旁威士忌

1. 卸载您已经拥有的任何波旁宝石版本：

   gem uninstall bourbon

2. 重新安装波旁威士忌，使用-v标志指定所需的版本：

   gem install bourbon -v 4.2.7

3. 请按照上述说明将波旁威士忌安装到您的项目中。

命令行接口

bourbon [options]

选项

选项	描述
-h ， --help	显示帮助
-v ， --version	显示版本号
--path	指定自定义路径
--force	武力安装（覆盖）

命令

命令	描述
bourbon install	将波旁威士忌安装到当前目录中
bourbon update	当前目录中的覆盖和更新波旁威士忌
bourbon help	显示帮助

浏览器支持

波旁威士忌支持Internet Explorer 11+以及Chrome，Firefox，Safari和Edge的最新版本。

贡献

请参阅贡献文件。谢谢，贡献者！

执照

波旁威士忌是版权所有©2011 ThinkBot，Inc。它是免费软件，可以根据许可证中指定的条款进行重新分配。

关于Thoughtbot

该仓库由Thinkbot，Inc。维护和资助。 ThoughtBot的名称和徽标是Thinkbot，Inc的商标。

我们喜欢开源软件！查看我们的其他项目。我们可以租用。