From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../howto/use_navigation_sidebars/index.html | 91 ++++++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 files/ja/mdn/contribute/howto/use_navigation_sidebars/index.html (limited to 'files/ja/mdn/contribute/howto/use_navigation_sidebars') diff --git a/files/ja/mdn/contribute/howto/use_navigation_sidebars/index.html b/files/ja/mdn/contribute/howto/use_navigation_sidebars/index.html new file mode 100644 index 0000000000..c618e45ccb --- /dev/null +++ b/files/ja/mdn/contribute/howto/use_navigation_sidebars/index.html @@ -0,0 +1,91 @@ +--- +title: ナビゲーションサイドバーの使い方 +slug: MDN/Contribute/Howto/Use_navigation_sidebars +tags: + - Documentation + - Draft + - HTML + - MDN + - MDN Meta + - MDN Web Docs + - Macros + - Meta + - NeedsContent + - Tutorial + - sidebars + - マクロ +translation_of: MDN/Contribute/Howto/Use_navigation_sidebars +--- +

{{MDNSidebar}}{{Draft}}

+ +

MDN の操作はよくサイドバーを用いて行われ、これは一連の記事や、同じ系列のドキュメントと MDN の他の領域の両方における関連コンテンツを列挙します。 MDN のサイドバーは自動的には生成されません。ページにサイドバーを入れるには、いくらかのマクロを作成し使用する必要があります。この記事では、 MDN サイドバーマクロの作成と記事内での使用方法の両方の手順を確認します。

+ +

現在の MDN のサイドバーマクロ

+ +

MDN には既に、サイドバーを生成するたくさんのマクロがあります。多くは MDN の特定のセクションに特化していますが、他に、特化したものがない文書領域のための一般的なサイドバーを生成するためのものがあります。

+ +
+
{{TemplateLink("AddonSidebar")}}
+
アドオンの文書を操作するためのサイドバーを挿入します。これは主にブラウザー拡張機能の作成についてのコンテンツです。
+
{{TemplateLink("APIRef")}}
+
API インターフェイスのリファレンスページおよびサブページで使用されるサイドバーを挿入します。
+
{{TemplateLink("CanvasSidebar")}}
+
HTML/DOM Canvas の文書の中で使用されるサイドバーを挿入します。
+
{{TemplateLink("DefaultAPISidebar")}}
+
特化したサイドバーのタイプがない API の API 概要ページで使用することができる既定のサイドバーを挿入します。
+
{{TemplateLink("FirefoxSidebar")}}
+
Firefox に特化した文書で使用されるサイドバーを挿入します。
+
{{TemplateLink("GamesSidebar")}}
+
ウェブ技術を使ったゲーム開発に関する MDN のコンテンツを操作するサイドバーを挿入します。
+
{{TemplateLink("HTMLSidebar")}}
+
MDN の HTML 文書で使用されるサイドバーを挿入します。
+
{{TemplateLink("HTTPSidebar")}}
+
MDN の HTTP 文書内のページで使用するためのサイドバーを挿入します。
+
{{TemplateLink("JSSidebar")}}
+
JavaScript 文書で使用するためのサイドバーを挿入します。
+
{{TemplateLink("LearnSidebar")}}
+
学習エリアのサイドバーを挿入します。
+
{{TemplateLink("MDNSidebar")}}
+
MDN の「メタ文書」、つまり、 MDN Web Docs サイト自体の利用や編集に関する文書を操作するサイドバーを挿入します。このページで実際にマクロが使われているのを見ることができます。
+
{{TemplateLink("ServiceWorkerSidebar")}}
+
サービスワーカーについての文書で使用されるサイドバーを挿入します。
+
{{TemplateLink("SpiderMonkeySidebar")}}
+
SpiderMonkey (Mozilla の JavaScript エンジン) のページに使用するサイドバーを挿入します。
+
{{TemplateLink("ToolsSidebar")}}
+
Firefox 開発ツールについてのページを列挙するサイドバーを挿入します。
+
{{TemplateLink("WebAssemblySidebar")}}
+
WebAssembly に関するリンクを含むサイドバーを挿入します。
+
{{TemplateLink("WebExtAPISidebar")}}
+
ブラウザー拡張 (WebExtension) についての API リファレンス文書を操作するために使われるサイドバーを挿入します。
+
{{TemplateLink("WebGLSidebar")}}
+
WebGL に関するコンテンツの操作を提供するサイドバーを挿入します。
+
{{TemplateLink("WebRTCSidebar")}}
+
MDN の WebRTC 文書の操作を提供するコンテンツのサイドバーを挿入します。
+
{{TemplateLink("XSLTRef")}}
+
XSLT, EXSLT, XPath についての文書のサイドバーを挿入します。
+
+ +

サイドバーの使用

+ +

サイドバーをページに追加するには、正しいマクロを探し、それから、サイドバーを挿入したいページで、「編集」ボタンをクリックしてください。ページに {{HTMLElement("p")}} ブロックを追加して、中身はマクロを呼ぶだけにしてください。そうすれば、マクロ呼び出しを追加することができます。通常、サイドバーマクロは引数を必要としませんので、単に次のように書くことができます。

+ +
<p>\{{MDNSidebar}}</p>
+ +

通常は、これを文書の最初の行に入れてください。一部の文書では、代わりに末尾に入っています。これはうまく動作しますが、一貫性を保証するために、できれば先頭に配置してみてください。

+ +

すでにマクロを呼び出す {{HTMLElement("p")}} ブロックがページの先頭にある場合、例えばバナーを生成する \{{Non-standard_Header}} などがある場合は、次のように同じ {{HTMLElement("p")}} の中にサイドバーのマクロを入れることができます。

+ +
<p>\{{HTTPSidebar}}\{{Non-standard_Header}}</p>
+ +

サイドバーの作成

+ +

詳細は執筆中

+ +

{{TemplateLink("SidebarUtilities")}} について触れておきます。

+ +

サイドバーの構築に役立つマクロがいくつかあります。

+ +
+
{{TemplateLink("ListSubpagesForSidebar")}}
+
指定されたページのサブページを使用して、サイドバー内で利用するために構築されたリンクのツリーを生成します。
+
-- cgit v1.2.3-54-g00ecf