Node.js公式ドキュメント翻訳サイト

このリポジトリは、Node.js日本ユーザグループにる、Node.js公式ドキュメントの翻訳サイト公開用リポジトリです。

関連リポジトリ

• nodejsjp/nodejsjp.github.com: Node.js日本ユーザグループ公式サイト
  • Node.js日本ユーザグループのトップページなど、翻訳ドキュメント以外のコンテンツ用リポジトリです。
• nodejsjp/nodejs.org_ja: Node.js公式ドキュメントの翻訳サイト
  • このリポジトリです。
• nodejsjp/node: 翻訳ドキュメントのソース
  • Node.js公式ドキュメントを翻訳したソース用のリポジトリです。

公式ドキュメントの翻訳はnodejsjp/node上のmarkdownに対して行い、ビルドされたHTMLをnodejsjp/nodejs.org_ja (このリポジトリ) にコミットすることで公開しています。このリポジトリ上のHTMLを直接編集することはしません。

翻訳手順

ソースドキュメントの修正

• joyent/nodeをクローンする。
• nodejsjp/nodeをリモートに追加する

$ git remote add nodejsjp https://github.com/nodejsjp/nodejsjp.github.com.git

• nodejsjp/nodeをフェッチする

$ git fetch nodejsjp

• 翻訳用ブランチをチェックアウトする
  • 本家リポジトリのmasterに対応するブランチはjapaneseです。
  • 本家リポジトリのv0.xxブランチに対応するのはjapanese-v0.xxです。

$ git checkout -b japanese nodejsjp/japanese

• 原文の変更をマージする
  • 新バージョンに対応する場合のみ必要です。誤字や誤訳を修正する場合は不要です。
  • コンフリクトしなくても多くの場合は翻訳を修正する必要があるため、--no-commitを指定します。

$ git merge --no-ff --no-commit v0.xx.yy

• doc以下のドキュメントを編集する。
• ドキュメントをビルドする

$ ./configure
$ make doc

• ブラウザで編集内容を確認してコミットし、自分のリモートリポジトリにプッシュする。
• nodejsjp/nodeにプルリクエストする。

翻訳サイトの修正

• nodejsjp/nodejs.org_jaをクローンする。
• 「翻訳ソースの修正」でビルドしたHTMLファイルをコピーする
  • 本家リポジトリのmasterに対応するドキュメントはルート直下にコピーします。
  • 本家リポジトリのv0.xxブランチに対応するドキュメントは docs/v0.xx/以下にコピーします。

cp -R path/to/node/out/doc/* ./

• コミットして自分のリモートリポジトリにプッシュする。
• nodejsjp/nodejs.org_jaにプルリクエストする。

公式サイトの修正

• nodejsjp/nodejsjp.github.comをクローンする。
• ドキュメントを修正する。
• コミットして自分のリモートリポジトリにプッシュする。
• nodejsjp/nodejsjp.github.comにプルリクエストする。