Favicon

Le favicon du site est généré une fois, à partir d'une unique image source téléversée, et déployé automatiquement à chaque build. Téléversez-le sous Settings (le contrôle de téléversement du favicon) ; l'application génère toutes les tailles qu'attendent les navigateurs et les applications web installables.

Téléversement

Le contrôle de favicon de Settings accepte les fichiers PNG, JPEG, SVG ou ICO jusqu'à 5 Mo. À l'enregistrement :

• La source est contrôlée pour sa taille (« à peu près carrée » ; un rapport d'aspect dépassant ~1,25:1 au maximum, car réduire un logotype large en une icône produit une lanière inutilisable). Les téléversements non carrés sont rejetés avec un message clair plutôt que déformés.
• Un jeu d'icônes généré est produit : favicon-96x96.png, apple-touch-icon.png (180×180), web-app-manifest-192x192.png, web-app-manifest-512x512.png, un enveloppeur SVG intégrant le rendu 96×96 (favicon.svg), et un favicon.ico (repris tel quel si vous avez téléversé un ICO, sinon dérivé du PNG 96×96).
• Les fichiers atterrissent à deux endroits : le répertoire assets/ (la source de vérité pour le prochain build statique) et public/ (pour que le CMS puisse les servir immédiatement).
• L'enregistrement déclenche un rebuild, et l'action est auditée (« Favicon updated by »).

Les installations fraîches livrent un jeu par défaut (le logo Chinaski), que le téléversement remplace.

Où les favicons apparaissent

Au moment du build, le jeu complet de favicons est copié à la racine du site de la sortie, pas sous un préfixe de langue quelconque, et inclus dans le manifeste de build signé. Le partial standard _head.tt émet alors les balises <link> du favicon pour les sites activés : le PNG du favicon, l'apple-touch-icon, et le raccourci .ico.

Le supprimer

Le contrôle de suppression du favicon dans Settings retire la source téléversée et tous les dérivés des deux répertoires, efface le réglage, et déclenche un rebuild : l'état restauré est celui des valeurs par défaut livrées (ou l'absence de liens <head> de favicon si les valeurs par défaut livrées sont absentes).

Modes de défaillance à connaître

• Le favicon ne fonctionne pas, où chercher ? Le jeu généré vit dans assets/ ; si le build statique se passe ailleurs, une entrée du journal de build vous le dit. Un échec de génération de favicon.svg est consigné comme avertissement (non fatal), le jeu PNG/ICO étant ce que le <head> référence.
• Résidus possédés par root : les fichiers générés et copiés remplacent plutôt qu'ils ne modifient : un favicon parasite possédé par root laissé par une action d'outils de déploiement ne peut pas bloquer l'enregistrement ; le chemin d'écriture exige une accessibilité au niveau du répertoire plutôt qu'une propriété au niveau du fichier.
• Si le processus ne peut pas du tout écrire dans le répertoire des assets, l'erreur flash nomme le répertoire et pointe vers propriété/permissions : c'est cela qu'il faut corriger, pas réessayer.