diff options
Diffstat (limited to 'files/pt-br/mdn/tools/kumascript/troubleshooting/index.html')
| -rw-r--r-- | files/pt-br/mdn/tools/kumascript/troubleshooting/index.html | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/files/pt-br/mdn/tools/kumascript/troubleshooting/index.html b/files/pt-br/mdn/tools/kumascript/troubleshooting/index.html new file mode 100644 index 0000000000..56053d6468 --- /dev/null +++ b/files/pt-br/mdn/tools/kumascript/troubleshooting/index.html @@ -0,0 +1,63 @@ +--- +title: Solucionando problemas de erros de KumaScript +slug: MDN/Tools/KumaScript/Solucionando_problemas_de_erros_de_KumaScript +tags: + - Erros + - Ferramentas + - Guía + - KumaScript + - MDN Meta +translation_of: MDN/Tools/KumaScript/Troubleshooting +--- +<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></code></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&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> & <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> |