Home

Symfony2ドキュメント 日本語リポジトリ

Symfony2ドキュメントの日本語翻訳リポジトリです。翻訳プロジェクトへはどなたでも参加いただけます。

• 現在、まだSymfony公式サイトにはホストされていないため、日本Symfonyユーザー会のサイトにて閲覧できるようにしています

翻訳の手順

手順について、Wikiの表の更新ではなく、新しい手順について準備中です。

英語ソースは英語版リポジトリ、翻訳は日本語版リポジトリ です。

1. 両方のリポジトリをcloneしてください。

$ git clone https://github.com/symfony/symfony-docs.git
$ git clone https://github.com/symfony-japan/symfony-docs-ja.git

2. 英語版リポジトリ <https://github.com/symfony/symfony-docs> を見て翻訳するファイルを選び、翻訳担当 にどのファイルを翻訳するか書き込んでください。 また、翻訳したファイルの先頭にはSphinx形式のコメントで翻訳完了日、ユーザー名、翻訳対象としたファイルのコミットIDを加えてください。(必須ではありませんが、管理が楽になります)

3. 日本語リポジトリにまだファイルがない場合は、英語版リポジトリと同じようにディレクトリを作り、英語版のファイルをコピーしてきて上書きで翻訳を開始してください。 日本語の翻訳ファイルがすでにある場合は、上手く差分を適用してください。
4. 翻訳が終わった段階で、日本語リポジトリへpull requestを送信します。 GitHub上で日本語リポジトリを自分のアカウントへForkしてください Forkしたリポジトリ用のSSH URLを、ローカルの作業ディレクトリでリモート設定します

$ git remote add （アカウント名） git@github.com:(アカウント)/symfony-docs-ja.git

5. 自分のアカウントのリポジトリへプッシュします

$ git push （アカウント名）master

6. プッシュできたら、GitHubの画面上で「Pull Request」を押し、日本語リポジトリへの適用リクエストを送信してください。
7. 翻訳担当表に書き込んである翻訳の完了したファイルの記述を削除してください。

翻訳担当表

今どのファイルを誰が翻訳しているのかという目安表です。管理表ではないのでいつも正しい状態が反映されているとは限りません。

• 翻訳担当

参考資料等

• reStructuredText入門
• Sphinx
• sphinx-php fabienさん作のconfig-block処理用ディレクティブ

Sphinxのビルドに必要なconfiguration-blockディレクティブと、英語・日本語のソースリポジトリをsubmoduleにまとめたリポジトリを作ってあります。

• hidenorigoto/symfony-docs-trans