From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../tools/kumascript/troubleshooting/index.html | 65 ++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 files/ja/mdn/tools/kumascript/troubleshooting/index.html (limited to 'files/ja/mdn/tools/kumascript/troubleshooting') diff --git a/files/ja/mdn/tools/kumascript/troubleshooting/index.html b/files/ja/mdn/tools/kumascript/troubleshooting/index.html new file mode 100644 index 0000000000..c7c6a3a8a3 --- /dev/null +++ b/files/ja/mdn/tools/kumascript/troubleshooting/index.html @@ -0,0 +1,65 @@ +--- +title: KumaScript エラーのトラブルシューティング +slug: MDN/Tools/KumaScript/Troubleshooting +tags: + - KumaScript + - MDN Meta + - Tools + - エラー + - ガイド +translation_of: MDN/Tools/KumaScript/Troubleshooting +--- +
{{MDNSidebar}}
+ +
+

ページに出てくる KumaScript エラーは読み手にとって不快なもので、大きく赤い恐ろしげなボックスですが、幸運なことに MDN アカウントを持つユーザーは誰でも、ドキュメントを直してこうしたエラーを修正できます。ページがエラーを起こしたとき、エラーのあるドキュメントリストに追加されます。サイト編集者は通常このリストを検査して、エラーを発見、修正します。この記事では4種類の KumaScript エラーと、修正するための対策について詳しく見ます。

+
+ +

DocumentParsingError

+ +

DocumentParsingError のエラーは KumaScript がドキュメント自体を理解できないときに表示されます。最もよくある原因は macro 内の文法エラーです。

+ +

以下をチェックします:

+ +
+
マクロ呼出しのつもりではない場合に中括弧を使った。
+
If you need to write  \{ in a document without calling a macro you can escape it with a \ like this: \\{
+
マクロパラメーターに特殊な文字を使った。
+
If you need to use a " or a \  inside of a macro parameter they can be escaped with a \ like this: \\ or \"
+
マクロパラメーター間にカンマがない。
+
Macro parameters need to be delimited by a comma (,) but not at the end of the list of parameters; for example \{\{anch("top", "Back to top")}}.
+
マクロ呼び出し内に HTML タグがある
+
If you apply styling to a macro, it will often break because, for example, a </code> tag may have appeared inside the macro code in the source code. Check the source view to see what's there, and remove any unnecessary styling.
+
+ + + +

TemplateLoadingError

+ +

TemplateLoadingError のエラーは KumaScript がページにどの macro を取り込むか探せないときに表示されます。

+ +

以下をチェックします:

+ +
+
マクロ名を誤ったり、マクロがリネームされた。
+
GitHub repo で既知のマクロのリストを確認できます。
+
+ +
+

Tip: You can make it quick and easy to jump to a specific macro by adding a search keyword to Firefox. See {{SectionOnPage("/en-US/docs/MDN/Contribute/Tools/KumaScript", "Using search keywords to open template pages")}} for a step-by-step guide to creating the search keyword for this.

+
+ +

TemplateExecutionError

+ +

TemplateExecutionError のエラーは KumaScript が macro 内のエラーに遭遇したときに表示されます。このエラーは管理者のみが修正できて、バグとして報告が必要となります。

+ +

エラーを報告する前に、これが修正済みでないことを確認します。KumaScript を強制的にページのフレッシュコピーを読み込ませることでできます。これには Shift  を押しっぱなしでページ再読み込みします (Windows/Linux では Shift + Ctrl + R 、Mac では Shift + Cmd + R )。

+ +

エラーが続く場合、ページの URL とエラーのテキストをつけてbug 報告します。

+ +

Error & Unknown

+ +

これは、エラーがこれ以外の種類にない場合のカテゴリーです。

+ +

修正をチェックして、TemplateExecutionError に記述されるようなしつこいバグとして報告します。

-- cgit v1.2.3-54-g00ecf