Skip to content

javascript-tutorial/ja.javascript.info

Repository files navigation

日本語版 Modern JavaScript Tutorial

このリポジトリは https://javascript.info の日本語翻訳版で、https://ja.javascript.info で公開されています。

翻訳をより良いものにするために、ご協力お願いします!

  • "Translate Progress" の issue を見てください。
  • 未チェック(未翻訳を表します)のコンテンツの中で、翻訳したいコンテンツを選んでください。
  • 翻訳していることが分かるよう、issueを作成してください。
  • リポジトリを Fork し、翻訳を行い、できたら PR をしてください。

🎉 Thank you!

コントリビューターの名前と翻訳した量は https://ja.javascript.info/about#contributors で見ることができます(PRがマージされると更新されます)。

P.S. 翻訳されている他の言語の一覧は https://github.com/javascript-tutorial/translate にあります。

構造

チャプター毎にフォルダが分かれており、その中に記事とタスクがあります。

フォルダは N-url という名前になっており、N はソートのための番号です(記事はこの順番に並びます)。 url はサイト上の URL スラッグです。

フォルダは次の1つ以上のファイルから成ります:

  • index.md セクション用
  • article.md 記事用
  • task.md タスク用(+ 他にあるとしたら解答用の solution.md)

ファイルは # Title Header から始まり、Markdown のようなフォーマットでテキストが続きます。シンプルなテキストエディタで編集可能です。

記事やタスクで利用する追加のリソース(画像など)や例も同じフォルダにあります。

翻訳時の Tips

翻訳は単語レベルで正確である必要はありません。技術的に正しく、分かりやすく説明されるべきです。

もし英語版の記事が改善できそうであれば、ぜひPRを送ってください。

コードブロック内のテキスト

  • コメントだけを翻訳してください。
  • 文字列や変数など、コメント以外のものは翻訳しないでください。

例:

// Example
const text = "Hello, world";
document.querySelector('.hello').innerHTML = text;

✅ DO (コメントを翻訳):

// 例
const text = 'Hello, world';
document.querySelector('.hello').innerHTML = text;

❌ DON'T (文字列やクラスの翻訳):

// 例
const text = 'ハローワールド';
// ".hello" は css クラスなので翻訳しません
document.querySelector('.ハロー').innerHTML = text;

外部リンク

外部リンクが Wikipedia (e.g. https://en.wikipedia.org/wiki/JavaScript)で、その記事の日本語版が存在し、かつそれなりの品質であれば、代わりにそのバージョンをリンクさせてください。

例:

[JavaScript](https://en.wikipedia.org/wiki/JavaScript) is a programming language.

✅ OK (en -> es):

[JavaScript](https://es.wikipedia.org/wiki/JavaScript) es un lenguaje de programación.

MDN へのリンクについては、部分的にしか翻訳されていない場合でも言語固有のバージョンを使用してください。

リンクされた記事に翻訳版がない場合は、「そのまま」リンクを残してください。

ローカルで動かす

このチュートリアルはローカルでも動かすことができ、その場ですぐに変更を確認することができます。

サーバは https://github.com/javascript-tutorial/server にあります。