和訳更新ガイド
この文書では、基本的な簡単なドキュメントの更新の仕方、和訳と原文をワンタッチで切り替える方法、そして新規ドキュメント公開やドキュメントの更新をいち早くキャッチする方法を解説します。
基本的な簡単なドキュメントの更新の仕方
Mozilla Japan では mozilla.org のドキュメントの和訳を提供していますが、これらは必ずしも最新とは限りません。ドキュメントが最新かどうかをチェックする方法と、古くなったドキュメントの変更点を調べる方法 (これが分かれば和訳文書を最新版に更新するのも楽ですね) を紹介します。
フッタと日付
mozilla.org のドキュメントのほとんどには、
このようなフッタがページ下に入っています。このフッタの中には、見たとおり日付が入っています。この日付はドキュメントの登録・更新時に自動生成されたものです。一方、和訳ドキュメントにも、
やはりフッタが入っています。この「英語版」の日付は、和訳をした時点でのオリジナルドキュメントの最終更新日で、「和訳版」の日付は和訳ドキュメントの最終更新日 (自動生成) です。オリジナルドキュメントの日付と「英語版」の日付が同じなら、その和訳は最新です。これが異なっている場合は、オリジナルドキュメントが更新され、和訳ドキュメントが古くなっているわけです (時々間違っていることもあります)。
和訳ドキュメントが古くなっている? 新しいドキュメントが欲しい、と思うのは当然でしょう。ただ、ほんの一部しか修正されていないとき、どこが修正されたか分からなければ、和訳を更新するのは大変です。
Bonsai で変更履歴を見る
そんな時は、和訳フッタの「英語版更新履歴」のリンクをクリックしましょう。オリジナルドキュメントにも「Document History」というリンクがあります。
これは Bonsai というツールの画面です。mozilla.org の文書は CVS というツールで管理されていて、いつどこを修正したか全部履歴が残っています。CVS の履歴を横断的に見られるようにしたものが Bonsai で、mozilla.org の文書も同じように横断的に見られます。
ここで、いつどこが更新されたかが分かります。Rev の列の数字 (バージョン番号) をクリックすると、その日・その時間に更新された場所が分かります。
各変更時の差分を見る
左側が更新前、右側が更新後です。緑色の部分がまるまる追加・削除された箇所。水色の部分が差し替えられた箇所。この色づけ、時々変な結果を表示しますので、そのときは残念でした。ただし、変更されているにもかかわらず色が付かないということはありません。
更新文書を作りたければ
mozilla.org のドキュメントと和訳ドキュメントの日付を比較して、それに対応する変更履歴を調べ、変更された部分だけ直せば、あっという間に和訳ドキュメントは最新になりました。新たな和訳ドキュメントを公開する要領で報告してください。
例外もあります
ここで補足。mozilla.org の一部のドキュメントにはフッタがありません。そういう文書はどうでしょうか?
この index.html の部分に、その文書の URL の http://www.mozilla.org/ に続く部分を入れれば、更新履歴を見ることができます。下にあるブックマークレットを使うと便利でしょう。
時々、自動生成でない更新日付が書いてある文書もありますが、あくまでその日付は「参考」にしてください。正しくないこともたまにあります。
和訳と原文をワンタッチで切り替える方法
このブックマークレットを使うと、和訳と原文を簡単に切り替えられます。リンクを右クリックして「このリンクをブックマーク」を選択し、適当な場所に追加してください。
Bonsai をワンタッチで表示する方法
このブックマークレットを使うと、更新履歴をワンタッチで表示できます。リンクを右クリックして「このリンクをブックマーク」を選択し、適当な場所に追加してください。
新規ドキュメント公開やドキュメントの更新をいち早くキャッチする方法
以下のページをまめにチェックすると、ドキュメントと公開・更新をいち早くチェックできます。URL 末尾の「48」とは、過去 48 時間以内にチェックインされた文書を示します。ここを変えることで検索の時間的な範囲を変えることができます。
Checkins to module MozillaOrg in the last 48 hours