aboutsummaryrefslogtreecommitdiff
path: root/files/ja/mdn/structures
diff options
context:
space:
mode:
authorFlorian Merz <me@fiji-flo.de>2021-02-11 12:07:59 +0100
committerFlorian Merz <me@fiji-flo.de>2021-02-11 12:07:59 +0100
commit6ef1fa4618e08426b874529619a66adbd3d1fcf0 (patch)
tree890e3e27131be010d82ef957fa68db495006cb0e /files/ja/mdn/structures
parent8260a606c143e6b55a467edf017a56bdcd6cba7e (diff)
downloadtranslated-content-6ef1fa4618e08426b874529619a66adbd3d1fcf0.tar.gz
translated-content-6ef1fa4618e08426b874529619a66adbd3d1fcf0.tar.bz2
translated-content-6ef1fa4618e08426b874529619a66adbd3d1fcf0.zip
unslug ja: move
Diffstat (limited to 'files/ja/mdn/structures')
-rw-r--r--files/ja/mdn/structures/api_references/api_reference_sidebars/index.html132
-rw-r--r--files/ja/mdn/structures/api_references/index.html58
-rw-r--r--files/ja/mdn/structures/api_references/what_does_an_api_reference_need/index.html168
-rw-r--r--files/ja/mdn/structures/live_samples/simple_live_sample_demo/index.html37
-rw-r--r--files/ja/mdn/structures/macros/commonly-used_macros/creating_templates_for_multi-languages/index.html12
5 files changed, 0 insertions, 407 deletions
diff --git a/files/ja/mdn/structures/api_references/api_reference_sidebars/index.html b/files/ja/mdn/structures/api_references/api_reference_sidebars/index.html
deleted file mode 100644
index 6695ab0969..0000000000
--- a/files/ja/mdn/structures/api_references/api_reference_sidebars/index.html
+++ /dev/null
@@ -1,132 +0,0 @@
----
-title: API リファレンスサイドバー
-slug: MDN/Structures/API_references/API_reference_sidebars
-tags:
- - API
- - Documentation
- - Guide
- - MDN
- - MDN Meta
- - Reference
- - groupdata
- - metadata
- - onboarding
- - sidebars
-translation_of: MDN/Structures/API_references/API_reference_sidebars
----
-<div>{{MDNSidebar}}</div>
-
-<p class="summary">API リファレンスページにカスタムサイドバーを追加して、関連するインターフェイス、チュートリアル、およびその API に関連する他のリソースへのリンクを表示することができます。この記事ではその方法を説明します。</p>
-
-<h2 id="Creating_a_sidebar" name="Creating_a_sidebar">サイドバーの作成</h2>
-
-<p>API サイドバーを作成するには、次の3つの手順を実行する必要があります。</p>
-
-<ol>
- <li>API リファレンスページを作成します</li>
- <li>特定の API の項目を <a href="https://github.com/mdn/kumascript">KumaScript リポジトリ</a>の <code>GroupData.json</code> データファイルに追加します</li>
- <li>{{TemplateLink("APIRef")}} マクロを使用して、表示したい各ページにサイドバーを挿入します</li>
-</ol>
-
-<p>これらのステップを順番に実行しましょう。この記事で参照する例は、<a href="/ja/docs/Web/API/Fetch_API">Fetch API</a> です。</p>
-
-<h3 id="Creating_your_API_reference_pages" name="Creating_your_API_reference_pages">API リファレンスページの作成</h3>
-
-<p>サイドバーをページに追加する前に、ページ自体を作成する必要があります (詳細については、<a href="/ja/docs/MDN/Contribute/Structures/API_references/What_does_an_API_reference_need">API リファレンスに必要なもの</a>ガイドを参照してください)。</p>
-
-<h3 id="Adding_an_entry_to_GroupData.json" name="Adding_an_entry_to_GroupData.json">GroupData.json への項目の追加</h3>
-
-<p><code><a href="https://github.com/mdn/kumascript/blob/master/macros/GroupData.json">GroupData.json</a></code> ファイルには、API 参照サイドバーに表示されるリンクに関するすべてのデータが格納されます。呼び出されると、{{TemplateLink("APIRef")}} マクロは引数として与えられた API 名を取り、<code>GroupData.json</code> でその名前を検索し、適切なサイドバーを作成してページに挿入します。</p>
-
-<p><code>GroupData.json</code> に項目を追加するには、以下を行う必要があります。</p>
-
-<ol>
- <li><a href="https://github.com/">GitHub</a> アカウントを持っていることを確認します</li>
- <li>KumaScript リポジトリをフォークし、新しいブランチを作成して変更を保存し、リポジトリをローカルにクローンします</li>
- <li>作業を開始する前に新しいブランチをチェックアウトし、作業が終わったら変更を押してください</li>
- <li>プルリクエストを作成して、MDN チームがあなたの作業をレビューし、必要に応じて変更を求めることができるようにします</li>
-</ol>
-
-<p>GitHub の使用についてサポートが必要な場合は、<a href="/ja/docs/MDN/Contribute/Structures/Compatibility_tables#The_new_way_The_browser_compat_data_repo_and_dynamic_tables">互換性一覧表</a>に詳細なガイドがあります。</p>
-
-<p><code><a href="https://github.com/mdn/kumascript/blob/master/macros/GroupData.json">GroupData.json</a></code> ファイルは、KumaScript リポジトリの macros ディレクトリ内にあります。それを見ると、巨大な JSON 構造があり、それぞれの API に独自のメンバーがあります。名前は API 名で、値は生成するサイドバーリンクを定義するいくつかのサブメンバーを含むオブジェクトです。</p>
-
-<p>たとえば、MDN の <a href="/ja/docs/Web/API/Fetch_API">Fetch API</a> ページを見てください。 <code>GroupData.json</code> の対応する項目は次のようになります。</p>
-
-<pre class="brush: json notranslate">"Fetch API": {
- "overview": [ "Fetch API"],
- "interfaces": [ "Body",
- "Headers",
- "Request",
- "Response",
- "FetchController",
- "FetchObserver",
- "FetchSignal",
- "ObserverCallback" ],
- "methods": [ "WindowOrWorkerGlobalScope.fetch()" ],
- "properties": [],
- "events": []
-},</pre>
-
-<p>ご覧のとおり、名前には "Fetch API" を使用し、オブジェクト値の内側には多数のサブメンバーが含まれています。</p>
-
-<h4 id="Sub-members_to_include_inside_a_GroupData_entry" name="Sub-members_to_include_inside_a_GroupData_entry">GroupData 項目内に含めるサブメンバー</h4>
-
-<p>この節では、<code>GroupData</code> 項目に含めることができるすべてのサブメンバーを一覧表示します。</p>
-
-<p>リストされたサブメンバーの中に含まれる値のほとんどは、リンクテキストと、表示されるリンクの最終的な URL を生成するためのメイン API インデックスページ — <code>https://developer.mozilla.org/<em>&lt;language-code&gt;</em>/docs/Web/API</code> — の最後に追加されたスラッグの両方に相当することに注意してください。そのため、例えば "Body" とすると、 <em>en-US</em> ロケールではこのようなリンクが生成されます。</p>
-
-<pre class="brush: html notranslate">&lt;li&gt;&lt;a href="https://developer.mozilla.org/en-US/docs/Web/API"&gt;Body&lt;/a&gt;&lt;/li&gt;</pre>
-
-<p>いくつかの例外があります。例えば "guides" サブメンバーには、関連するガイド/チュートリアルへのリンクを定義するリンク情報 (タイトルとスラッグ) が1つ以上含まれています。この場合、スラッグは MDN の docs ルート — https://developer.mozilla.org/<em>&lt;language-code&gt;</em>/docs — の最後に追加され、MDN のどこにでも記事を含めることができます。</p>
-
-<p>以下が利用可能なメンバーです。それぞれの場合、ロケールが <em>en-US</em> であると仮定した例が含まれています。これらはすべて技術的にはオプションですが、これらを省略する代わりに空の配列を含めることを強く推奨します。</p>
-
-<ol>
- <li>
- <p><code>"overview"</code> — 値は配列で、 API 概要ページがあればその中にスラッグを含めます。"Fetch API" の場合、 <a href="/en-US/docs/Web/API/Fetch_API">https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API</a> へのリンクが生成されます。</p>
- </li>
- <li>
- <p><code>"interfaces"</code> — 値は配列で、その API の一部を構成するすべてのインターフェイスをリストアップする必要があります。 "Body" の場合は <a href="/en-US/docs/Web/API/Body">https://developer.mozilla.org/en-US/docs/Web/API/Body</a> へのリンクが生成されます。</p>
- </li>
- <li>
- <p><code>"methods"</code> — 値は、 {{domxref("Navigator")}} や {{domxref("Window")}} で生成されたインスタンス化メソッドなど、仕様が他の API に関連付けられたインターフェイスに追加するメソッドを含む配列です。膨大な数のメソッドがある場合は、最も人気のあるものだけをリストアップするか、リストの先頭に置くことを検討するとよいでしょう。 "WindowOrWorkerGlobalScope.fetch()" を実行すると <a href="/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch">https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch</a> へのリンクが張られます。同じ API が所有するインターフェイスのメンバーであるメソッドを重複してリストアップしないようにしましょう。</p>
- </li>
- <li>
- <p><code>"properties"</code> — 値は、 API に関連付けられたすべてのプロパティを含む配列です。これには API 仕様で定義されているインターフェイスのメンバーであるプロパティや、API が他のインターフェイス上で定義しているプロパティを含めることができます。膨大な数のプロパティがある場合は、最も人気のあるものだけをリストアップするか、リストの先頭に配置することを検討するとよいでしょう。 "Headers.append" を実行すると、 <a href="/en-US/docs/Web/API/Headers/append">https://developer.mozilla.org/en-US/docs/Web/API/Headers/append</a> へのリンクが生成されます。</p>
- </li>
- <li>
- <p><code>"events"</code> — 値は、 API の仕様やその他の場所で定義されている API に関連するすべてのイベントを含む配列です。膨大な数のイベントがある場合は、最も人気のあるものだけをリストアップするか、リストの先頭に置くことを検討するとよいでしょう。 "animationstart" を実行すると、 <a href="/en-US/docs/Web/Events/animationstart">https://developer.mozilla.org/en-US/docs/Web/Events/animationstart</a> へのリンクが生成されます。</p>
- </li>
- <li>
- <p><code>"guides"</code> — 値は、API の使用方法を説明するガイドへのリンクを定義する1つ以上のオブジェクトを含む配列です。各オブジェクトは、ガイド記事を指す部分的な URL を含む "url" と、リンクのリンクテストを定義する "title" の2つのサブメンバーを含みます。例として、次のようなオブジェクトがあります。</p>
-
- <pre class="brush: json notranslate">{ "url": "/docs/Web/API/Detecting_device_orientation",
-"title": "Detecting device orientation" }</pre>
-
- <p>"Detecting device orientation" というタイトルのリンクを生成し、 <a href="/en-US/docs/Web/API/Detecting_device_orientation">https://developer.mozilla.org/en-US/docs/Web/API/Detecting_device_orientation</a> を指します。</p>
- </li>
- <li>
- <p><code>"dictionaries"</code> — API の一部であるすべての辞書を一覧にした文字列の配列。一般的に、特別な意味がある場合や、複数のページから参照する必要がある場合を除き、複数のプロパティやメソッドで使用される辞書のみをここにリストアップすべきです。 "RTCConfiguration" の場合は <a href="https://developer.mozilla.org/en-US/docs/Web/API/RTCConfiguration">https://developer.mozilla.org/en-US/docs/Web/API/RTCConfiguration</a> へのリンクを表示します。</p>
- </li>
- <li>
- <p><code>"types"</code> — API で定義されている型定義子と列挙型の配列。リストを短くするために、特別に重要なものや複数のページから参照されるものだけをリストアップすることもできます。 "RTCCodecType" は <a href="https://developer.mozilla.org/en-US/docs/Web/API/RTCCodecType">https://developer.mozilla.org/en-US/docs/Web/API/RTCCodecType</a> へのリンクを生成します。</p>
- </li>
- <li>
- <p><code>"callbacks"</code> — 値は、その API で定義されているすべてのコールバック型のリストを含む配列です。コールバック型を含む API であっても、このグループを使用する必要はないと思われるかもしれません。文字列 "RTCSessionDescriptionCallback" を含むこの配列の項目は、 <a href="https://developer.mozilla.org/en-US/docs/Web/API/RTCSessionDescriptionCallback">https://developer.mozilla.org/en-US/docs/Web/API/RTCSessionDescriptionCallback</a> へのリンクが生成されます。</p>
- </li>
-</ol>
-
-<h2 id="Tags_used_by_sidebars" name="Tags_used_by_sidebars">サイドバーで使用されるタグ</h2>
-
-<p>サブメンバーによっては、ページタグに基づいて子ページから自動的に発見されるものがあります。最上位 API 以下のページはサイドバーがレンダリングされるたびにクロールされ、メソッド ("Method" タグ)、プロパティ ("Property" タグ)、コンストラクター ("Constructor"タグ) の項目が自動的に生成されます。</p>
-
-<p>サブメンバーにも、タグに基づいた警告アイコンが自動的に表示されます。実験的な ("Experimental" タグ)、標準外 ("Non Standard" または "Non-standard" タグ)、非推奨 ("Deprecated" タグ)、廃止 ("Obsolete" タグ) サブメンバーには装飾が追加されます。</p>
-
-<p>タグベースの処理に関する詳細情報は、 <a href="https://github.com/mdn/kumascript/blob/master/macros/APIRef.ejs">APIRef ソースの中</a>にあります。</p>
-
-<h2 id="Inserting_the_sidebar" name="Inserting_the_sidebar">サイドバーの挿入</h2>
-
-<p><code>GroupData.json</code> に API の項目を追加してプルリクエストとして送信し、その変更がメインリポジトリに受け入れられたら、 {{TemplateLink("APIRef")}} マクロを使用して API リファレンスページに設置することができ、 GroupData の API に引数として使用されます。例として、 <a href="/ja/docs/Web/API/WebVR_API">WebVR API</a> のサイドバーは、各ページに次のように設置されています。</p>
-
-<pre class="notranslate">\{{APIRef("WebVR API")}}</pre>
diff --git a/files/ja/mdn/structures/api_references/index.html b/files/ja/mdn/structures/api_references/index.html
deleted file mode 100644
index c1d806b234..0000000000
--- a/files/ja/mdn/structures/api_references/index.html
+++ /dev/null
@@ -1,58 +0,0 @@
----
-title: API リファレンス
-slug: MDN/Structures/API_references
-tags:
- - API
- - Contribute
- - Guide
- - Reference
-translation_of: MDN/Structures/API_references
----
-<div>{{MDNSidebar}}</div>
-
-<div>{{IncludeSubnav("/ja/docs/MDN")}}</div>
-
-<p class="summary">クライアント側の JavaScript API は、ウェブ上で利用可能な技術の大部分を占めています。MDN には、これらの API で使用できる機能とその使用方法を説明する広範囲な参考資料が含まれています。このガイドセットでは MDN で API リファレンス資料を作成する方法について説明します。</p>
-
-<h2 id="Prerequisite_resources" name="Prerequisite_resources">事前に準備するリソース</h2>
-
-<p>API の文書化を開始する前に、次のものが必要です。</p>
-
-<ol>
- <li><strong>最新の仕様:</strong> W3C 勧告か初期の編集者の草稿かどうかに関わらず、その API をカバーする仕様の最新の草稿 (またはその仕様を参照) を参照する必要があります。通常それはウェブ検索で見つかります。最新のバージョンは「最新草稿」、またはそれに類するものの下にリストされている仕様のすべてのバージョンからリンクされることがよくあります。</li>
- <li><strong>最新のウェブブラウザー:</strong> <a href="https://nightly.mozilla.org/">Firefox Nightly</a>/<a href="https://www.google.com/intl/en/chrome/browser/canary.html">Chrome Canary</a> のような実験的/アルファ版のものが、あなたが文書化している機能をサポートする可能性が高いはずです。これは初期の/実験的な API を文書化している場合に特に関係します。</li>
- <li><strong>デモ/ブログ記事/その他の情報:</strong> できるだけ多くの情報を探しましょう。主なインターフェイス/プロパティ/メソッドが何であるか、主要な用途は何であるか、そしてそれを使って簡単な機能を書く方法を学ぶことで、API の仕組みに慣れるための時間を費やすことから始めておくと便利です。</li>
- <li><strong>有益なエンジニアリングの連絡先:</strong> 仕様、API の標準化に携わっている人、またはブラウザでの実装について質問するためのフレンドリーなエンジニアリング担当者を見つけることは本当に便利です。見つけるのに適した場所は次のとおりです。
- <ul>
- <li>関連会社に勤めている場合は、社内のアドレス帳。</li>
- <li>Mozilla の <a href="https://lists.mozilla.org/listinfo/dev-platform">dev-platform</a> や <a href="https://lists.mozilla.org/listinfo/dev-webapi">dev-webapi</a> のリスト、<a href="https://lists.w3.org/Archives/Public/public-webapps/">public-webapps</a> のような W3C のリストなど、その API の議論に関係する公開メーリングリスト。</li>
- <li>仕様そのもの。たとえば、 <a href="https://webaudio.github.io/web-audio-api/">Web Audio API</a> の仕様書では著者とその連絡先の詳細が上部に表示されています。</li>
- </ul>
- </li>
-</ol>
-
-<h2 id="High_level_structure" name="High_level_structure">高水準の構造</h2>
-
-<dl>
- <dt><a href="/ja/docs/MDN/Contribute/Structures/API_references/What_does_an_API_reference_need">What does an API reference need?</a></dt>
- <dd>この記事では完全な API リファレンスに必要なページについて説明します。</dd>
- <dt><a href="/ja/docs/MDN/Contribute/Structures/Page_types">Page types</a></dt>
- <dd>MDN に繰り返し使用されるいくつかの種類のページがあります。この記事では、これらのページ種別とその目的、および新しいページを作成するときに使用する各テンプレートとテンプレートの例について説明します。</dd>
-</dl>
-
-<h2 id="Individual_page_features" name="Individual_page_features">個々のページの特徴</h2>
-
-<p>これらの記事では、API リファレンスページに必要な個々のページの特徴を作成する方法について説明します。</p>
-
-<dl>
- <dt><a href="/ja/docs/MDN/Contribute/Structures/API_references/API_reference_sidebars">API リファレンスサイドバー</a></dt>
- <dd>MDN API リファレンス記事にサイドバーを含めると、その API に関連する関連インタフェース、チュートリアル、その他のリソースへのリンクが表示されるようにカスタマイズできます。この記事では、この方法について説明します。</dd>
- <dt><a href="/ja/docs/MDN/Contribute/Structures/Syntax_sections">構文の節</a></dt>
- <dd>MDN リファレンスページの構文の節には、その機能が持つ正確な構文 (例えば、どのような引数を受け付けるか、どの引数がオプションかなど) を定義する構文ボックスが含まれています。</dd>
- <dt><a href="/ja/docs/MDN/Contribute/Structures/Code_examples">コード例</a></dt>
- <dd>MDN には、ウェブプラットフォーム機能の使用方法を示すために、ページ全体に挿入された多数のコード例があります。この記事ではコードの例をページに追加する際に使用できるさまざまなメカニズムと、使用する必要があるものとそのタイミングについて説明します。</dd>
- <dt><a href="/ja/docs/MDN/Contribute/Structures/Specification_tables">仕様書一覧表</a></dt>
- <dd>MDN のすべてのリファレンスページは、その API または技術が定義されている仕様または仕様に関する情報を提供する必要があります。この資料では、これらのテーブルの外観とその構成方法について説明します。</dd>
- <dt><a href="/ja/docs/MDN/Contribute/Structures/Compatibility_tables">互換性一覧表</a></dt>
- <dd>MDN には、公開されているウェブ文書の互換性一覧表の標準フォーマットがあります。つまり、すべてのブラウザーで共有されているDOM、HTML、CSS、JavaScript、SVG などの技術の文書です。この記事では、機能を使用して MDN ページに互換性データを追加する方法について説明します。</dd>
-</dl>
diff --git a/files/ja/mdn/structures/api_references/what_does_an_api_reference_need/index.html b/files/ja/mdn/structures/api_references/what_does_an_api_reference_need/index.html
deleted file mode 100644
index 952c49ed70..0000000000
--- a/files/ja/mdn/structures/api_references/what_does_an_api_reference_need/index.html
+++ /dev/null
@@ -1,168 +0,0 @@
----
-title: API リファレンスには何が必要ですか?
-slug: MDN/Structures/API_references/What_does_an_API_reference_need
-tags:
- - API
- - ページ
- - リファレンス
-translation_of: MDN/Structures/API_references/What_does_an_API_reference_need
----
-<div>{{MDNSidebar}}</div>
-
-<p class="summary">この記事では、完全な API リファレンスに必要なページについて説明します。</p>
-
-<div class="note">
-<p><strong>メモ</strong>: API リファレンスで作業しているときに書いたり更新したりする必要があるドキュメントのリストを作成し、完了したらチェックを外すことをお勧めします。</p>
-</div>
-
-<h2 id="API_ページの概要">API ページの概要</h2>
-
-<p>An API reference will generally contain the following pages. You can find more details of what each page contains, examples, and templates, in our <a href="/en-US/docs/MDN/Contribute/Structures/Page_types">Page types</a> article.</p>
-
-<ol>
- <li>Overview page</li>
- <li>Interface pages</li>
- <li>Constructor pages</li>
- <li>Method pages</li>
- <li>Property pages (including event handlers properties)</li>
- <li>Event pages</li>
- <li>Concept/guide pages</li>
- <li>Examples</li>
-</ol>
-
-<div class="note">
-<p><strong>Note</strong>: We'll be referring to the <a href="/en-US/docs/Web/API/Web_Audio_API">Web Audio API</a> for examples in this article.</p>
-</div>
-
-<div class="note">
-<p><strong>Note</strong>: To create a page as specified below, the easiest way is to go to the parent page you want it to hang off, and choose <em>Cog icon &gt; New sub-article</em>. If you haven't got this option available on your MDN interface, you'll need to request this privilege (ask at <code>mdn-admins@mozilla.org</code>), or ask another MDN contributor to create them for you.</p>
-</div>
-
-<h3 id="概要ページ">概要ページ</h3>
-
-<p>A single API overview page is used to describe the role of the API, its top-level interfaces, related features contained in other interfaces, and other high level details. Its name and slug should be the name of the API plus "API" on the end. It is placed at the top level of the API reference, as a child of <a href="/en-US/docs/Web/API">https://developer.mozilla.org/en-US/docs/Web/API</a>.</p>
-
-<p>例:</p>
-
-<ul>
- <li>Title: <em>Web Audio API</em></li>
- <li>Slug: <em>Web_Audio_API</em></li>
- <li>URL: <a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API">https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API</a></li>
-</ul>
-
-<h3 id="インターフェイスページ">インターフェイスページ</h3>
-
-<p>Each interface will have its own page too, describing the purpose of the interface, listing any members (constructors, methods, properties, etc. it contains), and showing what browsers it is compatible with. A page's name and slug should be the name of the interface, exactly as written in the spec. Each page is placed at the top level of the API reference, as a child of <a href="/en-US/docs/Web/API">https://developer.mozilla.org/en-US/docs/Web/API</a>.</p>
-
-<p>例:</p>
-
-<ul>
- <li>Title: <em>AudioContext</em></li>
- <li>Slug: <em>AudioContext</em></li>
- <li>URL: <a href="https://developer.mozilla.org/en-US/docs/Web/API/AudioContext">https://developer.mozilla.org/en-US/docs/Web/API/AudioContext</a></li>
-</ul>
-
-<ul>
- <li>Title: <em>AudioNode</em></li>
- <li>Slug: <em>AudioNode</em></li>
- <li>URL: <a href="https://developer.mozilla.org/en-US/docs/Web/API/AudioNode">https://developer.mozilla.org/en-US/docs/Web/API/AudioNode</a></li>
-</ul>
-
-<div class="note">
-<p><strong>Note:</strong> We document every member appearing in the interface. You should bear the following rules in mind:</p>
-
-<ul>
- <li>We document methods defined on the <u>prototype</u> of an object implementing this interface (instance methods), and methods defined on the actual class itself (static methods). On the rare occasions that they both exist on the same interface, you should list them in separate sections on the page (Static methods/Instance methods). Usually only instance methods exist, in which case you can put these under the title "Methods".</li>
- <li>We do not document inherited properties and methods of the interface: they are listed on the respective parent interface. We do hint at their existence though.</li>
- <li>We do document properties and methods defined in mixins, though we use the mixin name as interface name. (This is not optimal as the mixin name will not appear in the console, but it prevents the duplication of documentation. We may revisit this in the future.)</li>
- <li>Special methods like the stringfier (<code>toString()</code>) and the jsonizier (<code>toJSON()</code>) are also listed if they do exist.</li>
- <li>Named constructors (like <code>Image()</code>  for {{domxref("HTMLImageElement")}} ) are also listed, if relevant.</li>
-</ul>
-</div>
-
-<h3 id="コンストラクタページ">コンストラクタページ</h3>
-
-<p>Each interface has 0 or 1 constructors, documented on a subpage of the interface's page. It describes the purpose of the constructor and shows what its syntax looks like, usage examples, browser compatibility information, etc. Its slug is the name of the constructor, which is exactly the same as the interface name, and the title is interface name, dot, constructor name, then parentheses on the end.</p>
-
-<p>Example:</p>
-
-<ul>
- <li>Title: <em>AudioContext.AudioContext()</em></li>
- <li>Slug: <em>AudioContext</em></li>
- <li>URL: <a href="https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/AudioContext">https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/AudioContext</a></li>
-</ul>
-
-<h3 id="プロパティページ">プロパティページ</h3>
-
-<p>Each interface has zero or more properties, documented on subpages of the interface's page. each page describes the purpose of the property and shows what its syntax looks like, usage examples, browser compatibility information, etc. Its slug is the name of the property, and the title is interface name, dot, then property name.</p>
-
-<p>Examples:</p>
-
-<ul>
- <li>Title: <em>AudioContext.state</em></li>
- <li>Slug: <em>state</em></li>
- <li>URL: <a href="/en-US/docs/Web/API/AudioContext/state">https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/state</a></li>
-</ul>
-
-<ul>
- <li>Title: <em>AudioContext.onstatechange</em></li>
- <li>Slug: <em>onstatechange</em></li>
- <li>URL: <a href="/en-US/docs/Web/API/AudioContext/onstatechange">https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/onstatechange</a></li>
-</ul>
-
-<div class="note">
-<p><strong>Note:</strong> Event handler properties are treated in the same way as regular properties; they are generally listed in a separate section on the interface page though.</p>
-</div>
-
-<ul>
-</ul>
-
-<h3 id="メソッドページ">メソッドページ</h3>
-
-<p>Each interface has zero or more methods, documented on subpages of the interface's page. each page describes the purpose of the method and shows what its syntax looks like, usage examples, browser compatibility information, etc. Its slug is the name of the method, and the title is interface name, dot, method name, then parentheses.</p>
-
-<p>Examples:</p>
-
-<ul>
- <li>Title: <em>AudioContext.close()</em></li>
- <li>Slug: <em>close</em></li>
- <li>URL: <a href="/en-US/docs/Web/API/AudioContext/close">https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/close</a></li>
-</ul>
-
-<ul>
- <li>Title: <em>AudioContext.createGain()</em></li>
- <li>Slug: <em>createGain</em></li>
- <li>URL: <a href="/en-US/docs/Web/API/AudioContext/createGain">https://developer.mozilla.org/en-US/docs/Web/API/AudioContext/createGain</a></li>
-</ul>
-
-<h3 id="イベントページ">イベントページ</h3>
-
-<p>Each event handler property you create will have a corresponding event page, describing the event that causes the handler to fire, documented on a subpage of <a href="/en-US/docs/Web/Events">https://developer.mozilla.org/en-US/docs/Web/Events</a>. Each page describes the purpose of the event and shows what its syntax looks like, usage examples, browser compatibility information, etc. Its slug and title is the name of the event.</p>
-
-<p>Example:</p>
-
-<ul>
- <li>Title: <em>statechange</em></li>
- <li>Slug: <em>statechange</em></li>
- <li>URL: <a href="/en-US/docs/Web/Events/statechange">https://developer.mozilla.org/en-US/docs/Web/Events/statechange</a></li>
-</ul>
-
-<h3 id="Conceptguide_pages">Concept/guide pages</h3>
-
-<p>Most API references have at least one guide and sometimes also a concept page to accompany it. At minimum, an API reference should contain a guide called "Using the <em>name-of-api</em>", which will provide a basic guide to how to use the API. More complex APIs may require multiple usage guides to explain how to use different aspects of the API.</p>
-
-<p>If required, you can also including a concepts article called "<em>name-of-api</em> concepts", which will provide explanation of the theory behind any concepts related to the API that developers should understand to effectively use it.</p>
-
-<p>These articles should all be created as subpages of the API overview page. For example, the Web Audio has four guides and a concept article:</p>
-
-<ul>
- <li><a href="/en-US/docs/Web/API/Web_Audio_API/Using_Web_Audio_API">https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API/Using_Web_Audio_API</a></li>
- <li><a href="/en-US/docs/Web/API/Web_Audio_API/Visualizations_with_Web_Audio_API">https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API/Visualizations_with_Web_Audio_API</a></li>
- <li><a href="/en-US/docs/Web/API/Web_Audio_API/Web_audio_spatialization_basics">https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API/Web_audio_spatialization_basics</a></li>
- <li><a href="/en-US/docs/Web/API/Web_Audio_API/Porting_webkitAudioContext_code_to_standards_based_AudioContext">https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API/Porting_webkitAudioContext_code_to_standards_based_AudioContext</a></li>
- <li><a href="/en-US/docs/Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API">https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API/Basic_concepts_behind_Web_Audio_API</a></li>
-</ul>
-
-<h3 id="例">例</h3>
-
-<p>You should create some examples that demonstrate at least the most common use cases of the API. You can put these anywhere that is appropriate, although the recommended place is the <a href="https://github.com/mdn/">MDN GitHub repo</a>.</p>
diff --git a/files/ja/mdn/structures/live_samples/simple_live_sample_demo/index.html b/files/ja/mdn/structures/live_samples/simple_live_sample_demo/index.html
deleted file mode 100644
index 9e550d81ac..0000000000
--- a/files/ja/mdn/structures/live_samples/simple_live_sample_demo/index.html
+++ /dev/null
@@ -1,37 +0,0 @@
----
-title: ライブコードサンプルの簡単なデモ
-slug: MDN/Structures/Live_samples/Simple_live_sample_demo
-tags:
- - MDN Meta
- - Structures
- - 例
-translation_of: MDN/Structures/Live_samples/Simple_live_sample_demo
----
-<div>{{MDNSidebar}}</div>
-
-<h2 id="The_example" name="The_example">例</h2>
-
-<p id="Simple_example_of_a_live_demo">これは、MDN でライブデモを行う方法を示す非常に簡単な例です。詳細については、<a href="/ja/docs/MDN/Contribute/Structures/Live_samples">ライブサンプル</a>を参照してください。</p>
-
-<pre class="brush: html notranslate">&lt;form&gt;
- &lt;label&gt;Try me&lt;input type="text" name="name"&gt;&lt;/label&gt;
- &lt;input type="submit" value="go"&gt;
-&lt;/form&gt;</pre>
-
-<pre class="brush: css notranslate">form {
- border-radius: 10px;
- background: powderblue;
-}</pre>
-
-<pre class="brush: js notranslate">var f = document.querySelector('form');
-
-f.addEventListener('submit', function(ev) {
- ev.preventDefault();
- document.querySelectorAll('input')[1].value = 'sending';
-}, false);</pre>
-
-<p>{{ EmbedLiveSample('The_example', '', '', '') }}</p>
-
-<div class="blockIndicator note">
-<p>注: ローカライズしたページでは、最初の引数の値は、サンプルを含む見出しの ID と同じにしてください.</p>
-</div>
diff --git a/files/ja/mdn/structures/macros/commonly-used_macros/creating_templates_for_multi-languages/index.html b/files/ja/mdn/structures/macros/commonly-used_macros/creating_templates_for_multi-languages/index.html
deleted file mode 100644
index a22ce9c70e..0000000000
--- a/files/ja/mdn/structures/macros/commonly-used_macros/creating_templates_for_multi-languages/index.html
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: creating templates for multi-languages
-slug: >-
- MDN/Structures/Macros/Commonly-used_macros/creating_templates_for_multi-languages
----
-<div>{{MDNSidebar}}</div>
-<div class="note"><strong>註:</strong> このページは執筆中です。</div>
-<h2 id="執筆用memo">執筆用memo</h2>
-<ul> <li>span 要素を使って言語版毎にテンプレートを用意するタイプの「ページ・プロパティ」は「なし(デフォルト)」にする。「English」などにするとテンプレートが英語版とその言語版とで二重に表示される現象が起きる。</li>
-</ul>
-<h2 id="テンプレートの_2_つのタイプ">テンプレートの 2 つのタイプ</h2>
-<h2 id="page.langage_を使わない">page.langage を使わない</h2>