PHPマニュアルの翻訳作業を簡単にしたくて、docker-phd-ja というソフトウェアを開発しています。今週は管理画面を充実させ、ブラウザ上でのファイルの編集やマニュアルのビルドを可能にしました。

edit

build

使い方

Docker がインストールされていれば、下記のコマンドですぐに実行できます。

docker pull iwamot/phd-ja
docker create -it -p 8080:80 --name phd-ja iwamot/phd-ja
docker start phd-ja

http://localhost:8080/phd-ja-admin/ にアクセスすると、管理画面が開きます。ポートは 8080 でなくてもOKなので、必要に応じてご変更ください。

実装済みの機能

  • ソースファイルの編集
  • マニュアルのビルド
  • 生成されたマニュアルの参照
  • 作業コピーの diff 出力(svn diff)
  • 作業コピーのリセット(svn revert)
  • 作業コピーの更新(svn update)

ぼくが推奨する翻訳手順

  1. オンラインエディタで翻訳を進める
  2. 翻訳結果をソースに反映し、マニュアルをビルドする
  3. 生成されたマニュアルを見て、違和感がないか確認する
  4. オンラインエディタからパッチを送る

この2と3の手間を減らすのが docker-phd-ja の開発の目的です。

ちなみに、PHPマニュアルの日本語翻訳に参加すると、PHPマニュアル序文に翻訳者として名前が載るかもしれません。ぼくも「Takashi Iwamoto」として載せていただきました。

関連リンク