innovato/font-awesome-5-lite

这是一个PHP库,用于生成Font Awesome 5(Pro和Free)SVG JS文件并将它们存储在缓存中。

0.2 2018-03-23 09:36 UTC

This package is not auto-updated.

Last update: 2024-09-29 05:14:53 UTC


README

这个PHP库可以生成Font Awesome 5(Pro和Free)SVG JS文件并将它们存储在缓存中。它只生成你需要的图标!这对于不希望使用第三方CDN或WebPack的人来说非常有用。

由于可能存在版权侵权问题,您需要自行下载最新的Font Awesome并将其添加到files/fa_source文件夹中。

快速开始

提供多种快速开始选项

  • 下载最新版本。
  • 克隆仓库:git clone https://github.com/innovato/font-awesome-5-lite.git
  • 使用 composer 安装:composer require innovato/font-awesome-5-lite

获取Font Awesome 5源文件(必需)

从官方网站(https://fontawesome.com/)获取Font Awesome 5源文件。您可以选择使用免费版或专业版。它们都与这个库兼容。

下载后,需要将Font Awesome svg-with-js/js文件夹的内容放置到files/fa_source目录中(或者使用您自己的资源目录)。

如果您选择使用自己的资源目录,请确保有一个名为"fa_source"的子目录包含SVG JS文件,并确保名称兼容。

基本用法

使用默认设置

<?php

include '../src/falite.php';

$faLite = new Innovato\FaLite();

$faLite->execute($_GET['icons']);

使用所有选项

<?php

include '../src/falite.php';

$faLite = new Innovato\FaLite();

$faLite->cacheEnabled = true; // Default true
$faLite->cacheDirectory = '../files/cache';
$faLite->filesDirectory = '../files';
$faLite->types = [
    'fab' => 'fa-brands',
    'fal' => 'fa-light',
    'far' => 'fa-regular',
    'fas' => 'fa-solid'
];
$faLite->execute($_GET['icons']);

Web服务器配置示例(可选)

您可以使用Nginx的rewrite创建一个规则,使其看起来像是一个合法的JS文件。例如

server {
    ...
    
    rewrite ^/font-awesome-lite\.js$  /examples/example_minimal.php;
    
    ...
}

或者使用Apache的mod_rewrite方法

<IfModule mod_rewrite.c>
  RewriteEngine on
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule ^example_minimal\.php$ /font-awesome-lite.js?&%{QUERY_STRING}
</IfModule>

在模板中添加Font Awesome Lite

将生成器URL添加到您的HTML中(当然使用您自己的URL和路径)

<script src="https://yourwebsite.com/assets/font-awesome-lite.js?icons=fab innovato, fas arrow-left"></script>

选项

致谢

非常感谢 Font Awesome 提供的优秀的SVG图标!

版权和许可

代码和文档版权所有 2018 Innovato。代码在 MIT 许可证 下发布。