---
title: Solucionando problemas de erros de KumaScript
slug: MDN/Tools/KumaScript/Troubleshooting
tags:
  - Erros
  - Ferramentas
  - Guía
  - KumaScript
  - MDN Meta
translation_of: MDN/Tools/KumaScript/Troubleshooting
original_slug: MDN/Tools/KumaScript/Solucionando_problemas_de_erros_de_KumaScript
---
<div>{{MDNSidebar}}</div><div class="summary">
<p>Erros de <a href="/en-US/docs/MDN/Kuma/Introduction_to_KumaScript">KumaScript</a> aparecendo numa página podem ser muito desagradáveis aos leitores, mostrando grandes e medonhas caixas vermelhas, mas felizmente qualquer pessoa com uma conta MDN pode editar um documento e consertar tais tipos de erros. Quando uma página possui algum erro, ela é adicionada na lista de <a href="/docs/with-errors">documentos com erros</a>. Editores do site passam por essa lista regularmente para achar e consertar erros. Este artigo detalha os quatro tipos de erros de KumaScript, e alguns passos que você pode fazer para consertá-los.</p>
</div>

<h2 id="Erro_tipo_DocumentParsingError">Erro tipo <em>DocumentParsingError</em></h2>

<p><code>DocumentParsingError</code> erros aparecem quando o KumaScript tem problemas para entender alguma coisa no próprio documento. A causa mais comum é um erro de sintaxe em alguma <a href="/en-US/docs/MDN/Contribute/Content/Macros">macro</a>.</p>

<p>Verifique:</p>

<dl>
 <dt>Uso de chaves sem a intenção de chamar uma macro.</dt>
 <dd>Se você pretende escrever  \{ num documento sem usar macro, você pode escapar as chaves com uma barra invertida \ da seguinte forma: <code>\\{</code></dd>
 <dt>Uso de caractére especial nos parâmetros de uma macro.</dt>
 <dd>Se você pretende usar aspas duplas " ou barra invertida \ dentro de algum parâmetro para uma macro, eles podem ser escapados através de uma barra invertida \ da seguinte forma: <code>\\</code> or <code>\"</code></dd>
 <dt>Falta de vírgula para separar parâmetros de macro.</dt>
 <dd>Parâmetros de macro precisam ser separados por uma vírgula (,) exceto no último parâmetro (ou se for único); por exemplo <code>\{\{anch("top", "Back to top")}}</code>.</dd>
 <dt>Tags HTML aparecendo dentro de uma chamada de macro</dt>
 <dd>Se você aplicar estilos a uma macro, geralmente não irá funcionar, pois uma tag <code>&lt;/code&gt;</code> pode aparecer dentro do código fonte da macro, causado erros de sintaxe na macro. Verifique a visão de código-fonte para ver o código que foi gerado, e remova qualquer estilo desnecessário.</dd>
</dl>

<ul>
</ul>

<h2 id="Erro_tipo_TemplateLoadingError">Erro tipo <em>TemplateLoadingError</em></h2>

<p><code>TemplateLoadingError</code> erros aparecendo quando um KumaScript tem problemas de encontrar qual <a href="/en-US/docs/MDN/Contribute/Content/Macros">macro</a> incluir numa página.</p>

<p>Verifique:</p>

<dl>
 <dt>Nomes com erro ortográfico ou macros renomeadas.</dt>
 <dd>Você pode ver a lista de macros conhecidas no <a href="https://github.com/mdn/kumascript/tree/master/macros">Repositório do Github</a>.</dd>
</dl>

<div class="note">
<p><strong>Dica:</strong> Você pode tornar mais rápido e fácil avançar para uma macro específica adicionando uma <a href="http://kb.mozillazine.org/Using_keyword_searches">busca por palavras-chave</a> no Firefox. Veja {{SectionOnPage("/en-US/docs/MDN/Contribute/Tools/KumaScript", "Using search keywords to open template pages")}} para um guia passo-a-passo de criar uma busca para isso.</p>
</div>

<h2 id="Erro_tipo_TemplateExecutionError">Erro tipo <em>TemplateExecutionError</em></h2>

<p><code>TemplateExecutionError</code> erros aparecem quando KumaScript encontra erros na macro. Esses erros só podem ser consertados por usuários administradores e precisam ser reportados como <em>bugs</em>.</p>

<p>Antes de reportar um erro, verifique se ele ainda não foi consertado. Você pode fazer isso forçando o KumaScript a te dar uma cópia fresca da página segurando <kbd>Shift</kbd>  enquanto atualiza a página (<kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>R</kbd> no Windows/Linux, <kbd>Shift</kbd> + <kbd>Cmd</kbd> + <kbd>R</kbd> no Mac).</p>

<p>Se os erros persistirem, <a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla_Developer_Network&amp;component=General#h=detail|bug">reporte um <em>bug</em></a>, incluindo a URL da página e o texto do erro.</p>

<h2 id="Erro_tipo_Error_Unknown">Erro tipo <em>Error</em> &amp; <em>Unknown</em></h2>

<p>Este é um tipo de erro que aparece quando o erro não pertence aos outros tipos de erros.</p>

<p>Verifique se existe alguma solução de contorno ou correção para o problema e reporte <em>bugs</em> persistentes como descrito em <a href="#TemplateExecutionError">TemplateExecutionError</a>.</p>