MDN/Structures/Macros を更新 (#1644)

* MDN/Structures/Macros を更新

2021/07/22 時点の英語版に同期

* Revert "MDN/Structures/Macros を更新"

This reverts commit 44ee306cd4b299f36724a369508dc4588f5ad1b5.

* Revert "Revert "MDN/Structures/Macros を更新""

This reverts commit 0c2a29aa908211c20adaec65cde9bf207565362e.

1 files changed, 17 insertions, 21 deletions

diff --git a/files/ja/mdn/structures/macros/index.html b/files/ja/mdn/structures/macros/index.html
index 40cddcf091..b4cf8a42ef 100644
--- a/files/ja/mdn/structures/macros/index.html
+++ b/files/ja/mdn/structures/macros/index.html
@@ -1,5 +1,5 @@
 ---
-title: マクロ
+title: マクロの使用
 slug: MDN/Structures/Macros
 tags:
   - Guide
@@ -9,38 +9,34 @@ tags:
   - Structures
 translation_of: MDN/Structures/Macros
 ---
-<div>{{MDNSidebar}}</div><p><span class="seoSummary">MDN が動作している <a href="/ja/docs/MDN/Kuma" title="/en-US/docs/Project:MDN/Kuma">Kuma</a> プラットフォームは、幅広い作業の自動化を可能にする強力なマクロシステムである <a href="/ja/docs/MDN/Contribute/Tools/KumaScript" title="/en-US/docs/Project:MDN/Kuma/KumaScript_guide">KumaScript</a> を提供しています。この記事は MDN のマクロを記事中で呼び出す方法について情報を提供します。</span></p>
+<div>{{MDNSidebar}}</div>
 
-<p><a href="/ja/docs/MDN/Contribute/Tools/KumaScript" title="/en-US/docs/Project:MDN/Kuma/KumaScript_guide">KumaScript ガイド</a>では MDN 上でマクロを利用する方法について詳細な情報を提供しているので、このセクションではむしろ全体の簡潔なまとめをします。</p>
+<p><span class="seoSummary">MDN が動作している <a href="/ja/docs/MDN/Yari">Yari</a> プラットフォームは、幅広い作業の自動化を可能にする強力なマクロシステムである <a href="/ja/docs/MDN/Tools/KumaScript">KumaScript</a> を提供しています。この記事は MDN のマクロを記事中で呼び出す方法について情報を提供します。</span></p>
 
-<h2 id="How_macros_are_implemented" name="How_macros_are_implemented">マクロはどのように実装されているか</h2>
+<p><a href="/ja/docs/MDN/Tools/KumaScript">KumaScript ガイド</a>では MDN 上でマクロを利用する方法について詳細な情報を提供しているので、この節ではむしろ全体の簡潔なまとめをします。</p>
 
-<p>MDN 上で動作するマクロは、サーバーで実行される <a href="/ja/docs/Web/JavaScript" title="/ja/docs/Web/JavaScript">JavaScript</a> コードを使用して実装され、 <a href="https://nodejs.org/en/" title="https://nodejs.org/en/">Node.js</a> によって解釈されます。そのうえ数多くのライブラリを用意しており、 Wiki 風のサービスを提供します。また、 Wiki プラットフォームとそのコンテンツを、マクロと連携させる機能を提供します。もっと詳細に興味があるのであれば、 <a href="/ja/docs/MDN/Contribute/Tools/KumaScript" title="/en-US/docs/Project:MDN/Kuma/KumaScript_guide">KumaScript ガイド</a>を参照して下さい。</p>
+<h2 id="How_macros_are_implemented">マクロはどのように実装されているか</h2>
 
-<h2 id="Using_a_macro_in_content" name="Using_a_macro_in_content">コンテンツでのマクロの利用</h2>
+<p>MDN 上で動作するマクロは、サーバーで実行される <a href="/ja/docs/Web/JavaScript">JavaScript</a> コードを使用して実装され、 <a href="https://nodejs.org/en/">Node.js</a> によって解釈されます。さらに、マクロがプラットフォームやそのコンテンツと相互作用するためのサービスや機能を提供する、私たちが実装したいくつかのライブラリーがあります。</p>
 
-<p>実際にマクロを使うには、マクロの呼び出しを二重の中括弧で囲むだけです。引数があれば括弧で囲みます。つまり以下のようになります。</p>
+<h2 id="Using_a_macro_in_content">コンテンツでのマクロの利用</h2>
 
-<pre class="notranslate">\{{macroname(parameter-list)}}</pre>
+<p>実際にマクロを使うには、マクロの呼び出しを二重の中括弧で囲みます。引数があれば括弧で囲みます。</p>
+
+<pre class="brush: js">\{{macroname(parameter-list)}}</pre>
 
 <p>マクロ呼び出しに関するいくつかのポイント</p>
 
 <ul>
  <li>マクロ名は大文字と小文字を区別します。それに関するエラーはよくあるので幾つかののパターンがあります。例えば、マクロ名に大文字があるのに全て小文字で入力しているかもしれません。また、小文字から始まる所を大文字にしてしまっているのかもしれません。</li>
- <li>引数はコンマで区切ります。</li>
- <li>引数が無ければ括弧は取ってしまって構いません。 <code>\{{macroname()}}</code> と <code>\{{macroname}}</code> はまったく同等です。</li>
- <li>数値の引数は引用符で囲む必要がありませんが、囲んでも構いません（ただし、複数のピリオドを含むバージョン番号を渡す場合などは、引用符で囲む必要があります）。</li>
- <li>エラーが発生した場合は、コードを丁寧に読み返して下さい。何が問題なのかそれでも特定できなかった場合には、 <a href="/ja/docs/MDN/Kuma/Troubleshooting_KumaScript_errors">KumaScript エラーのトラブルシューティング</a>を参照して下さい。</li>
+ <li>引数はカンマで区切ります。</li>
+ <li>引数がなければ括弧は取ってしまって構いません。 <code>\{{macroname()}}</code> と <code>\{{macroname}}</code> はまったく同じです。</li>
+ <li>数値の引数は引用符で囲む必要がありませんが、囲んでも構いません (ただし、複数のピリオドを含むバージョン番号を渡す場合などは、引用符で囲む必要があります)。</li>
+ <li>エラーが発生した場合は、コードを丁寧に読み返して下さい。何が問題なのかそれでも特定できなかった場合には、 <a href="/ja/docs/MDN/Tools/KumaScript/Troubleshooting">KumaScript エラーのトラブルシューティング</a>を参照して下さい。</li>
 </ul>
 
-<p>マクロは高度にキャッシュ化されています。どの入力値についても（引数や、マクロを動作させる URL といった環境変数のいずれでも）、その結果は記憶され再利用されます。つまり、入力が変化した時だけマクロは実行されます。</p>
-
-<div class="note">
-<p><strong>注:</strong> ブラウザーでページを強制的に再読み込み（つまり、 Shift を押しながら再読み込み）すると、そのページのマクロを再評価することが出来ます。</p>
-</div>
-
-<p>マクロは大きなテキストブロックを挿入したり、 MDN の他記事からの内容で置き換えたりするようなシンプルなこともできますし、サイトを走査して目次をまるごと作り上げたり、出力のスタイリングをしたり、リンクを張ったりといった複雑なこともできます。</p>
+<p>マクロは高度にキャッシュ化されています。どの入力値についても (引数や、マクロを動作させる URL といった環境変数のいずれでも)、その結果は記憶され再利用されます。つまり、入力が変化した時だけマクロは実行されます。</p>
 
-<p>最もよく使われるマクロについて<a href="/ja/docs/MDN/Contribute/Structures/Macros/Commonly-used_macros" title="/ja/docs/Project:MDN/Contributing/Custom_macros">良く使われるマクロ</a>のページで学習することが出来ます。また、<a href="https://developer.mozilla.org/ja/docs/templates" title="https://developer.mozilla.org/en-US/docs/templates">マクロの完全なリスト</a>もあります。そして多くのマクロには最上部のコメントとして、ソースに説明が組み込まれています。</p>
+<p>マクロは大きなテキストブロックを挿入したり、 MDN の他記事からの内容で置き換えたりするようなシンプルなこともできますし、サイトを走査して目次をまるごと作り上げたり、出力のスタイル付けをしたり、リンクを張ったりといった複雑なこともできます。</p>
 
-<p>{{EditorGuideQuicklinks}}</p>
+<p>最もよく使われるマクロについては、<a href="/ja/docs/MDN/Structures/Macros/Commonly-used_macros">よく使われるマクロ</a>のページで学習することができます。また、<a href="https://github.com/mdn/yari/tree/master/kumascript/macros">すべてのマクロの完全なソース</a>もあります。そして多くのマクロには最上部のコメントとして、ソースに説明が組み込まれています。</p>