initial commit

1 files changed, 65 insertions, 0 deletions

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
+---
+<div>{{MDNSidebar}}</div>
+
+<div class="summary">
+<p>ページに出てくる <a href="/ja/docs/MDN/Contribute/Tools/KumaScript">KumaScript</a> エラーは読み手にとって不快なもので、大きく赤い恐ろしげなボックスですが、幸運なことに MDN アカウントを持つユーザーは誰でも、ドキュメントを直してこうしたエラーを修正できます。ページがエラーを起こしたとき、<a href="/ja/docs/with-errors">エラーのあるドキュメント</a>リストに追加されます。サイト編集者は通常このリストを検査して、エラーを発見、修正します。この記事では4種類の KumaScript エラーと、修正するための対策について詳しく見ます。</p>
+</div>
+
+<h2 id="DocumentParsingError">DocumentParsingError</h2>
+
+<p><code>DocumentParsingError</code> のエラーは KumaScript がドキュメント自体を理解できないときに表示されます。最もよくある原因は <a href="/en-US/docs/MDN/Contribute/Content/Macros">macro</a> 内の文法エラーです。</p>
+
+<p>以下をチェックします:</p>
+
+<dl>
+ <dt>マクロ呼出しのつもりではない場合に中括弧を使った。</dt>
+ <dd>If you need to write  \{ in a document without calling a macro you can escape it with a \ like this: <code>\\{</code></dd>
+ <dt>マクロパラメーターに特殊な文字を使った。</dt>
+ <dd>If you need to use a " or a \  inside of a macro parameter they can be escaped with a \ like this: <code>\\</code> or <code>\"</code></dd>
+ <dt>マクロパラメーター間にカンマがない。</dt>
+ <dd>Macro parameters need to be delimited by a comma (,) but not at the end of the list of parameters; for example <code>\{\{anch("top", "Back to top")}}</code>.</dd>
+ <dt>マクロ呼び出し内に HTML タグがある</dt>
+ <dd>If you apply styling to a macro, it will often break because, for example, a <code>&lt;/code&gt;</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.</dd>
+</dl>
+
+<ul>
+</ul>
+
+<h2 id="TemplateLoadingError">TemplateLoadingError</h2>
+
+<p><code>TemplateLoadingError</code> のエラーは KumaScript がページにどの <a href="/en-US/docs/MDN/Contribute/Content/Macros">macro</a> を取り込むか探せないときに表示されます。</p>
+
+<p>以下をチェックします:</p>
+
+<dl>
+ <dt>マクロ名を誤ったり、マクロがリネームされた。</dt>
+ <dd><a href="https://github.com/mdn/kumascript/tree/master/macros">GitHub repo</a> で既知のマクロのリストを確認できます。</dd>
+</dl>
+
+<div class="note">
+<p><strong>Tip:</strong> You can make it quick and easy to jump to a specific macro by adding a <a href="http://kb.mozillazine.org/Using_keyword_searches">search keyword</a> 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.</p>
+</div>
+
+<h2 id="TemplateExecutionError">TemplateExecutionError</h2>
+
+<p><code>TemplateExecutionError</code> のエラーは KumaScript が macro 内のエラーに遭遇したときに表示されます。このエラーは管理者のみが修正できて、バグとして報告が必要となります。</p>
+
+<p>エラーを報告する前に、これが修正済みでないことを確認します。KumaScript を強制的にページのフレッシュコピーを読み込ませることでできます。これには <kbd>Shift</kbd>  を押しっぱなしでページ再読み込みします (Windows/Linux では <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>R</kbd> 、Mac では <kbd>Shift</kbd> + <kbd>Cmd</kbd> + <kbd>R</kbd> )。</p>
+
+<p>エラーが続く場合、ページの URL とエラーのテキストをつけて<a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla_Developer_Network&amp;component=General#h=detail|bug">bug 報告します</a>。</p>
+
+<h2 id="Error_Unknown">Error &amp; Unknown</h2>
+
+<p>これは、エラーがこれ以外の種類にない場合のカテゴリーです。</p>
+
+<p>修正をチェックして、<a href="#TemplateExecutionError">TemplateExecutionError</a> に記述されるようなしつこいバグとして報告します。</p>