MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

疑难排除 KumaScript错误

翻译正在进行中。

KumaScript 出现在一个页面错误可以很倒胃口的读者,在他们的恐怖的大红色的盒子,但幸运的是有一个MDN的账户可以编辑文档来解决这样的一个错误。当页面出现错误时,它会添加到有错误的 文档列表中  。网站编辑会定期查看此列表,以查找和修复错误。本文详细介绍了四种类型的KumaScript错误,以及您可以采取一些步骤来解决它们。

文档解析错误

DocumentParsingErrorerrors 在文档中错误出现时,KumaScript也难以理解文档本身。 最常见的原因是macro中的语法错误。

检查下面的情况:

使用花括号而不是去调用宏。
如果你需要不调用宏来在文档中写入 { 你可以通过添加 \ 来使用转义字符像这样:\{
在macro参数中使用特殊字符。
如果你需要在macro参数中表示 " 或者一个 \  通过添加 \ 来使用转义字符像这样: \\ or \"
macro 参数之间缺少逗号
参数之间需要用 (,) 分隔 ; 但是Macro参数的结尾不需要;例如 {{anch("top", "Back to top")}}。
宏调用中出现的HTML标签
如果你在宏中添加样式表,这样常常会产生问题,例如,一个</code> 标签可能会出现在宏的源代码中。检查源代码找到在哪里,然后删除任何不必要的样式表。

模板加载错误

模板加载错误出现在 KumaScript 找不到包含在页面中的宏的时候。

检查下面的情况:

宏的名字错误或者重复。
你可以去检查下宏的模板页看看名字是否正确。模板页的URL可以通过在URL https://developer.mozilla.org/en-US/docs/Template: 末尾添加模板名来构建 - 例如  {{anch("top", "Back to top")}} 的模板页是 https://developer.mozilla.org/en-US/docs/Template:anch.

macros for the MDN 的部分列表,可能包括你正在查找的宏,或者它正确的/新的拼法。

Tip: 你可以通过向 Firefox 添加 search keyword 来快速轻松地跳转到指定的宏。请参阅 "Using search keywords to open template pages" in KumaScript 一步步指导你来通过搜索关键字来打开模板页面。

模板执行错误

当KumaScript 在宏中遇到错误时,会出现TemplateExecutionError errors 。这些错误只能被管理员修复而且需要被作为漏洞报告。

在被报告称一个错误之前需要查看它是否被修复。 你可以通过使用 KumaScript 按住 Shift 来得到一个新的页面副本, 当你需要刷新页面的时候 (Shift + Ctrl + R 在 Windows/Linux上, Shift + Cmd + R 在 Mac上)。

如果错误仍然存在, report a bug, 包括页面的URL和文本的错误。

错误 & 未知

如果它们不是其他类型的错误,那么就是这种错误。

查看修复情况和持久漏洞的报告就像TemplateExecutionError 中描述的。

文档标签和贡献者

标签: 
 此页面的贡献者: ArcherGrey, Slayer1986, xgqfrms-GitHub
 最后编辑者: ArcherGrey,