From ab38a6d8dc6150dc37777d88ac4f427a3ca249a7 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 1 Aug 2021 01:25:53 +0900 Subject: MDN/Structures/Macros を更新 (#1644) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * MDN/Structures/Macros を更新 2021/07/22 時点の英語版に同期 * Revert "MDN/Structures/Macros を更新" This reverts commit 44ee306cd4b299f36724a369508dc4588f5ad1b5. * Revert "Revert "MDN/Structures/Macros を更新"" This reverts commit 0c2a29aa908211c20adaec65cde9bf207565362e. --- files/ja/mdn/structures/macros/index.html | 38 ++++++++++++++----------------- 1 file 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 --- -
{{MDNSidebar}}

MDN が動作している Kuma プラットフォームは、幅広い作業の自動化を可能にする強力なマクロシステムである KumaScript を提供しています。この記事は MDN のマクロを記事中で呼び出す方法について情報を提供します。

+
{{MDNSidebar}}
-

KumaScript ガイドでは MDN 上でマクロを利用する方法について詳細な情報を提供しているので、このセクションではむしろ全体の簡潔なまとめをします。

+

MDN が動作している Yari プラットフォームは、幅広い作業の自動化を可能にする強力なマクロシステムである KumaScript を提供しています。この記事は MDN のマクロを記事中で呼び出す方法について情報を提供します。

-

マクロはどのように実装されているか

+

KumaScript ガイドでは MDN 上でマクロを利用する方法について詳細な情報を提供しているので、この節ではむしろ全体の簡潔なまとめをします。

-

MDN 上で動作するマクロは、サーバーで実行される JavaScript コードを使用して実装され、 Node.js によって解釈されます。そのうえ数多くのライブラリを用意しており、 Wiki 風のサービスを提供します。また、 Wiki プラットフォームとそのコンテンツを、マクロと連携させる機能を提供します。もっと詳細に興味があるのであれば、 KumaScript ガイドを参照して下さい。

+

マクロはどのように実装されているか

-

コンテンツでのマクロの利用

+

MDN 上で動作するマクロは、サーバーで実行される JavaScript コードを使用して実装され、 Node.js によって解釈されます。さらに、マクロがプラットフォームやそのコンテンツと相互作用するためのサービスや機能を提供する、私たちが実装したいくつかのライブラリーがあります。

-

実際にマクロを使うには、マクロの呼び出しを二重の中括弧で囲むだけです。引数があれば括弧で囲みます。つまり以下のようになります。

+

コンテンツでのマクロの利用

-
\{{macroname(parameter-list)}}
+

実際にマクロを使うには、マクロの呼び出しを二重の中括弧で囲みます。引数があれば括弧で囲みます。

+ +
\{{macroname(parameter-list)}}

マクロ呼び出しに関するいくつかのポイント

-

マクロは高度にキャッシュ化されています。どの入力値についても（引数や、マクロを動作させる URL といった環境変数のいずれでも）、その結果は記憶され再利用されます。つまり、入力が変化した時だけマクロは実行されます。

- -
-

注: ブラウザーでページを強制的に再読み込み（つまり、 Shift を押しながら再読み込み）すると、そのページのマクロを再評価することが出来ます。

-
- -

マクロは大きなテキストブロックを挿入したり、 MDN の他記事からの内容で置き換えたりするようなシンプルなこともできますし、サイトを走査して目次をまるごと作り上げたり、出力のスタイリングをしたり、リンクを張ったりといった複雑なこともできます。

+

マクロは高度にキャッシュ化されています。どの入力値についても (引数や、マクロを動作させる URL といった環境変数のいずれでも)、その結果は記憶され再利用されます。つまり、入力が変化した時だけマクロは実行されます。

-

最もよく使われるマクロについて良く使われるマクロのページで学習することが出来ます。また、マクロの完全なリストもあります。そして多くのマクロには最上部のコメントとして、ソースに説明が組み込まれています。

+

マクロは大きなテキストブロックを挿入したり、 MDN の他記事からの内容で置き換えたりするようなシンプルなこともできますし、サイトを走査して目次をまるごと作り上げたり、出力のスタイル付けをしたり、リンクを張ったりといった複雑なこともできます。

-

{{EditorGuideQuicklinks}}

+

最もよく使われるマクロについては、よく使われるマクロのページで学習することができます。また、すべてのマクロの完全なソースもあります。そして多くのマクロには最上部のコメントとして、ソースに説明が組み込まれています。

-- cgit v1.2.3-54-g00ecf