From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/mdn/about/index.html | 146 +++++++++++++++++++++++++++ files/ja/mdn/about/linking_to_mdn/index.html | 88 ++++++++++++++++ 2 files changed, 234 insertions(+) create mode 100644 files/ja/mdn/about/index.html create mode 100644 files/ja/mdn/about/linking_to_mdn/index.html (limited to 'files/ja/mdn/about') 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 +--- +
{{MDNSidebar}}
+ +
{{IncludeSubNav("/ja/docs/MDN")}}
+ +

MDN Web Docs (以前は MDN — Mozilla Developer Network と呼ばれていました) は進化し続ける学習プラットフォームであり、下記に挙げるようなウェブ技術とウェブを支えるソフトウェアについて学ぶことができます。

+ + + +

我々のミッション

+ +

MDN のミッションは単純です。開発者がオープンなウェブ上でプロジェクトを簡単に構築できるようにする情報を提供することです。ウェブ上で公開されているオープンなテクノロジーであれば、どんなものでも私たちは文書化したいと考えています。

+ +

また、Mozilla の製品に関するドキュメントや、Mozilla プロジェクトをビルドしたり、プロジェクトに協力する方法に関するドキュメントも提供します。

+ +

もしあるトピックを MDN に含めるべきか、自信を持って判断できないときは、これは MDN に含まれますか？ のページを読んでみてください。

+ +

協力する方法

+ +

MDN を手助けるには、プロのコーダーやライターになる必要はありません。文書の意味が通るかを確認する編集レビュー、ちょっとした文章の寄稿、サンプルコードの追加など、いろいろな方法があります。実際にとても多くの方法があるため、私たちは MDN を始めよう ページを用意しています。あなたがどんなことに興味があるか、またどれだけ使える時間があるのかによって、自分にピッタリのタスクを見つけて貢献してみてください。

+ +

また、あなたのブログやウェブサイトで MDN の宣伝をする ことも私たちの助けになります。

+ +

MDN コミュニティ

+ +

私たちのコミュニティはグローバルなコミュニティです。世界中に様々な言語で作業をするすばらしい協力者の皆さんがいます。私たちについてもっと知りたい、あるいは MDN に関する助けが必要な場合は、ディスカッションフォーラムに参加してください。英語のでのコミュニケーションになります。@MozDevNet の Twitter アカウントをフォローして最新情報を追いかけることもできます。何かの間違いを見つけたりフィードバックしたり (感謝したり) したい場合、ライターや貢献者にツイートすることもできます。

+ +

MDN Web Docs の使用

+ +

MDN のコンテンツは無償で、オープンソースライセンスの下に利用できます。

+ +

著作権とライセンス

+ +

MDN のコンテンツはオープンソースライセンスの下で完全に利用できます。この節はどんな種類のコンテンツがあり、それぞれがどんなライセンスが有効かを網羅します。

+ +

文書と記事

+ +

MDN の wiki 文書は、 Mozilla Foundation の内外のライターの協力により作成されています。特に明記されていない限り、コンテンツは Creative Commons: Attribution-Sharealike license (CC-BY-SA), v2.5 もしくはそれ以上のバージョンの条件の下で利用可能です。

+ +

MDN コンテンツを再利用するときは、2 つのことを確認する必要があります。

+ +
    +
  1. +

    帰属は元のコンテンツに与えられます

    + +

    "Mozilla Contributors" を属性とし、ソースとなるコンテンツの特定の Wiki ページへのハイパーリンク (オンラインの場合) または URL (印刷物の場合) を含めてください。たとえば、この記事の帰属を示すには、次のように書くことができます。

    + +
    +

    About MDN by Mozilla Contributors is licensed under CC-BY-SA 2.5.

    +
    + +

    この例では、"Mozilla Contributors" が引用ページの履歴にリンクしていることに注意してください。詳しい説明は帰属のベストプラクティスを参照してください。

    +
    2. +
  2. +

    あなたの再利用はオリジナルのコンテンツと同じライセンスの下で公開されています。つまり CC-BY-SA v2.5 またはそれ以降のバージョンです

    +
    3. +
+ +

コードサンプルとスニペット

+ +

2010 年 8 月 20 日以降に追加されたコードサンプルは、パブリックドメイン (CC0) にあります。ライセンス通知は必要ありませんが、必要な場合は、"すべての著作権はパブリックドメインに帰属します。http://creativecommons.org/publicdomain/zero/1.0/" を使用できます。

+ +

2010 年 8 月 20 日より前にこの wiki に追加されたコードサンプルは MIT ライセンスの下で利用可能です。次の帰属情報を MIT テンプレートに挿入する必要があります。"©<Wiki ページの最終改訂日> <Wiki に掲載した人の名前>"

+ +

コードサンプルがどのライセンスで利用可能かを判断することができます。履歴を表示するには:

+ +
    +
  1. 記事のヘッダーにある Wiki で編集 ボタンをクリックします。これで、編集可能な、MDN Web Docs の Wiki バージョンに移動します (しかし、実際に編集モードに入っているのではありません)。
    2. +
  2. Wiki 記事の右上にある歯車アイコンをクリックし、表示されたメニューで 履歴を選択します。
    3. +
  3. すべて見るをクリックし、2010 年 8 月 20 日以前の最新のリビジョンを見つけます。
    4. +
  4. リビジョンの日付をクリックしてその日の記事のバージョンを確認します。
    5. +
+ +

サンプルがある場合は、ライセンスが変更される前に追加されたものであり、MIT ライセンスの条件で利用可能です。サンプルがないか、2010 年 8 月 20 日以前のリビジョンがない場合、変更後に追加されたものであり、パブリックドメインです。

+ +

貢献

+ +

この wiki に協力したい場合は、Attribution-ShareAlike ライセンス (または編集中のページで既に指定されている代替ライセンス) でドキュメントを公開し、Creative Commons CC-0 (パブリックドメインの献身) でコードサンプルを公開する必要があります。この wiki に追加することは、あなたの協力がそれらのライセンスの下で利用可能になることにあなたが同意することを意味します。

+ +

一部の古いコンテンツは、前述以外のライセンスで利用可能になりました。これらは代替ライセンスブロックによって各ページの下部に示されています。

+ +
+

新しいページをその他のライセンスで作成してはいけません。

+
+ +

ユーザーから提供された資料の著作権については、著作者がそれを第三者に譲渡しない限り、著作者に帰属するものとします。

+ +

ここに記載されている内容について、質問や懸念事項があれば、MDN 管理者 までご連絡ください。

+ +

ロゴ、商標、サービスマーク、ワードマーク

+ +
+

Mozilla Foundation の商標、ロゴ、サービスマークの権利、およびこのウェブサイトの操作画面や{{訳語("操作感","look and feel")}}は、Creative Commons: Attribution-Sharealike license ライセンスに基づいて提供されるものではなく、それらが (ロゴや画像デザインといった) 著作物である限り、上記の条件に基づいて許諾される著作物には含まれません。あなたが文書のテキストを利用する場合、上述の権利を行使しようとする場合、またはこのサイトにおける私たちのライセンス条件について、その他の質問がある場合は、Mozilla Foundation の窓口 licensing@mozilla.org までご連絡ください。

+ +

MDN にリンクするには

+ +

リンクを張るときは、ガイダンス記事 MDN にリンクするにはに従うのがベストプラクティスです。

+ +

コンテンツをダウンロードするには

+ +

単一ページのダウンロード

+ +

単一ページのコンテンツについては、ダウンロードしたいフォーマットを URL パラメーターに追加することで、取得することができます。

+ +

サードパーティ製のツールを使ったダウンロード

+ +

MDN のコンテンツは、Dash (macOS 用) や Zeal (Linux および Windows用) などのサードパーティ製のツールを使っても読むことができます。

+ +

Kapeli も オフラインで使用できる MDN 文書 を公開しており、HTML、CSS、JavaScript、SVG、XSLT が含まれます

+ +

MDN Web Docs の問題を報告する

+ +

MDN の問題を報告する を読んでください。

+ +

MDN Web Docs の歴史

+ +

MDN Web Docs (かつては Mozilla Developer Network (MDN)、その前は Mozilla Developer Center (MDC) として知られ、また Devmo としても知られていた) プロジェクトは、2005年初頭、 Mozilla Foundation が AOL からオリジナルの Netscape DevEdge のコンテンツの使用ライセンスを取得した時点から始まりました。 DevEdge のコンテンツの中からまだ使える素材が探し出され、更新と維持が楽になるよう、ボランティアによって wiki に移されました。

+ +

2017年7月に名前が MDN Web Docs に変更されました。この決定の背景となる理念については The Future of MDN: A Focus on Web Docs をご覧ください。

+ +

さらに詳しい MDN の歴史については、私たちのページ MDN は 10 周年を迎えましたを参照してください。当時の関係者から聞き取った内容も含まれています。

+ +

Mozilla について

+ +

私たちがどんな組織なのかもっと知りたい、どうすれば Mozilla の一員になれるのか知りたい、あるいは単に私たちがどこにいるのか知りたい。そう考えているあなたは、正しい場所に来ています。何が私たちを動かしているのか、そして他の組織とは違ったものにしているのか、そうしたことを知りたければ、私たちのミッションのページを訪れてみてください。

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 +--- +
{{MDNSidebar}}

MDN にリンクするガイドラインやそもそもリンクして良いのか聞かれることがありますが、もちろん OK です。MDN にリンクして頂いて構いません。その際のガイドラインやベストプラクティスが必要であれば続けて読んでください。

+ +

MDN にリンクして良いですか？

+ +

はい！是非どうぞ！ハイパーテキストリンクは Web の本質的な機能であるだけでなく、ユーザに価値あるリソースを指し示す方法であると共に、私たちのコミュニティの成果に対する信頼を示すことでもあります。

+ +

ですから、MDN のコンテンツへのリンクは是非遠慮なくしてください。MDN のフロントページ、あるいは必要に応じて MDN 内の特定ページにリンクしてください。リンク先ページ選択のベストプラクティスは以下の通りです。

+ +

どのページにリンクすべきですか？

+ +

リンクすべき特定のページは決まっていません。あなたの読者に役立つのがどのページかというのが大事です。

+ + + +

いずれにしても、リンク元ページや読者にとって最適なページにリンクしてください。リンクや私たちではなく、読者こそが大事なのですから。

+ +

良いリンクの仕方は？

+ +

リンクの仕方は自明ですが、良いリンクの仕方は少々難しいこともあります。リンクの仕方はいくつかあります:

+ +

テキスト内でのリンク

+ +

これが最も便利なリンク方法です。特定の話題に対して読者に更なる情報をリンクで提供するのです。多くの場合、このようなリンクはユーザを個別の関連情報ページにリンクするもので、Web サイトのホームページにリンクするものではありません (例外もありますが)。

+ +
+

… IndexedDB API を使えば、ローカルのデータベースにデータを格納できます…

+
+ +

このようなリンクはワンクリックでより詳しい情報が得られるユーザにとっても、的確な文脈で紹介してくれたことで気に入ってもらえるだろう MND にとっても、両方にとってとても価値あるものです。私たちのミッションは読者にできる限り速やかに必要な情報を届けることで、これは明らかにステキなやり方です。

+ +

テキスト中のリンクで避けるべきこと

+ +

テキスト中のリンクはステキで便利なものですが、留意すべき事がいくつかあります:

+ + + +

バナーや画像をサイトに追加するには

+ +

本文中からのリンク以外に、例えばサイドバーの画像から MDN にリンクしていただくこともできます。テキスト中のリンクはあなたが読者に情報を保管する目的でリンクするものですが、この場合は意味合いが異なります。サイドバーなどにリンク画像を追加するのは、あなたの MDN プロジェクトへの支援を表明するものであったり、MDN を宣伝するものであったり、総合的な情報源として MDN を紹介するものになります。

+ +

支援を表明するのに遠慮しないでください。MDN を宣伝するには ページであなたのサイトに合わせたボタンを作ってください。ランディングページなど他のページへのリンクにしていただくのも自由です。

+ +

WordPress から MDN に自動リンクするには

+ +

ブログポストから用語を選んで MDN の適切なページに自動的にリンクする WordPress plugin を用意しています。このプラグインでは上記のガイドラインに沿ったかたちでリンクしながら Web 技術についてブログを書るよう助けてくれます。試しにインストールしてみて、良ければご利用ください。

+ +

ご支援ありがとうございます！

+ +
+

Cross-Origin Resource Sharing

+ +

私達はMDNの公開する全てのデータで CORS を有効にしているつもりです。これにはほぼ全てのものが当てはまるはずです。もしあなたがなにかcross-origin requestsが使えない状態を発見したら、それは修正すべきバグです。

+
+ +
+
 
+
-- cgit v1.2.3-54-g00ecf