OK, veuillez essayer l’installation manuelle
Guide d’installation manuelle (Version de substitution)
Ce guide explique comment installer et appliquer manuellement le plugin discourse-moetwemoji-twemoji-fakepng-override à l’intérieur d’un conteneur Discourse en cours d’exécution, et clarifie pourquoi une reconstruction complète n’est pas strictement nécessaire pour la version de substitution.
1. Entrer dans le Conteneur Discourse
Sur votre serveur, accédez au répertoire Docker de Discourse (généralement /var/discourse) et entrez dans le conteneur en cours d’exécution :
cd /var/discourse
./launcher enter app
Vous devriez maintenant être dans le shell du conteneur.
2. Cloner le Plugin de Substitution Manuellement
Accédez au répertoire des plugins et clonez le dépôt :
cd /var/www/discourse/plugins
git clone https://github.com/constansino/discourse-moetwemoji-twemoji-fakepng-override.git
Vérifiez que le répertoire existe :
ls discourse-moetwemoji-twemoji-fakepng-override
3. Appliquer la Substitution d’Emoji
Retournez au répertoire racine de Discourse :
su - discourse
cd /var/www/discourse
Vérifiez l’état actuel (facultatif mais recommandé) :
RAILS_ENV=production bundle exec rake moetwemoji_twemoji:status
Appliquez la substitution :
RAILS_ENV=production bundle exec rake moetwemoji_twemoji:apply
Si la commande se termine sans erreur, les fichiers PNG Twemoji ont été remplacés par Moetwemoji.
4. Notes Importantes Concernant les Reconstructions (Persistance)
Aucune reconstruction n’est nécessaire pour que la substitution fonctionne
Cette version de substitution fonctionne en remplaçant directement les fichiers dans le conteneur en cours d’exécution.
Par conséquent :
Mais le changement N’EST PAS persistant
Parce que cela est fait à l’intérieur du système de fichiers du conteneur :
effacera les changements, et la substitution d’emoji sera perdue.
Si vous avez besoin de persistance à travers les reconstructions, vous devez installer le plugin via les hooks app.yml et reconstruire correctement.
5. Vider le Cache CDN et le Cache du Navigateur (Très Important)
Après avoir appliqué la substitution, les emojis peuvent toujours apparaître inchangés en raison de la mise en cache.
5.1 Vider le Cache CDN (ex: Cloudflare)
Si vous utilisez un CDN tel que Cloudflare :
Sinon, les anciens fichiers PNG Twemoji pourraient toujours être servis.
5.2 Vider le Cache du Navigateur
Du côté client :
-
Actualisation forcée de la page (Ctrl + F5 / Cmd + Shift + R)
-
Ou vider le cache du navigateur
-
Ou tester dans une fenêtre de navigation privée/incognito
Tant que les caches CDN et du navigateur ne sont pas vidés, les changements d’emoji pourraient ne pas être visibles.
6. Résumé
-
Ce plugin de substitution peut être installé et appliqué sans reconstruction
-
L’installation manuelle est utile pour :
-
Les tests
-
L’utilisation temporaire
-
Le débogage
-
L’inconvénient est le manque de persistance
-
Toujours vider le cache CDN + cache du navigateur après avoir appliqué les substitutions d’emoji