blob: b4cf8a42ef3cbc2aa2025fbf94842a36716deec0 (
plain)
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
|
---
title: マクロの使用
slug: MDN/Structures/Macros
tags:
- Guide
- Kuma
- KumaScript
- MDN Meta
- Structures
translation_of: MDN/Structures/Macros
---
<div>{{MDNSidebar}}</div>
<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>
<p><a href="/ja/docs/MDN/Tools/KumaScript">KumaScript ガイド</a>では MDN 上でマクロを利用する方法について詳細な情報を提供しているので、この節ではむしろ全体の簡潔なまとめをします。</p>
<h2 id="How_macros_are_implemented">マクロはどのように実装されているか</h2>
<p>MDN 上で動作するマクロは、サーバーで実行される <a href="/ja/docs/Web/JavaScript">JavaScript</a> コードを使用して実装され、 <a href="https://nodejs.org/en/">Node.js</a> によって解釈されます。さらに、マクロがプラットフォームやそのコンテンツと相互作用するためのサービスや機能を提供する、私たちが実装したいくつかのライブラリーがあります。</p>
<h2 id="Using_a_macro_in_content">コンテンツでのマクロの利用</h2>
<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/Tools/KumaScript/Troubleshooting">KumaScript エラーのトラブルシューティング</a>を参照して下さい。</li>
</ul>
<p>マクロは高度にキャッシュ化されています。どの入力値についても (引数や、マクロを動作させる URL といった環境変数のいずれでも)、その結果は記憶され再利用されます。つまり、入力が変化した時だけマクロは実行されます。</p>
<p>マクロは大きなテキストブロックを挿入したり、 MDN の他記事からの内容で置き換えたりするようなシンプルなこともできますし、サイトを走査して目次をまるごと作り上げたり、出力のスタイル付けをしたり、リンクを張ったりといった複雑なこともできます。</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>
|
