Font Awesome によるアイコンを表示するPukiWiki用プラグイン。
Font Awesome 公式サイトにユーザー登録して Kit Code を取得するか、ファイル一式をダウンロードしてあらかじめスキンに組み込んでおく必要があります。
FontAwesome Version 5 向けに実装しているため、互換性にご注意ください。
| 対象PukiWikiバージョン | 対象PHPバージョン |
|---|---|
| PukiWiki 1.5.3 ~ 1.5.4RC (UTF-8) | PHP 7.4 ~ 8.1 |
下記GitHubページからダウンロードした fa.inc.php を PukiWiki の plugin ディレクトリに配置してください。
https://github.com/ikamonster/pukiwiki-fa
&fa(code[,[color][,scale]]){[code2[,color2]]};
- code … アイコンコード。Font Awesomeサイト発行の各アイコンHTML「」の「faX fa-XXXX XXX」部分
- color … 表示色。形式は #RRGGBB, rgba(R,G,B,A), 色名, CSSカスタムプロパティ等（CSSで使える形式）。省略すると文字と同じ色
- scale … 表示倍率。単位は px, %, em, CSSカスタムプロパティ等（CSSで使える単位）。省略時の既定値は 100%
- code2,color2 … アイコンを2つ重ねる場合に使用。両code内に fa-stack-?x 指定が必須。下記の最後の使用例を参照
&fa(far fa-smile);
&fa(fas fa-save fa-2x);
&fa(fa fa-cog fa-fw,#009999);
&fa(fas fa-camera fa-stack-1x){fas fa-ban fa-stack-2x,Tomato};
ソース内の下記の定数で動作を制御することができます。
| 定数名 | 値 | 既定値 | 意味 |
|---|---|---|---|
| PLUGIN_FA_KITCODE | 文字列 | 1 | Font Awesome をロードするための Kit Code （例：'<script src="https://kit.fontawesome.com/xxxxxxxxxx.js" crossorigin="anonymous"></script>'） |
| PLUGIN_FA_STYLE | 文字列 | アイコンに共通して適用するスタイル （例：'.fa,.fab,.fad,.fal,.far,.fas { vertical-align: middle; }'） |