README

Fontawesome

Fontawesome 是一个流行的图标库，包含大量酷炫和花哨的元素。

具体示例，请查看官方网站。

本包的目的

Fontawesome 是一个庞大的库，专业版包含超过 7000 个图标。如果您想在选择器中使用图标，例如，在下载图标文件时加载提供的信息太大，无法处理，且可能导致性能问题。因此，为了简化，此包仅提取基本信息并创建一个新的、更轻量级的文件。

本包包含免费图标。当前版本为 5.13.0。要使用专业版，请阅读以下关于专业版的文档。

安装

您可以通过 Composer 安装此包

composer require quicksite/fontawesome-json-parser

自 Laravel 5.5 及以上版本起，包将自动注册服务提供者和外观

接下来，发布配置文件

php artisan vendor:publish --provider="Quicksite\FontawesomeJsonParser\FontawesomeJsonParserServiceProvider" --tag="config"

配置

配置文件很简单。它将文件发布到您的存储目录和配置文件中定义的文件夹。

return [

    /*
    |--------------------------------------------------------------------------
    | Fontawesome Json parser configurations
    |--------------------------------------------------------------------------
    |
    */

   'filename' => env('FONTAWESOME_JSON_FILENAME', 'icons'),

    'icons-route' => env('FONTAWESOME_JSON_ROUTE', '/fontawesome-icons'),
    'load-from-route' => env('FONTAWESOME_JSON_LOAD_FROM_ROUTE', 'fontawesome-icons'),
    'export-to-route' => env('FONTAWESOME_JSON_EXPORT_TO_ROUTE', 'fontawesome-icons'),
    'icons-route-index' => env('FONTAWESOME_ROUTE_INDEX', 'fontawesome-index'),

];

用法

使用 Fontawesome 的免费版本

此包已包含免费版本。要生成文件，只需在终端运行以下命令

    php artisan fontawesome:parse

这将为每个家族生成包含图标的单独文件。例如，免费版本将生成三个单独的文件：regular、brands 和 solid。

根据配置文件，生成的文件将放置在您的存储文件夹中，在配置中指定的文件夹内。

请注意，使用的存储磁盘是

    Storage::disk('local')

使用 Fontawesome 的专业版

如果您有专业版，只需将 icons.json 文件放入配置文件中指定的存储文件夹内（json 加载路由）。如果存在，Artisan 命令将采用专业版。

许可证

MIT 许可证 (MIT)。有关更多信息，请参阅许可证文件。