itlized/mopa-bootstrap-bundle

轻松将Twitter Bootstrap集成到symfony2

安装: 27

依赖者: 0

建议者: 0

安全: 0

星标: 0

关注者: 2

分支: 348

语言:CSS

类型:symfony-bundle

v3.0.0-beta3 2013-10-25 11:56 UTC

README

MopaBootstrapBundle 是一个代码集合,旨在尽可能容易地将Twitter的Bootstrap (http://twitter.github.com/bootstrap/) 集成到您的symfony2 (http://www.symfony.com) 项目中。

Bootstrap 3 的支持现在主要完成。查看 Beta-3

要在项目中使用 MopaBootstrapBundle 和 Twitter Bootstrap 3,请通过 composer 添加

注意

最近的BC(向后兼容)中断

  • dc4fd12: [BC Break] 完全移除了内联
  • add75e9: 将配置 mopa_bootstrap.navbar 重命名为 mopa_bootstrap.menu

BS3(此包的master分支)几乎稳定,请参阅 Beta-3 BS2(v2.3.x)相当稳定

BC中断变化可能不会移植到2.3。

分支

要使用此包与Bootstrap 3一起使用,请使用master分支

{
    "require": {
        "mopa/bootstrap-bundle": "v3.0.0-beta3",
        "twbs/bootstrap": "v3.0.0"
    }
}

对于Bootstrap 2,请使用v2.3.x分支

If you want to use bootstrap 2:

{
    "require": {
        "mopa/bootstrap-bundle": "2.3.x-dev",
        "twbs/bootstrap": "v2.3.2"
    }
}

要了解当前需要哪些版本,请查看 BRANCHES.md

文档

大部分文档存储在此包的 Resources/doc/index.md 文件中。无论如何,如果在更新后某些功能不按预期工作

最近的向后兼容中断变化

  • c892cd9: 改变了创建导航栏的方式,请阅读 文档
  • a4b78d5: 添加了BS2或BS3的版本检测
  • 5f1200f: 将 widget_addon 表单参数更改为使用类型(prepend/append)而不是 append(true/false)

实时展示

要查看此包,其功能和一些文档,请查看

MopaBootstrapBundle 实时展示

其他资源

安装

安装说明位于

包含的功能

  • 通过Composer桥检测Bootstrap版本
  • 用于与symfony2表单组件一起使用的Twig扩展和模板
    • 通过表单构建器或模板引擎控制您的表单
    • 控制几乎所有bootstrap2表单功能
    • 用于动态集合的javascript和twig块
  • 一个通用的Navbar类,用于在模板外生成您的Navbar
    • 下拉菜单、分隔符等辅助函数
  • 一个通用的Tab类,用于管理Bootstrap标签页
  • 为 KnpPaginatorBundle (https://github.com/knplabs/KnpPaginatorBundle) 提供的twig模板
  • 为 CraueFormFlowBundle (https://github.com/craue/CraueFormFlowBundle) 提供的twig模板
  • 为 KnpMenuBundle (https://github.com/KnpLabs/KnpMenuBundle) 提供的twig模板
    • 菜单链接上的图标支持

最近添加的功能

标签页

这里需要添加更多信息

Bootstrap 3

我们现在正式在主分支中支持Bootstrap 3,默认是通过composer确定版本,这意味着,MopaBootstrapBundle会尝试确定您已安装的版本,并配置自己使用它。这是在编译器过程中完成的,并存储在本地缓存中。如果由于任何原因这不适合您,您可能需要设置

我们为bs2和bs3提供了一些单独的文件,以便能够支持两者,例如表单

bs3功能集尚未完成,但我们希望它很快就会完成,在您的帮助下!例如,表单有一些已知问题,JS集合等

动态子导航栏

为了启动您的导航,Navbar组件进行了一些外观提升。集成动态子导航栏(您可能在twitter bootstrap文档中看到过)变得更加容易。

要了解如何使用此功能,请阅读Navbar文档(4-navbar-generation)

还可以查看沙盒

initializr

为了让您的HTML5基础更好,并让您使用我们添加到这个捆绑包中的良好实践,我们添加了来自HTML5 BoilerPlate项目的功能。集成是通过使用Initializr预先生成的设置来完成的。实际上,我们支持HTML5 BoilerPlate v3.0.3与Modernizr v2.5.3和Respond。

要了解如何使用这些功能,请阅读Initializr文档(50-Initializr.md)

警告

分支策略已经调整以更灵活

  • 旧版本的bootstrap 1.x分支(v1.x)仍然存在。
  • v2.0.x(以前为v2.x_sf2.0)分支遵循Symfony 2.0.x和bootstrap 2.x
  • 主分支遵循Symfony主分支和bootstrap 2.x
  • master-crud分支遵循Symfony主分支和bootstrap 2.x,但仍然有CRUD生成器,它依赖于SensioGeneratorBundle

翻译

如果您使用KnpPaginatorBundle与MopaBootstrapBundle一起,您可以将标签翻译成您的语言。为此,请添加新文件

Resources/translations/pagination.[YOUR LOCALE CODE].yml

例如,您有波兰语翻译。

贡献

如果您想为MopaBootstrapBundle贡献代码,请确保您的PR符合Symfony2.1编码标准。您可以使用PHP-CS-Fixer工具自动修复您的代码。

您可以在贡献者页面查看已经为此项目做出贡献的人。

许可证

此捆绑包受MIT许可证的约束。有关更多信息,请参阅捆绑包中的完整LICENCE文件。