po4a

po4a で翻訳作業を機械化する。以下、virtualbox 上の trusty における作業メモ。

# garbagetown @ garbagetown in ~/Desktop/trusty [5:45:54] 
$ cat Vagrantfile 
# -*- mode: ruby -*-
# vi: set ft=ruby :

# All Vagrant configuration is done below. The "2" in Vagrant.configure
# configures the configuration version (we support older styles for
# backwards compatibility). Please don't change it unless you know what
# you're doing.
Vagrant.configure("2") do |config|
  # The most common configuration options are documented and commented below.
  # For a complete reference, please see the online documentation at
  # https://docs.vagrantup.com.

  # Every Vagrant development environment requires a box. You can search for
  # boxes at https://vagrantcloud.com/search.
  config.vm.box = "ubuntu/trusty64"
(snip)

# garbagetown @ garbagetown in ~/Desktop/trusty [5:45:58] 
$ vagrant up
(snip)
# garbagetown @ garbagetown in ~/Desktop/trusty [5:51:44] 
$ vagrant ssh
Welcome to Ubuntu 14.04.5 LTS (GNU/Linux 3.13.0-125-generic x86_64)
(snip)

git がないのでインストールする。

~$ which git

~$ sudo apt-get install git
(snip)
~$ which git
/usr/bin/git

po4a も apt-get でインストールできる。

~$ apt-cache search po4a
po4a - tools for helping translation of documentation
dl10n - Debian infrastructure and tools for localization
sisu - documents - structuring, publishing in multiple formats and search

~$ sudo apt-get install po4a
(snip)
~$ which po4a
/usr/bin/po4a

play のドキュメントだけ clone する。

~$ cd /vagrant/

/vagrant$ git clone https://github.com/playframework/playframework.git
(snip)
/vagrant$ cd playframework/
/vagrant/playframework$ git config core.sparsecheckout true
/vagrant/playframework$ touch .git/info/sparse-checkout
/vagrant/playframework$ echo documentation/manual/ > .git/info/sparse-checkout
/vagrant/playframework$ git read-tree -m -u HEAD

以下のようなディレクトリ構成とする。

./playframework
./playframework/documentation
./playframework/documentation/manual
./translation-project
./translation-project/documentation
./translation-project/documentation/manual
./translation-project/po
./translation-project/po/manual

翻訳用ディレクトリを作成する。

ここでは translation-project ディレクトリを mkdir しているが、本来は playframework-ja から clone する。
TODO translation-project には documentation ディレクトリは不要だった...

/vagrant/playframework$ cd ..

/vagrant$ mkdir translation-project

/vagrant$ find playframework/documentation/manual/ -type d | \
> sed "s/playframework\///g" | \
> xargs -i \
> mkdir -p translation-project/{}

/vagrant$ find playframework/documentation/manual/ -type d | \
> sed "s/playframework\/documentation\///g" | \
> xargs -i \
> mkdir -p translation-project/po/{}

.po ファイルを作る。

/vagrant$ find playframework/documentation/ -name "*.md" | \
> sed "s/playframework\/documentation\///g" | \
> xargs -i \
> po4a-updatepo -f text -o markdown -M UTF-8 \
> -m playframework/documentation/{} \
> -p translation-project/po/{}_ja.po

本来はここで翻訳作業を行う。

.po ファイルから翻訳文を作成する。デフォルトで 80% 以上翻訳していないとエラーになるので -k 0 で強制的に出力。

/vagrant$ find playframework/documentation/ -name "*.md" | \
> sed "s/playframework\/documentation\///g" | \
> xargs -i \
> po4a-translate -f text -o markdown -M UTF-8 -k 0 \
> -m playframework/documentation/{} \
> -p translation-project/po/{}_ja.po \
> -l translation-project/documentation/{}

TODO index.toc もコピーする必要がある

翻訳ファイルからのコメントアウト除去

旧バージョンの翻訳から .po をリバースして新バージョンの .po にマージしたい
原文のコメントアウトが残っているため po4a-gettextize でリバースできない
このため、翻訳ファイルからコメントアウト部分を除去する必要がある。

以下、翻訳ファイルの例。

$ cat manual/Home.md
<!--- Copyright (C) 2009-2015 Typesafe Inc. <http://www.typesafe.com> -->
<!--
# Play %PLAY_VERSION% documentation
-->
# Play %PLAY_VERSION% ドキュメント

<!--
> Play is a high-productivity Java and Scala web application framework that integrates the components and APIs you need for modern web application development.
>
> Play is based on a lightweight, stateless, web-friendly architecture and features predictable and minimal resource consumption (CPU, memory, threads) for highly-scalable applications thanks to its reactive model, based on Iteratee IO.
-->
>Play は、現代の web アプリケーション開発に必要なコンポーネント及び API を統合した生産性の高い Java と Scala の web アプリケーションフレームワークです。
>
> Play の特徴は、ライトウェイト、ステートレス、web フレンドリーなアーキテクチャであること、機能予測のしやすさです。また、Iteratee IO をベースにしたリアクティブモデルのおかげで、スケーラブルなアプリケーションでも CPU、メモリ、スレッドなどのリソース消費が最小限になっています。

<!--
- [[What's new in Play 2.4?|Highlights24]] / [[Play 2.4 Migration Guide|Migration24]]
- [[What's new in Play 2.3?|Highlights23]] / [[Play 2.3 Migration Guide|Migration23]]
- [[What's new in Play 2.2?|Highlights22]] / [[Play 2.2 Migration Guide|Migration22]]
- [[What's new in Play 2.1?|Highlights21]] / [[Play 2.1 Migration Guide|Migration21]]
-->
- [[Play 2.4 の変更点|Highlights24]] / [[Play 2.4 移行ガイド|Migration24]]
- [[Play 2.3 の変更点|Highlights23]] / [[Play 2.3 移行ガイド|Migration23]]
- [[Play 2.2 の変更点|Highlights22]] / [[Play 2.2 移行ガイド|Migration22]]
- [[Play 2.1 の変更点|Highlights21]] / [[Play 2.1 移行ガイド|Migration21]]


@toc@

## モジュールとプラグイン

<!--
[[Temporary modules directory|ModuleDirectory]]
-->
[[一時的なモジュールディレクトリ | ModuleDirectory]]

<!--- (ハイフンが三つ) で始まる著作権コメントまで消さないよう一旦置換してからその他のコメント部分を削除し、最後に著作権コメントの置換部分を戻す。

$ cat manual/Home.md | \
> sed 's/<!---/!!---/' | \
> sed '/<!--/,/-->/d' | \
> sed 's/!!---/<!---/'
<!--- Copyright (C) 2009-2015 Typesafe Inc. <http://www.typesafe.com> -->
# Play %PLAY_VERSION% ドキュメント

>Play は、現代の web アプリケーション開発に必要なコンポーネント及び API を統合した生産性の高い Java と Scala の web アプリケーションフレームワークです。
>
> Play の特徴は、ライトウェイト、ステートレス、web フレンドリーなアーキテクチャであること、機能予測のしやすさです。また、Iteratee IO をベースにしたリアクティブモデルのおかげで、スケーラブルなアプリケーションでも CPU、メモリ、スレッドなどのリソース消費が最小限になっています。

- [[Play 2.4 の変更点|Highlights24]] / [[Play 2.4 移行ガイド|Migration24]]
- [[Play 2.3 の変更点|Highlights23]] / [[Play 2.3 移行ガイド|Migration23]]
- [[Play 2.2 の変更点|Highlights22]] / [[Play 2.2 移行ガイド|Migration22]]
- [[Play 2.1 の変更点|Highlights21]] / [[Play 2.1 移行ガイド|Migration21]]


@toc@

## モジュールとプラグイン

[[一時的なモジュールディレクトリ | ModuleDirectory]]

上記は cat した内容を置換しているが、ファイルそのものを置換したい場合は

$ sed -i ... <ファイル名>

とすればよい。

既存の翻訳ファイルから .po を作る

コメントアウト部分を除去したら、

-m 原文ファイル
-l 翻訳ファイル
-p po ファイル

を指定して po4a-gettextize する。

$ po4a-gettextize -f text -o markdown -M UTF-8 \
-m playframework/documentation/manual/working/scalaGuide/main/forms/ScalaForms.md \
-l translation-project/manual/working/scalaGuide/main/forms/ScalaForms.md \
-p translation-project/po/working/scalaGuide/main/forms/ScalaForms.md_ja.po

$ head -30 translation-project/po/working/scalaGuide/main/forms/ScalaForms.md_ja.po 
# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2017-08-01 20:26+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: Plain text
#: playframework/documentation/manual/working/scalaGuide/main/forms/ScalaForms.md:2
#, fuzzy, no-wrap
msgid "<!--- Copyright (C) 2009-2015 Typesafe Inc. <http://www.typesafe.com> -->\n"
msgstr "<!--- Copyright (C) 2009-2015 Typesafe Inc. <http://www.typesafe.com> -->\n"

#. type: Title #
#: playframework/documentation/manual/working/scalaGuide/main/forms/ScalaForms.md:2
#, fuzzy, no-wrap
msgid "Handling form submission"
msgstr "フォームの送信"

既存の翻訳ファイルから生成した po の内容で翻訳ファイルを作る

まず翻訳対象ファイルの po ファイルを作る。

vagrant@vagrant-ubuntu-trusty-64:/vagrant$ po4a-updatepo -f text -o markdown -M UTF-8 \
> -m playframework/documentation/manual/scalaGuide/main/forms/ScalaForms.md \
> -p translation-project/manual/working/scalaGuide/main/forms/ScalaForms.md_ja.po

次に、既存の翻訳ファイルから生成した po の内容をマージする。

POEdit を使って手動で実施するか、

How To Merge Two PO Files Using POEdit | MarketPressThemes

msgmerge コマンドで実施する。

gettext - Is it possible to combine two .po translation files together? - Stack Overflow

$ msgmerge \
> ScalaForms.md_ja.po \
> translation-project/manual/scalaGuide/main/forms/ScalaForms.md_ja.po \
> -o translation-project/manual/scalaGuide/main/forms/ScalaForms.md_ja.po.new
...................................................................... done.

$ grep -A 7 fuzzy translation-project/manual/working/scalaGuide/main/forms/ScalaForms.md_ja.po | tail -15
"Or you can define a default mapping on the number using [`Forms.default`]"
"(api/scala/play/api/data/Forms$.html):"
msgstr ""
"あるいは、[`Forms.default`](api/scala/play/api/data/Forms$.html) を使って番号"
"にデフォルトのマッピングを定義することもできます。"

--
#, fuzzy
msgid ""
"If you want a form to have a static value for a field, use [`Forms.ignored`]"
"(api/scala/play/api/data/Forms$.html):"
msgstr ""
"フォームにフィールドの静的な値を持たせたい場合は、[`Forms.ignored`](api/"
"scala/play/api/data/Forms$.html) を使います。"

msgattrib で fuzzy マークを取り除く。

translation - Removing all fuzzy entries of a PO file - Stack Overflow

$ msgattrib --clear-fuzzy -o ScalaForms.md_ja.po.new ScalaForms.md_ja.po.new

最後に、既存の翻訳から生成した po ファイルの内容で翻訳ファルを生成する。

/vagrant$ po4a-translate -f text -o markdown -M UTF-8 -k 0 \
> -m playframework/documentation/manual/scalaGuide/main/forms/ScalaForms.md \
> -p translation-project/manual/working/scalaGuide/main/forms/ScalaForms.md_ja.po \
> -l translation-project/manual/working/scalaGuide/main/forms/ScalaForms.md

が、うまくいかない・・・？あれ・・・？

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

po4a

po4a

翻訳ファイルからのコメントアウト除去

既存の翻訳ファイルから .po を作る

既存の翻訳ファイルから生成した po の内容で翻訳ファイルを作る

Clone this wiki locally