Skip to content

Structure des fichiers

Jason Rouet edited this page Sep 23, 2026 · 13 revisions

Depuis la migration vers WXT, le code n’est plus dans quelques fichiers à plat, mais organisé en dossiers dédiés.

Les points d’entrée de l’extension, ceux que WXT assemble pour générer le manifest et les scripts finaux.

  • spte.content.js — le script de contenu, injecté sur translate.wordpress.org, qui déclenche l’analyse typographique et construit l’interface d’SPTE.
  • background.js — active ou désactive l’icône de l’extension selon l’onglet actif (voir Quelles autorisations demande SPTE).
  • popup/ — la popup de réglages (index.html, main.js, style.css).
  • style.css — styles injectés dans la page translate.wordpress.org.

La logique métier, indépendante du DOM du navigateur autant que possible, ce qui permet de la tester sans navigateur.

  • rules.js — les expressions régulières de détection, et les données qu’elles utilisent (mots déconseillés, extensions de fichiers…), anciennement dans un fichier data.js séparé.
  • helpers.js — fonctions utilitaires génériques.
  • dom.js — manipulations DOM spécifiques aux tableaux de GlotPress.
  • settings.js — gestion des réglages utilisateur·ice.
  • warnings.js — construction des messages d’avertissement affichés.
  • fixtures/ — pages HTML de test utilisées par les tests Vitest.

Spécificités des WebExtensions

Contrairement à l’ancien code, il n’y a plus de fichier manifest.json déclarant content_scripts à la main : c’est WXT qui génère le manifest final à partir des entrypoints et de wxt.config.js (voir Le Manifest). L’ordre des imports JavaScript classiques (import ... from ...) dans spte.content.js remplace l’ancien ordre de chargement des scripts.

Clone this wiki locally