Les erreurs Kumascript apparaîssant sur une page peuvent être très déroutantes pour les lecteurs, à cause des gros vilains encadrés rouges, mais heureusement quiconque ayant un compte MDN peut éditer un document rectifiant de telles erreurs. Lorsqu'une page en contient une, elle est ajoutée à la liste des documents contenant des erreurs. Des rédacteurs viennent consulter cette liste régulièrement pour trouver et corriger des erreurs. Cet article détaille les quatre types d'erreurs Kumascript, et quelques pistes à suivre pour les corriger.
DocumentParsingError
Les erreurs DocumentParsingError
apparaîssent lorsque KumaScript a des difficultés à comprendre quelquechose au document. La raison la plus commune est une erreur de syntaxe dans une macro.
Vérifiez :
- L'utilisation de parenthèses sans l'intention d'appeler une macro.
-
Si vous avez besoin d'écrire un anti-slash-parenthèse { dans un document sans macro-commande vous l'échappez avec un anti-slash \ comme ceci :
\{
- L'utilisation d'un caractère spécial dans un paramètre de commande.
-
Si vous devez utiliser un guillement " ou un anti-slash \ à l'intérieur d'un paramètre de macro, ils peuvent être échappés avec un anti-slash \ comme ceci :
\\
ou\"
- Les virgules manquantes entre des paramètres de commandes.
-
Les paramètres de commandes doivent être séparés par une virgule (,) seulement ; par exemple
{{anch("top", "Back to top")}}
. - Les commandes HTML apparaîssant à l'intérieur d'une macrocommande.
-
Si vous appliquez un style à une macro, cela causera souvent des erreurs, par exemple, une commande
</code>
peut s'insérer et apparaître dans le code source. Vérifiez l'aperçu de la source pour voir ce qu'il en est, et supprimez le superflu.
TemplateLoadingError
Les erreurs TemplateLoadingError
apparaîssent lorsque KumaScript a du mal à trouver quelle macrocommande prendre en compte dans le contenu de la page.
Vérifiez :
Vous pouvez vous rendre sur la page d'exemples de macrocommandes pour en comparer l'orthographe. L'URL de cette page se construit en ajoutant le nom de la commande recherchée à la fin de l'adresse https://developer.mozilla.org/en-US/docs/Template: — par exemple la page gabarit pour
{{anch("top", "Back to top")}}
est https://developer.mozilla.org/en-US/docs/Template:anch.
S'y trouve une liste spécifique des macrocommandes du MDN , qui comprend la commande recherchée si elle existe, ou son orthographe correcte.
- Les noms de commande mal orthographiés et les renommer.
Nota : Vous pouvez accéder rapidement et facilement à une commande spécifique en faisant une recherche de mot-clés sur Firefox. <<<MORE SOON>>
TemplateExecutionError
Les erreurs TemplateExecutionError
apparaîssent lorsque KumaScript rencontre une erreur dans l'exécution de la commande. Ces erreurs ne peuvent être corrigées que par un utilisateur administrateur et doivent être signalées comme des bugs.
Avant de faire un rapport d'erreur vérifiez qu'elle n'a pas déjà été corrigée. Pour ce faire, exigez que KumaScript vous présente une page actualisée en tapant shift pendant le rafraîchissement de la page (Shift + Ctrl + R sur Windows/Linux, Shift + Cmd + R sur Mac).
Si l'erreur persiste, Signalez un bug. Incluez l'URL de la page et le commentaire d'erreur.
Erreur & Non-catégorisable
Ceci est la catégorie d'erreurs en dernier recours si aucune autre ne correspond à son type.
Souvent (mais pas toujours) ces erreurs sont relatives à un problème affectant tous ceux du MDN et peuvent être corrigées en une ou deux minutes ; tapez ensuite sur shift afin de rafraîchir la page (Shift + Ctrl + R sur Windows/Linux, Shift + Cmd + R sur Mac). Si ces erreurs persistent, s'il-vous-plaît, signalez un bug. Incluez l'URL de la page et le commentaire de l'erreur.