README

为您的 Symfony2 应用程序添加剑桥大学的风格。

作者

Chris Wilkinson chris.wilkinson@admin.cam.ac.uk

安装

将 ProjectLightBundle 添加到您的依赖项中

// composer.json

{
   // ...
   "require": {
       // ...
       "misd/project-light-bundle": "~1.0@dev"
   }
}

使用 Composer 下载并安装 ProjectLightBundle

$ php composer.phar update misd/project-light-bundle

在您的应用程序中注册该组件

// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Misd\ProjectLightBundle\ProjectLightBundle()
    );
}

Project Light 资产

该组件包含 Project Light 的所有资产（样式表、JavaScript 和图片）。

基本模板

可以扩展基本模板

{% extends 'ProjectLightBundle::base.html.twig' %}

或者其中一个主题

{% extends 'ProjectLightBundle::theme_blue.html.twig' %}
{% extends 'ProjectLightBundle::theme_green.html.twig' %}
{% extends 'ProjectLightBundle::theme_grey.html.twig' %}
{% extends 'ProjectLightBundle::theme_orange.html.twig' %}
{% extends 'ProjectLightBundle::theme_purple.html.twig' %}
{% extends 'ProjectLightBundle::theme_red.html.twig' %}
{% extends 'ProjectLightBundle::theme_turquoise.html.twig' %}

`标题`

HTML <title> 可以在 title 块中设置。默认为空。

示例

{% block title %}My title{% endblock %}

`样式表`

本地样式表可以包含在 stylesheets 块中。

示例

{% block stylesheets %}
<link rel="stylesheet" href="{{ asset('path/to/my/stylesheet.css') }}">
{% endblock %}

`主题`

如果不扩展特定的主题模板，可以在 theme 块中设置它。

示例

{% block theme %}campl-theme-3{% endblock %}

`内容`

这包含所有内容（包括本地页眉）。

`页脚`

可以在 footer 块中包含本地页脚。

`JavaScript`

本地 JavaScript 文件可以包含在 javascripts 块中。这将出现在页面末尾（即 </body> 之前）。

示例

{% block javascripts %}
<script src="{{ asset('path/to/my/javascript.css' }}"></script>
{% endblock %}

`合作伙伴关系`

合作伙伴品牌可以包含在 partnerships 块中。

示例

{% block partnerships %}

    <div class="campl-row campl-content">
        <div class="campl-wrap clearfix">
            <div class="campl-column12 campl-partnership-branding">
                <div class="campl-content-container campl-side-padding">
                    <div class="campl-content-container campl-logo-container campl-bottom-padding">
                        <p class="campl-branding-title">Supported by</p>
                        <ul class="campl-unstyled-list campl-logo-list campl-horizontal-navigation clearfix">
                            <li><img src="{{ asset('path/to/the/logo.png') }}" alt="Some Company"/></li>
                        </ul>
                    </div>
                </div>
            </div>
        </div>
    </div>

{% endblock %}

通知

该组件附带一个通知模板，您可以使用它

{% for level, messages in app.session.flashbag.all() %}
    {% for message in messages %}
        {% include 'ProjectLightBundle:Component:notification.html.twig' with {level: level, text: message} %}
    {% endfor %}
{% endfor %}

预期级别是 success、warning、alert 和 information（默认）。

KnpMenu 渲染

该组件附带一个自定义菜单渲染器，替换了默认的。如果您想使用自己的渲染器，可以像平常一样配置 KnpMenuBundle。

Pagerfanta 视图

该组件附带一个自定义视图，替换了默认视图。如果您想使用自己的视图，可以像平常一样配置 WhiteOctoberPagerfantaBundle。

misd / project-light-bundle

维护者

详细信息