initial commit

2 files changed, 234 insertions, 0 deletions

diff --git a/files/ja/mdn/about/index.html b/files/ja/mdn/about/index.html
new file mode 100644
index 0000000000..561a45fbbf
--- /dev/null
+++ b/files/ja/mdn/about/index.html
@@ -0,0 +1,146 @@
+---
+title: MDN Web Docs について
+slug: MDN/About
+tags:
+  - Collaborating
+  - Community
+  - Copyright
+  - Documentation
+  - Guide
+  - Licenses
+  - MDN Meta
+  - ガイド
+  - コミュニティ
+  - ドキュメント
+  - ライセンス
+  - 著作権
+translation_of: MDN/About
+---
+<div>{{MDNSidebar}}</div>
+
+<div>{{IncludeSubNav("/ja/docs/MDN")}}</div>
+
+<p>MDN Web Docs (以前は MDN — Mozilla Developer Network と呼ばれていました) は進化し続ける学習プラットフォームであり、下記に挙げるようなウェブ技術とウェブを支えるソフトウェアについて学ぶことができます。</p>
+
+<ul>
+ <li><a href="/ja/docs/CSS" title="/ja/docs/CSS">CSS</a>、<a href="/ja/docs/HTML" title="/ja/docs/HTML">HTML</a>、<a href="/ja/docs/JavaScript" title="/ja/docs/JavaScript">JavaScript</a> などのウェブ標準</li>
+ <li><a href="/ja/docs/Apps" title="/ja/docs/Apps">オープンなウェブアプリの開発</a></li>
+ <li><a href="/ja/docs/Mozilla/Add-ons" title="/ja/docs/Add-ons">Firefox のアドオン開発</a></li>
+</ul>
+
+<h2 id="Our_mission" name="Our_mission">我々のミッション</h2>
+
+<p>MDN のミッションは単純です。開発者が<a href="/ja/docs/Web">オープンなウェブ</a>上でプロジェクトを簡単に構築できるようにする情報を提供することです。ウェブ上で公開されているオープンなテクノロジーであれば、どんなものでも私たちは文書化したいと考えています。</p>
+
+<p>また、<a href="/ja/docs/Mozilla">Mozilla の製品</a>に関するドキュメントや、<a href="/ja/docs/Mozilla">Mozilla プロジェクトをビルドしたり、プロジェクトに協力する</a>方法に関するドキュメントも提供します。</p>
+
+<p>もしあるトピックを MDN に含めるべきか、自信を持って判断できないときは、<a href="ja/docs/MDN/Contribute/Guidelines/Does_this_belong_on_MDN">これは MDN に含まれますか？</a> のページを読んでみてください。</p>
+
+<h2 id="How_you_can_help" name="How_you_can_help">協力する方法</h2>
+
+<p>MDN を手助けるには、プロのコーダーやライターになる必要はありません。文書の意味が通るかを確認する編集レビュー、ちょっとした文章の寄稿、サンプルコードの追加など、いろいろな方法があります。実際にとても多くの方法があるため、私たちは <a href="/ja/docs/MDN/Getting_started">MDN を始めよう</a> ページを用意しています。あなたがどんなことに興味があるか、またどれだけ使える時間があるのかによって、自分にピッタリのタスクを見つけて貢献してみてください。</p>
+
+<p>また、あなたのブログやウェブサイトで <a href="/ja/docs/MDN/About/Promote">MDN の宣伝をする</a> ことも私たちの助けになります。</p>
+
+<h2 id="The_MDN_community" name="The_MDN_community">MDN コミュニティ</h2>
+
+<p>私たちのコミュニティはグローバルなコミュニティです。世界中に様々な言語で作業をするすばらしい協力者の皆さんがいます。私たちについてもっと知りたい、あるいは MDN に関する助けが必要な場合は、<a href="https://discourse.mozilla-community.org/c/mdn">ディスカッションフォーラム</a>に参加してください。英語のでのコミュニケーションになります。<a href="http://twitter.com/MozDevNet">@MozDevNet</a> の Twitter アカウントをフォローして最新情報を追いかけることもできます。何かの間違いを見つけたりフィードバックしたり (感謝したり) したい場合、ライターや貢献者にツイートすることもできます。</p>
+
+<h2 id="Using_MDN_Web_Docs_content" name="Using_MDN_Web_Docs_content">MDN Web Docs の使用</h2>
+
+<p>MDN のコンテンツは無償で、オープンソースライセンスの下に利用できます。</p>
+
+<h3 id="Copyrights_and_licenses" name="Copyrights_and_licenses">著作権とライセンス</h3>
+
+<p>MDN のコンテンツはオープンソースライセンスの下で完全に利用できます。この節はどんな種類のコンテンツがあり、それぞれがどんなライセンスが有効かを網羅します。</p>
+
+<h4 id="Documentation_and_articles" name="Documentation_and_articles">文書と記事</h4>
+
+<p><strong>MDN の wiki 文書</strong>は、 Mozilla Foundation の内外のライターの協力により作成されています。特に明記されていない限り、コンテンツは <a class="external text" href="https://creativecommons.org/licenses/by-sa/2.5/" rel="nofollow">Creative Commons: Attribution-Sharealike license</a> (CC-BY-SA), v2.5 もしくはそれ以上のバージョンの条件の下で利用可能です。</p>
+
+<p>MDN コンテンツを再利用するときは、2 つのことを確認する必要があります。</p>
+
+<ol>
+ <li>
+  <p>帰属は元のコンテンツに与えられます</p>
+
+  <p>"Mozilla Contributors" を属性とし、ソースとなるコンテンツの特定の Wiki ページへのハイパーリンク (オンラインの場合) または URL (印刷物の場合) を含めてください。たとえば、この記事の帰属を示すには、次のように書くことができます。</p>
+
+  <blockquote>
+  <p><a href="https://developer.mozilla.org/ja/docs/MDN/About">About MDN</a> by <a href="https://developer.mozilla.org/ja/docs/MDN/About$history">Mozilla Contributors</a> is licensed under <a href="https://creativecommons.org/licenses/by-sa/2.5/">CC-BY-SA 2.5</a>.</p>
+  </blockquote>
+
+  <p>この例では、"Mozilla Contributors" が引用ページの履歴にリンクしていることに注意してください。詳しい説明は<a href="https://wiki.creativecommons.org/wiki/Best_practices_for_attribution">帰属のベストプラクティス</a>を参照してください。</p>
+ </li>
+ <li>
+  <p>あなたの再利用はオリジナルのコンテンツと同じライセンスの下で公開されています。つまり CC-BY-SA v2.5 またはそれ以降のバージョンです</p>
+ </li>
+</ol>
+
+<h4 id="Code_samples_and_snippets" name="Code_samples_and_snippets">コードサンプルとスニペット</h4>
+
+<p>2010 年 8 月 20 日以降に追加されたコードサンプルは、<a class="external" href="https://creativecommons.org/publicdomain/zero/1.0/">パブリックドメイン</a> (<a href="https://creativecommons.org/publicdomain/zero/1.0/">CC0</a>) にあります。ライセンス通知は必要ありませんが、必要な場合は、"すべての著作権はパブリックドメインに帰属します。http://creativecommons.org/publicdomain/zero/1.0/" を使用できます。</p>
+
+<p>2010 年 8 月 20 日より前にこの wiki に追加されたコードサンプルは <a class="external" href="https://opensource.org/licenses/mit-license.php">MIT ライセンス</a>の下で利用可能です。次の帰属情報を MIT テンプレートに挿入する必要があります。"©&lt;Wiki ページの最終改訂日&gt; &lt;Wiki に掲載した人の名前&gt;"</p>
+
+<p>コードサンプルがどのライセンスで利用可能かを判断することができます。履歴を表示するには:</p>
+
+<ol>
+ <li>記事のヘッダーにある <strong>Wiki で編集</strong> ボタンをクリックします。これで、<a href="https://wiki.developer.mozilla.org">編集可能な、MDN Web Docs の Wiki バージョン</a>に移動します (しかし、実際に編集モードに入っているのではありません)。</li>
+ <li>Wiki 記事の右上にある歯車アイコンをクリックし、表示されたメニューで <strong>履歴</strong>を選択します。</li>
+ <li><strong>すべて見る</strong>をクリックし、2010 年 8 月 20 日以前の最新のリビジョンを見つけます。</li>
+ <li>リビジョンの日付をクリックしてその日の記事のバージョンを確認します。</li>
+</ol>
+
+<p>サンプルがある場合は、ライセンスが変更される前に追加されたものであり、MIT ライセンスの条件で利用可能です。サンプルがないか、2010 年 8 月 20 日以前のリビジョンがない場合、変更後に追加されたものであり、パブリックドメインです。</p>
+
+<h4 id="Contributions" name="Contributions">貢献</h4>
+
+<p>この wiki に協力したい場合は、Attribution-ShareAlike ライセンス (または編集中のページで既に指定されている代替ライセンス) でドキュメントを公開し、<a href="https://creativecommons.org/publicdomain/zero/1.0/">Creative Commons CC-0</a> (パブリックドメインの献身) でコードサンプルを公開する必要があります。この wiki に追加することは、あなたの協力がそれらのライセンスの下で利用可能になることにあなたが同意することを意味します。</p>
+
+<p>一部の古いコンテンツは、前述以外のライセンスで利用可能になりました。これらは<a class="internal" href="/Archive/Meta_docs/Examples/Alternate_License_Block">代替ライセンスブロック</a>によって各ページの下部に示されています。</p>
+
+<div class="warning">
+<p>新しいページをその他のライセンスで作成してはいけません。</p>
+</div>
+
+<p><strong>ユーザーから提供された資料の著作権については、著作者がそれを第三者に譲渡しない限り、著作者に帰属するものとします。</strong></p>
+
+<p>ここに記載されている内容について、質問や懸念事項があれば、<a class="external" href="mailto:mdn-admins@mozilla.org?subject=MDN%20licensing%20question" rel="nofollow" title="mailto:eshepherd@mozilla.com">MDN 管理者</a> までご連絡ください。</p>
+
+<h4 id="Logos_trademarks_service_marks_and_wordmarks" name="Logos_trademarks_service_marks_and_wordmarks">ロゴ、商標、サービスマーク、ワードマーク</h4>
+
+<hr>
+<p>Mozilla Foundation の商標、ロゴ、サービスマークの権利、およびこのウェブサイトの操作画面や{{訳語("操作感","look and feel")}}は、Creative Commons: Attribution-Sharealike license ライセンスに基づいて提供されるものではなく、それらが (ロゴや画像デザインといった) 著作物である限り、上記の条件に基づいて許諾される著作物には含まれません。あなたが文書のテキストを利用する場合、上述の権利を行使しようとする場合、またはこのサイトにおける私たちのライセンス条件について、その他の質問がある場合は、Mozilla Foundation の窓口 <a class="external text" href="mailto:licensing@mozilla.org" rel="nofollow" title="mailto:licensing@mozilla.org">licensing@mozilla.org</a> までご連絡ください。</p>
+
+<h3 id="Linking_to_MDN" name="Linking_to_MDN">MDN にリンクするには</h3>
+
+<p>リンクを張るときは、ガイダンス記事 <a href="/ja/docs/MDN/About/Linking_to_MDN">MDN にリンクするには</a>に従うのがベストプラクティスです。</p>
+
+<h2 id="Downloading_content" name="Downloading_content">コンテンツをダウンロードするには</h2>
+
+<h3 id="Single_pages" name="Single_pages">単一ページのダウンロード</h3>
+
+<p>単一ページのコンテンツについては、ダウンロードしたいフォーマットを <a href="https://developer.mozilla.org/ja/docs/MDN/Contribute/Tools/Document_parameters#URL_parameters">URL パラメーター</a>に追加することで、取得することができます。</p>
+
+<h3 id="Third-party_tools" name="Third-party_tools">サードパーティ製のツールを使ったダウンロード</h3>
+
+<p>MDN のコンテンツは、<a href="http://kapeli.com/dash">Dash</a> (macOS 用) や <a href="http://zealdocs.org/">Zeal</a> (Linux および Windows用) などのサードパーティ製のツールを使っても読むことができます。</p>
+
+<p><a href="https://kapeli.com/">Kapeli</a> も <a href="https://kapeli.com/mdn_offline">オフラインで使用できる MDN 文書</a> を公開しており、HTML、CSS、JavaScript、SVG、XSLT が含まれます</p>
+
+<h2 id="Reporting_problems_with_MDN_Web_Docs" name="Reporting_problems_with_MDN_Web_Docs">MDN Web Docs の問題を報告する</h2>
+
+<p><a href="/ja/docs/MDN/Contribute/Howto/Report_a_problem">MDN の問題を報告する</a> を読んでください。</p>
+
+<h2 id="History_of_MDN_Web_Docs" name="History_of_MDN_Web_Docs">MDN Web Docs の歴史</h2>
+
+<p>MDN Web Docs (かつては Mozilla Developer Network (MDN)、その前は Mozilla Developer Center (MDC) として知られ、また <em>Devmo</em> としても知られていた) プロジェクトは、2005年初頭、 <a class="external" href="https://foundation.mozilla.org">Mozilla Foundation</a> が AOL からオリジナルの Netscape <a href="https://web.archive.org/web/*/devedge.netscape.com">DevEdge</a> のコンテンツの使用ライセンスを取得した時点から始まりました。 DevEdge のコンテンツの中からまだ使える素材が探し出され、更新と維持が楽になるよう、ボランティアによって wiki に移されました。</p>
+
+<p>2017年7月に名前が MDN Web Docs に変更されました。この決定の背景となる理念については <a href="https://blog.mozilla.org/opendesign/future-mdn-focus-web-docs/">The Future of MDN: A Focus on Web Docs</a> をご覧ください。</p>
+
+<p>さらに詳しい MDN の歴史については、私たちのページ <a href="https://developer.mozilla.org/ja/docs/MDN_at_ten">MDN は 10 周年を迎えました</a>を参照してください。当時の関係者から聞き取った内容も含まれています。</p>
+
+<h2 id="About_Mozilla" name="About_Mozilla">Mozilla について</h2>
+
+<p>私たちがどんな組織なのかもっと知りたい、どうすれば <em>Mozilla</em> の一員になれるのか知りたい、あるいは単に私たちがどこにいるのか知りたい。そう考えているあなたは、正しい場所に来ています。何が私たちを動かしているのか、そして他の組織とは違ったものにしているのか、そうしたことを知りたければ、私たちの<a href="https://www.mozilla.org/ja/mission/">ミッション</a>のページを訪れてみてください。</p>
diff --git a/files/ja/mdn/about/linking_to_mdn/index.html b/files/ja/mdn/about/linking_to_mdn/index.html
new file mode 100644
index 0000000000..c7b7e87623
--- /dev/null
+++ b/files/ja/mdn/about/linking_to_mdn/index.html
@@ -0,0 +1,88 @@
+---
+title: MDN にリンクするには
+slug: MDN/About/Linking_to_MDN
+tags:
+  - Documentation
+  - Guide
+  - MDN
+translation_of: MDN/About/Linking_to_MDN
+---
+<div>{{MDNSidebar}}</div><p><span class="seoSummary">MDN にリンクするガイドラインやそもそもリンクして良いのか聞かれることがありますが、もちろん<strong> OK です。MDN にリンクして頂いて構いません。</strong>その際のガイドラインやベストプラクティスが必要であれば続けて読んでください。</span></p>
+
+<h2 id="MDN_にリンクして良いですか？">MDN にリンクして良いですか？</h2>
+
+<p><strong>はい！</strong>是非どうぞ！ハイパーテキストリンクは Web の本質的な機能であるだけでなく、ユーザに価値あるリソースを指し示す方法であると共に、私たちのコミュニティの成果に対する信頼を示すことでもあります。</p>
+
+<p>ですから、MDN のコンテンツへのリンクは是非遠慮なくしてください。<a href="/">MDN のフロントページ</a>、あるいは必要に応じて MDN 内の特定ページにリンクしてください。リンク先ページ選択のベストプラクティスは以下の通りです。</p>
+
+<h2 id="どのページにリンクすべきですか？">どのページにリンクすべきですか？</h2>
+
+<p>リンクすべき特定のページは決まっていません。<strong>あなたの読者に役立つのがどのページか</strong>というのが大事です。</p>
+
+<ul>
+ <li>MDN 自体について書かれている時はメインページにリンクしていただけます: <a href="/">https://developer.mozilla.org/</a></li>
+ <li>特定領域や技術について言及される場合は特定のトピックについて目次や索引となる<strong>ランディングページ</strong>と呼ばれるページにリンクするのが良いでしょう。例えばこのようなページです:
+  <ul>
+   <li>HTML: <a href="/ja/docs/Web/HTML">https://developer.mozilla.org/ja/docs/Web/HTML</a></li>
+   <li>HTML5: <a href="/ja/docs/Web/Guide/HTML/HTML5">https://developer.mozilla.org/ja/docs/Web/Guide/HTML/HTML5</a></li>
+   <li>CSS: <a href="/ja/docs/Web/CSS">https://developer.mozilla.org/ja/docs/Web/CSS</a></li>
+   <li>CSS3: <a href="/ja/docs/Web/CSS/CSS3">https://developer.mozilla.org/ja/docs/Web/CSS/CSS3</a></li>
+   <li>DOM: <a href="/ja/docs/Web/API/Document_Object_Model">https://developer.mozilla.org/ja/docs/Web/API/Document_Object_Model</a></li>
+   <li>JavaScript: <a href="/ja/docs/Web/JavaScript">https://developer.mozilla.org/ja/docs/Web/JavaScript</a></li>
+  </ul>
+ </li>
+ <li>特定のページや技術などについて書かれている場合は個別のページにリンクするのが良いでしょう。例えば:
+  <ul>
+   <li>HTML の要素について説明しているなら、HTML 要素リストページ (<a href="/ja/docs/Web/HTML/Element">https://developer.mozilla.org/ja/docs/Web/HTML/Element</a>) や {{HTMLElement("colgroup")}} など個別要素のページ</li>
+   <li>同様に CSS についても CSS リファレンス (網羅的な目次ページ: <a href="/ja/docs/Web/CSS/Reference">https://developer.mozilla.org/ja/docs/Web/CSS/Reference</a>) や {{cssxref("list-style-type")}} といった特定プロパティのページ</li>
+  </ul>
+ </li>
+</ul>
+
+<p><strong>いずれにしても、リンク元ページや読者にとって最適なページにリンクしてください。</strong>リンクや私たちではなく、読者こそが大事なのですから。</p>
+
+<h2 id="良いリンクの仕方は？">良いリンクの仕方は？</h2>
+
+<p>リンクの仕方は自明ですが、良いリンクの仕方は少々難しいこともあります。リンクの仕方はいくつかあります:</p>
+
+<h3 id="テキスト内でのリンク">テキスト内でのリンク</h3>
+
+<p>これが最も便利なリンク方法です。特定の話題に対して読者に更なる情報をリンクで提供するのです。多くの場合、このようなリンクはユーザを個別の関連情報ページにリンクするもので、Web サイトのホームページにリンクするものではありません (例外もありますが)。</p>
+
+<blockquote>
+<p>… <a href="/ja/docs/IndexedDB">IndexedDB</a> API を使えば、ローカルのデータベースにデータを格納できます…</p>
+</blockquote>
+
+<p>このようなリンクはワンクリックでより詳しい情報が得られるユーザにとっても、的確な文脈で紹介してくれたことで気に入ってもらえるだろう MND にとっても、両方にとってとても価値あるものです。私たちのミッションは読者にできる限り速やかに必要な情報を届けることで、これは明らかにステキなやり方です。</p>
+
+<h4 id="テキスト中のリンクで避けるべきこと">テキスト中のリンクで避けるべきこと</h4>
+
+<p>テキスト中のリンクはステキで便利なものですが、留意すべき事がいくつかあります:</p>
+
+<ul>
+ <li><strong>リンクしすぎないこと。</strong><a href="/en-US/docs/Web/JavaScript/Reference/Statements/do...while" title="do...while">す</a> <a href="/en-US/docs/Web/CSS/:not" title=":not()">べ</a> <a href="/en-US/docs/Web/CSS/:link" title=":link">て</a> の単語、あるいはほぼすべての文字にリンクをつけるのは目障りです。文章の中で大事な部分だけをしっかり選んでそこだけリンクするか、読者が既に知っていそうな事についてまでリンクしないようにすること。</li>
+ <li><strong>同じ用語について何度も繰り返しリンクしない。</strong> 例えば CSS アニメーションについて各場合、「アニメーション」という単語がでてくるたびに <a href="/en-US/docs/Web/CSS/animation"><code>animation</code> CSS プロパティ</a> にリンクする必要はありません。読者はそれについて知らなければ、最初にでてきたときに関連情報へのリンクをクリックします。それ以降の部分では、以前から知っていたか前出時にリンク先を見て知ったかに関わらず、すでに知っている前提で書き進めることができます。読者がリンク先を参照するためにページをスクロールせずに済むように、同じ用語について何度か (多くとも数段落毎に一度) リンクするのは構いません。</li>
+ <li><strong>フォーラムやブログコメントでリンクするときにはご注意を。</strong>具体的な質問や問題に対して適切な情報源に関連リンクを示すのはステキだし歓迎されます。Web 上のあちこちに MDN へのリンクを無闇に書きまくるのは不適切です。サイトの管理者や読者は速やかにあなたをスパマーとして認識し、MDN の評価が傷つけられます。私たちは価値あるリソースを作ることに努めておりそのような行為によって私たちの努力の成果が損なわれることは望んでいません。適切な数だけ関連するリンクを紹介してください。</li>
+</ul>
+
+<h3 id="バナーや画像をサイトに追加するには">バナーや画像をサイトに追加するには</h3>
+
+<p>本文中からのリンク以外に、例えばサイドバーの画像から MDN にリンクしていただくこともできます。テキスト中のリンクはあなたが読者に情報を保管する目的でリンクするものですが、この場合は意味合いが異なります。サイドバーなどにリンク画像を追加するのは、あなたの MDN プロジェクトへの支援を表明するものであったり、MDN を宣伝するものであったり、総合的な情報源として MDN を紹介するものになります。</p>
+
+<p>支援を表明するのに遠慮しないでください。<a href="/docs/MDN/Promote">MDN を宣伝するには</a> ページであなたのサイトに合わせたボタンを作ってください。ランディングページなど他のページへのリンクにしていただくのも自由です。</p>
+
+<h3 id="WordPress_から_MDN_に自動リンクするには">WordPress から MDN に自動リンクするには</h3>
+
+<p>ブログポストから用語を選んで MDN の適切なページに自動的にリンクする <a href="/docs/MDN/Promote#WordPress_plugin">WordPress plugin</a> を用意しています。このプラグインでは上記のガイドラインに沿ったかたちでリンクしながら Web 技術についてブログを書るよう助けてくれます。試しにインストールしてみて、良ければご利用ください。</p>
+
+<p>ご支援ありがとうございます！</p>
+
+<article>
+<h2 id="Cross-Origin_Resource_Sharing">Cross-Origin Resource Sharing</h2>
+
+<p>私達はMDNの公開する全てのデータで <a href="https://developer.mozilla.org/docs/HTTP/Access_control_CORS" title="/docs/HTTP/Access_control_CORS">CORS</a> を有効にしているつもりです。これにはほぼ全てのものが当てはまるはずです。もしあなたがなにか<a href="https://developer.mozilla.org/docs/HTTP/Access_control_CORS" title="/docs/HTTP/Access_control_CORS">cross-origin requests</a>が使えない状態を発見したら、それは<a href="https://bugzilla.mozilla.org/form.mdn">修正すべきバグ</a>です。</p>
+</article>
+
+<article>
+<header> </header>
+</article>