2008年 9月 29日 月曜日

OpenSolaris マンページで書いたのですが、いよいよ OpenSolaris マニュアルページの翻訳プロジェクトを始めます !

• 英語: How to Translate OpenSolaris Manual Pages
• 日本語: OpenSolaris マニュアルページを翻訳しよう!

色々検討した末、翻訳するフォーマットは .po ファイルでいくことにしました。.roff だとタグを壊してしまう可能性が高いことと、翻訳するときに改行がたくさん入ってわかりにくいこと、英語ファイルと日本語ファイルが別々になってしまうためです。.po ファイルのいいところは、日本語と英語が必ずペアになっているので、翻訳するときに見やすいし、あとで翻訳メモリーを作ることもできること。そして、.roff から変換した .po ファイルのいいところは、.roff のブロックタグ (段落を決定するためのタグ) が、ほとんど取り去られているので、タグを壊す可能性が低いという点です。字体を指定するタグは B<xxx> のような形式で残るのですが、区別しやすいし、万一タグを壊してしまっても修正しやすいのです。

たとえば...

# type: Plain text

#: man1/elfwrap.1.en.pid4000:24

msgid "elfwrap - wrap data in an B file"

msgstr "elfwrap - B ファイル内のデータをラップする"



# type: SH

#: man1/elfwrap.1.en.pid4000:24

#, no-wrap

msgid "SYNOPSIS"

msgstr "形式"

... のようになります。msgstr に日本語を入れるんです。

日本語にした .po ファイルは、Sun で .roff に戻して問題がないか検証し、査読用ファイルを作って wiki にアップします。catman というコマンドで作ったもので、見た目は man コマンドで表示されるものとほぼ同じです。査読も終わって完成したら、ダウンロードセンターに置きます。時期をみて OpenSolaris バイナリに入れるつもりですが、すぐに使いたい場合は、ファイルをダウンロードして自分のシステムの /usr/share/man/ja などの場所に入れれば man コマンドで表示できますよ。

みなさん、参加しませんかー? 興味のある方は g11n-ja-discuss メーリングリストまたは reiko-dot-saito-at-sun-dot-com までメールください。お待ちしています!

English:

As I wrote on the last column "OpenSolaris manual pages, we are now starting OpenSolaris Manual Page Translation project !

• English: How to Translate OpenSolaris Manual Pages
• Japanese: OpenSolaris マニュアルページを翻訳しよう!

After the thorough research, we decided to go with ".po" file as a translation file format. Disadvantage of .roff file is... (1) complicated block tags are highly likely to confuse translators - tags may be broken or it takes time to understand where is the full sentence, (2) Translators have to view a source and a target file separately. While, .po file always includes a pair of source and target strings in a file, which will save translator/reviewer's time and make it easier to generate a translation memory.

Another advantage of .po file converted from .roff is the most of the .roff block tags will be removed. Only font tags, such as B<xxx>, will remain, but it is easy to tell how it works, and in case they are broken, easy to restore.

For example...

# type: Plain text

#: man1/elfwrap.1.en.pid4000:24

msgid "elfwrap - wrap data in an B file"

msgstr "elfwrap - B ファイル内のデータをラップする"



# type: SH

#: man1/elfwrap.1.en.pid4000:24

#, no-wrap

msgid "SYNOPSIS"

msgstr "形式"

Target strings will be placed on msgstr line within double quotes.

After .po file is translated, Sun will convert it back to .roff and generate catman file. Catman file includes the contents of manual pages as you view them by man command on a terminal window. This is for review. After the review is done, Sun will upload the translated roff file to Donwload Center. You can download it and place it on your system under your man path such as /usr/share/man... We plan to include them in OpenSoalris binary when the schedule matches.

Why don't you join this project ? If you are interested, please let me know by email to g11n-ja-discuss mailing list or reiko-dot-saito-at-sun-dot-com. Looking forward to working with you !

2008年 9月 10日 水曜日

前から訳そうと関係のある内容です。to を訳すとき、みなさんはどのように日本語にしていますか ? 高校で習った文法、覚えていますか ? 名詞的用法、形容詞的用法、副詞的用法の 3 つが基本でしたよね。

名詞的用法: 「... すること」と訳す

I like to play tennis: わたしはテニスをすることが好き。

形容詞的用法: 「... ための」と、前にある名詞を修飾する

This is the function to control each parameter:  この機能は、各パラメータを制御するためのものです。

副詞的用法: 「... ために」と、前にある動詞を修飾する

You can use this function to control each parameter: この機能は、各パラメータを制御するために使用できます。

わたしがよく引っかかるのは、最後の「副詞的用法」の訳し方。なんでもかんでも「するために」と訳されていることが多いのです。副詞的用法には、いくつか種類があります。技術翻訳では「〜するために」という目的を示すもの、「〜してこうなった」という結果を示すもの、「〜だから、〜ので」という判断の根拠を示すものが多いです。なのに、多くの場合、最初の「目的」で訳されてしまっているのです。確かに目的で正しいのかもしれません。上の例でも「制御するために使用する」で間違っていませんものね。でも、こんな日本語使いますか ?

わたしだったら「この機能を使うと、各パラメータを制御することができます。」と訳すと思う。その場合、わたしは to を「結果」として訳しています。use の結果として control になるの。これも、前から訳すというルールを頭に置いています。

手順によくある、

Edit this file to update the default setting of parameter A.

は、どう訳しましょうか。よく目にするのは、

A パラメータのデフォルト設定を更新するために、このファイルを編集します。

なんですが、どうも不自然で違和感が... to を「ために」と目的で訳しているのです。この to をはさんで前と後が、原因と結果である、として訳してみると次のようになります。

このファイルを編集して、A パラメータのデフォルト設定を更新します。

簡単な見分け方は、to を and に置き換えても無理がないかどうか。置き換えられるんだったら、前から後ろへと訳す (〜するために、と戻ってこない)。わたしはそうして判断しています。

English::
What I am going to write is related to the past entry
Translate from top to end. How would you translate "to do" in the technical writing ? Do you remember what you learned at school ? In Japan, we learn three major usages at high school: Translate as "noun", "adjective", and "adverb".

Noun: Translate as noun function of "doing"

I like to play tennis: translate as I like playing tennis.

Adjective: Translate as adjective function of "doing"

This is the function to control each parameter:  translate as This is the controlling function for each parameter.

Adverb: Translate as "for doing"

You can use this function to control each parameter: translate as You can use this function 

for controlling each parameter.

What concerns me is the last one, "Adverb" usage. It is true this applies to the many cases, but this is over used than it should. Adverb usage has more patterns and I believe the most popular ones are three: Purpose, Result, and Reason. I often see Purpose is mis-used for the case of Result.

"You can use this function to control each parameter" is often translated in Japanese as "To control each parameter, you can use this function.". It is correct, but sounds awkward. We do not talk like this. I would translate this using Result pattern, "You can use this function, and control each parameter.". I translated "use" as a trigger and "control" as a result, and translate from top to end.

How would you translate the common expression in the procedure ?

Edit this file to update the default setting of parameter A.

I often see in Japanese translation:

To update the default setting of parameter A, edit this file.

It is correct, but I do not like it. I would translate as:

Edit this file and update the default setting of parameter A.

When I am not sure, I try to check which part has higher focus. Try replacing "to" with "and". If it works, I will translate from top to end using Result pattern. That's my way.

2008年 9月 09日 火曜日

Bug description is a tough one to translate. Release Notes includes many of the bug information which is described in only one sentence. Most of them are reused from "synopsis" of bug report or issue in Bug/Issue tracker. To translate them correctly, I always look into the bug description body. Sometimes it takes 10 - 20 minutes to translate just one line !

Yesterday, I reviewed and corrected the translation of "shaped/translucent window" in the acceptance check. The original translation of "shaped" was "with shadow". I assumed a translator took it as "shaded". The reviewer corrected it to "formed" or "molded". It is correct literally since "to shape" is to make a form. But, it sounds strange and does not make sense to me - "Need support for shaped/translucent window". What is formed window ?

I searched on the web and assumed it is a Java implementation of the window to add pop-up window to the static display, and "shaped" may mean the window whose shape is defined somewhere by such as draw(Shape, s)... I know this is not the perfectly correct answer, but assumed (hoped) not far from it. So, changed the translation into "Need support for the translucent window whose shape is defined." Also, I added (shaped) to the end so that it rings a bell of the users who knows how to program it.

This is my typical way to determine the translation of unknown term in time. I used to spend more time - it was too scary to select uncertain translation with less information. I wanted to be perfect... that approach worked well when I was junior. I had more time that I can use for myself. Now the time goes by and I would be a bottleneck if I keep the same style. I do enjoy the management job, but sometimes miss the dedicated time for translation. That's why I like to be a member of open source software community!

日本語:

バグ情報の翻訳は、やっかいです。リリースノートには、大抵、バグ情報がたくさん載っていますが、そのほとんどは、バグ ID と説明がちょろっとあるだけ。バグレポートの synopsis (要約) からの引用なので、ほんとにそっけなーい文章です。意味がわかるように翻訳するには、バグレポートの中身を読むことが多いので、一つの文章を訳すのに 10 分も 20 分もかかることがあります。

昨日、そのような翻訳で「shaped/translucent window」という表現の翻訳・査読結果を修正しました。翻訳会社さんに訳してもらった結果を、わたしのチームのレビューアが査読するのですが、その結果の受け入れ検査です。元の翻訳は「陰付き/半透明ウィンドウ」でした。これは「shaped」を「shaded」と間違っているものと思われます。レビューアは、これを「成形/半透明ウィンドウ」と修正していました。うーん、確かに shaped は形を作るという意味なので、あっているんですが、「成形ウィンドウ」ってなんですか !? と思って、調べてみることに。。。

Web で検索してみると、どうも Java の実装で、ポップアップウィンドウの一種のようでした。そして (勇敢にも) 形を指定する際に shape というキーワードを使うのではないか... と予想しました e.g. draw(Shape, s)。ここで暴露するのは恥ずかしいのですが、たぶんこれは大間違いではないけど、大正解でもないでしょう。役に立つ度合いを上げるために、(ユーザーが、あ、これね、とわかってくれることを祈って)、(shaped) と補足で説明を入れました。結果、「形状指定 (shaped)/半透明ウィンドウ」としたのでした。

これは、意味のよくわからない単語の訳を「時間内に」決めるときの典型的な流れです。昔は、もっともっと時間を使ってたなぁ。。。だって、よくわからないのに訳を決めるなんて、怖すぎる。失敗して恥かきたくないし! というのが本音でした。そういう気持ちは、まだ経験の浅いときには、とても役に立ちました。勉強するぞ、という原動力になったし、そのための時間も持てたからね。。。でも今は、それをやっていると「ボトルネック」になってしまうのよ〜。。。(あ、ボトルネックってわかりますか ? 瓶の入り口が狭まっているところのことを指していて、流れがきゅーっと止まってしまうことを例えて言うんですが。日本語では何ていうのかな、あぁ、思いつかない。)

管理の仕事は、大きな流れを生み出すという点で面白いんだけど、ときどき、翻訳に没頭していた頃を懐かしく思い出します。だから、オープンソースソフトウェアに関わる仕事は、とても好きなんです。だって、ひとりの翻訳者・査読者として貢献できるもの!

2008年 9月 08日 月曜日

I am discussing how to run a translation project for OpenSolaris community. The target is manual pages. It may sound strange, but I like the manual pages very much. They serve as the quick reference as well as the most detailed dictionary of commands. As a technical translator, this is so challenging because it is a summary of that command's function and written with an assumption that the user already knows the related commands. When translating manual pages, I have to use all of my brains and imagine what they are all about. If I do not understand one sentence, usually, the next one will illustrate or expand it's meaning, but in a manual page, the next one almost always tells another story... That's why I like them! It's like an exam to check how much I know about the software and how it works; as if it challenges me "You may not know, but this command works this way...", then, I feel I have to answer "Oh, I know!!! "

I know OpenSolaris manual pages have lots to be translated. I looked for the possibilities to translate them internally at Sun, but it turned out not promising for resource limitations. Then I thought, how about translating them with community ? I want to translate and read them in my language!

Now I am working with Japanese OpenSolaris engineer, Takeshi Asano, who is in the same organization (Globalization) to determine the project's basics. What should be the source format ? How to translate them ? How can we share the accomplishment ? Can we include them in OpenSolaris build ?

The possible choice is to convert .roff format into .po format and translate .po. We confirmed it is possible but we have not reached how we can share the translation. .po can be converted back to .roff, and .roff can be viewed by catman. The concern is the way to view .roff in a printable format. Yes, we can convert them manually in "our" environment, but I want that be possible by "externally" by anyone of the community. I know I know, it is not so easy.

Another option is to convert .roff into the text (wiki) format. It is easy to translate and share/view the translation in a manual page format (catman).

Advantage of Option 1 is that the translated roff can be integrated into the build easily and that translated po can be converted into translation memory (TM). It would be great if a translator uses translation memory tool, such as OmegaT, but even if she/he does not use it, we can generate "alignment TM" from po files. Advantage of Option 2 is off course the ease of use (translation and view). Disadvantage of Option 2 is, if we try to integrate them in the build and create a memory, we have to do them all manually...

Well, I will wait for the reply from Takeshi, and decide which way to go this week or the next. If anybody comes up with another idea, please let me know !

日本語:

今、OpenSolaris の翻訳プロジェクトをどう進めるかを話し合っています。翻訳対象は、マンページ! (ドキュメントでは「マニュアルページ」と書いていますが、話すときは絶対! 「マンページ」ですよねぇ。) こう言うとちょっとヘンかもしれませんが、わたしはマンページ大好き！　ユーザーとしては、困ったときにぱっと man コマンドで見ることのできる辞書といった頼れる存在で、翻訳する者としては、闘志をかき立てられる手強い存在です。だってマンページって、読む人は関連するコマンドは知っているものとしてどんどん話を進めていくんですもの。訳すときは、これまで学んだことを総動員して想像力を使いまくって挑みます。普通、ひとつの文がわからなかったら、その次の文で説明するなり関連のある内容を書くなりしているものですが、マンページは「ところで」っていうかんじで次の文章が始まるんですよね... だから好きなんだけど。そのクールさが。まるで「こんなこと知ってる?」と試されるようで、「ええ、知ってますとも!」と受けて立ちたくなってしまいます。

OpenSolaris のマンページはまだ訳されていないものがたくさんあります。最初、社内で訳す方法がないか調べてみましたが、リソースが足りなくて、難しそうです。ならば、コミュニティーで訳せないかな!? と思ったのでした。マンページ訳したいし、日本語で読みたいんだもの。

そこで、日本語 OpenSolaris のエンジニア、浅野剛さんと、どうやってプロジェクトを進めるかを話し合っています。どのフォーマットの英語ファイルを対象にするか ? 翻訳するのはどのフォーマットで ? どう翻訳するか ? 成果はどう共有するか? OpenSolaris のビルドには入れられないか ? などなど...

一つめの方法は、.roff フォーマットを .po に変えて、.po を翻訳するというもの。変換自体は成功することを確認済みなのですが、翻訳成果をどうやって共有 (参照可能に) するか、まだ道が見えていません。.po を .roff に戻して、catman で表示させたものをテキストにしてアップロードしたいんだけど... この作業は社内の環境で人が手でやるなら可能です。でも、それだとタイムリーにできないしねぇ。わたしは、翻訳したらすぐに catman でフォーマットしたものを見たいんですよ。。。そのための仕組みが必要になるんだけどね。

もう一つの方法は、.roff を wiki に変えて翻訳するというものです。翻訳も参照もしやすい (表示形式で訳すから) から、いいよね。でも、その後、どうやってビルドに入れるか、どうやって翻訳メモリーを作るか、が課題です。

一つめの方法のいいところは、翻訳した po を roff に戻せば、その roff はビルドに入れられること、翻訳した po からはメモリーが作りやすいことです。翻訳にメモリーツールを使ってもらえればいいけど、そうでなくても、翻訳結果から alignment TM というメモリーを作ることができます。

こんなことを浅野さんと話し合っているのです。今週か来週には、どうするか決めようと思っています。もしほかにアイデアがあったら、是非教えてください！

2008年 9月 05日 金曜日

今日は久しぶりにつれづれ日記。このごろ、エネルギー不足だったんですよ。なんでかなぁ。暑くて体調悪いからかしら、それとも、ストレスのせいかしら...と考えて、早めに寝たり気分転換に趣味に走ったりしていましたが、いまいち効果を感じられず。でも、だんだん元気が出てきましたの。さて、どうしてでしょう ?

それは、休んだからでも、気分転換したからでもなく、問題に真っ向からぶつかって「わずかな光」が見えたから! でした。それは仕事のことなんですが、ちょっと腰のひけてた件があって、いつかはやらないといけないことなんだけど、今は目をそらしておきたい、といった状態でした。私の場合、「腰のひける件」というのは、だいたい「何をすればいいのか、ぼんやりしていてイメージがつかめない。でも、やらないといけない。」という件であることが多いです。「ぼんやり」から「はっきり」へと転換させないといけないのだけど、それをするには情報が足りなくて、情報を得るには、いろんな人と「ぼんやりした」話をして「はっきり」するまで、まとめていかなくてはいけない。

ううう... それをするぐらいなら、今、手元にあってやり方のはっきりしている仕事がしたい〜... という状態が 1 週間ばかり続いていました。でも、それでは心が晴れないんですよ。わたし、真面目すぎますか ?

でもその状態に我慢ができなくなってきて、ついに勇気を出して一歩踏み出してみました。「あのね、これこれこういう件なんだけど、どう思う ?」「この後だれに話すといいかな。」「それをするには、どうすればいいかな。」といった具合に、だだだーーーっと進展して、あっというまにイメージできるようになったのです。ああ、うれしい!　これならできる。さっさと進めてしまおう。と、元気百倍。

こんなことなら、早く行動するんだった、あの落ち込んだ日々は何だったんだろう、と思います。エネルギーを貯めるっていうけど、本当は、貯めておくんじゃなくて作っていくものだったんだなぁ。忙しいときほど、エネルギーは湧いてくるものね。すぐには解決しないことでも、ずっとその壁に向かっていたら、いつかは光が見えるって信じて、これからも頑張ろうと思いました。ちゃんちゃん。

English:

Today's entry is like my monologue... It's been a while since I wrote such a personal thought. I have been down for a while, but I did not know why. I assumed I might be tired because of too hot summer or too much stress, and tried to get more sleep or spend more time on my hobby. But both of them did not work well and I could not feel better at all. After some other try, however, I am reviving again now! Do you know what worked ?

It's not the sleep or change of air, but the courage to face the wall. I pull the courages together and go against the wall to see a glimmer of light through the tiny hole. The "wall" is a difficult task in my work. There is a high level goal and I know I have to do something to accomplish it, but I have no idea what I should do.... that's the typical "wall" that I have. It is so high and I cannot break it with my bear hands. I need a special tool, but don't know where to get it. To be more specific, the goal is understood literally, but it is still high level propaganda and I cannot figure out what I can/should do to make it happen - I cannot break it down into the small pieces that I can work on. I know I have to communicate with people, various people, outside of my daily communication path, and drive the idea into actionable items.

Oh, but it take so much energy... I want to put it aside and focus on the tasks that I can manage with the known process... that's the voice from my heart. I know I know, this will not clear my mind. This last about 1 week, and now I cannot stand it anymore. Maybe I am too serious and diligent.

Anyway, I made up my mind to face the wall and dig a hole. I walked in their spaces and talked "There is such an issue. What do you think?" "Do you know who I should talk to ?" "What would you recommend to do to make it happen ?" "What do you think about this plan?" .... the issues are now broken into pieces and I successfully separate the things that I can resolve and not. This is a small but brilliant light for me. Now I can describe what I should do. It makes me so happy.

Now I look back my path, and feel I should have realized the energy is not to be saved but to be generated by actions. I remember my tendency that I will be more energetic and happier when I am extremely busy. I will keep facing the wall and take an action even if it looks robust - maybe the wall is not thick enough and if I take courage to punch it, my small fist may dig a hole... that's a lesson I learned today.