Identifier ce que WordPress semble ignorer
Vous modifiez theme.json et la palette reste identique, une option manque dans l’éditeur ou les liens conservent leur ancienne couleur. Ces symptômes correspondent à des contrôles différents. Le fichier peut manquer dans la livraison, utiliser une propriété incompatible ou fournir une valeur par défaut qu’une personnalisation remplace. Un style peut également être produit par WordPress et perdre face à une autre règle dans le navigateur.
Ce guide concerne une installation autohébergée sur laquelle vous pouvez examiner le thème actif et préparer une copie de travail. Un thème de blocs offre généralement l’écran Styles dans l’Éditeur de site. Le cœur utilise aussi theme.json dans certains thèmes classiques, mais leurs écrans et leur façon d’afficher les styles varient. Si vous ne gérez que le contenu, relevez le nom du thème et les éléments observés avant de demander une correction des fichiers.
Le résultat attendu doit être observable. Choisissez une option précise à retrouver dans l’éditeur ou un élément précis dont le style doit changer. Traitez ce cas avant de réviser toute la configuration. Cela permet de savoir quel changement a produit l’effet.
Comparer la même page avant et après la mise à jour
Lorsque la colonne de lecture se resserre après une mise à jour, prenez une page où la différence se voit et une seconde qui utilise un autre modèle. Pour la première, notez le thème actif et sa version, le modèle associé et le bloc qui paraît trop étroit. Capturez le rendu public à une largeur de fenêtre donnée. Prenez les mesures au même endroit sur les deux versions, par exemple sur le paragraphe d’introduction et sur le bloc Contenu qui l’enveloppe. Une mesure de la seule fenêtre ne vous dit pas combien d’espace le texte reçoit.
Pour retrouver un état antérieur, utilisez une copie sauvegardée avec ses fichiers et sa base correspondante. Une copie de l’ancien dossier du thème permet de comparer les fichiers livrés. Pour reproduire l’apparence passée, elle doit s’accompagner de l’état des modèles personnalisés, des styles et des extensions du moment. Si vous avez seulement l’ancienne version du thème, vous pouvez établir quelle valeur le fournisseur a changée et mesurer cette version sur copie. Notez que les réglages enregistrés sur cette copie sont ceux dont vous disposez aujourd’hui.
Sur chaque version, chargez la même URL en session anonyme. Dans le navigateur, utilisez le même zoom et la même largeur de zone d’affichage. La barre latérale de l’éditeur et l’ouverture des outils de développement peuvent réduire cette zone. Passez les outils en panneau séparé ou utilisez la vue adaptative avec une largeur fixée. Relevez aussi une largeur mobile. Sur un écran de 390 pixels, deux réglages de largeur maximale de 640 et 720 pixels peuvent produire le même rendu à cause de la place disponible et des marges.
Vérifiez le reste de la page. Si l’en-tête et le pied occupent toujours la même largeur tandis que le texte se resserre, relevez l’endroit où les bords commencent à diverger. Si la page témoin et la page de comparaison se resserrent exactement dans le même bloc, remontez à leur conteneur commun ou aux styles globaux. Ce relevé vous donne une mesure et une portée à vérifier après chaque essai.
Construire un témoin dans l’éditeur et sur la page publique
Sur une copie privée représentative, repérez une page qui contient le bloc concerné. Notez la version de WordPress, l’éventuelle extension Gutenberg déjà active et le thème. Comparez l’éditeur utilisé par le problème avec la page publique. Un réglage d’interface et une déclaration CSS ne produisent pas le même résultat. Par exemple, masquer la couleur personnalisée dans le sélecteur peut laisser en place une couleur enregistrée dans un ancien bloc.
Pour un problème d’apparence, ajoutez sur la copie un bloc témoin de même type, sans couleur ni style choisi manuellement. Gardez l’ancien bloc comme comparaison. Cette lecture permet de distinguer les valeurs par défaut des attributs déjà enregistrés dans le contenu. N’utilisez pas un bloc d’un autre type pour conclure qu’une règle ciblée fonctionne partout.
- Notez le nom du réglage attendu et le type du bloc ou de l’élément visé.
- Relevez la valeur actuelle dans l’éditeur et le rendu de la page témoin.
- Conservez un exemplaire de la configuration active et des personnalisations de la copie.
- Prévoyez une seule modification par essai, avec une façon de rétablir l’état initial.
Ouvrir le fichier du thème réellement actif
Dans Apparence puis Thèmes, identifiez le thème actif pour le site concerné. Sur un multisite, faites cette lecture dans le tableau de bord du bon sous-site. Retrouvez son dossier dans le gestionnaire de fichiers ou le dépôt utilisé pour le déploiement. Le fichier attendu se nomme theme.json à la racine du thème, généralement sous wp-content/themes/nom-du-theme/. Un fichier placé sous templates ou dans le dossier d’une autre copie n’est pas le fichier racine du thème actif.
Pour un thème enfant, inspectez aussi le fichier du parent. Comparez la même propriété dans les deux fichiers. Le thème enfant peut apporter une valeur qui l’emporte sur celle du parent. Si vous déployez depuis une archive, ouvrez le fichier présent après livraison et comparez-le à celui que vous avez modifié. Une copie préparée localement peut être correcte sans avoir été publiée sur l’environnement que vous observez.
Ne corrigez pas le parent tiers en place. Quand le thème appartient à l’équipe, travaillez dans ses sources et déployez par son mécanisme habituel. Quand il vient d’un éditeur, privilégiez le fichier enfant maintenu ou le correctif officiel adapté.
Corriger la syntaxe avant de chercher une surcharge
Ouvrez le fichier de la copie dans un éditeur qui signale les erreurs JSON. Cherchez en priorité une virgule manquante entre deux propriétés, une virgule après la dernière entrée, des guillemets simples ou un commentaire ajouté dans le fichier. Vérifiez aussi que les objets et les tableaux sont correctement fermés. Le fichier doit rester du JSON ordinaire, même si votre éditeur accepte un format plus permissif dans ses propres fichiers.
Lisez la structure depuis la racine. Une clé qui apparaît deux fois au même niveau rend le résultat ambigu pour les outils qui lisent le fichier. Fusionnez les deux parties sous une clé unique. Évitez également d’ajouter une deuxième section settings pour reprendre un exemple trouvé ailleurs. Les autres valeurs du thème doivent rester dans l’objet déjà présent.
- Corrigez la première erreur signalée par l’analyseur et relisez le fichier en entier.
- Comparez la différence avec l’original pour vérifier qu’aucune section n’a disparu.
- Enregistrez dans la copie et vérifiez le témoin avant de modifier une autre valeur.
- Si la correction touche trop de lignes, repartez du fichier sauvegardé et reportez seulement le changement voulu.
Choisir le schéma qui correspond au WordPress cible
Un document peut être du JSON valide et contenir un chemin que WordPress ne connaît pas. Vérifiez la propriété dans la référence de la version du site et dans le schéma correspondant. Pour un thème distribué sur plusieurs versions, prenez aussi en compte la plus ancienne version prise en charge. Le schéma de développement peut déjà proposer une propriété absente d’un cœur installé sans Gutenberg.
La clé version indique le format des données. La version 3 a été introduite dans WordPress 6.6. Un fichier plus ancien peut continuer à fonctionner sur un cœur récent. Ne remplacez pas 2 par 3 pour débloquer une option sans lire les changements de format. Lorsqu’une migration est utile, préparez-la et contrôlez les différences de comportement sur la copie avant de l’inclure dans une livraison.
La clé $schema aide un éditeur compatible à proposer les bons types et noms. Elle ne donne aucune fonction supplémentaire au WordPress qui lit le fichier. Si la propriété souhaitée n’est disponible que sur une version plus récente, choisissez un réglage compatible avec l’installation ou préparez une mise à jour séparée. Vérifiez d’abord la compatibilité du thème et du reste du site.
Placer une option d’interface dans settings
L’exemple cible un thème dont le fichier utilise déjà la version 3. Il montre comment interdire le choix d’une couleur arbitraire dans les sélecteurs qui prennent en charge ce réglage. Le test est pertinent si cette option est visible au départ sur le bloc témoin. Contrôlez le sélecteur dans l’éditeur après avoir rechargé la page. Les couleurs prédéfinies et celles déjà enregistrées dans le contenu suivent leurs propres règles.
Reportez uniquement la clé custom sous settings.color dans le fichier existant. Conservez la palette et les autres propriétés. La valeur false est un booléen JSON et s’écrit sans guillemets. L’adresse de schéma sert ici d’exemple pour WordPress 6.6. Si votre projet cible une autre version, adaptez-la à sa référence.
Si la propriété existe déjà au niveau global, cherchez une valeur propre au bloc sous settings.blocks. Cette valeur peut expliquer pourquoi le contrôle reste disponible pour un seul type de bloc. Décidez si le changement doit être général ou limité à ce bloc. Réglez seulement ce périmètre, puis vérifiez également un bloc voisin qui devrait conserver son interface.
{
"$schema": "https://schemas.wp.org/wp/6.6/theme.json",
"version": 3,
"settings": {
"color": {
"custom": false
}
}
}Définir le style par défaut du bon élément
Lorsque le but est de changer la couleur des liens, placez la valeur dans styles. Le fragment suivant fixe une couleur de texte pour l’élément lien. Il convient à un témoin qui contient un lien ordinaire sans style local. Il ne vise pas le fond d’un bloc Bouton ni la couleur appliquée uniquement au survol. Choisissez une couleur qui reste lisible sur le fond du thème.
Dans le fichier existant, reportez seulement la propriété de texte sous styles.elements.link.color. Conservez les propriétés déjà définies pour les liens et les autres éléments. Après le déploiement sur la copie, inspectez le lien témoin et vérifiez la valeur calculée. Si un lien dans un autre bloc conserve une autre couleur, examinez la portée de ce bloc et ses attributs avant d’élargir la règle globale.
Si la valeur est générée et perd face à un sélecteur plus spécifique, modifier plusieurs fois le code de couleur ne résoudra pas le conflit. Identifiez la règle gagnante dans le navigateur et choisissez ensuite où doit vivre la valeur. Retirez la modification d’essai en restaurant la propriété d’origine.
{
"version": 3,
"styles": {
"elements": {
"link": {
"color": {
"text": "#24536e"
}
}
}
}
}Examiner les Styles enregistrés pour le thème actif
Pour un thème de blocs, ouvrez Apparence puis Éditeur et entrez dans Styles. Inspectez la zone liée au symptôme. Pour les liens, ouvrez Couleurs puis l’élément correspondant. Pour un seul type de bloc, examinez aussi ses réglages dans la partie Blocs de Styles. Une valeur enregistrée à ce niveau peut prendre le dessus sur le fichier du thème. Relever la valeur affichée et son périmètre évite de réinitialiser des personnalisations utiles pour une seule différence.
Sur la copie, modifiez ou rétablissez la seule propriété en cause si l’écran le permet. Vérifiez aussi la présence d’un style appliqué au bloc depuis l’éditeur de la page. Un réglage global ne retire pas automatiquement ce que l’auteur a choisi dans le bloc. Si vous ne pouvez pas rétablir seulement la propriété, utilisez une copie disposant d’un état de référence ou une révision appropriée pour faire la comparaison.
- Relevez les choix existants dans Styles et dans le bloc témoin.
- Comparez la propriété dans la configuration du thème et dans l’interface.
- Décidez laquelle doit rester la référence pour le site.
- Vérifiez le témoin et un autre bloc après l’ajustement, puis remettez la valeur enregistrée si le résultat régresse.
Vérifier une variation de styles après sélection
Un thème peut proposer des variations sous forme de fichiers JSON dans son dossier styles. Dans l’Éditeur de site, l’utilisateur peut choisir une de ces variantes puis sauvegarder les Styles du site. La configuration effectivement utilisée peut donc inclure des choix issus d’une variation sélectionnée auparavant. Une simple modification du fichier qui propose cette variation ne remplace pas forcément les choix déjà enregistrés pour le thème.
Si l’écart concerne une installation qui utilise une variation, retrouvez le fichier qui propose celle-ci et comparez la même propriété dans le fichier racine, dans la variation et à l’écran Styles. Lisez aussi les surcharges du thème enfant si celui-ci est actif. La couleur qu’un site présente peut être intentionnelle même si la nouvelle valeur du fichier racine est valide.
Sur la copie, prévisualisez ou sélectionnez la variation adaptée, puis vérifiez les changements avant de sauvegarder. Ce choix peut modifier plusieurs styles à la fois. Si seul un réglage doit changer, modifiez-le à son niveau. Pour une comparaison temporaire, notez la variation d’origine et revenez à la version sauvegardée des Styles dès que vous avez identifié la source.
Suivre la règle CSS qui détermine la valeur finale
Ouvrez la page témoin et inspectez l’élément concerné dans les outils du navigateur. Consultez la propriété calculée, par exemple color pour le texte d’un lien. Revenez ensuite à la déclaration active et relevez son sélecteur et son origine. L’outil peut aussi montrer les déclarations qui s’appliqueraient mais perdent face à une autre. Cela distingue un style absent d’un style présent dont la priorité est insuffisante.
Si la règle du thème est absente, vérifiez la propriété et le niveau concernés, puis comparez avec un bloc sans personnalisation. Si elle est présente, identifiez le fichier, le style local ou le CSS supplémentaire qui l’emporte. Ajustez la source qui porte réellement la décision. Évitez d’ajouter une suite de règles !important, qui rendrait ensuite le réglage plus difficile à comprendre et à surcharger.
Un navigateur peut aussi recevoir une ancienne page ou d’anciennes ressources. Si la copie montre le changement et que le site public reçoit encore la version précédente, confirmez d’abord le fichier livré et la date de la réponse. Ensuite seulement, traitez le cache qui sert la version ancienne en visant l’URL touchée.
Retrouver le modèle chargé et son conteneur
Ce parcours concerne les thèmes de blocs. Dans la barre latérale de l’éditeur de page, relevez le modèle affiché sous les réglages de la page. Ouvrez ensuite Apparence → Éditeur → Modèles avec un compte qui peut modifier le site. Dans le modèle concerné, utilisez la Vue en liste pour trouver le bloc Contenu et remonter jusqu’à son groupe parent. Notez les blocs qui encadrent le contenu, leur réglage de mise en page, leurs alignements et les éventuelles largeurs fixées. Une colonne, un groupe contraint ou un bloc Contenu contraint peuvent intervenir à des étages différents.
Un modèle livré par le thème dans templates/page.html peut coexister avec une version personnalisée que WordPress a enregistrée en base. Une version enregistrée correspondant au modèle recherché a priorité sur le fichier. Comparez donc la structure du modèle affiché à celle du fichier de la version active. Pour lire les blocs d’un modèle personnalisé, ouvrez le menu de l’éditeur et son éditeur de code sur la copie. Relevez la présence du groupe ou le réglage qui diffère. L’indication d’un modèle personnalisé, quand elle est disponible, aide à chercher au bon endroit. Si le thème est classique, demandez au responsable d’identifier le modèle PHP et ses conteneurs. Le parcours Apparence → Éditeur → Modèles concerne l’éditeur de site des thèmes de blocs.
Sur la copie, si la différence appartient au groupe qui contient le texte, modifiez uniquement son réglage dans le modèle. Vous pouvez aussi attribuer un modèle distinct à une seule page lorsque l’exception lui est propre. Dans le récapitulatif d’enregistrement, vérifiez que vous enregistrez le modèle prévu et examinez le nombre de pages qui l’utilisent. Rechargez la page témoin, une autre page du même modèle et une page qui en utilise un autre. Le résultat attendu est que la largeur change dans le groupe visé et dans le périmètre de ce modèle. Pour revenir en arrière, rétablissez la valeur ou le modèle assigné que vous avez relevé. La réinitialisation d’un modèle personnalisé efface ses personnalisations. Gardez sa structure avant de l’essayer sur copie.
Comparer le réglage global au défaut de theme.json
Ce parcours convient si plusieurs contenus héritent de la même largeur. Avec les droits sur l’éditeur de site, ouvrez Apparence → Éditeur → Styles → Mise en page. Relevez la largeur de contenu et la largeur étendue si le thème expose ces champs. Comparez avec settings.layout.contentSize et settings.layout.wideSize dans le fichier theme.json actif. Si un thème enfant est actif, vérifiez les deux fichiers et les styles enregistrés pour le thème réellement utilisé. Une variation de styles choisie dans l’éditeur peut aussi avoir contribué aux valeurs enregistrées.
La largeur de contenu s’applique aux enfants ordinaires d’une mise en page contrainte. La largeur étendue concerne les blocs qui disposent de cet alignement et l’utilisent dans ce contexte. Élargir la largeur étendue ne rendra donc pas nécessairement plus large le paragraphe qui vous sert de témoin. Le navigateur peut révéler la valeur globale active en affichant la propriété personnalisée --wp--style--global--content-size sur le bloc ou l’un de ses ancêtres. Vérifiez d’abord qu’une règle du conteneur utilise cette variable. Dans un modèle où un groupe impose sa propre largeur, la variable globale peut garder la valeur attendue sans gouverner la largeur mesurée.
Si le changement de défaut du thème est la cause et que la politique du site prévoit une même colonne pour plusieurs modèles, testez une valeur globale dans l’éditeur sur la copie. Notez la valeur précédente, changez uniquement la largeur de contenu et enregistrez les Styles. Les pages qui utilisent ce réglage doivent retrouver la largeur visée tant que leur conteneur laisse assez de place. Contrôlez aussi une liste d’articles, un bloc aligné en largeur étendue et la lecture sur mobile. Pour annuler, remettez le champ à sa valeur précédente ou choisissez une révision de Styles après avoir vérifié les autres réglages concernés. Un retour global peut également toucher la typographie ou les couleurs enregistrées au même moment.
Confirmer la déclaration CSS qui gagne sur la page publique
Si le conteneur possède la largeur attendue et que seul un bloc se resserre, ouvrez la page publique et inspectez le bloc dans les outils de développement du navigateur. Dans Calculé ou Computed, filtrez d’abord max-width, max-inline-size et width. Regardez aussi le schéma de boîte pour séparer le contenu, le remplissage et les marges. Une propriété affichée à none sur le paragraphe peut coexister avec une largeur de 540 pixels si le bloc parent est lui-même limité. Remontez au parent puis au groupe jusqu’à trouver le premier élément dont la largeur explique la mesure.
Dépliez la propriété calculée ou suivez-la dans Styles pour retrouver le sélecteur et sa source. Relevez le nom de la feuille, l’éventuelle condition de largeur d’écran et le bloc auquel la règle s’applique. Une règle générée pour un conteneur contraint peut se trouver dans une balise de style du document. Une déclaration provenant de style.css, du CSS additionnel ou d’une extension peut viser le bloc lui-même. Si un fichier concaténé ne révèle pas immédiatement l’origine, comparez sur copie sans l’optimisation des feuilles ou recherchez le sélecteur dans les sources autorisées.
Décochez temporairement la déclaration gagnante dans Styles et reprenez les deux mesures. Si le texte retrouve la largeur du bloc Contenu alors que ce dernier ne bouge pas, vous avez isolé la règle qui le rétrécissait. Si les deux largeurs restent identiques, cherchez la contrainte suivante, par exemple une colonne de grille ou la taille imposée par un parent flexible. Ces essais dans les outils de développement sont propres à l’onglet et se perdent au rechargement.
Corrigez ensuite la déclaration à sa source sur la copie. Pour une règle ajoutée au site, modifiez le sélecteur qui vise la mauvaise zone ou supprimez la contrainte devenue inutile. Pour une règle du thème fournisseur, conservez le fichier livré et préparez, si nécessaire, une correction maintenable dans un thème enfant ou dans le CSS additionnel prévu par le site. Limitez le sélecteur aux éléments pour lesquels la mesure a changé. Vérifiez la déclaration active après rechargement, ainsi qu’une page hors du périmètre visé. Pour annuler, rétablissez la ligne consignée ou retirez la correction ciblée, puis refaites les mêmes mesures.
Refaire les mesures avec un témoin à une variable par étape
Voici une recette proposée pour distinguer trois niveaux de contrainte sur une copie ; les valeurs suivantes sont pédagogiques et ne constituent pas des mesures de votre site. Avec une fenêtre suffisamment large, fixez d’abord la largeur globale de contenu à 720 pixels et relevez le conteneur puis le texte. Changez uniquement ce défaut à 640 pixels et comparez. Rétablissez ensuite le défaut, puis essayez séparément une largeur du conteneur et une limite du paragraphe. Après chaque étape, remettez la valeur initiale avant le contrôle suivant.
Une valeur globale modifiée sans changement du texte peut indiquer un conteneur plus étroit. Un paragraphe avec max-width: none reste limité par son parent ; inversement, une règle appliquée au seul paragraphe peut le rendre plus étroit sans modifier ce parent. Vérifiez ces hypothèses avec les valeurs calculées plutôt qu’en attribuant d’avance chaque mesure à theme.json. Reprenez le même contrôle sur mobile, où la largeur disponible peut masquer la différence entre deux maximums.
Pour comparer votre propre page, gardez un relevé aussi simple. Commencez par la version active et consignez trois valeurs pour chaque essai. Relevez la variable globale, la largeur du bloc qui enveloppe le contenu et la largeur du texte. Ajoutez le nom du modèle. Testez ensuite une seule intervention, rechargez, puis reprenez ces mesures. Un changement de variable sans mouvement du conteneur vous oriente vers le modèle ou un autre parent. Un parent stable avec un enfant qui change vous oriente vers une règle visant l’enfant. Un changement simultané de tous les niveaux demande de reprendre la comparaison avec un seul réglage modifié.
Avant de reproduire la correction sur le site actif, comparez sur la copie deux pages qui partagent le modèle et une page hors périmètre. Contrôlez la largeur de lecture sur ordinateur et l’absence de défilement horizontal sur téléphone. Après l’enregistrement, rechargez la page publique anonyme et vérifiez la valeur calculée et la source de la règle. Notez la version du thème, le modèle, la mesure et le réglage exact à rétablir. Cette trace vous permettra de vérifier la même zone après la prochaine mise à jour.
Vérifier la correction et garder un retour ciblé
La réparation est établie lorsque le témoin montre l’option ou le style attendu et que la cause identifiée explique la différence. Pour un réglage, contrôlez le sélecteur avec le profil et le type de bloc concernés. Pour un style, vérifiez la valeur calculée et le résultat visuel. Faites un essai sur une seconde page qui réutilise la même règle, puis vérifiez au moins un bloc qui devait conserver ses choix.
Un changement de fichier se retire en restaurant la version précédente du fichier concerné. Une personnalisation faite dans Styles se retire en rétablissant les valeurs notées ou, si l’écran et l’historique le permettent, en revenant à la révision pertinente. Regardez ce que cette révision change avant de l’appliquer. Restaurer les fichiers du thème ne rétablit pas à lui seul ce qui a été enregistré dans la base.
- Refaites le même relevé qu’au départ, dans l’éditeur et sur la page si les deux sont concernés.
- Comparez les pages voisines et les états utiles, comme le survol pour une couleur de lien.
- Si une personnalisation voulue disparaît, restaurez sa valeur et réduisez le périmètre du changement.
- Conservez la différence finale et le nom du fichier effectivement livré.
Documenter où chaque décision de style doit être modifiée
Décidez avec l’équipe quels réglages appartiennent au thème et lesquels restent à la main des personnes qui gèrent le site. Une valeur répétée dans le parent, l’enfant, la variation et Styles peut rester cohérente aujourd’hui, puis diverger à la prochaine livraison. Indiquez dans le dossier du thème le niveau à modifier pour le réglage corrigé et la version de WordPress sur laquelle il est prévu.
Gardez un exemple de bloc témoin pour les couleurs, espacements ou options qui structurent le design. Au prochain changement, comparez d’abord ce témoin avec le rendu précédent. Si le thème doit fonctionner sur plusieurs versions du cœur, vérifiez l’option sur la plus ancienne version annoncée et sur la version de déploiement. Le fait que l’éditeur de code reconnaisse une propriété ne suffit pas à couvrir les deux environnements.
Le fichier, l’Éditeur de site et l’inspecteur du navigateur suffisent à cette démarche. Les fonctions décrites font partie de WordPress et n’exigent aucun achat supplémentaire. Si vous devez transmettre le problème, joignez le chemin de la propriété, le fichier chargé, le type de bloc, la valeur calculée et la version du site. Ces éléments orientent la correction vers la bonne couche.
Repérer les clés JSON dupliquées avant la livraison
Un analyseur JSON ordinaire peut accepter deux clés identiques et conserver la dernière sans avertissement. Ce contrôle Python local refuse explicitement ce cas dans une copie du fichier theme.json, située dans le dossier courant. Il ne charge pas WordPress et ne modifie aucun fichier.
Une erreur de syntaxe indique la position à examiner ; une clé répétée doit être fusionnée dans l’objet existant, en conservant ses autres propriétés. Par exemple, deux objets settings à la racine peuvent faire disparaître une palette si l’un remplace l’autre lors de la lecture. Ne supprimez pas simplement le second sans comparer les valeurs qu’il apporte.
Un succès de ce script ne valide ni le schéma WordPress, ni la compatibilité d’une propriété, ni les styles enregistrés en base. Poursuivez avec le schéma correspondant au cœur cible, puis le bloc témoin et la valeur calculée dans le navigateur. Le parcours sans terminal reste un éditeur qui signale les doublons et le schéma. Pour annuler l’essai, restaurez la copie précédente du seul fichier ; les personnalisations de Styles demandent leur propre retour.
import json
from pathlib import Path
def objet_sans_doublon(paires):
resultat = {}
for cle, valeur in paires:
if cle in resultat:
raise ValueError('Clé JSON dupliquée : ' + cle)
resultat[cle] = valeur
return resultat
def constante_interdite(valeur):
raise ValueError('Constante hors JSON : ' + valeur)
texte = Path('theme.json').read_text(encoding='utf-8-sig')
donnees = json.loads(texte, object_pairs_hook=objet_sans_doublon,
parse_constant=constante_interdite)
if not isinstance(donnees, dict):
raise ValueError('La racine doit être un objet JSON.')
print('Syntaxe JSON et unicité des clés contrôlées.')Sources et références
Ces références permettent de vérifier les fonctions, les prérequis et les limites décrits. Une documentation consultée ne constitue pas un essai pratique.
Consulter les 13 références
- Guide de theme.json ↗
- Configuration globale et priorités ↗
- Référence de la version 3 ↗
- Thèmes enfants ↗
- Écran Styles ↗
- Variations de styles ↗
- Lecture des réglages fusionnés ↗
- WordPress — réglages contentSize et wideSize ↗
- WordPress — priorité des modèles de blocs ↗
- WordPress — modifier et réinitialiser un modèle ↗
- Chrome DevTools — propriétés calculées et cascade ↗
- Documentation officielle : docs.python.org ↗
- Documentation officielle : developer.wordpress.org ↗





