files/ja/mdn/tools/kumascript/troubleshooting/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
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="/ja/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="/ja/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>