We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

KumaScript 错误出现在页面上很倒读者的胃口,看看包裹着它们的吓人的大红盒子吧,但幸运的任何有MDN账户的小伙伴都可以编辑文档来解决这样的错误。当页面出现错误时,它会添加到有错误的 文档列表中  。网站编辑会定期查看此列表,以查找和修复错误。本文详细介绍了四种类型的KumaScript错误,以及一些您解决他们的步骤。

文档解析错误

当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 在宏中遇到错误时,会出现模板执行错误 。这些错误只能被管理员修复而且需要被作为漏洞报告。

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

如果错误仍然存在, 报告一个 bug, 包含出错页面的URL和错误文本。

错误 & 未知

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

像 模板执行错误 中描述的那样,查看修复情况和持久漏洞的报告。

文档标签和贡献者

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