README

kohana-twbs 为 Kohana 项目添加了对 Twitter Bootstrap 和 Font-Awesome 的支持，通过 composer 从源代码导入依赖以确保它们可以轻松更新。

安装基本库和静态资源

在您的 composer.json 中包含以下内容

{
	"require": {
		"ingenerator/kohana-twbs" : "dev-master"
	}
}

运行 composer 以通过 composer install 将模块及其外部依赖项安装到您的项目中。

您应该在模块目录中看到此模块，在 vendor 目录下有 Twitter Bootstrap 和 Font-Awesome 包。不过，静态字体和 JavaScript 文件不能从那里托管，所以接下来您需要像往常一样启用模块，然后运行 `minion twbs:publishasssets" 以将所需文件从 vendor 包复制到您的文档根目录。您应该更新您的 .gitignore 文件以避免将这些复制的文件检查到源代码控制中。

安装和编译 less 文件

为了在自定义网站样式时提供最大灵活性，kohana-twbs 默认将所有 CSS 从原始 LESS 源代码编译出来。提供了一个 minion 任务来帮助完成此操作，这也需要您安装 recess - 由 Bootstrap 项目官方支持的 less 编译器。

默认情况下，minion twbs:compile-less 将编译和压缩模块的 assets/less 目录中包含的 site.bootstrap.less，输出到 DOCROOT/assets/css/site.bootstrap.css。提供的文件简单地将 bootstrap 与 Font-Awesome 图标集结合起来。

一旦您准备好开始自定义样式，请将 site.bootstrap.less 放在 APPATH/assets/less 中 - 这将编译模块版本。所有 assets/less 文件都将包含在 recess 的 include 路径中，但 recess 的工作方式与 Kohana CFS 略有不同。

通过 minion 任务传递的选项，recess 将按照以下方式搜索 @import 文件

• 包含 @import 语句的文件的目录
• CFS 中的每个 assets/less 文件夹，按顺序
• Font-Awesome less 文件夹
• Bootstrap less 文件夹

因此，您不能简单地放入例如 carousel.less 文件并替换 bootstrap 自身的文件。您有两个选项

• 定义覆盖/扩展 bootstrap 默认样式的样式，并在包含 bootstrap 之后包含它们。
• 从您的顶级 less 文件中导入单个 bootstrap 组件，并适当地指定它们的路径，而不是仅导入整个 bootstrap 文件。

您还可以向 compile-less 任务传递选项来配置其他编译器属性，包括源和目标路径。

许可证

版权所有 (c) 2013，inGenerator Ltd 保留所有权利。

在满足以下条件的情况下，允许重新分发和使用源代码和二进制形式，无论是否修改

• 源代码重新分发必须保留上述版权声明、本条件列表和以下免责声明。
• 二进制形式重新分发必须复制上述版权声明、本条件列表和以下免责声明在随分发提供的文档和/或其他材料中。
• 未经 inGenerator Ltd 事先书面许可，不得使用 inGenerator Ltd 名称或其贡献者的名称来认可或推广从本软件派生的产品。

本软件由版权所有者和贡献者提供，"按现状"提供，并放弃任何明示或暗示的保证，包括但不限于适销性和适用于特定目的的暗示保证。在任何情况下，版权所有者或贡献者均不对任何直接、间接、偶然、特殊、示范性或后果性损害（包括但不限于替代货物或服务的采购；使用、数据或利润的损失；或业务中断）承担责任，无论这些损害是否由使用本软件引起，无论是否事先被告知这种损害的可能性。