README

MediaWiki的FontAwesome 扩展提供了解析器函数，可以将Font Awesome Free 图标插入到维基文本中。

目前包含Font Awesome Free，版本6.2.1。

要求

PHP 7.4.3或更高版本
MediaWiki 1.35或更高版本

安装

使用Composer

使用Composer是安装此扩展的推荐方式。

从MediaWiki安装目录运行以下命令

COMPOSER=composer.local.json php composer.phar require --no-update mediawiki/font-awesome ^2.0
php composer.phar update --no-dev mediawiki/font-awesome

要更新扩展，请再次运行最后一个命令。

使用GitHub下载

从GitHub下载tar包或zip文件
将其提取到您的MediaWiki安装的extensions目录中
将文件夹重命名为FontAwesome-...

要更新扩展，请完全删除FontAwesome文件夹并重新安装。

激活

将以下行添加到您的LocalSettings.php

wfLoadExtension( 'FontAwesome' );

配置

FontAwesome图标有两种渲染模式可供选择

带有CSS的Web字体：此实现使用Web字体作为文件格式，并依赖于浏览器将其作为任何自定义字体一样渲染图标。
带有JavaScript的SVG：此实现使用JavaScript编码图标数据和显示图标机制的浏览器执行代码。

可以通过在LocalSettings.php中设置变量$wgFaRenderMode来选择渲染模式。允许的值是：webfonts（默认）和javascript。

示例： $wgFaRenderMode = 'javascript';

关于渲染模式的优缺点，请参阅fontawesome.com上的性能 & Font Awesome。

使用

此扩展定义了三个解析器函数

{{#far:...}} 用于插入FontAwesome Regular字体中的图标
{{#fas:...}} 用于插入FontAwesome Solid字体中的图标
{{#fab:...}} 用于插入FontAwesome Brands字体中的图标

示例： {{#fab:wikipedia-w}} 将插入Wikipedia-W图标

有关有效图标名称，请参阅https://fontawesome.com/v6/search。

专业支持

FontAwesome扩展由Professional Wiki维护。您可以联系我们以获得安装或自定义FontAwesome的帮助。我们还进行开发工作。

许可证

GNU通用公共许可证，版本3或更高版本。

Font Awesome Free扩展包包含在扩展中。请参阅其许可文件以获取详细信息。

发行说明

版本 2.0.0

发布于2023年1月27日。

将最低PHP版本从7.0提升至7.4.3。
将最低MediaWiki版本从1.31提升至1.35。
更新到FontAwesome 6。

版本 1.1.0

发布于2023年1月25日。

更新FontAwesome到5.15.4。

版本 1.0.0

发布于2019年10月20日。

初始版本

mediawiki / font-awesome

维护者

详细信息