[JM:02096] Re: po4a cfg 使いませんか?

Zurück zum Archiv-Index
Akihiro Motoki amoto****@gmail*****
2021年 3月 18日 (木) 21:13:42 JST


元木です。

感想編です。

On Thu, Mar 18, 2021 at 8:54 AM 長南洋一 <cyoic****@maple*****> wrote:
>
> 長南です。
>
> いろいろと御提案してくださって、ありがとうございます。私のやることを
> ご覧になっていて、歯がゆくてたまらなくなられたのでしょう。
>
> po4a cfg を使うことについては、私は 1 マニュアル 1 PO ファイル主義ですから、
> po4a-gettxize, po4a-translate, po4a-updatepo で十分用が足ります。

正直に言うと、毎回ページにあわせて丁寧にコマンドラインを用意して
(or コピーして) 打たないといけないのが、面倒だなと思ったのと、
上にあげた po4a の各コマンドも久しぶりに使うと思い出すのが面倒で
あるコマンドを1個 (make とか) 打つだけの方が自分は楽だなと思ったのが、
本音です。

> それに、その方が、po4a を初めて使う人にとっても、使い方が単純だし、
> 自分が今何をやっているかもはっきりして、受け入れやすいのではないかと思います。
> もともと、こうしたコマンドは、一般ユーザが po4a を気軽に使えるようにと、
> 作られたインターフェースなのでしょう。
>
> もっとも、そんなことが言えるのも、マニュアルがたかだか 100 個ぐらいしかなく、
> しかも、一つ一つ訳しているからで、LDP man pages のように、マニュアルが
> 1000 個もあったら、やっていられないのは分かります。ですから、そういう場合は、
> うまく行くやり方があるのならば、それを使えばよいと思います。
>
> 根本的に JM にとって重要なのは、original 以下の原文から release 以下の
> 翻訳 roff を作ることです。どうやってそうするかは、翻訳者の自由にまかせて
> 良いのではないでしょうか。翻訳 roff を作る上で、注意事項があるのなら、
> README でも作って、書いておけば十分だと思います。
>
> と、こう書いてきて気がつくのですが、1000 個ものマニュアル群を訳した方と、
> 数個程度のマニュアル群を訳してきたものでは、考え方が違ってくるのですね。
> でも、大部分の人にとって、一度に訳すマニュアルは、1 個か 2 個、多くても
> 数個なのではないでしょうか。LDP man pages というのは、かなり特殊です。

この話を呼んでいて、クラウドを語るときの「ペットと家畜」の例えを
久しぶりに思い出しました。
一つ一つの man page を丁寧に扱うのが「ペット」 に相当する、
「ペット」なので個々の違いはむしろ特徴で親しみが湧くものなので、
man page 毎にこのオプションが必要とかを毎回指定するのも全然気にならない。
一方、「家畜」は基本的にはどれも均質なことを求めます。どの man pages も
同じに扱えることが望ましい。オプションの違いなどは最初の1回指定すれば
もうお目にかかりたくないので設定ファイルとかに隠蔽する、
基本的に、すべて均一で違いを意識する必要はなく、同じ方法で操作できる
(→自動化につながる)のが望ましい。全く逆の考え方ですね。

> > ## po4a-translate のコマンドライン
> >
> > 変換時の追加オプションを指定していますが、どのファイルをどのオプションで変換したかは
> > よくわかりません。README にはたぶん他のファイルにも必要でしょうと書かれているだけ。
>
> 元木さんは、-o で渡す追加オプションがいろいろあることをご存知だから、かえって
> 混乱なさったのだと思います。私は、「manpage によっては、po4a-translate
> だけでなく、po4a-gettextize や po4a-updatepo をするときにも
> -o unknown_macros=untranslated というオプションが必要なものがある。
> それは以下に列挙するものだ」という意味のことを書いただけです。今のところ、
> 他の追加オプションが必要な例には出会っていません。

オプションがいろいろあることを知っているのは、単にそういう場面にたくさん
出会って困ったからです。知りたくて知ってるわけじゃないですww

ちなみに、util-linux の README に書いてあるオプションは、
現在は (po4a 0.57 @ Ubuntu Focal 時点では) すべて不要です。
オプションなしで変換できます。

> ちょっと嫌味かもしれませんが、念のため、私の書いた文を、一部省略して引用して
> おきます。この README.po4a は、po4a-translate などについて読者に
> ある程度の知識があることを前提にしているので、そのへんの説明は省いています。

[...]

> > (a) addenda の活用
> > (b) 訳注の扱い
>
> patch を使うことについてですから、これは一緒に論じます。
>
> 私も sudo の翻訳では、addenda を使いました。しかし、find を翻訳している
> ときから、patch を使うようになりました。
>
> 私のようにかなり長い訳注を何箇所にも入れたい場合、addenda では複数のファイルが
> 必要になります。訳注なんて改訂するたびに、いらなくなったり、増えたりするものです。
> そもそも、addenda ファイルが複数ある事自体煩わしいことですし、増えたり減ったり
> したら、addenda ファイルの名前と内容が混乱してきます。それは望ましくありません。
> 他人の作ったものだったら、扱いに困ると思います。patch なら 1 個ですみます。

基本的には、addenda は画一的な内容を追記するものだと思います。
翻訳の copyright を書くとか、そういう共有の内容。
そういう用途なら、どの場合でも一緒なので、パッチでも adenda でも同じなはず。

> もう一つ都合が悪いのは、addenda では、内容を追加することは出来ても、
> 内容を変更することが出来ないことです。ところが、たとえば、AUTHOR や
> AVAILABILITY の中などに man2html では解釈できない groff の書式が
> があったりして、そういうところは Web ブラウザで見ると、消えてしまったり、
> 余計な文字が入ってしまったりするわけです。そういうのは、roff としては
> 間違っていないのですから、PO ファイルの中で書き換えるよりも、patch で
> 書き換えた方が、後々のためになるのではないかと思いました。

そういう背景がどこにも書かれていないので、
私にはパッチの内容でできない部分がありました。
そういうのはどうやって共有すればいいんでしょうね?

> 長い訳注を PO ファイル中に書くのも、試してみました。でも、それだと、
> 二行目以下の字下げが出来ないでしょう。訳注と本文との区別が一目で
> わからないので、諦めたのだと思います。

私は訳注は最低限にして、基本的には原文を直す議論をすべき、という意見を
持っています。長い訳注というのはその時点で原文を直すべきというアラートだと
思います。ここは長南さんとは根本的に意見の違うところかもしれないので、
以前マニュアルをレビューしていたときも、できるだけ触れないようにしていました。

> > util-linux のフォルダーで、 draft 以下や original 以下はどのような管理に
> > なっているかよく分からなかったです。
> > draft 以下は po4a を使っているときには、無視されている?
> > original 以下がどうなっているか分からなかったのは、cal-ja.po だとオリジナルが
> > cal.man になっていて、たぶん別の場所から来ているのだと思いました。
>
> オリジナルファイルの拡張子を man にしていると、"#: cal.man" になるんですね。
> 全然気が付きませんでした。私は、jm 以下とは別の作業ディレクトリで作業をして
> いるのですが、そこに、原文と翻訳中の (po から変換した)  roff ファイル、
> さらに佐藤さん訳の roff ファイルが混在しています。紛らわしいので、原文の拡張子を
> man にしたのだと思います。原文の出所は、この場合なら、翻訳版の cal.1 の
> 翻訳履歴を見ていただけば、
>
> Updated & Modified (util-linux 2.34) Tue Mar  3 11:18:32 JST 2020
>
> などとなっているはずです。開発元にあった util-linux-2.34.tar.xz から
> 取り出したもので、original にあるものと同じことを確認しています。
>
> 今試してみたのですが、po4a-updatepo で cal.1 のバージョンを 2.34 から
> 2.36 に上げてみましたが、問題なく PO ファイルを更新できました。cal.man に
> なっていても、害はないようです。
>
> なお、original にある大部分のファイルは、バージョン 2.34 のもので、
> 佐藤さんが投稿なさったときに、白方さんが登録してくださったものです
> (翻訳が 2.35.2 や 2.36 のものに対応する原文ファイルは、そのバージョンを
> 翻訳したとき、私が登録したもの)。draft にあるのも、白方さんの登録で、
> 佐藤さんが投稿なさった原稿です。po4a を使う場合、原文と訳文を並列した
> ファイルは作らないので、draft ディレクトリは使っていません。
>
> せっかく、いろいろと提案してくださったのに、みんな「ヤダ」ですませて
> しまって、恐縮です。お気を悪くなさらないように。

今のプロジェクト状況なので、翻訳したい人がやりたい方法でやればいいと思います。
他の人が入ってくることは少ないと思いますので、わざわざ一番活動している人が
使いにくいと思う方法を使う必要はないでしょう。同じパッケージでアクティブな人が
複数出てきたらそのときに折り合いをつければいいと思います。
そのときにアクティブになった人が使いやすいと思う方法にしていけばいいと思います。
LDP man-pages も同じです。今の方法は私(および当時のフランス語翻訳チーム)が
楽だと思った方法、というだけです。それ以上でもそれ以下でもありません。

それでは!


linuxjm-discuss メーリングリストの案内
Zurück zum Archiv-Index