README

此模块提供了视图助手，使使用twitter bootstrap变得简单。可选地，此模块还允许您使用AssetManager模块构建、缓存、修改和扩展twitter bootstrap。

注意

对bootstrap 3.0的支持正在积极开发中。您可以通过检出3.0.0分支来帮助和测试。

安装视图助手

如何安装？

将需求添加到您的composer.json文件中

./composer.phar require spoonx/sxbootstrap
# When asked for a version, type: "2.*"

安装Font Awesome

如何安装？

1. 将依赖添加到您的composer.json文件中

   ./composer.phar require fortawesome/font-awesome
   # When asked for a version, type: "3.*"

2. 在config/autoload/sxbootstrap.local.php中添加以下内容以启用Font Awesome的使用

   <?php
   return array(
       'twitter_bootstrap' => array(
           'use_font_awesome' => true,
       ),
   );

安装渲染器（推荐）

如何安装？

1. 将依赖添加到您的composer.less文件中

   ./composer.phar require rwoverdijk/assetmanager twbs/bootstrap
   # When asked for a version, type: "1.*" for assetmanager and "2.*" for bootstrap.

2. 在application.config.php配置文件中启用AssetManager和SxBootstrap。

3. 安装less...

   a) 通过NPM/Node.js （推荐方法）

   1. Install npm/node.js. [Instructions](https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager) can be found here.
   2. To Install lessc, open up your command line, and navigate to your project (`cd /path/to/my/project`).
   3. Once you get there, run the following command: `npm install less .` (including the dot).
   

   b) 通过lessphp （不建议）

   **Add the requirement**
   
   ```bash
   ./composer.phar require leafo/lessphp
   # When asked for a version, type: "0.*"
   ```
   
   Then add the following config to your application's module.config.php:
   
   ```php
   'twitter_bootstrap' => array(
       'use_lessphp' => true,
   ),
   ```
   

4. 配置过滤器以使其工作。 （仅适用于您使用node.js且二进制文件不在/usr/bin/node中，或您的node路径不是默认路径的情况，因此您已忽略步骤3a中的建议。)

5. 查看wiki以获取示例和其他信息以开始使用。特别是关于如何配置过滤器以使其工作（页面底部）的部分。

好的...为什么？

渲染器有很多优点。

• 允许轻松自定义
• 允许您扩展（在您的less文件中使用混入和变量！）
• 防止手动管理资源
• 允许切换组件和插件以包含（通过不包含不需要的文件来最小化文件大小）。
• 等等。

功能

• 简单的出色表单
• 新功能 可选的Font Awesome集成
• 新功能 添加加载路径
• 新功能 添加自定义组件
• 可定制（变量、组件、插件）
• 与AssetManager兼容
• 丰富的视图助手
• 可扩展（从bootstrap上下文运行自己的less文件以共享混入和变量）
• 与twitter bootstrap 2.3+兼容（较旧版本也可能工作）
• 您可以可选地使用lessphp（不推荐）

使用方法

查看vendor/spoonx/sxbootstrap/config中的config/sxbootstrap.local.php.dist文件以获取配置选项和相关信息。同时，请查看wiki。

问题/支持

如果您遇到模块的问题，以下是一些可能有帮助的资源。

• wiki页面，您可能会找到答案。
• RWOverdijk at irc.freenode.net #zftalk.dev
• 问题跟踪器。 （请尽量不要提交不相关的问题。）
• 通过邮件