Moetwemoji: 軽量アニメーション絵文字 (AVIF) - フォーラムを活性化させよう

OK、手動インストールをお試しください

手動インストールガイド(上書きバージョン)

このガイドでは、実行中のDiscourseコンテナ内に discourse-moetwemoji-twemoji-fakepng-override プラグインを手動でインストールおよび適用する方法を説明し、完全な再構築が厳密には必要ない理由を明確にします。


1. Discourseコンテナに入る

サーバーで、Discourse Dockerディレクトリ(通常は /var/discourse)に移動し、実行中のコンテナに入ります。

cd /var/discourse
./launcher enter app

これでコンテナシェル内にいるはずです。


2. オーバーライドプラグインを手動でクローンする

プラグインディレクトリに移動し、リポジトリをクローンします。

cd /var/www/discourse/plugins
git clone https://github.com/constansino/discourse-moetwemoji-twemoji-fakepng-override.git

ディレクトリが存在することを確認します。

ls discourse-moetwemoji-twemoji-fakepng-override


3. 絵文字の上書きを適用する

Discourseのルートディレクトリに戻ります。

su - discourse
cd /var/www/discourse

現在のステータスを確認します(オプションですが推奨されます)。

RAILS_ENV=production bundle exec rake moetwemoji_twemoji:status

上書きを適用します。

RAILS_ENV=production bundle exec rake moetwemoji_twemoji:apply

コマンドがエラーなしで終了した場合、Twemoji PNGファイルはMoetwemojiに置き換えられました。


4. 再構築に関する重要な注意点(永続性)

:red_exclamation_mark: オーバーライドを機能させるために再構築は不要

この上書きバージョンは、実行中のコンテナ内のファイルを直接置き換えることで機能します。
したがって:

  • :white_check_mark: ./launcher rebuild app を実行する必要はありません

  • :white_check_mark: rakeタスクの実行後、変更は即座に反映されます

:warning: ただし、変更は永続的ではありません

これはコンテナファイルシステム内で行われるため:

  • 今後の ./launcher rebuild app

  • またはコンテナの再作成/アップグレード

変更を消去し、絵文字の上書きは失われます。

:backhand_index_pointing_right: 再構築をまたいで永続性が必要な場合は、app.yml のフックを介してプラグインをインストールし、適切に再構築する必要があります。


5. CDNとブラウザキャッシュのクリア(非常に重要)

上書きを適用した後も、キャッシュのために絵文字が変更されていないように見えることがあります。

5.1 CDNキャッシュのクリア(例:Cloudflare)

CloudflareなどのCDNを使用している場合:

  • 次のキャッシュをパージします。

    • /images/emoji/*

    • または必要に応じて完全なキャッシュパージを実行します

そうしないと、古いTwemoji PNGファイルが引き続き提供される可能性があります。

5.2 ブラウザキャッシュのクリア

クライアント側では:

  • ページのハードリフレッシュ(Ctrl + F5 / Cmd + Shift + R

  • またはブラウザキャッシュのクリア

  • またはシークレット/プライベートウィンドウでのテスト

CDNキャッシュとブラウザキャッシュの両方がクリアされるまで、絵文字の変更が表示されない場合があります。


6. 要約

  • このオーバーライドプラグインは再構築なしでインストールおよび適用できます

  • 手動インストールは次の場合に役立ちます。

    • テスト

    • 一時的な使用

    • デバッグ

  • 欠点は永続性の欠如です

  • 絵文字の上書きを適用した後には、必ずCDNキャッシュ + ブラウザキャッシュをクリアしてください