README

关于

此 Bundle 使得将 Ionicons 集成到您的 Symfony2 项目变得简单。

先决条件

您的项目中安装了 Ionicons 仓库。它不包含在此 Bundle 中。您可以使用 Composer、Bower 或其他方式来安装它。

安装

将 neonexus/ionicons-bundle 添加到您的 composer.json

 {
     ...
     "require": {
         ...
         "neonexus/ionicons-bundle": "0.4.*",
         "driftyco/ionicons": "1.5.*"
     }
     ...
 }

将 IoniconsBundle 添加到您的 AppKernel.php

 ...
 public function registerBundles()
 {
     $bundles = array(
         ...
         new NeoNexus\Ionicons\IoniconsBundle()
     );
     ...
 }
 ...

更新您的依赖项： composer update。

注意：通过 composer 安装 Ionicons 是可选的，但可以使此 Bundle 即刻生效。因此，我建议这样做。

配置

如果您没有通过 composer 安装 Ionicons，则必须配置到您的安装路径

ionicons:
    assets_dir: %kernel.root_dir%/../vendor/driftyco/ionicons

自定义

如果您想自定义 Ionicons，您必须在您的项目中放置一个自定义变量文件并配置路径。您还必须设置输出路径。

ionicons:
    filter: less
    customize:
        variables_file:         %kernel.root_dir%/Resources/ionicons/variables.less
        ionicons_output:    %kernel.root_dir%/Resources/less/ionicons.less

如果您想使用 lessphp 或 sass Assetic 过滤器，您必须相应地设置 filter 变量。

有一个命令可以生成一个自定义输出文件，以便包含您的自定义变量文件

app/console neonexus:ionicons:generate

使用

字体文件的安装

此 Bundle 提供了一个命令，可以将字体文件安装到 web/fonts 目录

app/console neonexus:ionicons:install

还有一个 ScriptHandler，可以在每次 composer install 或 composer update 时自动执行此操作

...
"scripts": {
    "post-install-cmd": [
        ...
        "NeoNexus\\Ionicons\\Composer\\ScriptHandler::install"
    ],
    "post-update-cmd": [
        ...
        "NeoNexus\\Ionicons\\Composer\\ScriptHandler::install"
    ]
},
...

要包含 Ionicons CSS，只需在您的基础模板中包含 @ionicons_css。

<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8" />
        <title>{% block title %}Welcome!{% endblock %}</title>
        {% block stylesheets %}
            {% stylesheets
                '@ionicons_css'
            %}
                <link rel="stylesheet" href="{{ asset_url }}" media="screen"/>
            {% endstylesheets %}
        {% endblock %}

简单图标（目前损坏）

要插入简单图标，请将 {{ fa_icon( icon name|options ) }} 添加到您的模板中。

参数可以是只包含图标名称且没有 fa- 前缀的 string 或 JSON 以进行更多自定义。完整的选项集如下

{
    icon:           name of the icon without 'fa-' prefix
    scale:          [lg|2x|3x|4x|5x|stack-1x|stack-2x],
    fixed-width:    [true|false],
    list-icon:      [true|false],
    border:         [true|false],
    pull:           [left|right],
    spin:           [true|false],
    rotate:         [90|180|270],
    flip:           [horizontal|vertical],
    inverse:        [true|false]
}

待办事项

修复 Twig 扩展
修复测试

许可

此 Bundle 在 MIT 许可证下发布。
Ionicons 也在 MIT 许可证下发布。

致谢

此 Bundle 是基于 Font Awesome Bundle 分支的，并从中获得灵感。感谢 Andreas Ernst！

neonexus / ionicons-bundle

维护者

详细信息

README

关于

先决条件

安装

配置

自定义

使用

字体文件的安装

简单图标（目前损坏）

待办事项

许可

致谢