initial commit

17 files changed, 1830 insertions, 0 deletions

diff --git a/files/ja/mdn/tools/add-ons_and_plug-ins/index.html b/files/ja/mdn/tools/add-ons_and_plug-ins/index.html
new file mode 100644
index 0000000000..d89e8efbdb
--- /dev/null
+++ b/files/ja/mdn/tools/add-ons_and_plug-ins/index.html
@@ -0,0 +1,33 @@
+---
+title: MDN に関連するアドオンとプラグイン
+slug: MDN/Tools/Add-ons_and_plug-ins
+tags:
+  - Landing
+  - MDN Meta
+  - Site-wide
+  - Tools
+translation_of: MDN/Tools/Add-ons_and_plug-ins
+---
+<div>{{MDNSidebar}}</div><p><span class="seoSummary">MDN コミュニティのメンバーは多くの楽しく、便利なプロジェクトを立ち上げています。 MDN の利用や、内容への貢献を簡単にする、ツール、アドオン、ユーテリティを作成するものがあります。</span></p>
+
+<p>こうした数々のプロジェクトのリンクがここにあります。これらの多くは完成まで手助けも要るため、あなたが助けるものを探しているコーダーである場合、ここに機会が見つかるかもしれません!</p>
+
+<div class="twocolumns">
+<dl>
+ <dt><a href="https://github.com/mdn/doc-linter-webextension">MDN doc tests add-on</a></dt>
+ <dd>MDNの編集中に表示されるサイドバーを作成する Firefox アドオンで、コンテンツのテストと妥当性チェックを提供します。これは作業途中なので、より多くのテストを歓迎します!</dd>
+ <dt><a href="https://github.com/npny/mdn-automatic-translation">MDN automatic translation</a></dt>
+ <dd>{{Glossary("Regular_expression", "正規表現")}}ベースのルールを使って、自動的によくある用語を翻訳された形に置き換える。</dd>
+ <dt><a href="https://addons.mozilla.org/en-US/firefox/addon/mdn-search/">MDN Search</a></dt>
+ <dd>URLバーで <code>"mdn &lt;searchterm&gt;"</code> とタイプすることですばやくMDN のリファレンス素材を検索することができる <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions">WebExtension</a>。 組み込みのMDN 検索をベースにしているが、より良い結果を出すようにロジックが追加されている。JavaScript と CSS リファレンスを探すのに最適化されている。</dd>
+ <dt><a href="https://addons.mozilla.org/en-US/firefox/addon/mdn-interface-documentation-ge/">MDN Interface Documentation Generator</a></dt>
+ <dd>この Firefox アドオンは、XPCOM インターフェイス用に、適切にフォーマットされたスケルトン生成に役立ちます。しばらく更新されてないので、バージョン互換性の情報を正しく表示しませんが、いろいろと便利です。いくつか更新されたら、またかけがえないものに戻るでしょう。</dd>
+ <dt> </dt>
+ <dt><a href="https://github.com/a2sheppy/mdn-save-with-comment">Save with comment hotkey addon</a></dt>
+ <dd>MDNエディタのリビジョンコメント欄にすぐにスクロールさせる Firefox アドオン。つまりこれによって、あなたが編集したことに対する、小さな情報を簡単に追加できます。</dd>
+ <dt><a href="https://github.com/Elchi3/sublime-mdn">Sublime Text MDN search plug-in</a></dt>
+ <dd>コーディング中にドキュメントを得るのに、MDNをすぐに検索できる Sublime Text のプラグイン。</dd>
+ <dt><a href="https://addons.mozilla.org/en-US/firefox/addon/lazarus-form-recovery/?src=mdn">Lazarus</a></dt>
+ <dd>定期的にフォームデータをlocal storageに自動保存する Firefox 拡張機能で、すべてのデータをクラッシュやエラーから保護します。これは MDN で作業する時に便利で、なぜなら MDN エディターのコンテンツも保存し、成果を保存する前に何か失敗した場合に戻すことができるためです。</dd>
+</dl>
+</div>
diff --git a/files/ja/mdn/tools/content_kits/index.html b/files/ja/mdn/tools/content_kits/index.html
new file mode 100644
index 0000000000..b10f0bb06d
--- /dev/null
+++ b/files/ja/mdn/tools/content_kits/index.html
@@ -0,0 +1,67 @@
+---
+title: コンテンツキット
+slug: MDN/Tools/Content_kits
+translation_of: Archive/MDN/Content_kits
+---
+<div>{{MDNSidebar}}</div><div class="summary">
+<p><span class="seoSummary">MDN コンテンツキットはある題材について技術リソースを集めたもので、 地域の技術者の会合を開いたり、 イベント、会議、ワークショップなどで技術的なプレゼンテーションを行う時に役に立ちます。</span></p>
+</div>
+
+<p>Each MDN Content Kit offers relevant, up-to-date technical information for presenters and teachers on a particular topic related to web development or web app development, such as Web APIs, useful libraries, or developer tools. Content Kits may also be focused on Mozilla products, tools, or technologies such as Firefox Developer Tools or <a href="https://www.mozilla.org/en-US/research/">Mozilla Research</a> projects. Resources may include slides, demos, code samples, screencasts, video, exercises, etc.</p>
+
+<p>By providing MDN Content Kits, MDN aims to grow developer engagement with Mozilla in regional communities, and increase standards-based web development globally.</p>
+
+<h2 id="MDN_コンテンツキットを作成する_または_寄贈する">MDN コンテンツキットを作成する または 寄贈する</h2>
+
+<p>Kits can be built by anyone, and we encourage people to suggest and build kits! Individuals may also contribute to existing content kits by submitting a pull request on Github.  Get started with the <a href="https://github.com/mdn/content-kit-template">MDN Content Kit Template</a> on Github or read about the project on the <a href="https://wiki.mozilla.org/MDN/Projects/Content/MDN_Content_Kits">MDN wiki</a>.</p>
+
+<div class="note">
+<p><strong>Note</strong>: There is also a <a href="http://chrisdavidmills.github.io/content-kit-guide/">Content Kit Guide</a> available, to give you more guidance in creating content kits.</p>
+</div>
+
+<h2 id="現在のコンテンツキット">現在のコンテンツキット</h2>
+
+<ul>
+ <li><a href="http://mdn.github.io/beginning-programming-content-kit/">Beginners Programming</a>. This kit contains resources you can use to learn and teach general programming principles and the JavaScript language. The teacher will need to know HTML and JavaScript. The students will not need any previous web development knowledge but knowing how the web works and what web pages are will help. The Beginners Programming kit has 8 sections, each of which takes 1-1.5 hours to teach.</li>
+ <li><a href="http://end3r.github.io/Gamedev-Canvas-Content-Kit/">Beginners Game development with HTML5 Canvas</a>. In this kit you can learn the basics of game development using <a href="/en-US/docs/Web/JavaScript">JavaScript</a> and <a href="/en-US/docs/Web/API/Canvas_API">HTML5 Canvas</a>. All you need is a little prior experience with JavaScript basics.</li>
+ <li><a href="http://end3r.github.io/Gamedev-Phaser-Content-Kit/">Beginners Game development with Phaser</a>. In this kit you can learn the basics of game development using Phaser, a popular HTML5 game development framework. This differs from the above kit because it doesn't teach you any pure JavaScript, instead giving you expeience of working with a framework. All you need is a little prior experience with JavaScript basics.</li>
+ <li><a href="https://gist.github.com/callahad/1d0885dd70b157c3978e#file-valence-content-kit-md">Valence</a>.  Valence is the public-facing name for the Firefox Developer Tools Adapters, which extend the Firefox WebIDE to allow for remotely debugging pages in Chrome or Safari from within the Firefox Developer Tools. Valence is still in development and is experimental. Valence is distributed as an add-on, which is automatically downloaded and installed by Firefox Developer Edition, though the raw .xpi file is available on <a href="http://archive.mozilla.org/pub/labs/valence/">archive.mozilla.org</a> and its source code is on GitHub.  The Valance Content Kit is for an experienced web developer to give a presentation to a group of experienced web developers.</li>
+ <li><a href="https://github.com/sole/ck-node-firefox">node-firefox</a>. Node-firefox is a series of node.js modules for interacting with Firefox runtimes via the Developer Tools remote debugging protocol. The node-firefox Content Kit is for an experienced web developer to give a presentation to a group of experienced web developers.</li>
+ <li><a href="https://github.com/chrisdavidmills/html5-captions-and-subtitles-content-kit">Working with HTML5 Video: Adding captions and subtitles</a>. This kit contains everything you might need to present a one hour presentation on HTML5 video captions and subtitles. This includes using the {{htmlelement("track")}} element, WebVTT syntax, CSS extensions, and the difference between captions and subtitles.</li>
+ <li><a href="http://codingfree.github.io/l10n-content-kit">l10n.js</a>. JavaScript library that enables localization through the native JavaScript method intended for it. There is already a placeholder method for all API calls as specified in the ECMAScript specification and is present in all JavaScript engines.</li>
+ <li><a href="https://github.com/TatumCreative/mdn-matrix-math">Matrix Math for the Web</a>. This content kit is brief overview of manipulating 3d objects with matrices (a concept from linear algebra.) Matrix math is used heavily in WebGL, but web developers are more familiar with DOM manipulations. This intro divorces the explanation of matrices from the WebGL APIs by using the CSS3 matrix3d transform. It demonstrates translation, scale, and rotation transformations, as well as exploring how to compose a single matrix transform from multiple transforms through matrix multiplication.</li>
+ <li><a href="https://github.com/TatumCreative/mdn-model-view-projection">WebGL Model View Projection</a>. This content kit explores how to take data within a WebGL project, and project it into the proper spaces to display it on the screen. It assumes a knowledge of basic matrix math using translation, scale, and rotation matrices. It explains the three core matrices that are typically used to represent a 3d object: the model, view and projection matrices.</li>
+ <li><a href="https://github.com/TatumCreative/mdn-lighting-models">WebGL Lighting Models</a>. Getting a model projected onto the screen using WebGL is only the first step for working in 3d. The next is applying a shading or lighting model to it. This content kit walks through the steps on how to build the classic Lambertian lighting model and the Blinn Phong lighting model.</li>
+</ul>
+
+<h2 id="MDN_コンテンツキットを利用する">MDN コンテンツキットを利用する</h2>
+
+<p>Hints on using Content Kits before, during, and after a meetup. Note that these points are representative of a general Content Kit — not all points will necessarily apply to all kits.</p>
+
+<h3 id="会合の前に"><span class="mw-headline" id="Prior_to_a_meetup">会合の前に</span></h3>
+
+<ol>
+ <li>Review the content kit and all supporting materials, including relevant MDN articles.</li>
+ <li>Download the demo project and play with it until you feel comfortable demoing it.</li>
+ <li>Download the video, so you can play it locally if all else fails.</li>
+</ol>
+
+<h3 id="会合の中で"><span class="mw-headline" id="During_the_meetup">会合の中で</span></h3>
+
+<ol>
+ <li>Present the topic, including a live demo (or recorded, if necessary.)</li>
+ <li>Lead the group in a discussion of the topic, or an activity with the demo project.</li>
+</ol>
+
+<h3 id="会合の後で"><span class="mw-headline" id="After_the_meetup">会合の後で</span></h3>
+
+<ol>
+ <li>Submit issues for any problems you encountered with the kit.</li>
+ <li>Submit pull requests for any changes you made to the kit.</li>
+</ol>
+
+<h2 id="新しい_MDN_コンテンツキットを提案する">新しい MDN コンテンツキットを提案する</h2>
+
+<p>If you would like to propose a new topic for an MDN Content Kit, please add your topic to <a href="https://devengage.etherpad.mozilla.org/DevMeetupTopics">this etherpad</a> as well as on the <a href="https://lists.mozilla.org/listinfo/mdn">MDN mailing list</a>.</p>
+
+<p>If you propose a new Content Kit topic, please let us know how you will use the new MDN Content Kit and whether you will provide us feedback. We are looking for proposals for topics that will be used by groups that can provide us with feedback so that we can continue to improve and grow the collection of MDN Content Kits.</p>
diff --git a/files/ja/mdn/tools/document_parameters/index.html b/files/ja/mdn/tools/document_parameters/index.html
new file mode 100644
index 0000000000..6198f8ea7b
--- /dev/null
+++ b/files/ja/mdn/tools/document_parameters/index.html
@@ -0,0 +1,95 @@
+---
+title: URL 引数と文書メタデータ
+slug: MDN/Tools/Document_parameters
+tags:
+  - Documentation
+  - Kuma
+  - MDN Meta
+  - Page-level
+  - Reference
+  - Tools
+translation_of: MDN/Tools/Document_parameters
+---
+<div>{{MDNSidebar}}</div>
+
+<section id="intro">
+<p id="Introduction"><span class="seoSummary">MDN の Kuma Wiki プラットホームには、外からアクセスする API がありません。代わりに、人間がアクセスできるリソースを機械的に扱いやすいデータに変換する手段を提供するというのが私たちのアプローチです。</span></p>
+</section>
+
+<section id="params">
+<h2 id="URL_GET_parameters" name="URL_GET_parameters">URL の GET 引数</h2>
+
+<p>すべての Kuma wiki 文書の URL が HTTP GET で取得されたりブラウザーで見られる時に役立つクエリ引数オプションをサポートしています。</p>
+
+<p>複数のクエリ引数は最初の <kbd>?</kbd> の代わりに <kbd>&amp;</kbd> で区切られます (マクロの例を見てください)。</p>
+
+<dl>
+ <dt><code>summary</code></dt>
+ <dd>
+ <p>Kuma にページの概要のみを返すよう指示します。 "SEO summary" クラスでマークされたコンテンツがある場合、そのコンテンツが返されます。そのようなコンテンツがない場合、 "Summary" というタイトルのあるコンテンツが返されます。そうならない場合、最初のブロックのコンテンツが返されます。</p>
+
+ <div class="note"><strong>バグのお知らせ:</strong> 現在、 <code>summary</code> 引数は <code>raw</code> 引数も指定しないと文書全体を返すというバグがあります。なお、 <a href="#json-view"><code>$json</code> 代替ビュー</a>を使用して返される JSON から概要を取得することもできます。</div>
+ </dd>
+ <dt><code>raw</code></dt>
+ <dd>Kuma に、ヘッダーやフッターなどのスキン素材のない、ページの生コンテンツを返すよう指示します。これはエディターを手軽に構築するテンプレートやスクリプトを実行しません。</dd>
+ <dd><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5?raw">https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5?raw</a></code></dd>
+ <dt><code>macros</code></dt>
+ <dd>Kuma にページ内のすべてのテンプレートを実行するよう指示します。 <code>?raw</code> と組み合わせると、これはサイトラッパーを除くすべてをレンダリングした MDN コンテンツを提供します。既定では <code>?raw</code> なしです (つまり、通常のサイト表示です) <code>?raw</code> がある時は既定でオフです。</dd>
+ <dd><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5?raw&amp;macros">https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5?raw&amp;macros</a></code></dd>
+ <dt><code>nomacros</code></dt>
+ <dd>Kuma にページ内の KumaScript テンプレートを実行しないよう指示します。通常のサイト表示では <code>?macros</code> が既定で「オン」になっていますが、このオプションはオフにします。</dd>
+ <dd><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5?nomacros">https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5?nomacros</a></code></dd>
+ <dt><code>include</code></dt>
+ <dd>Kuma に <code>noinclude</code> クラスを持つブロックを除くように命じます。これは単体のページではなく、他のページに含まれた場合のような出力を得るのに便利です。よくサンプルコードなどを除きます (いつもではありませんが)。</dd>
+ <dd><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/XUL/Attribute/align?raw&amp;macros&amp;include">https://developer.mozilla.org/ja/docs/XUL/Attribute/align?raw&amp;macros&amp;include</a></code></dd>
+ <dt><code>section=id</code></dt>
+ <dd>Kuma に指定したアンカー名を持つセクションのみのコンテンツを返すように指示します。</dd>
+ <dd><strong>例:</strong>
+ <ul>
+  <li><code><a href="https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters?raw&amp;section=params">https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters?raw&amp;section=params</a></code><br>
+   (...また、もっと興味深いものは...)</li>
+  <li><code><a href="https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters?raw&amp;macros&amp;section=params">https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters?raw&amp;macros&amp;section=params</a></code></li>
+ </ul>
+
+ <div class="note"><strong>バグのお知らせ:</strong> 現在、 <code>section</code> 引数は <code>raw</code> 引数も使用しないと文書全体を返すというバグがあります。</div>
+ </dd>
+ <dt><code>expand</code></dt>
+ <dd>
+ <p><code>$children</code> ビューと連結して、サブページごとの詳細情報つきの JSON レスポンスを展開します。これは各サブページごとの <code>$children</code> と <code>$json</code> の連結のように動作します。この方法は、サブページのタグについて学べます。</p>
+
+ <p><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5$children?expand">https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5$children?expand</a></code></p>
+ </dd>
+</dl>
+</section>
+
+<section id="metadata">
+<h2 id="Document_metadata_resources" name="Document_metadata_resources">文書のメタデータリソース</h2>
+
+<p>文書の URL のレスポンスを微調整するための引数と一緒に、 URL 接尾辞で指定される文書の代替ビューもいくつかあります。</p>
+
+<dl>
+ <dt><code>$toc</code></dt>
+ <dd>Kuma に HTML のページの目次のみを返すよう命じます。順序付きリスト (つまり {{HTMLElement("ol")}}) として返されます。</dd>
+ <dd><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters$toc">https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters$toc</a></code></dd>
+ <dt id="json-view"><code>$json</code></dt>
+ <dd>Kuma に JSON オブジェクトでページを記述するよう命じます。このオブジェクトは基本的に、 KumaScript の処理 <code>wiki.getPage()</code> を使用して得られるものと同じです。</dd>
+ <dd><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5$json">https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5$json</a></code></dd>
+ <dt><code>$children</code></dt>
+ <dd>Kuma にページのトピックの子を JSON で列挙するよう命じます。このオブジェクトは基本的に、 KumaScript の処理 <code>pages.subpages()</code> を使用して得られるものと同じです。</dd>
+ <dd><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5$children
+">https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5$children</a></code></dd>
+ <dd>(これは <code>?expand</code> 引数と共に使用して、もっと詳細のレスポンスを得ることもできます。)</dd>
+ <dt><code>$compare</code></dt>
+ <dd>必須のクエリ引数 <code>?from</code> および <code>?to</code>で指定されたリビジョン間のソーステキスト行の違いを表示します。</dd>
+ <dd><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters$compare?to=911697&amp;from=911067">https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters$compare?to=911697&amp;from=911067</a></code></dd>
+ <dt><code>$edit</code></dt>
+ <dd>指定された文書の現在のリビジョンを、表示する代わりに編集します。</dd>
+ <dd><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters$edit">https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters$edit</a></code></dd>
+ <dt><code>$history</code></dt>
+ <dd>指定された文書の内容を表示する代わりに、最新の10リビジョンのリビジョン履歴を表示します。履歴全体は、クエリ引数の値に <code>?limit=all</code> を付けることで要求できます。</dd>
+ <dd><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters$history?limit=all">https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters$history?limit=all</a></code></dd>
+ <dt><code>$revision</code></dt>
+ <dd>文書の "<code>/</code>" の後に指定された番号のリビジョンを表示します。</dd>
+ <dd><strong>例:</strong> <code><a href="https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters$revision/915141">https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters$revision/915141</a></code></dd>
+</dl>
+</section>
diff --git a/files/ja/mdn/tools/feeds/index.html b/files/ja/mdn/tools/feeds/index.html
new file mode 100644
index 0000000000..6d30d1a342
--- /dev/null
+++ b/files/ja/mdn/tools/feeds/index.html
@@ -0,0 +1,53 @@
+---
+title: MDN の Feeds API について
+slug: MDN/Tools/Feeds
+tags:
+  - Kuma
+  - MDN Meta
+  - Site-wide
+  - ツール
+  - リファレンス
+translation_of: MDN/Tools/Feeds
+---
+<div>{{MDNSidebar}}</div><p>MDN の wiki では、サイトの更新内容を追跡する為にフィード API が提供されています。この API はまだ作成中であるかもしれませんが、この情報は役立つかもしれません。</p>
+
+<h2 id="Accessing_the_feeds" name="Accessing_the_feeds">フィードへのアクセス</h2>
+
+<p>フィードは次の様な形式の ベース URL から始まります。</p>
+
+<pre class="syntaxbox notranslate">https://developer.mozilla.org/<strong>&lt;locale&gt;</strong>/docs/feeds/<strong>&lt;format&gt;</strong>/</pre>
+
+<p>ベース URL 内の各プレースホルダーはそれぞれ次の意味を持ちます。</p>
+
+<ul>
+ <li><code>&lt;locale&gt;</code> は、標準のロケール文字列の内の一つとします。英語版の内容を取得するのであれば "en-US"、日本語なら "ja" を指定します。URL に <code>?all_locales</code> オプションを追加しない限り、そのロケールの記事のエントリを含むようにフィルターリングされます。</li>
+ <li><code>&lt;format&gt;</code> は、フィードの形式です。「 <code>rss</code> 」、「 <code>atom</code> 」、「 <code>json</code> 」の何れかを選択可能です。</li>
+</ul>
+
+<p><code>json</code> 形式を使用する場合、オプションとして <a href="http://en.wikipedia.org/wiki/JSONP">the JSONP convention</a> で JavaScript としてデータを読み込むための <code>?callback=&lt;callback name&gt;</code> クエリパラメーターが指定可能です。</p>
+
+<h2 id="Available_Feeds" name="Available_Feeds">購読可能フィード</h2>
+
+<dl>
+ <dt><code>all</code></dt>
+ <dd>最近の記事の変更すべてを編集日付順で。新規に作成された記事も含む。すべての変更は各記事のフィードのエントリーに結ばれています。例えば:<a href="https://developer.mozilla.org/ja/docs/feeds/rss/all"> https://developer.mozilla.org/ja/docs/feeds/rss/all</a></dd>
+ <dt><code>revisions</code></dt>
+ <dd>特定の記事のリビジョンを編集日付順で。新規作成も含む。各リビジョンはフィードの別々のエントリーを持ちます。例えば: <a href="https://developer.mozilla.org/ja/docs/feeds/atom/revisions">https://developer.mozilla.org/ja/docs/feeds/atom/revisions</a></dd>
+ <dt><code>tag/<em>&lt;tagname&gt;</em></code></dt>
+ <dd>フィードの指定タグの付いた記事の更新情報のみを編集日付順で取得。例えば:<a href="https://developer.mozilla.org/ja/docs/feeds/json/tag/CSS?callback=loadFeed"> https://developer.mozilla.org/ja/docs/feeds/json/tag/CSS?callback=loadFeed</a></dd>
+ <dt><code>files</code></dt>
+ <dd>最近のファイルのアップロードまたは変更。例えば:<a href="https://developer.mozilla.org/ja/docs/feeds/atom/files"> https://developer.mozilla.org/ja/docs/feeds/atom/files</a></dd>
+ <dt><code>l10n-updates</code></dt>
+ <dd>翻訳ページの最終更新時以降に翻訳の元となる言語の記事が変更された記事のリスト (つまり、他の言語から翻訳された記事で、元の言語の記事が変更された場合)。例えば:<a href="https://developer.mozilla.org/fr/docs/feeds/atom/l10n-updates"> https://developer.mozilla.org/fr/docs/feeds/atom/l10n-updates</a></dd>
+ <dt><code>needs-review[/<em>&lt;reviewtype&gt;</em>]</code></dt>
+ <dd>要レビューとされた記事のリスト。<code>technical</code> 、<code>editorial</code> 、<code>kumascript</code> の何れかに絞って取得する事も可能。
+ <ul>
+  <li><a href="https://developer.mozilla.org/ja/docs/feeds/json/needs-review">https://developer.mozilla.org/ja/docs/feeds/json/needs-review</a></li>
+  <li><a href="https://developer.mozilla.org/fr/docs/feeds/rss/needs-review/technical">https://developer.mozilla.org/fr/docs/feeds/rss/needs-review/technical</a></li>
+  <li><a href="https://developer.mozilla.org/ja/docs/feeds/atom/needs-review/editorial">https://developer.mozilla.org/ja/docs/feeds/atom/needs-review/editorial</a></li>
+  <li><a href="https://developer.mozilla.org/ja/docs/feeds/atom/needs-review/kumascript">https://developer.mozilla.org/ja/docs/feeds/atom/needs-review/kumascrip</a></li>
+ </ul>
+ </dd>
+</dl>
+
+<p> </p>
diff --git a/files/ja/mdn/tools/index.html b/files/ja/mdn/tools/index.html
new file mode 100644
index 0000000000..19f4f4ba50
--- /dev/null
+++ b/files/ja/mdn/tools/index.html
@@ -0,0 +1,14 @@
+---
+title: MDN のツール
+slug: MDN/Tools
+tags:
+  - Landing
+  - MDN Meta
+  - Tools
+translation_of: MDN/Tools
+---
+<div>{{MDNSidebar}}{{IncludeSubnav("/ja/docs/MDN")}}</div>
+
+<p>MDN は数々の機能を提供して、進行を追跡すること、内容を管理すること、最新の変更をサイトへ反映することを容易にしようと努めています。</p>
+
+<p>{{LandingPageListSubpages}}</p>
diff --git a/files/ja/mdn/tools/kumascript/index.html b/files/ja/mdn/tools/kumascript/index.html
new file mode 100644
index 0000000000..2a2a5132d2
--- /dev/null
+++ b/files/ja/mdn/tools/kumascript/index.html
@@ -0,0 +1,471 @@
+---
+title: KumaScript
+slug: MDN/Tools/KumaScript
+tags:
+  - Kuma
+  - KumaScript
+  - MDN Meta
+  - NeedsContent
+  - Site-wide
+  - ガイド
+  - ツール
+translation_of: MDN/Tools/KumaScript
+---
+<div>{{MDNSidebar}}</div>
+
+<p><span class="seoSummary">MDN を構築している <a href="/ja/docs/MDN/Kuma">Kuma</a> プラットフォームにおいて、 wiki 上のコンテンツを自動化するテンプレートシステムは <a class="link-https" href="https://github.com/mdn/kumascript">KumaScript</a> と呼ばれています。 KumaScript はサーバー側 JavaScript で実行されており、 <a class="external" href="https://nodejs.org/en/">Node.js</a> を使用して実装されています。</span>この記事は、 KumaScript の使い方について基本的な情報を提供するものです。</p>
+
+<p>詳細な概要や KumaScript の Q&amp;A については、 MDN 開発チームの <a href="https://vreplay.mozilla.com/replay/showRecordDetails.html?sortBy=date&amp;viewCount=1&amp;currentPage=1&amp;groupBy=combo&amp;roomFilter=&amp;usernameFilter=&amp;searchFilter=&amp;usernameFullFilter=&amp;myManager=-1&amp;adminManager=0&amp;webCast=0&amp;command=&amp;recId=1082&amp;auxMessage=&amp;auxMessage1=&amp;lang=en&amp;langChanged=&amp;tenantFilter=&amp;securityTab=">KumaScript Fireside Chat</a> を見ていてください (ミーティングはビデオで10分で開始します)。 KumaScript は、以前の MDN で使われていたプラットフォームであり、 MindTouch のためのテンプレート言語であった DekiScript を置き換えました。</p>
+
+<h3 id="What_is_KumaScript" name="What_is_KumaScript">KumaScript とは</h3>
+
+<ul>
+ <li>文書間で繰り返し現れるコンテンツの再利用やローカライズを行う手段 (互換性のラベル、セクションナビゲーション、警告バナーなど)。</li>
+ <li>他の文書からコンテンツを引用して文書を構築する手段。</li>
+ <li>他のウェブサイトやサービス (Bugzilla など) からコンテンツを取得して含める手段</li>
+</ul>
+
+<h3 id="What_KumaScript_is_not" name="What_KumaScript_is_not">KumaScript にはないもの</h3>
+
+<ul>
+ <li>KumaScript は、フォーム送信を受け付けるような対話型スクリプトには対応していません。</li>
+ <li>KumaScript には、データベースやファイルにアクセスしたり、情報を永続的に格納したりする仕組みはありません。</li>
+ <li>KumaScript は、ログイン中のユーザー情報に基づくサイトのパーソナライズには対応していません。</li>
+ <li>KumaScript は、ユーザー情報にアクセスすることはできず、コンテンツとページのメタデータにのみアクセス可能です。</li>
+</ul>
+
+<h2 id="Basics" name="Basics">基本</h2>
+
+<p>KumaScript は MDN で<a href="https://github.com/mde/ejs">埋め込み JavaScript テンプレート</a>に利用されています。これらのテンプレートは MDN の筆者ならば誰でも文書内で、マクロを使用して呼び出すことができます。</p>
+
+<p>KumaScript のスクリプトは<em>テンプレート</em>であり、それぞれのテンプレートは Github の <a href="https://github.com/mdn/kumascript/tree/master/macros">KumaScript リポジトリの macros ディレクトリ</a>に格納されているファイルです。テンプレートは以下のようなものです。</p>
+
+<pre class="brush: js no-line-numbers notranslate">&lt;% for (var i = 0; i &lt; $0; i++) { %&gt;
+  Hello #&lt;%= i %&gt;
+&lt;% } %&gt;</pre>
+
+<p>テンプレートは wiki コンテンツのどこからでも<em>マクロ</em>で呼び出すことができます。マクロは次のようなものです。</p>
+
+<pre class="brush: none no-line-numbers notranslate">\{{hello(3)}}</pre>
+
+<p>マクロの出力は以下のようなものです。</p>
+
+<pre class="brush: html no-line-numbers notranslate">Hello #0
+Hello #1
+Hello #2</pre>
+
+<h3 id="Macro_syntax" name="Macro_syntax">マクロの構文</h3>
+
+<p>KumaScript のテンプレートは、以下のようにドキュメントのコンテンツの中でマクロとして呼び出すことができます。</p>
+
+<pre class="brush: none no-line-numbers notranslate">\{{templateName("arg0", "arg1", ..., "argN")}}</pre>
+
+<p>マクロの構文は、以下の規則に基づいて構成されます。</p>
+
+<ul>
+ <li>マクロのコードは <code>\{{</code> より始まり、 <code>\}}</code> で終わります。</li>
+ <li>マクロの最初の部分はテンプレートの名前です。この名前の小文字の値は、 <a href="https://github.com/mdn/kumascript/tree/master/macros">KumaScript の macros ディレクトリ</a>以下のファイル名の小文字の値に一致します。</li>
+ <li>テンプレートは引数を受け付けます。括弧内にコンマ区切りで複数の引数を記述する事ができます。</li>
+ <li>数値以外の引数は引用符で囲む必要があります。数値は囲む必要はありません。</li>
+</ul>
+
+<h4 id="Using_JSON_as_a_macro_parameter" name="Using_JSON_as_a_macro_parameter">マクロの引数に JSON を用いる</h4>
+
+<p>半実験的な機能 (動作保証なし) として、以下のように引数が一つだけの場合は、引数に JSON オブジェクトを指定できます。</p>
+
+<pre class="brush: none no-line-numbers notranslate">\{{templateName(<code class="language-json">{ "Alpha": "one", "Beta": ["a", "b", "c"], "Foo": "https:\/\/mozilla.org\/" }</code>)}}</pre>
+
+<p>このマクロからのデータは、テンプレートコード内で <code class="language-javascript">$0</code> 引数のオブジェクトとして利用できます (例えば、 <code>$0.Alpha</code>, <code>$0.Beta</code>, <code>$0.Foo</code>)。これにより、引数の単純なリストで実現することが難しい又は不可能な複雑なデータ構造を、マクロ引数で表すことができます。</p>
+
+<p>なお、この引数の形はとても繊細です。 — 正確に <a href="http://json.org/" title="http://json.org/">JSON の構文</a>に従っていなければならず、間違いを犯しやすいエスケープ文字の要件が求められます (例えば、すべてのスラッシュをエスケープするなど)。疑わしい場合は、 <a href="http://jsonlint.com/" title="http://jsonlint.com/">JSON をバリデーターに掛けてみてください</a>。</p>
+
+<h4 id="How_to_write_in_text" name="How_to_write_in_text">「\{{」を記述する方法</h4>
+
+<p>"<code>\{{</code>" という文字の並びはマクロの開始を示すため、実際にページ内で "<code>\{{</code>" および "<code>}}</code>" を使用したい場合は問題になります。おそらく <code>DocumentParsingError</code> メッセージが発生するでしょう。</p>
+
+<p>この場合、 <code>\\{</code> のように最初の中括弧をバックスラッシュでエスケープすることができます。</p>
+
+<h3 id="Template_Syntax" name="Template_Syntax">テンプレートの構文</h3>
+
+<p>それぞれの KumaScript テンプレートは、 <a href="https://github.com/mdn/kumascript/tree/master/macros">KumaScript の macros ディレクトリ</a>に格納されているファイルです。これらのファイルは GitHub 上の何らかのオープンソースプロジェクトのファイルとして作成したり編集したりします (詳しくは <a href="https://github.com/mdn/kumascript">the KumaScript README</a> をご覧ください)。</p>
+
+<p>KumaScript テンプレートは、いくつかの簡単な規則で、<a href="https://ejs.co">組込み JavaScript テンプレートエンジン</a>によって処理されます。</p>
+
+<ul>
+ <li>テンプレート内では、マクロから渡された引数は <code>$0</code>, <code>$1</code>, <code>$2</code>, などのような変数として利用できます。引数のリスト全体は、テンプレート内で変数 <code>arguments</code> として利用できます。</li>
+ <li>多くのテキストは出力として扱われ、出力ストリームに入ります。</li>
+ <li>JavaScript の変数や式は、以下のブロックを用いて出力ストリームに挿入可能です。
+  <ul>
+   <li><code class="language-ejs">&lt;%= expr %&gt;</code> — 出力される前に HTML エスケープされた JavaScript の式の値 (<code>&lt;</code> および <code>&gt;</code> は <code>&amp;lt;</code> および <code>&amp;gt;</code> となる)</li>
+   <li><code class="language-ejs">&lt;%- expr %&gt;</code> — エスケープされない JavaScript の式の値 (マークアップを動的に構築したり、マークアップを含むことができる他のテンプレートの結果に使用してください)</li>
+   <li>このブロック直下にセミコロンを含めるとエラーとなる。</li>
+  </ul>
+ </li>
+ <li><code class="language-ejs">&lt;%</code> と <code>%&gt;</code> の間は JavaScript として解釈される。すなわち、ループ、条件文、関数などを含めることが可能。</li>
+ <li><code class="language-ejs">&lt;% %&gt;</code> ブロック内は出力ストリームに含まれない。ブロック内の変数などをブロック外で使用する場合は、以下のように <code>&lt;%= %&gt;</code> を用いる。
+  <pre class="brush: js notranslate">&lt;% for (var i = 0; i &lt; $0; i++) { %&gt;
+  Hello #&lt;%= i %&gt;
+&lt;% } %&gt;</pre>
+
+  <p>Note how the JavaScript code is contained in <code class="language-ejs">&lt;% ... %&gt;</code>, and output happens in the space between <code class="language-ejs">%&gt; ... &lt;%</code>. The <code>for</code> loop in JS can begin with one <code class="language-ejs">&lt;% %&gt;</code> block, transition to output mode, and finish up in a second <code class="language-ejs">&lt;% %&gt;</code> JS block.</p>
+ </li>
+ <li>EJS の構文の詳細については、<a href="https://ejs.co">上流モジュールのドキュメント</a>でご確認ください。</li>
+</ul>
+
+<h3 id="Tips">Tips</h3>
+
+<p>マクロのリストと、マクロが MDN でどの様に使用されているか<a href="/ja/dashboards/macros">マクロダッシュボード</a>で確認することができます。</p>
+
+<h2 id="Advanced_Features" name="Advanced_Features">より高度な機能</h2>
+
+<p>KumaScript には前章までに紹介したもの以外に、より高度な機能もあります。</p>
+
+<h3 id="Environment_variables" name="Environment_variables">環境変数</h3>
+
+<p>When the wiki makes a call to the KumaScript service, it passes along some context on the current document that KumaScript makes available to templates as variables:</p>
+
+<dl>
+ <dt><code>env.path</code></dt>
+ <dd>現在の wiki 文書へのパス</dd>
+ <dt><code>env.url</code></dt>
+ <dd>現在の wiki 文書への 絶対 URL</dd>
+ <dt><code>env.id</code></dt>
+ <dd>現在の wiki 文書のユニーク ID</dd>
+ <dt><code>env.files</code></dt>
+ <dd>An array of the files attached to the current wiki document; each object in the array is as described under {{ anch("File objects") }} below</dd>
+ <dt><code>env.review_tags</code></dt>
+ <dd>記事のレビュータグ配列 ("technical"、 "editorial"など。)</dd>
+ <dt><code>env.locale</code></dt>
+ <dd>現在の wiki 文書のロケール</dd>
+ <dt><code>env.title</code></dt>
+ <dd>現在の wiki 文書のタイトル</dd>
+ <dt><code>env.slug</code></dt>
+ <dd>現在の wiki 文書の URL スラッグ</dd>
+ <dt><code>env.tags</code></dt>
+ <dd>現在の wiki 文書に付与されたタグの名称のリスト</dd>
+ <dt><code>env.modified</code></dt>
+ <dd>現在の wiki 文書の最終更新日を示すタイムスタンプ</dd>
+ <dt><code>env.cache_control</code></dt>
+ <dd><code>Cache-Control</code> header sent in the request for the current wiki document, useful in deciding whether to invalidate caches</dd>
+</dl>
+
+<h4 id="File_objects" name="File_objects">File オブジェクト</h4>
+
+<p>個々の file オブジェクトは以下の様なフィールドを持ちます。</p>
+
+<dl>
+ <dt><code>title</code></dt>
+ <dd>添付ファイルのタイトル</dd>
+ <dt><code>description</code></dt>
+ <dd>現行版の添付ファイルに関する説明</dd>
+ <dt><code>filename</code></dt>
+ <dd>添付ファイルのファイル名</dd>
+ <dt><code>size</code></dt>
+ <dd>添付ファイルのサイズ（※単位 = bytes )</dd>
+ <dt><code>author</code></dt>
+ <dd>添付ファイルをアップロードした人のユーザ名</dd>
+ <dt><code>mime</code></dt>
+ <dd>添付ファイルの MIME type</dd>
+ <dt><code>url</code></dt>
+ <dd>添付ファイルの URL</dd>
+</dl>
+
+<h4 id="Working_with_tag_lists" name="Working_with_tag_lists">タグリストでの作業</h4>
+
+<p>The <code>env.tags</code> and <code>env.review_tags</code> variables return arrays of tags. You can work with these in many ways, of course, but here are a couple of suggestions.</p>
+
+<h5 id="Looking_to_see_if_a_specific_tag_is_set">Looking to see if a specific tag is set</h5>
+
+<p>You can look to see if a specific tag exists on a page like this:</p>
+
+<pre class="brush: js notranslate">if (env.tags.indexOf("tag") != −1) {
+  // The page has the tag "tag"
+}
+</pre>
+
+<h5 id="Iterating_over_all_the_tags_on_a_page">Iterating over all the tags on a page</h5>
+
+<p>You can also iterate over all the tags on a page, like this:</p>
+
+<pre class="brush: js notranslate">env.tag.forEach(function(tag) {
+  // do whatever you need to do, such as:
+  if (tag.indexOf("a") == 0) {
+    // this tag starts with "a" - woohoo!
+  }
+});</pre>
+
+<h3 id="APIs_and_Modules" name="APIs_and_Modules">API とモジュール</h3>
+
+<p>KumaScript offers some built-in methods and APIs for KumaScript macros. Macros can also use <code>module.exports</code> to export new API methods.</p>
+
+<p>KumaScript では、ビルトインのユーティリティ API だけでなく、wiki 文書として編集可能なモジュール内で新規の API を定義する機能も提供されています。</p>
+
+<h4 id="Built-in_methods" name="Built-in_methods">ビルトインメソッド</h4>
+
+<p>This manually-maintained documentation is likely to fall out of date with the code. With that in mind, <a class="link-https" href="https://github.com/mdn/kumascript/blob/master/lib/kumascript/api.js#L175" title="https://github.com/mdn/kumascript/blob/master/lib/kumascript/api.js#L208">you can always check out the latest state of built-in APIs in the KumaScript source</a>. But here is a selection of useful methods exposed to templates:</p>
+
+<dl>
+ <dt><code class="language-javascript">md5(string)</code></dt>
+ <dd>与えられた文字列の MD5 16 進ダイジェストを返す</dd>
+ <dt><code class="language-javascript">template("name", ["arg0", "arg1", ..., "argN"])</code></dt>
+ <dd>
+ <p>Executes and returns the result of the named template with the given list of parameters.</p>
+
+ <p>Example: <code class="language-javascript">&lt;%- template("warning", ["foo", "bar", "baz"]) %&gt;</code>.</p>
+
+ <p>Example using the <code>DOMxRef</code> macro: <code class="language-javascript">&lt;%- template("DOMxRef", ["Event.bubbles", "bubbles"]) %&gt;</code>.</p>
+
+ <p>This is a JavaScript function. So, if one of the parameters is an arg variable like $2, do not put it in quotes. Like this: <code class="language-javascript">&lt;%- template("warning", [$1, $2, "baz"]) %&gt;</code>. If you need to call another template from within a block of code, do not use <code>&lt;%</code> ... <code>%&gt;</code>. Example: <code class="language-javascript">myvar = "&lt;li&gt;" + template("LXRSearch", ["ident", "i", $1]) + "&lt;/li&gt;";</code></p>
+ </dd>
+ <dt><code class="language-javascript">require(name)</code></dt>
+ <dd>Loads another template as a module; any output is ignored. Anything assigned to <code class="language-javascript">module.exports</code> in the template is returned.</dd>
+ <dd>Used in templates like so: <code class="language-javascript">&lt;% const my_module = require('MyModule'); %&gt;</code>.</dd>
+ <dt><code class="language-javascript">cacheFn(key, timeout, function_to_cache)</code></dt>
+ <dd>Using the given key and cache entry lifetime, cache the results of the given function. Honors the value of <code>env.cache_control</code> to invalidate cache on <code>no-cache</code>, which can be sent by a logged-in user hitting shift-refresh.</dd>
+ <dt><code class="language-javascript">request</code></dt>
+ <dd>Access to <a class="link-https" href="https://github.com/mikeal/request" title="https://github.com/mikeal/request"><code>mikeal/request</code></a>, a library for making HTTP requests. Using this module in KumaScript templates is not yet very friendly, so you may want to wrap usage in module APIs that simplify things.</dd>
+ <dt><code class="language-javascript">log.debug(string)</code></dt>
+ <dd>Outputs a debug message into the script log on the page (i.e. the big red box that usually displays errors).</dd>
+</dl>
+
+<h4 id="Built-in_API_modules" name="Built-in_API_modules">組込み API モジュール</h4>
+
+<p>There are a set of built in API that are automatically loaded and made available to every template by the environment script.</p>
+
+<p>For the most part, these attempt to provide stand-ins for legacy DekiScript features to ease template migration. But, going forward, these can be used to share common variables and methods between templates:</p>
+
+<ul>
+ <li><code>kuma.*</code> - <a href="https://github.com/mdn/kumascript/blob/master/src/api/kuma.js">Kuma</a></li>
+ <li><code>MDN.*</code> - <a href="https://github.com/mdn/kumascript/blob/master/src/api/mdn.js">MDN:Common</a></li>
+ <li><code>page.*</code> - <a href="https://github.com/mdn/kumascript/blob/master/src/api/page.js">DekiScript:Page</a></li>
+ <li><code>string.*</code> - <a href="https://github.com/mdn/kumascript/blob/master/src/api/string.js">DekiScript:String</a></li>
+ <li><code>uri.*</code> - <a class="link-https" href="https://github.com/mdn/kumascript/blob/master/src/api/uri.js">DekiScript:Uri</a></li>
+ <li><code>web.*</code> - <a class="link-https" href="https://github.com/mdn/kumascript/blob/master/src/api/web.js">DekiScript:Web</a></li>
+ <li><code>wiki.*</code> - <a class="link-https" href="https://github.com/mdn/kumascript/blob/master/src/api/wiki.js">DekiScript:Wiki</a></li>
+</ul>
+
+<p>You can see the most up to date list of methods under <code>kuma</code> from <a href="https://github.com/mdn/kumascript/blob/master/src/api/kuma.js">the KumaScript source code</a>, but here are a few:</p>
+
+<dl>
+ <dt><code class="language-javascript">kuma.inspect(object)</code></dt>
+ <dd>Renders any JS object as a string, handy for use with <code>log.debug()</code>. See also: <a href="https://nodejs.org/api/util.html#util_util_inspect_object_options">node.js <code class="language-javascript">util.inspect()</code></a>.</dd>
+ <dt><code class="language-javascript">kuma.htmlEscape(string)</code></dt>
+ <dd>Escapes the characters <code>&amp;, &lt;, &gt;, "</code> to <code>&amp;amp, &amp;lt;, &amp;gt;, &amp;quot;</code>, respectively.</dd>
+ <dt><code class="language-javascript">kuma.url</code></dt>
+ <dd>See also: <a href="http://nodejs.org/api/url.html">node.js <code>url</code> module</a>.</dd>
+ <dt><code class="language-javascript">kuma.fetchFeed(url)</code></dt>
+ <dd>Fetch an RSS feed and parse it into a JS object. See also: <a href="https://github.com/mdn/kumascript/blob/master/macros/InsertFeedLinkList.ejs"><code>InsertFeedLinkList</code></a></dd>
+</dl>
+
+<h4 id="Creating_modules" name="Creating_modules">モジュールの作成</h4>
+
+<p>Using the built-in <code>require()</code> method, you can load a template as a module to share common variables and methods between templates. A module can be defined in a template like this:</p>
+
+<pre class="brush: js notranslate">&lt;%
+module.exports = {
+    add: function (a, b) {
+        return a + b;
+    }
+}
+%&gt;</pre>
+
+<p>Assuming this template is saved under <a href="https://github.com/mdn/kumascript/tree/master/macros">https://github.com/mdn/kumascript/tree/master/macros</a> as <code>MathLib.ejs</code>, you can use it in another template like so:</p>
+
+<pre class="brush: js notranslate">&lt;%
+var math_lib = require("MathLib");
+%&gt;
+The result of 2 + 2 = &lt;%= math_lib.add(2, 2) %&gt;</pre>
+
+<p>このテンプレートの出力は以下の様になるでしょう。</p>
+
+<pre class="brush: html no-line-numbers notranslate">The result of 2 + 2 = 4</pre>
+
+<h2 id="Tips_and_caveats">Tips and caveats</h2>
+
+<h3 id="Debugging" name="Debugging">デバッグ</h3>
+
+<p>A useful tip when debugging. You can use the <code>log.debug()</code> method to output text to the scripting messages area at the top of the page that's running your template. Note that you need to be really sure to remove these when you're done debugging, as they're visible to all users! To use it, just do something like this:</p>
+
+<pre class="brush: js no-line-numbers notranslate">&lt;%- log.debug("Some text goes here"); %&gt;</pre>
+
+<p>You can, of course, create more complex output using script code if it's helpful.</p>
+
+<h3 id="Caching" name="Caching">キャッシュ</h3>
+
+<p>KumaScript templates are heavily cached to improve performance. For the most part, this works great to serve up content that doesn't change very often. But, as a logged-in user, you have two options to force a page to be regenerated, in case you notice issues with scripting:</p>
+
+<ul>
+ <li>Hit Refresh in your browser. This causes KumaScript to invalidate its cache for the content on the current page by issuing a request with a <code>Cache-Control: max-age=0</code> header.</li>
+ <li>Hit Shift-Refresh in your browser. This causes KumaScript to invalidate cache for the current page, as well as for any templates or content used by the current page by issuing a request with a <code>Cache-Control: no-cache</code> header.</li>
+</ul>
+
+<h3 id="Using_search_keywords_to_open_template_pages" name="Using_search_keywords_to_open_template_pages">検索キーワードを使用してテンプレートページを開く</h3>
+
+<p>When using templates, it's common to open the template's code in a browser window to review the comments at the top, which are used to document the template, its parameters, and how to use it properly. To quickly access templates, you can create a Firefox <a href="http://kb.mozillazine.org/Using_keyword_searches">search keyword</a>, which gives you a shortcut you can type in the URL box to get to a template more easily.</p>
+
+<p>To create a search keyword, open the bookmarks window by choosing "Show all bookmarks" in the Bookmarks menu, or by pressing <kbd>Control+Shift+B</kbd> (<kbd>Command+Shift+B</kbd> on Mac). Then from the utility ("Gear") menu in the Library window that appears, choose "New Bookmark...".</p>
+
+<p>This causes the bookmark editing dialog to appear. Fill that out as follows:</p>
+
+<dl>
+ <dt>Name</dt>
+ <dd>A suitable name for your search keyword; "Open MDN Template" is a good one.</dd>
+ <dt>Location</dt>
+ <dd><code>https://github.com/mdn/kumascript/blob/master/macros/%s</code></dd>
+ <dt>Tags{{Optional_Inline}}</dt>
+ <dd>A list of tags used to organize your bookmarks; these are entirely optional and what (if any) tags you use is up to you.</dd>
+ <dt>Keyword</dt>
+ <dd>The shortcut text you wish to use to access the template. Ideally, this should be something short and quick to type, such as simply "t" or "mdnt".</dd>
+ <dt>Description{{Optional_Inline}}</dt>
+ <dd>A suitable description explaining what the search keyword does.</dd>
+</dl>
+
+<p>The resulting dialog looks something like this:</p>
+
+<p><img alt="" src="https://mdn.mozillademos.org/files/14432/Screen%20Shot%202016-11-28%20at%203.08.39%20PM.png" style="height: 289px; width: 500px;"></p>
+
+<p>Then click the "Add" button to save your new search keyword. From then on, typing your keyword, then a space, then the name of a macro will open that macro in your current tab. So if you used "t" as the keyword, typing <kbd>t ListSubpages</kbd> will show you the page at {{TemplateLink("ListSubpages")}}.</p>
+
+<h2 id="Cookbook" name="Cookbook">クックブック</h2>
+
+<p>This section will list examples of common patterns for templates used on MDN, including samples of legacy DekiScript templates and their new KumaScript equivalents.</p>
+
+<h3 id="Force_templates_used_on_a_page_to_be_reloaded">Force templates used on a page to be reloaded</h3>
+
+<p>It bears repeating: To force templates used on a page to be reloaded after editing, hit Shift-Reload. Just using Reload by itself will cause the page contents to be regenerated, but using cached templates and included content. A Shift-Reload is necessary to invalidate caches beyond just the content of the page itself.</p>
+
+<h3 id="Recovering_from_.22Unknown_Error.22" name="Recovering_from_.22Unknown_Error.22">「不明なエラー」からの回復</h3>
+
+<p>ページ読込時に、時折、このようなスクリプティング・メッセージが表示される事があります。</p>
+
+<pre class="brush: none no-line-numbers notranslate">Kumascript service failed unexpectedly: &lt;class 'httplib.BadStatusLine'&gt;</pre>
+
+<p>これはおそらく、 KumaScript サービスの一時的な障害です。ページの再読込みでこの問題が解決する事があります。これで問題が解決しない場合はスーパーリロード（<kbd><kbd>shift</kbd> + <kbd>F5</kbd></kbd>）を試してみて下さい。これらの試みの後もエラーが解消されない場合は、<a class="link-https" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=mozilla.org&amp;format=itrequest">file an IT bug</a> for Mozilla Developer Network to ask for an investigation.</p>
+
+<h3 id="Broken_wiki.languages_マクロ">Broken wiki.languages() マクロ</h3>
+
+<p>幾つかのページで、以下の様なスクリプトエラーメッセージを見かける場合があるでしょう。</p>
+
+<pre class="brush: none; no-line-numbers notranslate">Syntax error at line 436, column 461: Expected valid JSON object as the parameter of the preceding macro but...</pre>
+
+<p>その様なページを編集状態にした場合、ページ下部に以下の様なマクロが見つかるかもしれません。</p>
+
+<pre class="brush: none no-line-numbers notranslate">\{{ wiki.languages(<code class="language-json">{ "zh-tw": "zh_tw/Core_JavaScript_1.5_教學/JavaScript_概要", ... }</code>) }}</pre>
+
+<p>To fix the problem, just delete the macro. Or, replace the curly braces on either side with HTML comments <code>&lt;!-- --&gt;</code> to preserve the information, like so:</p>
+
+<pre class="brush: html no-line-numbers notranslate">&lt;!-- wiki.languages({ "zh-tw": "zh_tw/Core_JavaScript_1.5_教學/JavaScript_概要", ... }) --&gt;</pre>
+
+<p>Because Kuma supports localization differently, these macros aren't actually needed any more. But, they've been left intact in case we need to revisit the relationships between localized pages. Unfortunately, it seems like migration has failed to convert some of them properly.</p>
+
+<h3 id="Finding_the_Current_Pages_Language" name="Finding_the_Current_Page's_Language">ページの言語の取得</h3>
+
+<p>In KumaScript, the locale of the current document is exposed as an environment variable:</p>
+
+<pre class="brush: js no-line-numbers notranslate">const lang = env.locale;</pre>
+
+<p>The <code>env.locale</code> variable should be reliable and defined for every document.</p>
+
+<h3 id="Reading_the_contents_of_a_page_attachment">Reading the contents of a page attachment</h3>
+
+<p>You can read the contents of an attached file by using the <code>mdn.getFileContent()</code> function, like this:</p>
+
+<pre class="brush: js notranslate">&lt;%
+  let contents = mdn.getFileContent(fileUrl);
+  // ... do stuff with the contents ...
+%&gt;
+</pre>
+
+<p>or</p>
+
+<pre class="brush: js no-line-numbers notranslate">&lt;%- mdn.getFileContent(fileObject); %&gt;
+</pre>
+
+<p>In other words, you may specify either the URL of the file to read or as a file object. The file objects for a page can be accessed through the array <code>env.files</code>. So, for example, to embed the contents of the first file attached to the article, you can do this:</p>
+
+<pre class="brush: js no-line-numbers notranslate">&lt;%- mdn.getFileContent(env.files[0]); %&gt;
+</pre>
+
+<div class="blockIndicator note">
+<p><strong>Note:</strong> You probably don't want to try to embed the contents of a non-text file this way, as the raw contents would be injected as text. This is meant to let you access the contents of text attachments.</p>
+</div>
+
+<p>If the file isn't found, an empty string is returned. There is currently no way to tell the difference between an empty file and a nonexistent one. But if you're putting empty files on the wiki, you're doing it wrong.</p>
+
+<h3 id="Localizing_template_content" name="Localizing_template_content">テンプレートのローカライズ</h3>
+
+<p>Templates are not translated like wiki pages, rather any single template might be used for any number of locales.</p>
+
+<p>So the main way to output content tailored to the current document locale is to pivot on the value of <code>env.locale</code>. There are many ways to do this, but a few patterns are common in the conversion of legacy DekiScript templates:</p>
+
+<h4 id="Ifelse_blocks_in_KumaScript" name="Ifelse_blocks_in_KumaScript">If/else ブロックを用いる例</h4>
+
+<p>The KumaScript equivalent of this can be achieved with simple if/else blocks, like so:</p>
+
+<pre class="brush: js notranslate">&lt;% if ("fr" == env.locale) { %&gt;
+&lt;%- template("CSSRef") %&gt; « &lt;a href="/fr/docs/Référence_CSS/Extensions_Mozilla"&gt;Référence CSS: Extensions Mozilla&lt;/a&gt;
+&lt;% } else if ("ja" == env.locale) { %&gt;
+&lt;%- template("CSSRef") %&gt; « &lt;a href="/ja/docs/CSS_Reference/Mozilla_Extensions"&gt;CSS リファレンス: Mozilla 拡張仕様&lt;/a&gt;
+&lt;% } else if ("pl" == env.locale) { %&gt;
+&lt;%- template("CSSRef") %&gt; « &lt;a href="/pl/docs/Dokumentacja_CSS/Rozszerzenia_Mozilli"&gt;Dokumentacja CSS: Rozszerzenia Mozilli&lt;/a&gt;
+&lt;% } else if ("de" == env.locale) { %&gt;
+&lt;%- template("CSSRef") %&gt; « &lt;a href="/de/docs/CSS_Referenz/Mozilla_CSS_Erweiterungen"&gt;CSS Referenz: Mozilla Erweiterungen&lt;/a&gt;
+&lt;% } else { %&gt;
+&lt;%- template("CSSRef") %&gt; « &lt;a href="/en-US/docs/CSS_Reference/Mozilla_Extensions"&gt;CSS Reference: Mozilla Extensions&lt;/a&gt;
+&lt;% } %&gt;</pre>
+
+<p>Depending on what text editor is your favorite, you may be able to copy &amp; paste from the browser-based editor and attack this pattern with a series of search/replace regexes to get you most of the way there.</p>
+
+<p>My favorite editor is MacVim, and a series of regexes like this does the bulk of the work with just a little manual clean up following:</p>
+
+<pre class="brush: none notranslate">%s#&lt;span#^M&lt;span#g
+%s#&lt;span lang="\(.*\)" .*&gt;#&lt;% } else if ("\1" == env.locale) { %&gt;#g
+%s#&lt;span class="script"&gt;template.CSSxRef(#&lt;%- template("CSSxRef", [#
+%s#)&lt;/span&gt; &lt;/span&gt;#]) %&gt;
+</pre>
+
+<p>Your mileage may vary, and patterns change slightly from template to template. That's why the migration script was unable to just handle this automatically, after all.</p>
+
+<h4 id="String_variables_and_switch" name="String_variables_and_switch">文字列値と switch</h4>
+
+<p>Rather than switch between full chunks of markup, you can define a set of strings, switch them based on locale, and then use them to fill in placeholders in a single chunk of markup:</p>
+
+<pre class="brush: js notranslate">&lt;%
+var s_title = 'Firefox for Developers';
+switch (env.locale) {
+    case 'de':
+        s_title = "Firefox für Entwickler";
+        break;
+    case 'fr':
+        s_title = "Firefox pour les développeurs";
+        break;
+    case 'es':
+        s_title = "Firefox para desarrolladores";
+        break;
+};
+%&gt;
+&lt;span class="title"&gt;&lt;%= s_title %&gt;&lt;/span&gt;</pre>
+
+<h4 id="Use_mdn.localString">Use <code class="language-javascript">mdn.localString()</code></h4>
+
+<p>A recent addition to the <code>MDN:Common</code> module is <code class="language-javascript">mdn.localString()</code>, used like this:</p>
+
+<pre class="brush: js notranslate">&lt;%
+var s_title = mdn.localString({
+  "en-US": "Firefox for Developers",
+  "de": "Firefox für Entwickler",
+  "es": "Firefox para desarrolladores"
+});
+%&gt;
+&lt;span class="title"&gt;&lt;%= s_title %&gt;&lt;/span&gt;</pre>
+
+<p>これは switch 文による分岐よりも簡潔であり、テンプレート内で一種類や二種類程度の文字列のみの翻訳が必要なケースなどでは、switch 文より良い選択となるかもしれません。ロケールにより多くの文字列を切り替える必要がある場合（※例: <a href="/ja/docs/Template:CSSRef" title="Template:CSSRef | MDN">Template:CSSRef | MDN</a>）は、switch 文 を用いた方が良いでしょう。 if 文を用いた場合が良い場合もあります。適切なものを選択して御利用下さい。</p>
+
+<p>オブジェクトに適切なロケールが無い場合、 "en-US" の値が初期値として使用されます。</p>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+
+<ul>
+ <li><a href="https://github.com/mdn/kumascript">KumaScript ソースコード</a></li>
+ <li><a href="https://wiki.mozilla.org/MDN/Kuma">Kuma wiki</a></li>
+</ul>
diff --git a/files/ja/mdn/tools/kumascript/troubleshooting/index.html b/files/ja/mdn/tools/kumascript/troubleshooting/index.html
new file mode 100644
index 0000000000..c7c6a3a8a3
--- /dev/null
+++ b/files/ja/mdn/tools/kumascript/troubleshooting/index.html
@@ -0,0 +1,65 @@
+---
+title: KumaScript エラーのトラブルシューティング
+slug: MDN/Tools/KumaScript/Troubleshooting
+tags:
+  - KumaScript
+  - MDN Meta
+  - Tools
+  - エラー
+  - ガイド
+translation_of: MDN/Tools/KumaScript/Troubleshooting
+---
+<div>{{MDNSidebar}}</div>
+
+<div class="summary">
+<p>ページに出てくる <a href="/ja/docs/MDN/Contribute/Tools/KumaScript">KumaScript</a> エラーは読み手にとって不快なもので、大きく赤い恐ろしげなボックスですが、幸運なことに MDN アカウントを持つユーザーは誰でも、ドキュメントを直してこうしたエラーを修正できます。ページがエラーを起こしたとき、<a href="/ja/docs/with-errors">エラーのあるドキュメント</a>リストに追加されます。サイト編集者は通常このリストを検査して、エラーを発見、修正します。この記事では4種類の KumaScript エラーと、修正するための対策について詳しく見ます。</p>
+</div>
+
+<h2 id="DocumentParsingError">DocumentParsingError</h2>
+
+<p><code>DocumentParsingError</code> のエラーは KumaScript がドキュメント自体を理解できないときに表示されます。最もよくある原因は <a href="/en-US/docs/MDN/Contribute/Content/Macros">macro</a> 内の文法エラーです。</p>
+
+<p>以下をチェックします:</p>
+
+<dl>
+ <dt>マクロ呼出しのつもりではない場合に中括弧を使った。</dt>
+ <dd>If you need to write  \{ in a document without calling a macro you can escape it with a \ like this: <code>\\{</code></dd>
+ <dt>マクロパラメーターに特殊な文字を使った。</dt>
+ <dd>If you need to use a " or a \  inside of a macro parameter they can be escaped with a \ like this: <code>\\</code> or <code>\"</code></dd>
+ <dt>マクロパラメーター間にカンマがない。</dt>
+ <dd>Macro parameters need to be delimited by a comma (,) but not at the end of the list of parameters; for example <code>\{\{anch("top", "Back to top")}}</code>.</dd>
+ <dt>マクロ呼び出し内に HTML タグがある</dt>
+ <dd>If you apply styling to a macro, it will often break because, for example, a <code>&lt;/code&gt;</code> tag may have appeared inside the macro code in the source code. Check the source view to see what's there, and remove any unnecessary styling.</dd>
+</dl>
+
+<ul>
+</ul>
+
+<h2 id="TemplateLoadingError">TemplateLoadingError</h2>
+
+<p><code>TemplateLoadingError</code> のエラーは KumaScript がページにどの <a href="/en-US/docs/MDN/Contribute/Content/Macros">macro</a> を取り込むか探せないときに表示されます。</p>
+
+<p>以下をチェックします:</p>
+
+<dl>
+ <dt>マクロ名を誤ったり、マクロがリネームされた。</dt>
+ <dd><a href="https://github.com/mdn/kumascript/tree/master/macros">GitHub repo</a> で既知のマクロのリストを確認できます。</dd>
+</dl>
+
+<div class="note">
+<p><strong>Tip:</strong> You can make it quick and easy to jump to a specific macro by adding a <a href="http://kb.mozillazine.org/Using_keyword_searches">search keyword</a> to Firefox. See {{SectionOnPage("/en-US/docs/MDN/Contribute/Tools/KumaScript", "Using search keywords to open template pages")}} for a step-by-step guide to creating the search keyword for this.</p>
+</div>
+
+<h2 id="TemplateExecutionError">TemplateExecutionError</h2>
+
+<p><code>TemplateExecutionError</code> のエラーは KumaScript が macro 内のエラーに遭遇したときに表示されます。このエラーは管理者のみが修正できて、バグとして報告が必要となります。</p>
+
+<p>エラーを報告する前に、これが修正済みでないことを確認します。KumaScript を強制的にページのフレッシュコピーを読み込ませることでできます。これには <kbd>Shift</kbd>  を押しっぱなしでページ再読み込みします (Windows/Linux では <kbd>Shift</kbd> + <kbd>Ctrl</kbd> + <kbd>R</kbd> 、Mac では <kbd>Shift</kbd> + <kbd>Cmd</kbd> + <kbd>R</kbd> )。</p>
+
+<p>エラーが続く場合、ページの URL とエラーのテキストをつけて<a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla_Developer_Network&amp;component=General#h=detail|bug">bug 報告します</a>。</p>
+
+<h2 id="Error_Unknown">Error &amp; Unknown</h2>
+
+<p>これは、エラーがこれ以外の種類にない場合のカテゴリーです。</p>
+
+<p>修正をチェックして、<a href="#TemplateExecutionError">TemplateExecutionError</a> に記述されるようなしつこいバグとして報告します。</p>
diff --git a/files/ja/mdn/tools/page_deletion/index.html b/files/ja/mdn/tools/page_deletion/index.html
new file mode 100644
index 0000000000..e6ebdd1910
--- /dev/null
+++ b/files/ja/mdn/tools/page_deletion/index.html
@@ -0,0 +1,61 @@
+---
+title: ページの削除
+slug: MDN/Tools/Page_deletion
+tags:
+  - Guide
+  - MDN
+  - MDN Project
+  - Page-level
+translation_of: MDN/Tools/Page_deletion
+---
+<div>{{MDNSidebar}}</div>
+
+<p>MDN からページを完全に削除することは滅多にありません。もっともよくある理由は、ページがスパムによって作成された、または間違って作成された場合です。かつては有用であったページが時代遅れの技術の記述となった場合には、削除するのではなく MDN の /Archive セクションに移動することでアーカイブされます。</p>
+
+<h2 id="Requesting_page_deletion" name="Requesting_page_deletion">ページの削除の申請</h2>
+
+<p><span class="seoSummary">MDN の<a href="/ja/docs/MDN/Community/Roles/Admins">管理者</a>だけがページを削除することができます。管理者以外のユーザーは、ページの削除をリクエストすることができます。</span></p>
+
+<p>ページを削除するには次のようにしてください。</p>
+
+<ol>
+ <li><strong>ページコンテンツの削除や変更はしないでください。</strong>ページ削除時にはその時点のコンテンツを記録しておきます。</li>
+ <li>ページに "Junk" タグを追加してください。他のタグは削除しないでください。</li>
+ <li>ページの削除に緊急を要する場合 (例えばコンテンツが不適切、攻撃的、あるいは技術的に危険なものである場合など) は、 <a href="mailto:mdn-admins@mozilla.org" title="Notify an administrator">MDN 管理者にお知らせください</a>。</li>
+</ol>
+
+<p>管理者は削除が適切かどうか判断した上で、随時ページを削除していきます。</p>
+
+<h2 id="How_to_delete_a_page" name="How_to_delete_a_page">ページを削除するには</h2>
+
+<p>ページを削除すると決めた管理者は、以下のようにしてください。</p>
+
+<ol>
+ <li>削除したいページの右上隅付近にある<strong>詳細</strong>メニューを開いてください。</li>
+ <li><strong>このページを削除</strong>をクリックしてください。「ページの削除」画面が次のように現れます。<br>
+  <br>
+  削除しようと選択したページのタイトルと、関連する一部のメタデータが表示されます。</li>
+ <li><strong>理由</strong>欄に "Spam" や "Junk" や "Created by mistake" など、適切な理由を入力してください。</li>
+ <li><strong>削除</strong>ボタンをクリックしてください。「文書が削除されました」画面が表示され、このページへのリンクがあれば表示されます。 (権限のないユーザーには、<strong>この文書を復元</strong>ボタンが表示されません。)</li>
+</ol>
+
+<h2 id="Restricted_access" name="Restricted_access">アクセス制限</h2>
+
+<p>ページ削除ツールには文書の構造を破壊する可能性が存在するため、アクセスには上位の権限を必要とします。</p>
+
+<h3 id="Roles_that_have_this_permission" name="Roles_that_have_this_permission">この権限を持つロール</h3>
+
+<ul>
+ <li><a href="/ja/docs/MDN/Contribute/Admins"><strong>Admins</strong></a></li>
+</ul>
+
+<h3 id="Conditions_for_gaining_this_permission" name="Conditions_for_gaining_this_permission">この権限を得るための条件</h3>
+
+<p>このツールにアクセスする権限を得るための条件は以下のとおりです。</p>
+
+<ul>
+ <li><strong>日常的に</strong>この権限を必要としていること (例えば、頻繁にスパムや間違いのページに対応する必要がある場合)。たまにしかページを削除する必要がないのであれば、管理者に依頼してください。</li>
+ <li>日常的に MDN を編集しており、建設的な協力の記録がある場合。</li>
+</ul>
+
+<p>この権限を取得する手続については、<a href="/ja/docs/MDN/Contribute/Processes/Requesting_elevated_privileges">上位権限の申請</a>を参照してください。</p>
diff --git a/files/ja/mdn/tools/page_moving/index.html b/files/ja/mdn/tools/page_moving/index.html
new file mode 100644
index 0000000000..920c6f299c
--- /dev/null
+++ b/files/ja/mdn/tools/page_moving/index.html
@@ -0,0 +1,57 @@
+---
+title: ページの移動
+slug: MDN/Tools/Page_moving
+tags:
+  - Guide
+  - MDN Meta
+  - Page-level
+  - Tools
+translation_of: MDN/Tools/Page_moving
+---
+<div>{{MDNSidebar}}</div>
+
+<p>なぜページ (またはページのツリー) を移動するのでしょう。サイトの階層の適切な場所ではなく、サイトの最上位に作成してしまったのかもしれません。あるいは既存の文書を整頓しているのかもしれませんね。古い内容をアーカイブする必要があるのかもしれません。このような理由で MDN はページを移動する機能を持っており、1つのページを移動するだけではなく、その下位のページをまとめて移動することもできます。</p>
+
+<p><span class="seoSummary"><strong>ページ移動ツール</strong>により、編集者は MDN ツリー内の文書およびそのすべてのサブページの URL またはスラッグを変更することができます。ページを整頓したり、間違った位置にあるページを修正したりするときに、とても手軽で強力なツールです。</span></p>
+
+<div class="note">
+<p><strong>メモ:</strong> 特別な権限を持つユーザーだけが MDN でページを移動することができます。<strong>この記事を移動</strong>という選択肢が<strong>詳細</strong> メニューに表示されない場合、使用するのに権限が必要です。この権限を得る方法については、下にある<a href="#Restricted_access">アクセス制限</a> を見てください。</p>
+</div>
+
+<h2 id="How_to_move_pages" name="How_to_move_pages">ページを移動するには</h2>
+
+<p>ページまたはページのツリーを移動するには、以下のようにします。</p>
+
+<ol>
+ <li>MDN で移動したいページの右上の角にある<strong>詳細</strong> メニューを開いてください。<br>
+  <img alt="" src="https://mdn.mozillademos.org/files/14565/MDN_right_menu.png" style="height: 208px; width: 200px;"></li>
+ <li><strong>この記事を移動</strong> をクリックしてください。下のような「ページの移動」画面が表示されます。<br>
+  <img alt="" src="https://mdn.mozillademos.org/files/14567/MDN_page_move.png" style="height: 437px; width: 375px;"><br>
+  一番上には、すべて (アルファベットが) 大文字で、移動しようとしているページのタイトルが表示され、続いてページを移動するためのフォームを正しく記入する方法についての注意書きの一覧が表示されます。ページタイトルは編集可能となっていますが、ここで変更しても反映されません。この問題の状態については、 {{bug(828533)}} を参照してください。</li>
+ <li><strong>新しい URL スラグ</strong>の隣の枠に、ページの移動先としたいスラグを入力してください。この行の上にあるのは <strong>URL のプレビュー</strong>で、ここに、<strong>新しい URL スラグ</strong>の値を反映した、ページ移動後のフルパスの URL が表示されます。</li>
+ <li>この移動操作によって影響を受ける全てのサブページの一覧が表示されます。<strong>N ページを移動</strong>ボタンと<strong>キャンセル</strong>ボタンの下にあります。サブページがなければ、その旨が表示されます。この一覧は、ページの移動が予測しなかった副作用を与えるのか判断するのに役立つかもしれません。閲覧の多いコンテンツの移動や、一度に大量のページを移動するのには注意を払ってください。</li>
+ <li>すべてが望み通り設定されていると分かったら、 <strong>N ページを移動する</strong>ボタンをクリックします。非同期のバックグラウンドプロセスが始まり、各ページを移動して<strong>かつ</strong>元のページにリダイレクトを設置します。ですので、古い URL もリダイレクトによって動作し続けます。移動のプロセスが完了したらメールが届きます。そのメールには、ページの新しい場所にクリックして移動できるリンクが含まれています。</li>
+</ol>
+
+<h2 id="Restricted_access" name="Restricted_access">アクセス制限</h2>
+
+<p>内容をおかしな場所に移動することで害となる明らかな可能性が存在するため、このツールは誰もが使えるようにはなっていません。</p>
+
+<h3 id="Roles_that_have_this_permission" name="Roles_that_have_this_permission">この権限を持つロール</h3>
+
+<ul>
+ <li><a href="/ja/docs/MDN/Contribute/Admins"><strong>Admins</strong></a></li>
+ <li><a href="/ja/docs/MDN/Contribute/Topic_driver_role"><strong>Topic drivers</strong></a></li>
+ <li><a href="/ja/docs/MDN/Contribute/Localization_driver_role"><strong>Localization drivers</strong></a></li>
+</ul>
+
+<h3 id="Conditions_for_gaining_this_permission" name="Conditions_for_gaining_this_permission">この権限を得るための条件</h3>
+
+<p>このツールにアクセスする権限を得るための条件は以下のとおりです。</p>
+
+<ul>
+ <li><strong>日常的に</strong>この権限を必要としていること (例えば、頻繁にページの移動を行う必要がある、あるトピックについて大きなリファクタリングを行っているなど)。たまにしかページを移動する必要がないのであれば、管理者に依頼してください。</li>
+ <li>日常的に MDN を編集していて、 <a href="/ja/docs/MDN/Contribute/Content/Style_guide#Page_titles">ページの命名</a> 規則に通じていること。</li>
+</ul>
+
+<p>この権限を取得する手続については、<a href="/ja/docs/MDN/Contribute/Processes/Requesting_elevated_privileges">上位権限の申請</a>を参照してください。</p>
diff --git a/files/ja/mdn/tools/page_regeneration/index.html b/files/ja/mdn/tools/page_regeneration/index.html
new file mode 100644
index 0000000000..590eda0260
--- /dev/null
+++ b/files/ja/mdn/tools/page_regeneration/index.html
@@ -0,0 +1,34 @@
+---
+title: MDN 上のページのレンダリング
+slug: MDN/Tools/Page_regeneration
+tags:
+  - Guide
+  - MDN Meta
+  - Page-level
+  - Tools
+translation_of: MDN/Tools/Page_regeneration
+---
+<div>{{MDNSidebar}}</div>
+
+<p>MDN サイトは性能上の理由でページをキャッシュしています。 この結果、ページに対する保存済みの変更が、次回リロード時に反映されない場合があります。常にではないがしばしば、ページがの更新が処理中であることを示すバナーが表示されます。ブラウザーで強制リフレッシュしてサーバーからページをリロードできますが、サーバー上の更新が完了しないと効果がないことがあります。</p>
+
+<p>いくつかのページ (特に Landing ページ【訳注: 階層下のページの一覧を列挙するページ】) では、マクロを使って自動的に内容の生成と更新を行っています。Landing ページのためにこれを行うことで、作者が手動で更新しなくても、新しい記事が自動的にページに載ることが保証されます。これは長期間の貢献者には便利であり、新参者にはサイトの階層のどこにリンクすべきか分からずに成果を見失うことを避けるのに役立ちます。</p>
+
+<p>またあるページを別のページにトランスクルージョンする(例えば {{TemplateLink("Page")}} マクロを使って)のにも使います。</p>
+
+<p><span class="seoSummary">MDN は性能上の理由でレンダリングしたコンテンツをキャッシュしているため、元の素材（たとえばマクロの出力や引用されるページ）に加わった変更は自動的にはページに反映されません。そのような元の素材に頻繁に変更が加わることがわかっているならば、ページの自動生成を有効にすることを検討したくなるかもしれません。</span></p>
+
+<p>自動生成を有効にするには:<strong> </strong>【訳注: この機能は現在、英語版のページでのみ設定できます】</p>
+
+<ol>
+ <li><strong>EDIT</strong> ボタンをクリックし、編集モードに入ります。</li>
+ <li>ページタイトルの下にある  <strong>Edit page title and properties</strong> をクリックします。ページのメタデータフィールドが現れます。</li>
+ <li><strong>Rendering max age</strong> に値を設定します。この値が、キャッシュされたページが(マクロの再実行も含めて)再生成されるスケジュールを決定します。普通は 4 または 8 Hours を指定します。 文書が頻繁に変更される技術に関しては、より少ない数値を指定しても良いでしょう。</li>
+ <li>変更を保存します。リビジョンコメントに、設定内容を記録しておくのは良い習慣です。例: "Rendering max age を 4 Hours に設定"</li>
+</ol>
+
+<p>ページは指定したスケジュールに従って再生成されます。</p>
+
+<div class="note">
+<p><strong>注:</strong> "Edit page title and properties" オプションは、文書の作成時には現れませんので、一度保存してから開き直す必要があります。</p>
+</div>
diff --git a/files/ja/mdn/tools/page_watching/index.html b/files/ja/mdn/tools/page_watching/index.html
new file mode 100644
index 0000000000..fe7b3a7f45
--- /dev/null
+++ b/files/ja/mdn/tools/page_watching/index.html
@@ -0,0 +1,49 @@
+---
+title: ページやページ群を監視・購読する
+slug: MDN/Tools/Page_watching
+tags:
+  - Guide
+  - MDN Meta
+  - Page-level
+  - Tools
+translation_of: MDN/Tools/Page_watching
+---
+<div>{{MDNSidebar}}</div>
+
+<p><span class="seoSummary">MDN ページを購読することで、そのページが更新・変更された時はいつでもメールで通知を受け取ることができます。</span>すべての MDN ページの右上の隅に、監視ボタンがあります。購読のオプションにアクセスするには、監視ボタンの上にポインターを動かして監視メニューを開くいてください。</p>
+
+<p><img alt="MDN の監視メニューのスクリーンショット" src="https://mdn.mozillademos.org/files/12551/MDN_-_Watch_Menu.png" style="border-style: solid; border-width: 1px; display: block; height: 298px; margin: 0 auto; width: 463px;"></p>
+
+<p>そのページだけを購読するか、サブページも一緒に購読するかをオプションで選択してください。</p>
+
+<h2 id="Subscribe_to_a_page" name="Subscribe_to_a_page">ページを購読する</h2>
+
+<p>ユーザーがそのページを編集するたびにメール通知を受け取るには、ページの上部にある詳細メニューの最初のオプション「この記事を購読」をクリックします。</p>
+
+<h2 id="Subscribe_to_a_page_and_all_its_sub-articles" name="Subscribe_to_a_page_and_all_its_sub-articles">ページとすべてのサブページを購読する</h2>
+
+<p>2つ目のオプション「この記事と全サブ記事を購読」をクリックすると、ユーザーがそのページとすべてのサブページを編集するたびにメール通知を受け取るようになります。これは購読を要求した後に追加されたサブページも含むため、将来多くのサブページが作られた場合、その通知も同様に受け取ります。</p>
+
+<h2 id="Unsubscribe_from_a_page" name="Unsubscribe_from_a_page">ページの購読解除</h2>
+
+<p>購読を解除してページの監視をやめる場合は、再び監視メニューを開いて「この記事の購読を中止」をクリックしてください。ページを購読していると「この記事の購読を中止」とだけ表示されています。ページが変更されるたびにメール通知を受けることはなくなります。</p>
+
+<h2 id="The_page_change_emails" name="The_page_change_emails">ページ変更のメール</h2>
+
+<p>ページを購読すると、ページが保存されるたびにメールを受け取ります。このメールは notifications@developer.mozilla.org から MDN アカウントに登録されたメールアドレスに送信されます。各メッセージにはこの形のタイトルがあります:</p>
+
+<pre class="notranslate">[MDN] ページ "<em>ページタイトル</em>" が <em>ユーザー名</em> によって変更されました</pre>
+
+<p>メッセージはタイトル情報の繰り返しで始まり、つぎにコンテンツの標準差分を表示して、正確に何が変更されたかを示します。変更は HTML ソースコードで表示され、 MDN のコンテンツに慣れていない場合少し読みにくいかもしれません。</p>
+
+<p>差分の下には、変更に対応するのに役立つ、次のようなリンクの一覧があります:</p>
+
+<ul>
+ <li>その変更を行ったユーザーの MDN プロファイルを表示する</li>
+ <li>MDN のオンサイト履歴機能を使ってページの新旧のバージョンを比較する</li>
+ <li>ブラウザーで記事自体を見る</li>
+ <li>記事を編集する</li>
+ <li>記事の履歴を見る</li>
+</ul>
+
+<p>メールの最後には、"HTML element reference とその全サブ記事に対する編集の購読を開始しました" といった、どんな購読でメールが生成されたかの通知や、購読をやめるためのリンクがあります。購読をやめるリンクをクリックすると、その監視リクエストのメッセージを受け取らなくなります。</p>
diff --git a/files/ja/mdn/tools/put_api/index.html b/files/ja/mdn/tools/put_api/index.html
new file mode 100644
index 0000000000..6e05522016
--- /dev/null
+++ b/files/ja/mdn/tools/put_api/index.html
@@ -0,0 +1,208 @@
+---
+title: PUT API
+slug: MDN/Tools/PUT_API
+tags:
+  - Advanced
+  - Automation
+  - Documentation
+  - Draft
+  - Guide
+  - MDN Meta
+  - PUT API
+  - Page-level
+  - Tools
+translation_of: MDN/Tools/PUT_API
+---
+<div>{{MDNSidebar}}</div>
+
+<div> {{draft}}</div>
+
+<p><span class="seoSummary">MDN Wiki はページの全体、または一部の更新のための<strong>実験的な</strong> <a href="/ja/docs/Web/HTTP">HTTP</a> PUT API を提供しています。</span>この機能は、次のような時に便利です:</p>
+
+<ul>
+ <li>プロジェクトのページを作成し、自動ビルド、テスト、デプロイスクリプトからある節のコンテンツを更新することができる。これはコミュニティがプロジェクトの進捗の最新についていくのに役立ちます。</li>
+ <li>ソースコードと並行してドキュメントを提供する場合、HTML をプッシュして MDN のサブセクションにレンダリングできます。これでチームの作業フローにとって適切な方法でドキュメントを維持できて、MDN に貢献したりローカライズ担当がコンテンツを翻訳できるままになります。</li>
+</ul>
+
+<h2 id="Testing_your_application" name="Testing_your_application">アプリケーションをテストする</h2>
+
+<p>MDN を実行するソフトウェアを開発する中で、次のようにいろいろなステージ上のサイトインスタンスをホストしています:</p>
+
+<ul>
+ <li>Production (<a href="http://developer.mozilla.org/" title="http://developer.mozilla.org/">http://developer.mozilla.org/</a>), the real site with stable code and where changes to content matter.</li>
+ <li>Staging (<a href="http://developer.allizom.org/" title="http://developer.allizom.org/">http://developer.allizom.org/</a>), a version of the site where changes are throwaway and upcoming features are tested.</li>
+ <li>Development (<a href="http://developer-dev.allizom.org/" title="http://developer-dev.allizom.org/">http://developer-dev.allizom.org/</a>), a version of the site running the absolute latest and untested code.</li>
+</ul>
+
+<p>プロダクションサイトを無駄にしないようにするには、まずステージングに対してアプリケーションを開発する必要があります。それから、あなたが望むことを合理的に実行することができたら、それをプロダクションに反映するように再構成します。また、開発に取り組むこともできますが、問題が発生する可能性があります。</p>
+
+<h2 id="Creating_an_API_key" name="Creating_an_API_key">API キーを作成する</h2>
+
+<p>APIキーを使うと、毎回 Persona ログインするような介入を要求せずに、アプリケーションを代理人として動作させることができます。SSL 上の HTTP ベーシック認証を使ってユーザー名とパスワードを提供します。基本的な使用のトラッキングを集めて、どのように使われているかがわかるようにします。そして、たまたま持つべきでない人々に渡った場合は、アクセスを無効にするよう API キーを削除できます。</p>
+
+<p>If you have the correct privileges to do so, to create an API key, sign into MDN and <a href="https://developer.mozilla.org/ja/users/account/keys" title="https://developer.mozilla.org/ja/users/account/keys">visit the API keys management page</a>. This page lets you create and delete API keys, as well as inspect recent usage history.  Only Mozillians in good standing can currently get API keys, since they grant abilities to automate changes to content rapidly, so unprivileged users must request the ability by filing a bug.</p>
+
+<p>{{NoteStart}}The above link goes to the Production site, and the same keys do not work between Production and Staging. You can also get to this page by visiting your profile on the respective site: Click on your username in the upper right of the site. On your profile page, you should see a "Manage API Keys" button.{{NoteEnd}}</p>
+
+<p>From there, clicking on the "<a href="https://developer.mozilla.org/ja/users/account/keys/new" title="https://developer.mozilla.org/ja/users/account/keys/new">Create a new API key</a>" button should take you to an entry form so you can submit a request for an API key.</p>
+
+<p>After filling out and submitting the form, you will receive a key ID and secret. These are your username and password, respectively. Copy these down somewhere safe (eg. to your application's configuration settings); the site will never display them again, and there is no recovery method. If you lose them, simply delete the API key and create another.</p>
+
+<h2 id="Making_a_PUT_request" name="Making_a_PUT_request">PUT リクエストを作成する</h2>
+
+<p>Since the PUT API works by way of HTTP, it should be compatible with the application environment and libraries of your choice. This first example uses <a href="http://curl.haxx.se/" title="http://curl.haxx.se/">the command-line tool cURL</a> and a UNIX shell to demonstrate how to issue a simple PUT request to MDN.</p>
+
+<h3 id="Request" name="Request">リクエスト</h3>
+
+<pre class="brush: bash notranslate"># Base URL and API key from staging (example only; substitute your own)
+MDN_BASE_URL="https://developer.allizom.org"
+MDN_KEY_ID="frsNFFR3w0yEALRE9IA9oN1KwoDno8vVGrzsBNvCofI"
+MDN_SECRET="423PdCvnvraH0FkCDTKnizTmKGNkEdgQTi6RlEFTiWs"
+
+# Document-specific details
+DOC_USERNAME="lmorchard"  # Change this to your name
+DOC_PATH=/ja//docs/User:$DOC_USERNAME/PutExample"
+DOC_TYPE="text/html"
+DOC_DATA="&lt;b&gt;HELLO WORLD&lt;/b&gt;"
+
+# Putting it all together...
+curl -si -X PUT -H"Content-Type: $DOC_TYPE" -d"$DOC_DATA" -u"$MDN_KEY_ID:$MDN_SECRET" "$MDN_BASE_URL$DOC_PATH"</pre>
+
+<p>Since there's a lot going on in this cURL invocation, the example is broken into variables:</p>
+
+<ul>
+ <li><code>MDN_BASE_URL</code> - as mentioned before, you should plan to switch your application between staging and production servers on MDN. This variable allows for that.</li>
+ <li><code>MDN_KEY_ID</code> - the key ID from the API key you created. Note that these are server-specific - the same keys do not work between staging and production.</li>
+ <li><code>MDN_SECRET</code> - the secret from the API key that corresponds with the key ID.</li>
+ <li><code>DOC_USERNAME</code> - change this to your MDN username.</li>
+ <li><code>DOC_PATH</code> - the URL path to the document with content you want to manipulate.</li>
+ <li><code>DOC_TYPE</code> - the content in the request will be <code>text/html</code></li>
+ <li><code>DOC_DATA</code> - the content sent in the PUT request body; this is the content that will be used in a new revision to the document</li>
+</ul>
+
+<p>So, along with the variables, here are some general notes on the example and its use of the PUT API:</p>
+
+<ul>
+ <li>The key ID and secret are supplied as username and password, respectively, in HTTP Basic authentication over SSL.</li>
+ <li>The <code>DOC_PATH</code> for this example includes a username - presumably yours - but that's just for the sake of example and ensuring you have your own sample document to play with. You can use any URL path to any document on the wiki.</li>
+ <li>A <code>Content-Type</code> header is required, and lets MDN know how to process the content sent in the PUT request. Several content types are supported, and this feature will be described in greater detail shortly.</li>
+ <li>Content intended for the document is sent in the request body, using the representation promised in the <code>Content-Type</code> header</li>
+</ul>
+
+<h3 id="Response" name="Response">レスポンス</h3>
+
+<p>There are several responses you may see if you try this example: <code>403</code>, <code>404</code>, <code>201</code>, or <code>205</code>. (You may see others, but those suggest something has gone wrong with the site. That will, hopefully, be rare.)</p>
+
+<h4 id="403_Forbidden" name="403_Forbidden">403 Forbidden</h4>
+
+<p>If either the key ID or secret are incorrect, you'll see a <code>403 Forbidden</code> response. Double check your key details and that you're using the right pair for the right server. Create a new API key, if necessary.</p>
+
+<h4 id="404_Not_Found" name="404_Not_Found">404 Not Found</h4>
+
+<p>If you've never created a document at the URL path <code>/en-US/docs/User:$MDN_USERNAME</code>, you'll see a <code>404 Not Found</code> response.</p>
+
+<p>{{NoteStart}}The PUT API will not automatically create parent documents. If you're creating a number of documents intended to comprise a subsection of MDN, make sure to create parent documents first from the top down in the hierarchy.{{NoteEnd}}</p>
+
+<h4 id="201_Created" name="201_Created">201 Created</h4>
+
+<p>If the parent document exists, but the path itself doesn't, you should see a <code>201 Created</code> response. This signifies that a new document was created, as opposed to an existing one having been updated.</p>
+
+<h4 id="205_Reset_Content" name="205_Reset_Content">205 Reset Content</h4>
+
+<p>In the case of an updated document, you'll see a <code>205 Reset Content</code> response. This means that the document content has been updated, and that you should reload the document if you happen to need to see the results.</p>
+
+<p>{{NoteStart}}MDN performs certain filtering and processing steps on content, so what you put in may not be exactly what gets served back.{{NoteEnd}}</p>
+
+<h2 id="Supported_Content_Types" name="Supported_Content_Types">サポートされるコンテンツのタイプ</h2>
+
+<p>The PUT API accepts one of several content types in the request body.</p>
+
+<h3 id="texthtml" name="texthtml">text/html</h3>
+
+<p>There are actually two forms of <code>text/html</code> accepted: fragment and document.</p>
+
+<h4 id="Fragment" name="Fragment">Fragment</h4>
+
+<p>An HTML fragment is just an arbitrary chunk of markup, and is used as-is to revise document content. This is the simplest way to update documents.</p>
+
+<h4 id="Document" name="Document">Document</h4>
+
+<p>However, if the request body consists of an <code>&lt;html&gt;</code> element containing <code>&lt;head&gt;</code> and <code>&lt;body&gt;</code> elements, it's treated as a full HTML document. In this case, the following processing happens:</p>
+
+<ul>
+ <li>From the <code>&lt;head&gt;</code> element, the contents of <code>&lt;title&gt;</code> is extracted and used as the title for the document on MDN.</li>
+ <li>The contents of <code>&lt;body&gt;</code> is extracted as the content for a new revision. </li>
+</ul>
+
+<p>This is a more complex way to update documents, but is intended as a convenience to accomodate submission of existing HTML pages.</p>
+
+<h3 id="applicationjson" name="applicationjson">application/json</h3>
+
+<p>Although the <code>text/html</code> content type is handy, there are more fields belonging to documents that are useful to manage. These include the following:</p>
+
+<ul>
+ <li><code>title</code> - the document title</li>
+ <li><code>content</code> - the content intended for the new revision</li>
+ <li><code>tags</code> - tags used to organize documents: this is given as a single string, with tags separated by commas</li>
+ <li><code>review_tags</code> - tags used to request content reviews: this is given as a single string, with tags separated by commas</li>
+ <li><code>summary</code> - a comment describing the revision to be made</li>
+ <li><code>show_toc</code> - a flag (0/1) indicating whether the table of contents should be shown for this document</li>
+</ul>
+
+<p>These fields can be supplied as string values in a JSON-encoded object with the <code>application/json</code> content-type in a PUT request.</p>
+
+<pre class="brush: bash notranslate"># Auth Stuff
+DOC_USERNAME="lmorchard"  # Change this to your name
+MDN_KEY_ID="frsNFFR3w0yEALRE9IA9oN1KwoDno8vVGrzsBNvCofI"
+MDN_SECRET="423PdCvnvraH0FkCDTKnizTmKGNkEdgQTi6RlEFTiWs"
+
+# Base Settings (for Staging Env)
+MDN_BASE_URL="https://developer.allizom.org"
+DOC_PATH=/ja//docs/User:$DOC_USERNAME/PutExample"
+DOC_TYPE="application/json"
+
+<code class="language-bash"># Doc Content
+echo '{"content": "&lt;b&gt;Hello World&lt;/b&gt;", "title": "New Sample Title", "show_toc": 1, "tags": "Beginner, Tutorial", "review_tags": "editorial, technical", "summary": "Sample JSON update from the API"}' &gt; /tmp/mdn.json
+
+# Submitting Content</code>
+curl -X PUT -H "Content-Type: $DOC_TYPE" -d @/tmp/mdn.json -u"$MDN_KEY_ID:$MDN_SECRET" "$MDN_BASE_URL$DOC_PATH"
+</pre>
+
+<h3 id="multipartform-data" name="multipartform-data">multipart/form-data</h3>
+
+<p>This content type is handled basically like <code>application/json</code> - the same fields are accepted. But, it might be less useful than JSON and is supported mainly for testing purposes.</p>
+
+<h2 id="Updating_a_single_section" name="Updating_a_single_section">1 つのセクションを更新する</h2>
+
+<p>Normally, an HTTP PUT request replaces the entirety of a document with the submitted content in a new revision. However, you can use the query parameter <code>?section</code> to constrain revision to a single section of the document and leave the rest of the content as-is. This is handy for automating changes to one part of a document that is otherwise managed by hand, or even for aggregating changes from many sources or scripts into one document.</p>
+
+<h3 id="Creating_document_sections" name="Creating_document_sections">文書のセクションを作成する</h3>
+
+<p>Documents on MDN can be broken up into sections. These sections are useful for building a table of contents, linking to specific parts, and editing subsets of document content.</p>
+
+<h4 id="Using_headers" name="Using_headers">Using headers</h4>
+
+<p>Headers (ie. <code>&lt;h2&gt;</code> .. <code>&lt;h6&gt;</code>) make sections in MDN documents. The text of each header is transformed automatically into an ID, and that's used for anchor links in the table of contents sidebar on most documents. Those auto-generated IDs can be overriden with the <code>name</code> attribute on headers. Either way, looking at the table of contents is the easiest way to see how a document is broken up into sections, and to discover the IDs for those sections.</p>
+
+<p>The contents of a section include its header and everything following the header up to (but not including) another header of the same or higher level. So, a section that starts with an <code>&lt;h2&gt;</code> continues until the next <code>&lt;h2&gt;</code>, including any subsections started by <code>&lt;h3&gt;</code> .. <code>&lt;h6&gt;</code>. That also means sections can be nested: An <code>&lt;h3&gt;</code> appearing after an <code>&lt;h2&gt;</code> creates a subsection, including any further nested subsections started by <code>&lt;h4&gt;</code> .. <code>&lt;h6&gt;</code>, up to the next <code>&lt;h3&gt;</code> or <code>&lt;h2&gt;</code>.</p>
+
+<p>@@TODO: Show an HTML example with headers, here. This is a bit confusing.</p>
+
+<h4 id="Using_container_elements" name="Using_container_elements">Using container elements</h4>
+
+<p>Setting an <code>id</code> attribute on a container element (eg. a <code>&lt;div&gt;</code> or <code>&lt;span&gt;</code> or <code>&lt;section&gt;</code>) in the source editor also creates a section, at least with respect to the PUT API. This is a bit more advanced and requires manual changes to raw HTML, rather than using the WYSIWYG editor. But, if you want to update a chunk of the page without the need for headers, this is how to do it.</p>
+
+<h3 id="Specifying_a_section" name="Specifying_a_section">セクションを指定する</h3>
+
+<ul>
+ <li>Look at the table of contents, note the anchor ID for the link (ie. the <code>#hash</code> part of the URL).<br>
+  Example: <code>https://developer.mozilla.org/ja/docs/User:lmorchard/PUT-API#Specifying_a_section</code></li>
+ <li>Take everything after the "#" character, and you have the section ID.<br>
+  Example: <code>Specifying_a_section</code></li>
+ <li>Add <code>?section={ID}</code> to the URL for the document, substituting the section ID for <code>{ID}</code>.<br>
+  Example: <code>https://developer.mozilla.org/ja/docs/User:lmorchard/PUT-API?section=Specifying_a_section</code></li>
+ <li>If you view <a href="https://developer.mozilla.org/ja/docs/User:lmorchard/PUT-API?section=Specifying_a_section" title="https://developer.mozilla.org/ja/docs/User:lmorchard/PUT-API?section=Specifying_a_section">that URL</a> in a browser (ie. HTTP GET), you'll see just that section of the document.<br>
+  (For more details on what you can do with HTTP GET, see also: <a href="/ja/docs/Project:The_Kuma_API" title='/ja/docs/Project:The_Kuma_API""'>Project:The_Kuma_API</a>)</li>
+ <li>If you issue a PUT request to that URL, you'll modify just that section of the document.<br>
+  (But, don't do that to the example URL, or you'll clobber the page you're reading right now!)</li>
+</ul>
diff --git a/files/ja/mdn/tools/revision_dashboard/index.html b/files/ja/mdn/tools/revision_dashboard/index.html
new file mode 100644
index 0000000000..10c96bfa07
--- /dev/null
+++ b/files/ja/mdn/tools/revision_dashboard/index.html
@@ -0,0 +1,117 @@
+---
+title: リビジョンダッシュボード
+slug: MDN/Tools/Revision_dashboard
+tags:
+  - Guide
+  - MDN Meta
+  - Site-wide
+  - Tools
+translation_of: MDN/Tools/Revision_dashboard
+---
+<div>{{MDNSidebar}}</div>
+
+<p><span class="seoSummary"><a href="/dashboards/revisions" title="https://developer.mozilla.org/dashboards/revisions">リビジョンダッシュボード</a> は MDN Web Docs Wiki の機能で MDN での最近の更新と追加を見たり、何が変更されたのか詳細を確認したり、それらの更新に対して様々な方法で行動することができます。</span> この記事では、リビジョンダッシュボードの使い方を説明します。</p>
+
+<h2 id="First_look" name="First_look">外観</h2>
+
+<p>リビジョンダッシュボードのインターフェイスは多くの要素を持ち、便利な機能が満載です。まずはインターフェイスの主要な部分の概観から始めましょう。</p>
+
+<p><img alt="Annotated screenshot of main revision dashboard view" src="https://mdn.mozillademos.org/files/11481/MDN_Revision_Dashboard_main.png" style="height: 625px; width: 1102px;"></p>
+
+<p>ここで注意すべき最も大事なことは履歴のリストで、ここでフィルターにマッチする履歴や、履歴の差分 (クリックした履歴で変更された内容が見られます) を一通り見ることができます。</p>
+
+<h2 id="The_revision_list" name="The_revision_list">リビジョン一覧</h2>
+
+<p>リビジョンダッシュボードウィンドウの中ほどにあるリビジョン一覧は、最近なされた変更を提供します。この一覧は、最近変更された記事が最初に来るように順序付けられていて、先に進むともっと古い履歴になります。</p>
+
+<p>リビジョン一覧のすぐ下にあるのは、検索クエリーにマッチしたページがどれくらいあり、そのうちのどこを見ているのかを示すインジゲーターです。何もフィルターをかけていない場合、MDN wiki になされたすべての履歴のページ数が見えます。</p>
+
+<p>一覧の各行は wiki への 1 つの変更に対応しています。"変更" とは次のいずれかからなっています:</p>
+
+<ul>
+ <li>新しいページが作成されました。これはリビジョンタイムスタンプの下に "new" のタグで示されます。</li>
+ <li>ページが移動されました。これはコメント欄の影のある四角に "&lt;old path&gt; ➞ &lt;new path&gt;" のように示されます。</li>
+ <li>ページのテキストが変更されました。</li>
+ <li>ページのタグが変更されました。</li>
+ <li>ページが削除されました。{{unimplemented_inline()}}</li>
+</ul>
+
+<p>各行は 4 つの列からなります: リビジョン、タイトル、コメント、著者です。</p>
+
+<h3 id="Revision_column" name="Revision_column">リビジョン列</h3>
+
+<p>リビジョン列はなされた変更の情報が与えられます。この列ではいくつかの情報が提供されます:</p>
+
+<dl>
+ <dt>タイムスタンプ</dt>
+ <dd>リビジョンが保存された正確な日付と時間。これはリビジョン詳細ページへのリンクで、そこではリビジョンのメタデータとコンテンツが表示されます。</dd>
+ <dt>ロケール</dt>
+ <dd>記事のロケールが列のタグとして示されます。これは言語の省略コードで表示され、例えば英語では "en-US" です。</dd>
+ <dt>ファイル変更インジゲーター</dt>
+ <dd>これまで存在しない新しい記事には <strong>new</strong> のタグが表示されます。ページが削除されたことを示す場合は、<strong>deleted</strong> タグが出てきます。ページが 1 回の改訂だけで削除された場合、<strong>new</strong> と <strong>deleted</strong> タグの両方が表示されることもありえます。</dd>
+ <dt>
+ <h3 id="Title_column" name="Title_column">タイトル列</h3>
+ </dt>
+</dl>
+
+<dl>
+ <dt>記事のタイトル</dt>
+ <dd>記事のタイトルは、ページにセットされているため、列に表示されます。タイトルは、直接移動して素早く簡単に見られるような、wiki 記事へのリンクでもあります。</dd>
+ <dt>記事のパス</dt>
+ <dd>記事のタイトルの下に、記事のパスが表示されます。これは記事の URL の一部分で、<code>http://developer.mozilla.org/<em>&lt;locale&gt;</em>/docs/</code> の後に来るものです。</dd>
+ <dt>
+ <h3 id="Comment_column" name="Comment_column">コメント列</h3>
+ </dt>
+</dl>
+
+<dl>
+ <dt>リビジョンコメント</dt>
+ <dd>変更の著者がリビジョンコメントを変更の保存時に追加していた場合、そこにあります。これは小さめのイタリックなテキストで表示されます。</dd>
+ <dt>移動の情報</dt>
+ <dd>リビジョンがページの移動を表す場合、wiki 上の移動元と行き先のパスが表示されます。</dd>
+ <dt>
+ <h3 id="Author_column" name="Author_column">著者列</h3>
+ </dt>
+</dl>
+
+<p>著者の列はそのリビジョンを保存した人のユーザー名が表示されます。それをクリックしてユーザーのプロフィールページをすぐに見ることができます。</p>
+
+<div class="note">
+<p><strong>管理者のみ:</strong> 管理者権限を持つ MDN ユーザーは著者列の見出しに <strong>Toggle IPs</strong> ボタンもあります。これをクリックするとそれぞれの著者の IP アドレスが表示され、不正なユーザーを IP アドレスによって禁止することができます。ユーザーが禁止されたら、ユーザー名の下に印が出ますが、これは管理者のみに見えます。</p>
+</div>
+
+<h2 id="Filtering" name="Filtering">フィルター</h2>
+
+<p>MDN はいくつかの便利なフィルターオプションを提供しており、あなたのニーズに応じてリビジョンの「物」の量を削減できます。フィルターを調整して、<strong>絞り込み</strong> ボタンを押して適用します。しばらくすると、ディスプレイはフィルター結果を更新します。いくつかのフィルターを利用できます:</p>
+
+<dl>
+ <dt>ロケール</dt>
+ <dd>You may filter so that you only see changes in a specific locale. 既定では, you see changes across all locales, but this may not be useful to you. Indeed, if you're a member of a localization team, 例えば、the only locales you're likely to care about are your own and English. You can specify the locale to filter by in the URL when going to the revision dashboard by adding "locale=&lt;localename&gt;" to the query string. 例えば、: <a href="https://developer.mozilla.org/ja/dashboards/revisions?locale=en-US" title="https://developer.mozilla.org/ja/dashboards/revisions?locale=en-US">https://developer.mozilla.org/ja/dashboards/revisions?locale=en-US</a> filters to show only changes to English documents.</dd>
+ <dt>ユーザー</dt>
+ <dd>Interested in what a specific user has been up to? You can look at the revisions submitted by a single user by entering it in this field. You can specify a user in the URL when going to the revision dashboard by adding "user=&lt;username&gt;" to the query string. 例えば、you can see changes by the user Sheppy with <a href="https://developer.mozilla.org/ja/dashboards/revisions?user=Sheppy" title="https://developer.mozilla.org/ja/dashboards/revisions?user=Sheppy">https://developer.mozilla.org/ja/dashboards/revisions?user=Sheppy</a>. This box will offer suggestions as you type, to help you find exactly the person you're looking for.</dd>
+ <dt>トピック</dt>
+ <dd>If you'd like to see changes only about a given topic area, you can specify a topic string. This will be matched against the URLs of articles that have been changed and show only those whose titles include this string. You can specify the parameter "topic=&lt;topic&gt;" in the URL's query string to filter on this, as well. 例えば、if you'd like to see only JavaScript-related changes: <a href="https://developer.mozilla.org/ja/dashboards/revisions?topic=JavaScript" title="https://developer.mozilla.org/ja/dashboards/revisions?topic=JavaScript">https://developer.mozilla.org/ja/dashboards/revisions?topic=JavaScript</a>.</dd>
+ <dt>開始日と終了日</dt>
+ <dd>You can specify that you want to see only revisions in a certain range of dates, or with a certain starting or ending date. The dashboard UI provides date selection widgets for these fields. You can specify these parameters in the URL's query string, but you must use your system locale's version of the date string. 例えば、: https://developer.mozilla.org/ja/dashboards/revisions?start_date=09%2F01%2F2015 for revisions starting with September 2, 2015 in the en-US locale.</dd>
+ <dt>先行期間</dt>
+ <dd>Rather than typing or selecting start or end dates, you can specify that you want to see revisions from a selected period prior to the present time, such as the last hour, day, week, or 30 days.</dd>
+</dl>
+
+<p>フィルターを組み合わせて使うのにも注目すぺきで、ユーザーインターフェイスや URL のクエリーストリングの両方でそれは言えます。かなり複雑な検索も実効できます。例えば、ユーザー{{UserLink("evilpie")}} が書いた英語の JavaScript 記事を見つけるには、このようにします <a href="https://developer.mozilla.org/ja/dashboards/revisions?locale=en-US&amp;user=evilpie&amp;topic=JavaScript" title="https://developer.mozilla.org/ja/dashboards/revisions?locale=en-US&amp;user=evilpie&amp;topic=JavaScript">https://developer.mozilla.org/ja/dashboards/revisions?locale=en-US&amp;user=evilpie&amp;topic=JavaScript</a>.</p>
+
+
+
+<h2 id="The_revision_diff" name="The_revision_diff">更新の差分</h2>
+
+<p>ページのあるリビジョンと前のリビジョンの違いを表示する「差分」を見ることができます。あるリビジョンの差分を見るには、リンクではない行のいずれかをクリックします (つまり、タイムスタンプ、記事のタイトル、著者のユーザー名以外)。この行はリビジョンの差分とリビジョンコントロールを説明します。</p>
+
+<p><img alt="Annotated screenshot of revision dashboard view" src="https://mdn.mozillademos.org/files/11485/MDN_Revision_Dashboard_diff.png" style="height: 245px; width: 1201px;"></p>
+
+<p>リビジョンコントロールは次の記事操作を許可します:</p>
+
+<ul>
+ <li><strong>もとに戻す</strong>: 記事を表示されたものの前に戻します。</li>
+ <li><strong>ページを表示</strong>: ページの現在の状況を表示します。</li>
+ <li><strong>ページを編集</strong>: 編集モードでページを開きます。</li>
+ <li><strong>履歴</strong>: ページの履歴ビューを開きます。</li>
+</ul>
diff --git a/files/ja/mdn/tools/sample_server/index.html b/files/ja/mdn/tools/sample_server/index.html
new file mode 100644
index 0000000000..6f8af2e0f5
--- /dev/null
+++ b/files/ja/mdn/tools/sample_server/index.html
@@ -0,0 +1,107 @@
+---
+title: MDN サンプルサーバ
+slug: MDN/Tools/Sample_server
+tags:
+  - Advanced
+  - Draft
+  - Guide
+  - MDN Meta
+  - Site-wide
+  - Tools
+translation_of: MDN/Tools/Sample_server
+---
+<div>{{MDNSidebar}}</div><div>{{IncludeSubnav("/ja/docs/MDN")}}</div>
+
+<p><span class="seoSummary">MDN の <a href="/ja/docs/MDN/Kuma">Kuma</a> プラットフォームは内蔵の<a href="/ja/docs/MDN/Contribute/Editor/Live_samples">ライブサンプルシステム</a>を提供して単純な（時にはそう単純でない）コードのサンプルをその出力と共にページの中で表示する機能を提供していますが、この機能では許可されていないことがあり、またサーバへの通信を必要とするサンプルもあります。私たちは MDN サンプルサーバを用意し、このような、またその他の問題も合わせて、解決することにしました。</span> この記事は、そのサンプルサーバを利用するためのガイドです。</p>
+
+<h2 id="Possible_use_cases" name="Possible_use_cases">想定するユースケース</h2>
+
+<p>たいていのサンプルは組み込みの <a href="https://developer.mozilla.org/ja/docs/MDN/Contribute/Editor/Live_samples">live sample system</a> で表現できますが、例外もあります。サンプルサーバーの利用が必要となる理由は下記の通りです:</p>
+
+<ul>
+ <li>サンプルにサーバー上で永続的に実行されるコードが必要、例えば WebSocket サーバーにはサーバーコンポーネントと、サンプルサーバー上のクライアントコンポーネントもあるなど。</li>
+ <li>MDN wiki のコンテンツでは動かない技術を使ったサンプルや、読み手がコンテンツに集中する能力に影響するようなものは明らかに候補となります; これにはサウンド効果やメディアや大量のアニメーションを再生するものが含まれます。</li>
+ <li>MDN でホストできないようなリソースにアクセスする必要があるサンプルはサンプルサーバーに置かれます。</li>
+</ul>
+
+<h2 id="Referencing_samples" name="Referencing_samples">サンプルへの参照を追加する</h2>
+
+<p>各サンプルのコードは <a href="https://github.com/mdn/samples-server">GitHub で管理されて</a>おり、そのすべてのサンプルの実行可能/使用可能なインストールアクセスを提供するサーバーを持っています。各サンプルには固有の名前があり、リンクされる際には常にその名前のみで参照されます。以下のマクロの1つを使います。</p>
+
+<h3 id="GithubSampleLink" name="GithubSampleLink">GithubSampleLink</h3>
+
+<p>{{TemplateLink("GithubSampleLink")}} は Github にある与えられた名前を持つサンプルのサンプルコードへのリンクを作成します。リンクのテキストとして使用する文字列をオプションで変更することもできます。</p>
+
+<h3 id="GithubSampleFileLink" name="GithubSampleFileLink">GithubSampleFileLink</h3>
+
+<p>{{TemplateLink("GithubSampleFileLink")}} は Github にあるサンプルコードの中の指定された名前のファイルへのリンクを作成します。引数として、サンプルの名前、 リンクしたいファイルへのサンプルコード内での相対パスがあり、オプションでリンクのテキストを指定することもできます。</p>
+
+<h3 id="SampleServerLink" name="SampleServerLink">SampleServerLink</h3>
+
+<p>{{TemplateLink("SampleServerLink")}} はサンプルサーバー上のユーザーインタラクティブなサンプルへのリンクを挿入します。これはユーザーにサンプルへ移動してブラウザー内で遊ぶことができるように使います; これはサンプルがサーバーのみで作られてクライアント側のコードから別の場所から参照する場合には使いません。サンプルの名前と、オプションでリンクの代替テキストを入力として受けます。</p>
+
+<h2 id="高度なサンプルに貢献する">高度なサンプルに貢献する</h2>
+
+<p><a href="https://mdn-samples.mozilla.org/">サンプルサーバー</a>に置かれたサンプルに貢献するには、GitHub の <a href="https://github.com/mdn/samples-server">MDN サンプルサーバーリポジトリ</a>をフォークする必要があります。現在、すべてのサンプルは GitHub の同じリポジトリにあります。</p>
+
+<p>それぞれのサンプルは <a href="https://github.com/mdn/samples-server/tree/master/s"><code>s/</code> ディレクトリー</a>の下に自身のディレクトリーを持っています。新しいサンプルを作るには、そこに適切な名前のディレクトリーを追加します。例えば、ちょっとしたゲームを実装するための Fetch API の使い方を示す例であれぱ、<code>s/fetch-trivia</code> にサンプルを置いても良いでしょう。</p>
+
+<h3 id="Structure_of_an_advanced_sample" name="Structure_of_an_advanced_sample">高度なサンプルの構造</h3>
+
+<p>それぞれのサンプルに一つの必須ファイルがあります (これは皮肉にもまだ使われていませんが、すぐ使われるため入れておいてください): <code>manifest.json</code> というマニフェストファイルで、これはサンプルを説明し、サンプルサーバー自体からと、これをメンテ・使用するツールから使われるメタデータを提供します。その他のすべてはオプションです。もっと詳しく見ていきましょう。</p>
+
+<h4 id="マニフェストファイル_manifest.json">マニフェストファイル: manifest.json</h4>
+
+<p>マニフェストファイルは第一に、サンプルのリストをビルドするのに使われますが、最終的には各サンプルのスタートアップとシャットダウンプロセスを改良することに使われるでしょう。これは次のような JSON オブジェクトです:</p>
+
+<pre class="brush: json line-numbers  language-json notranslate"><code class="language-json"><span class="punctuation token">{</span>
+  <span class="key token">"name":</span> <span class="string token">"WebSocket based chat server with WebRTC video chat support"</span><span class="punctuation token">,</span>
+  <span class="key token">"docsUrl":</span> <span class="string token">"https://developer.mozilla.org/ja/docs/Web/API/WebRTC_API/Signaling_and_video_calling"</span><span class="punctuation token">,</span>
+  <span class="key token">"description":</span> <span class="string token">"Uses Node.js to set up a WebSocket-based chat server, and provides a web page you can use to join the chat. Adds a feature to start a video call with another chat participant."</span>
+<span class="punctuation token">}</span></code></pre>
+
+<p>現在オブジェクトには3つの項目があり、<em>すべてが必須です </em>(まだ使用してないですが、すぐ使います):</p>
+
+<dl>
+ <dt><code>name</code></dt>
+ <dd>実例の名前です。例の比較的短い名前であるべきです。</dd>
+ <dt><code>docsUrl</code></dt>
+ <dd>この例を詳しく扱っている MDN の主なページの URL です。例が複数のページから参照されている場合、「メイン」ページ (または存在するならランディングページ) のアドレスであるべきです。</dd>
+ <dt><code>description</code></dt>
+ <dd>実例を説明する長めの文で、これがデモする技術についての情報を含みます。</dd>
+</dl>
+
+<h4 id="スタートアップ時にサンプルを動かす_startup.sh">スタートアップ時にサンプルを動かす: startup.sh</h4>
+
+<p>When the sample server starts up or samples are restarted, each sample's base directory is scanned to see if there's a shell script file named <code>startup.sh</code>. If the file exists, it is executed, so that the sample has the opportunity to install support files, run any scripts, and start up any server processes that are needed to support the sample. For example, the <a href="https://developer.mozilla.org/ja/docs/Web/API/WebRTC_API/Signaling_and_video_calling">WebSocket chat sample's</a> startup.sh script looks like this:</p>
+
+<pre class="brush: bash line-numbers  language-bash notranslate"><code class="language-bash">npm install websocket
+node chatserver.js</code></pre>
+
+<p>The first line uses the Node package manager, <code>npm</code>, to install the module named <code>websocket</code>, which provides support for creating and/or talking to <a href="https://developer.mozilla.org/ja/docs/Web/API/WebSocket_API">WebSocket</a> servers.</p>
+
+<p>The second line actually starts up the server process, which is implemented as a JavaScript script which is started up and run in the background.</p>
+
+<h4 id="Node.js_モジュールを使う_package.json">Node.js モジュールを使う: package.json</h4>
+
+<p>To use Node modules in your project, you'll need to add a <code>package.json</code> file, which lists information about your sample but also includes a list of dependencies, so that those dependencies can be installed for you by the Node package manager (<code>npm</code>).</p>
+
+<h4 id="Optional_files" name="Optional_files">オプションのファイル</h4>
+
+<p>You may of course have other files. Obvious candidates are an <code>index.html</code> file so that users that browse to your sample see some content, style sheets, support HTML and JavaScript files, images and other media, and so forth.</p>
+
+<h3 id="Submitting_your_sample" name="Submitting_your_sample">サンプルを投稿する</h3>
+
+<p>Once you've finished and tested your sample, you will want to submit it so that it can be tested and eventually installed onto the production sample server. This is done using the standard Github <a href="https://help.github.com/articles/using-pull-requests/">pull request</a> process.</p>
+
+<h2 id="Tips_and_errata" name="Tips_and_errata">Tips とエラッタ</h2>
+
+<p>Because the sample server itself is still a work in progress, there are quirks and issues with how samples work. Here are some tips that will help you avoid some of the worst potential problems.</p>
+
+<h3 id="Port_numbers" name="Port_numbers">Port numbers</h3>
+
+<p>If your sample needs to use a network port, you will have to take care not to inadvertently use one that's already being used by another sample (or by a system service on the server).  At some point in the future, there will be an entry in the sample manifest for requesting a port number, so that the system will allocate them and keep track of which are used and which are not. But until then, be careful not to step on any toes!</p>
+
+<h2 id="進行中の作業">進行中の作業</h2>
+
+<p>このページそのもの、そしてここに記述されているサーバについては、作業が継続中です。</p>
diff --git a/files/ja/mdn/tools/search/index.html b/files/ja/mdn/tools/search/index.html
new file mode 100644
index 0000000000..fdef55a96b
--- /dev/null
+++ b/files/ja/mdn/tools/search/index.html
@@ -0,0 +1,158 @@
+---
+title: MDN の検索機能
+slug: MDN/Tools/Search
+tags:
+  - Guide
+  - MDN Meta
+  - Site-wide
+  - Tools
+translation_of: MDN/Tools/Search
+---
+<div>{{MDNSidebar}}</div>
+
+<p class="summary"><span class="seoSummary">MDN のオンサイト検索機能では、外部の検索エンジンで MDN の記事を検索した時には得られない多くの機能が提供されます。この記事では MDN の検索エンジンを最大限に活用する方法を記します。</span></p>
+
+<h2 id="Basic_search_options" name="Basic_search_options">基本的な検索オプション</h2>
+
+<h3 id="Filtering_results" name="Filtering_results">結果をフィルタリングする</h3>
+
+<p>MDN で検索クエリの結果を表示する際に、トピック、技術レベル、文書タイプで結果をフィルタリングするオプションがあります。これは、関連するキーワードが複数の文脈で表示される可能性のあるメソッドを探している場合などに便利です。トピックフィルターを使用して、最も興味のある API の結果のみを表示することができます。これらのフィルターは、ページに設定されたタグによって、どのページを含めるか除外するかを決定します (ページを作成または編集する際に<a href="/ja/docs/MDN/Contribute/Howto/Tag">適切にタグ付けする</a>のはこれが理由です)。以下の種類のフィルターを適用することができます。</p>
+
+<dl>
+ <dt>トピック</dt>
+ <dd>トピックのタグに従って検索結果を絞り込む</dd>
+ <dt>技術レベル</dt>
+ <dd><strong>Beginner</strong>, <strong>Intermediate</strong>, <strong>Advanced</strong> の各タグで絞り込む</dd>
+ <dt>文書タイプ</dt>
+ <dd><strong>Example</strong>, <strong>Guide</strong>, <strong>Tools</strong> の各タグで絞り込む</dd>
+</dl>
+
+<h2 id="Advanced_search_options" name="Advanced_search_options">高度な検索オプション</h2>
+
+<p>MDN 貢献者向けに特定のマクロや HTML 属性などを検索できるよう、マクロの出力ではなく生の HTML でページのソースを検索できる高度な検索機能を用意しています。</p>
+
+<p>今のところこの高度な検索用のユーザーインターフェイスは用意しておらず、URL で直接アクセスすることで利用できます。検索結果は通常の MDN の検索結果ページあるいは JSON フォーマットのいずれかで得られます (後者の検索結果は例えば KumaScript などから使うこともできます)。この節ではその使い方を説明します。</p>
+
+<p><strong>注:</strong> ここで紹介する検索クエリーは広く利用される目的で作る URL ではありません。ツールやユーティリティから使用するためのものであり、将来変更される可能性があります。クエリーのパフォーマンスも高くない場合があります。</p>
+
+<h3 id="Search_query_format" name="Search_query_format">検索クエリーの書式</h3>
+
+<p>高度な検索クエリーは検索に適切な引数を付けた URL で実行してください。ベースとなる URL は次のいずれかです。</p>
+
+<dl>
+ <dt><code>https://developer.mozilla.org/ja/search</code></dt>
+ <dd>通常の MDN 検索結果ページを出力とする場合はこちらを使います。</dd>
+ <dt><code>https://developer.mozilla.org/ja/search.json</code></dt>
+ <dd>JSON 形式で結果を取得する場合はこちらを使います。検索結果の書式については {{anch("JSON response body format")}} をご覧ください。</dd>
+</dl>
+
+<p>これに続けて、欲しい結果を得るには適切なパラメータを追加してください。次のパラメータを組み合わせて利用できます:</p>
+
+<dl>
+ <dt><code>q=</code></dt>
+ <dd>マッチする検索クエリー。これは基本検索で使われるパラメーターと同じです。</dd>
+ <dt><code>locale=</code></dt>
+ <dd>検索対象とするロケール。既定ではすべてのロケールが対象となります。すべてのロケールを明示的に指定するにはワイルドカード "*" を指定することもできます。例えば、 <code>locale=ja</code> とすれば検索結果を日本語だけに絞り込めます。</dd>
+ <dt><code>css_classnames=</code></dt>
+ <dd>検索対象とする CSS クラス名。ページの HTML に少なくとも指定されたクラスが 1 つ以上含まれているページを検索します。</dd>
+ <dt><code>html_attributes=</code></dt>
+ <dd>検索対象とする HTML 属性テキスト。これは前方一致検索です。つまり、指定したテキストが HTML の属性文字列の始めにある場合、検索にマッチします。詳しくは下記をご覧ください。</dd>
+ <dt><code>kumascript_macros=</code></dt>
+ <dd>検索対象とする 1 つ以上の KumaScript のリスト。これをつかって特定のマクロを使った記事を検索できます。例えば、マクロを廃止する場合や、パラメータが変更され既存のページを更新する必要がある場合に便利です。</dd>
+ <dt><code>highlight=</code></dt>
+ <dd><code>true</code> か <code>false</code> のどちらかで、既定では <code>true</code> です。検索クエリーにマッチする結果の周りに <code><a href="/ja/docs/Web/HTML/Element/mark">&lt;mark&gt;</a></code> 要素を含めるかどうかを決めます。</dd>
+ <dt><code>per_page=</code></dt>
+ <dd>100以下の数値です。既定では Kuma はページ当たり10個の結果を出力します。それとは異なる値を使用する場合にこの引数を使用してください。</dd>
+</dl>
+
+<h3 id="Examples" name="Examples">例</h3>
+
+<p>検索例をいくつか示します。</p>
+
+<h4 id="Searching_by_locale" name="Searching_by_locale">ロケールによる検索</h4>
+
+<pre class="syntaxbox notranslate">https://developer.mozilla.org/en-US/search?locale=<var>ja</var></pre>
+
+<p>この例では日本語の記事のリストが得られます。言語 (ロケール) 以外での絞り込みはされません。このページの翻訳時点では 12092 ページが見つかります (もちろん翻訳ページは増え続けているのであなたが試すときにはもっと大きな数になっているはずです！)</p>
+
+<h4 id="Searching_by_CSS_class_name" name="Searching_by_CSS_class_name">CSS クラス名による検索</h4>
+
+<pre class="syntaxbox notranslate">https://developer.mozilla.org/ja/search?locale=ja&amp;css_classnames=<var>smaller</var></pre>
+
+<p>この例では CSS で <code>smaller</code> クラスを使っている記事のリストが得られます。ページ翻訳時点では 42 ページに絞り込まれます。</p>
+
+<h4 id="Searching_by_HTML_attribute_string" name="Searching_by_HTML_attribute_string">HTML 属性文字列による検索</h4>
+
+<pre class="syntaxbox notranslate">https://developer.mozilla.org/ja/search?locale=ja&amp;html_attributes=<var>style</var></pre>
+
+<p>この例では HTML 要素に <code>style</code> 属性が使われている記事のリストが得られます。ページ翻訳時点では 7277 ページが該当します。これらはダメなページで修正されるべきものです。少しずつ標準化したクラスで置き換えていく必要があります。</p>
+
+<p>属性値も含めて検索することはできますが、検索文字列に <code>=</code> や <code>/</code> を含める場合にはこれらを URL エンコードする必要があることに注意してください。例えば、www.mozilla.org にリンクしているページは次のように検索します:</p>
+
+<pre class="syntaxbox notranslate">https://developer.mozilla.org/ja/search?locale=ja&amp;html_attributes=<var>href%3D%22https%3A%2F%2Fwww.mozilla.org</var></pre>
+
+<p>この検索結果は 80 件になりました。www.mozilla.org にリンクしているページは意外と少ないですね！</p>
+
+<h4 id="KumaScript_マクロの使用状況による検索">KumaScript マクロの使用状況による検索</h4>
+
+<pre class="syntaxbox notranslate">https://developer.mozilla.org/ja/search?locale=ja&amp;kumascript_macros=<var>TemplateLink</var></pre>
+
+<p>この例では {{TemplateLink("TemplateLink")}} マクロを使用しているページを検索します。マクロの引数が変更された時や、マクロの使用をやめたいときに検索することができます。</p>
+
+<h3 id="JSON_response_body_format" name="JSON_response_body_format">JSON レスポンス本文の書式</h3>
+
+<p>JSON で検索結果を取得する場合も、通常の検索結果ページ同様に数件ずつのページ単位で結果が返されます。各ページには検索結果に関するメタデータが含まれる KumaScript オブジェクトと、通常のページオブジェクトにページ編集用の URL フィールドが追加されたものの配列が返されます。</p>
+
+<p>結果のオブジェクトに含まれるデータは次の通りです。</p>
+
+<dl>
+ <dt><code>count</code></dt>
+ <dd>検索結果の総数</dd>
+ <dt><code>next</code></dt>
+ <dd>検索結果の次ページ URL (あるいは最終ページの場合は {{JSxRef("Global_Objects/null", "null")}})</dd>
+ <dt><code>previous</code></dt>
+ <dd>検索結果の前ページ URL (あるいは最初のページの場合は {{JSxRef("Global_Objects/null", "null")}})</dd>
+ <dt><code>query</code></dt>
+ <dd>結果を検索するのに使われた検索クエリー</dd>
+ <dt><code>page</code></dt>
+ <dd>このオブジェクトに含まれる検索結果ページ番号</dd>
+ <dt><code>pages</code></dt>
+ <dd>検索結果ページの総数</dd>
+ <dt><code>start</code></dt>
+ <dd>このページの結果のうち最初の項目の番号</dd>
+ <dt><code>end</code></dt>
+ <dd>このページの結果のうち最後の項目の番号</dd>
+ <dt><code>filters</code></dt>
+ <dd>さまざまな検索フィルターの設定を含めた配列。通常の検索に利用可能なフィルターです</dd>
+ <dt><code>documents</code></dt>
+ <dd>マッチしたページの{{anch("Page_objects", "ページオブジェクト")}}の配列</dd>
+</dl>
+
+<h4 id="Page_objects" name="Page_objects">ページオブジェクト</h4>
+
+<p>各ページオブジェクトには次のものが含まれます。</p>
+
+<dl>
+ <dt><code>title</code></dt>
+ <dd>記事タイトル</dd>
+ <dt><code>slug</code></dt>
+ <dd>記事のスラグ。ページの URL のうち、ロケール名とスラッシュに続くものすべてです。</dd>
+ <dt><code>locale</code></dt>
+ <dd>ページのロケール</dd>
+ <dt><code>excerpt</code></dt>
+ <dd>ページコンテンツの断片 (スニペット)。これは記事本文の冒頭部分か、"SEO Summary" クラスが使われていればそのクラスで指定されたコンテンツ。<a href="/ja/docs/MDN/Contribute/Tools/Search$edit#Search_query_format">検索クエリ引数</a>内で <code>highlight=false</code> を指定しない限り、excerpt には <code><a href="/ja/docs/Web/HTML/Element/mark">&lt;mark&gt;</a></code> 要素が入ります。</dd>
+ <dt><code>url</code></dt>
+ <dd>ページの完全な URL</dd>
+ <dt><code>edit_url</code></dt>
+ <dd>ページを編集モードで開く完全な URL</dd>
+ <dt><code>tags</code></dt>
+ <dd>ページのタグの配列</dd>
+ <dt><code>score</code></dt>
+ <dd>検索エンジンで割り当てられたスコア値</dd>
+ <dt><code>explanation</code></dt>
+ <dd>検索クエリーにどのように何故マッチしたかという検索エンジンからの雑多な情報。このコンテンツの詳細についてはこのページでは解説しません。</dd>
+</dl>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+
+<p>追加の<a href="/ja/docs/MDN/Kuma/Getting_started#Finding_pages">管理者のみの検索機能</a>がいくつかあり、例えばスラッグが特定の文字で始まっているページを検索したりすることができます。</p>
diff --git a/files/ja/mdn/tools/template_editing/index.html b/files/ja/mdn/tools/template_editing/index.html
new file mode 100644
index 0000000000..d32794f82e
--- /dev/null
+++ b/files/ja/mdn/tools/template_editing/index.html
@@ -0,0 +1,38 @@
+---
+title: テンプレートの編集
+slug: MDN/Tools/Template_editing
+tags:
+  - Page-level
+translation_of: MDN/Tools/Template_editing
+---
+<div>{{MDNSidebar}}</div><p>MDNでは、 <a href="/ja/docs/MDN/Contribute/Tools/KumaScript">KumaScript</a> で書かれたテンプレートがコンテンツの自動生成、およびページのカスタマイズに使われています。 それぞれのテンプレートは、別々の Wiki ページに置かれていて、ページ名は以下のとおりです:<br>
+ <code>/en-US/docs/Template:<em>テンプレートの名前</em></code></p>
+
+<p><span class="seoSummary">MDN の Wikiを編集している人なら誰でも、マクロを通じてテンプレートを呼び出すことができます。KumaScript は強力なので、テンプレートの作成と編集のための権限は、必要な経験を持ち合わせた信頼できるユーザーのみに与えられています。</span></p>
+
+<h2 id="この権限を持つ役割の人">この権限を持つ役割の人</h2>
+
+<ul>
+ <li><a href="/ja/docs/MDN/Community/Roles/Admins"><strong>MDN管理者</strong></a></li>
+ <li><a href="/ja/docs/MDN/Community/Roles/Topic_driver_role"><strong>トピックドライバ</strong></a></li>
+ <li><a href="/ja/docs/MDN/Community/Roles/Localization_driver_role"><strong>ローカライゼーションドライバ</strong></a></li>
+</ul>
+
+<h2 id="この権限を得るための条件">この権限を得るための条件</h2>
+
+<p>このツールにアクセスする権限を得るための条件は以下のとおりです:</p>
+
+<ul>
+ <li><strong>常に</strong>この権限を必要としていること。 例えば、新しいマクロの作成する、古いマクロを修正する、または多くをローカライズするなど。</li>
+ <li>MDN を定期的に編集していて、 JavaScript でのコードの書き方を知っていること、そしてKumaScript によるテンプレートの制約とリスクを知っていること。</li>
+ <li>"テンプレート編集権限を持っているpeer" のうち<strong>2人による</strong>保証があり、なおかつどの peer からも<strong>拒否</strong>されていないこと。</li>
+</ul>
+
+<p>この権限を得るためのプロセスについては、<a href="https://developer.mozilla.org/en-US/docs/MDN/Contribute/Processes/Requesting_elevated_privileges">上位権限のリクエスト</a> を見てください。</p>
+
+<h2 id="テンプレート編集の権限を持っている人（peer）たち">テンプレート編集の権限を持っている人（peer）たち</h2>
+
+<ul>
+ <li>現在の peer: <a href="/en-US/profiles/sheppy/">Sheppy</a>,  <a href="/en-US/profiles/teoli">teoli</a>, <a href="/en-US/profiles/Fscholz">fscholz</a>, <a href="/en-US/profiles/wbamberg">wbamberg</a>, <a href="/en-US/profiles/Chrisdavidmills">chrisdavidmills</a>, <a href="/en-US/profiles/Jeremie">Jeremie</a>.</li>
+ <li>新たな peer の追加、peer の削除は、現在の peer の賛同を得ることで行われます。</li>
+</ul>
diff --git a/files/ja/mdn/tools/zones/index.html b/files/ja/mdn/tools/zones/index.html
new file mode 100644
index 0000000000..2bb4599e2d
--- /dev/null
+++ b/files/ja/mdn/tools/zones/index.html
@@ -0,0 +1,203 @@
+---
+title: ゾーン
+slug: MDN/Tools/Zones
+tags:
+  - Deprecated
+  - Guide
+  - MDN Meta
+  - Site-wide
+  - Tools
+translation_of: Archive/MDN/Zones
+---
+<div>{{MDNSidebar}}</div><p><span class="seoSummary"><strong>ゾーン</strong>は MDN の特別なエリアで、そのコンテンツは特別ゾーンナビゲーションボックス、ページのヘッダにおける強調された視覚要素のような追加ユーザインタフェースと共に提供されます。</span> このガイドはゾーンの構築と維持について取り扱います。</p>
+
+<div class="warning">
+<p><strong>ゾーンの使用は廃止されました</strong><br>
+ Due to an unsatisfactory user experience and the performance costs of its implementation, we are in the process of deprecating zones. <em>Please only create a new zone if you absolutely must</em>; generally, this should only be done to fix problems related to content which is a zone in English but not in other locales.  Please drop into #mdn on IRC to ask questions about anything you read here, especially if you're considering creating a zone or turning any existing material into a zone.</p>
+</div>
+
+<h2 id="ゾーンの特徴">ゾーンの特徴</h2>
+
+<p>Once you've created a zone, as covered below, you have various special features and abilities that you can, and should, take advantage of:</p>
+
+<ul>
+ <li>A colored header area with a color that uniquely identifies your zone.</li>
+ <li>A "hero image" representing the zone in the header area.</li>
+ <li>A zone landing page, at the base of the zone's navigation hierarchy, which presents a larger than usual banner area with the hero image in a large size and space for a short blurb describing the zone.</li>
+ <li>A special navigation sidebar; zones may include content from anywhere on MDN in this navigation, even if they're not actually contained within the zone's direct hierarchy.</li>
+ <li>Subpages of the zone's landing page — that is, pages actually physically located beneath the landing page — inherit the zone's color and hero image, with a smaller banner area at the top of the page.</li>
+</ul>
+
+<p>There are basically two types of zone: the <strong>in-wiki zone</strong>, and the <strong>mini-site zone</strong>.</p>
+
+<h3 id="Wiki_内のゾーン">Wiki 内のゾーン</h3>
+
+<p>An <strong>in-wiki zone</strong> is a zone which takes advantage of zone functionality while remaining part of the main flow of MDN's documentation content.  These are sort of semi-zones, in that they generally don't include content from outside their own hierarchy.</p>
+
+<p>An in-wiki zone allows a segment of MDN to add the additional visuals and, probably more importantly, the zone navigation sidebar, without removing the user from the main flow of MDN content.</p>
+
+<div class="note">
+<p><strong>Note:</strong> In-wiki zones do not typically appear in the "Zones" list on the MDN home page, since they're treated as part of the main body of MDN's documentation content.</p>
+</div>
+
+<h3 id="ミニサイト_ゾーン">ミニサイト ゾーン</h3>
+
+<p>A <strong>mini-site zone</strong> is a zone which, while edited and managed using the same interface as any wiki page on MDN, is presented outside the main flow of documentation content. In all functional respects, it supports all the standard wiki functionality provided by the <a href="/en-US/docs/MDN/Kuma">Kuma</a> platform on which MDN is built. A good example is the <a href="/en-US/Apps">App Center</a>.</p>
+
+<p>When a mini-site zone is created, it is given a new URL outside the "/docs/" tree on MDN, typically at the URL <code>https://developer.mozilla.org/<em>&lt;locale&gt;</em>/zone/<em>&lt;your_zone_name&gt;</em></code>.</p>
+
+<div class="note">
+<p><strong>Note:</strong> In general, only very high-profile, special-purpose content should be moved out of the wiki hierarchy; these zones are intended primarily for setting up special-purpose promotional and/or program-related content.</p>
+</div>
+
+<h2 id="何をゾーンにするべきか">何をゾーンにするべきか?</h2>
+
+<p>This is an interesting question, and to be honest, the answer is likely to change over time. Zones are a new concept for MDN, and we're still learning exactly how we'll use them.</p>
+
+<p>There are basically two reasons to create a zone:</p>
+
+<ol>
+ <li>You need to set up a <strong>mini-site</strong> for a promotional campaign or a specific product.</li>
+ <li>You want to create a one-stop shop, so to speak, for a topic that spans multiple technology areas.</li>
+</ol>
+
+<h2 id="ゾーンを作成する">ゾーンを作成する</h2>
+
+<p>The first step is to create the content. At a minimum, you need to create the initial landing page that will become the root page for your zone. Once you have at least the root page, and possibly even your sub-content, you can then have the pages turned into a zone.</p>
+
+<p>In order to turn a section of MDN into a zone requires MDN administrator privileges, so you'll need to ask an MDN administrator to do it for you. There are a few things you'll need to provide to the admin as part of your request:</p>
+
+<ul>
+ <li>What page on MDN should be turned into the root page for the new zone. Keep in mind that all pages below it in the site's hierarchy will become part of the zone.</li>
+ <li>Is your zone an {{anch("In-wiki zones", "in-wiki zone")}} or a {{anch("Mini-site zones", "mini-site zone")}}?</li>
+ <li>You'll need to provide style information and artwork for the customization of the header area in the new zone. See {{anch("Customizing the appearance")}} for details.</li>
+</ul>
+
+<div class="note">
+<p><strong>Note:</strong> Because zones are a special-purpose construct, you will likely be asked to justify why the content should be a zone at all. Refer to {{anch("What should be a zone.3F", "What should be a zone?")}} for insight.</p>
+</div>
+
+<h2 id="ゾーンのアクセスポリシーを変更する">ゾーンのアクセスポリシーを変更する</h2>
+
+<p>At this time, there's no functional support for access control for zones. This functionality is coming in the future. If you need access control for your zone, please let us know, so we can adjust the priority of that work.</p>
+
+<h2 id="表示をカスタマイズする">表示をカスタマイズする</h2>
+
+<p>Part of what makes a zone a zone is the ability to customize its visual identity. Minimally, this means a special color and image used as the background in the header area of the zone's pages to help the user know that they're in a specific zone. It's also possible to make other basic adjustments to the appearance of the page, as long as the overall feeling of being on MDN is retained.</p>
+
+<div class="note">
+<p><strong>Note:</strong> It's important to keep in mind that the instructions below are <strong>suggestions</strong>. You can try to tinker further with the CSS for your zone. Just keep in mind that your changes may be reviewed by our UX and/or design teams, and will be expected to blend in well with the rest of MDN.</p>
+</div>
+
+<h3 id="基本的なカスタマイズ">基本的なカスタマイズ</h3>
+
+<p>The basic, required customizations for each zone are the background color and image for the header area of the pages in the zone. When requesting that a zone be created, you'll be asked to provide these. Here are basic guidelines to what you need to provide.</p>
+
+<ul>
+ <li>The background color should be reasonably distinctive from other zones' backgrounds, while being relevant to the topic area covered by the zone. You should specify this to the MDN administrator setting up your zone as a {{cssxref("&lt;color&gt;")}}.</li>
+ <li>The background image is, by default, presented near the right side of the header area (or the left side in a right-to-left locale). This image may be in any Web-compatible format, although PNG is generally best. It should either blend into your specified background color or (preferably) have a transparent background. As a general rule, the background image should be about 468 pixels wide and 400 pixels tall, although the CSS on the page can be set to use {{cssxref("overflow")}} to crop it if necessary. That said, making the image too large increases page size, so that should be avoided.</li>
+ <li>The image may be sent to the MDN admin with your zone creation request, or may be one that's already been uploaded to MDN as an attachment to an appropriate page.</li>
+</ul>
+
+<p>With this information, the MDN admin team can set up the basic CSS for your zone for you. If you'd like, however, you can go a step farther and provide the CSS yourself. By following the guidelines in {{anch("Additional customizations")}}, you can experiment with other changes to the appearance of your zone.</p>
+
+<h3 id="さらなるカスタマイズ">さらなるカスタマイズ</h3>
+
+<p>If you'd like to investigate additional customization options, take a look at the CSS/stylus template located <a href="https://github.com/mozilla/kuma/blob/master/media/redesign/stylus/zones.styl">in github</a>. This lists all the Stylus CSS for the styles you're allowed to alter using your zone's custom CSS.</p>
+
+<p>If you wish to perform additional customizations, you may do so, with one major caveat: your customizations must not be so drastic that they make the pages in the zone no longer "feel" like part of MDN.</p>
+
+<p>When customizing the zone's stylesheet, it's your job to sort out from the template which styles you want to alter and to put together the CSS to do so. Once you've done so, provide that CSS to the MDN admin team, and they'll install it for you.</p>
+
+<p>All zone-related content has the class <code>zone</code> on it.</p>
+
+<div class="note">
+<p><strong>Note:</strong> Please note that because the site is actively undergoing development, anything about specific classes and styles discussed here is subject to change without notice.</p>
+</div>
+
+<h4 id="背景色">背景色</h4>
+
+<p>As mentioned previously, the first thing you're likely to customize is the background color for your zone's header area. The CSS looks something like this:</p>
+
+<pre class="brush: css notranslate">.zone #main-header, .zone .zone-article-header, .zone .zone-landing-header {
+    background-color: <strong><em>zone-color</em></strong>;
+}
+</pre>
+
+<p>The ID <code>main-header</code> refers to the site navigation area at the very top of the page. This includes the "Mozilla" cross-site navigation tab, search box, and other global navigation functionality.</p>
+
+<p>The class <code>zone-article-header</code> represents the appearance of the header area on article pages within the zone. That is, all pages other than the base landing page within the zone will have this class on their heading area.</p>
+
+<p>The class <code>zone-landing-header</code> is used for the header area on the zone's landing page. This is the taller heading area on the landing page, with the larger image in it.</p>
+
+<p>As a general rule, you want all of these areas to have the same color; indeed, the article and landing page header colors should be the same. The only reason you might configure them differently is if they were gradients and you wanted to adjust them to have the same overall "average" color despite the different height of the space.</p>
+
+<p><strong>In short:</strong> Replace <strong><em>zone-color</em></strong> in the CSS snippet above with the {{cssxref("&lt;color&gt;")}} you've selected for your zone color.</p>
+
+<h4 id="ランディングページのヘッダ画像">ランディングページのヘッダ画像</h4>
+
+<p>You will also want to change the image that represents your zone on the zone's landing page. This page has a larger header box to accomodate a larger image to represent your zone. The CSS looks like this:</p>
+
+<pre class="brush: css notranslate">.zone .zone-landing-header .zone-image {
+    background-image: url(<strong><em>zone-image-url</em></strong>);
+}
+</pre>
+
+<p>The <code>zone-image</code> class is used to specify and style the image for your zone's landing page header. This image should be no wider than 468 pixels, although you can override this by using additional CSS here. Simply replace <em><strong>zone-image-url</strong></em> with the URL of the image to use.</p>
+
+<div class="note">
+<p><strong>Note:</strong> The easiest way to provide the image is to simply attach it to an appropriate page on MDN and use the resulting URL.</p>
+</div>
+
+<h4 id="記事ページのヘッダ画像">記事ページのヘッダ画像</h4>
+
+<p>Additionally, you should set the image that represents your zone on its subpages. By default, this image is constrained to 200 pixels wide by 400 pixels tall, but, again, that can be overridden.</p>
+
+<pre class="brush: css notranslate">.zone .zone-article-header .zone-image {
+    background-image: url(<strong><em>zone-image-url</em></strong>);
+}
+</pre>
+
+<p>Just replace <em><strong>zone-image-url</strong></em> with the URL of the image to use.</p>
+
+<div class="note">
+<p><strong>Note:</strong> The easiest way to provide the image is to simply attach it to an appropriate page on MDN and use the resulting URL. You can choose to use the same image as you do for the landing page header image, with some scaling or cropping applied, or you can use a different image.</p>
+</div>
+
+<h4 id="ヘッダボタンの下の境界">ヘッダボタンの下の境界</h4>
+
+<p>The last thing you're generally advised to change is the appearance of the bottom border of the buttons in the zone header area. This is the CSS:</p>
+
+<pre class="brush: css notranslate">.zone .zone-landing-header a.button {
+    box-shadow: inset 0 -1px <strong><em>color</em></strong>;
+}
+</pre>
+
+<p>Here, replace <strong><em>color</em></strong> with a {{cssxref("&lt;color&gt;")}} that is very similar to your background color, but slightly darker.</p>
+
+<h2 id="ゾーンナビゲーション">ゾーンナビゲーション</h2>
+
+<h3 id="ゾーンナビゲーションサイドバー">ゾーンナビゲーションサイドバー</h3>
+
+<p>The sidebar appearing on every page in a zone is defined in the zone's landing page content, in a section called "Subnav" (visible only when editing the page). This section may contain a manually curated list of pages or use a macro, such as {{TemplateLink("ListSubpages")}}. In the latter case you will need to <a href="/en-US/docs/MDN/Kuma/Introduction_to_KumaScript#Caching">force-reload</a> (shift+refresh) the zone's landing page in order to update the sidebar.</p>
+
+<h3 id="クイックリンク">クイックリンク</h3>
+
+<p>As is the case with any page on MDN, pages within zones may use the <a href="/en-US/docs/MDN/Contribute/Content/Quicklinks">quicklinks</a> feature. Quicklinks are a navigation box, presented in the left sidebar area, offering links the user may follow to related material. These links may be within MDN or off-site, and may be nested up to two total levels deep, using folders.</p>
+
+<p>To aid in generating common types of quicklinks for zones, we have some macros you can use.</p>
+
+<h4 id="QuickLinksWithSubpages">QuickLinksWithSubpages</h4>
+
+<p>The {{TemplateLink("QuickLinksWithSubpages")}} macro generates all of the HTML required to present a quicklinks box on the page with the links corresponding to the pages in a specified hierarchy. You can also use it with no parameters at all to present quicklinks of subpages of the current page, although this is not commonly as useful in a zone since the zone navigation will generally present this for you.</p>
+
+<h2 id="ゾーンのスタイルガイド">ゾーンのスタイルガイド</h2>
+
+<h2 id="注記">注記</h2>
+
+<p>This section offers some notes that are worth keeping in mind when creating, working with, and using zones.</p>
+
+<ul>
+ <li>Every page in a zone automatically inherits the navigation sidebar provided on their zone's root page.</li>
+ <li>If a page in a zone has a quicklinks section, the quicklinks are displayed below the zone's navigation in the sidebar. Toggling off the quicklinks makes both the quicklinks and the navigation bar disappear, allowing more room for the page content.</li>
+</ul>