OpenOffice.org日本語プロジェクトのページに書き込む方法

はじめに

OpenOffice.org日本語プロジェクトのページに書き込む方法について解説しました。Content Developer権限以上を持っている、OpenOffice.org日本語プロジェクトのプロジェクトメンバーは、OpenOffice.org日本語プロジェクトのページにcvsを通じて書き込むことができます。

SCA/JCA/CAを提出しているか

OpenOffice.org日本語プロジェクトでは、Content Developer権限を持つためには SCA/JCA/CAを提出していなければなりません。もしそうでなければ、Sun Microsystems 社貢献者協定(Sun Microsystems Inc Contributor Agreement (SCA))の提出方法を参照し、提出することをお願いしております。JCA/CAについては、既に時代遅れで、新たに提出される場合は、全くおすすめしません。
自分のSCA/JCA/CAがSUNに届いているかどうかは、Copyright-Approved Persons and Companiesで名前が載っているかどうかで確認できます。ただし、最近の状況については、Stefan Taxhet (st@openoffice.org)にIssueを書いて直接尋ねて確認してください。

SSH DSA public keyの作成 (Linux, MacOSX, FreeBSD, Cygwin)

まず、SSH2の公開鍵を作ります。これは、UNIX系(Linux, MacOSX, FreeBSD, Cygwin)では以下のような手順で作成されます。「ターミナル」または、「端末」を開きます。

% ssh-keygen -d
Generating public/private dsa key pair.
Enter file in which to save the key (/home/maho/.ssh/id_dsa):
Created directory '/home/maho/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/maho/.ssh/id_dsa.
Your public key has been saved in /home/maho/.ssh/id_dsa.pub.
The key fingerprint is:
99:c8:1b:76:bc:6f:0b:ef:0e:2f:f4:64:54:36:1f:91 maho@debussy.private.org

そして、以上の場合は、"/home/maho/.ssh/id_dsa.pub"がSSH DSA public keyです。これは「公開鍵」と呼ばれ、公開して問題のないものです。つぎに、秘密鍵はパーミッションが600です。念のため確認しておきましょう。

% chmod 600 ~/.ssh/id_dsa
% ls -la ~/.ssh/id_dsa
-rw-------  1 maho  users  672 07 17  2009 /home/maho/.ssh/id_dsa

注意! ~/.ssh/id_dsaは「秘密鍵」です。絶対に公開しないでください。

SSH DSA public keyの作成 (Windows)

TeraTermを使うと比較的簡単に作成できます。また、cygwinをご利用の方は、cvsおよびopensshパッケージをインストール後、ほぼ上記「SSH DSA public keyの作成 (Linux, MacOSX, FreeBSD, Cygwin)」と同じように SSH DSA public keyを作成できます。

OpenOffice.orgの登録ユーザーになる

SSH DSA public keyの提出のためにはOpenOffice.orgの登録ユーザーになる必要があります。SCAをサブミットした際はすでに登録しているはずですが、念のため繰りかえします。OpenOffice.orgユーザー登録するを参照し、ユーザー登録してください。その時の"Username"が必要となります。

SSH DSA public keyの提出

まずOpenOffice.orgへlogin してください。IssueTrackerのページに飛んで、

wwwというセクションに飛びます。
担当者(Assigned to:) となっているところに、ssh2key@openoffice.org と入力します。
URL に http://ja.openoffice.org と入力します。
要約(summary) Please upload ssh2keyなどとします。
サブコンポーネント(Subcomponent)はopenoffice.org CVSまたはopenoffice.org svnを選択します。
説明(Description)に、 "Would it be possible to get an ssh key for write CVS access." などと書きます。
実行(commit) ボタンを押します。
しばらくしたら issues@openoffice.org からメールが来ます。その URL をアクセスしてください。
薄い青色の Create a new attachment というセクションが出来ているはずです。
それをクリックして、自分の SSH2 の dsa public key を plain text で attach してください。
右上の方にある、CCの追加、にプロジェクトリードのOpenOffice.orgでの登録ユーザー名を書き込んでください。
お疲れさまでした。これで終わりです。

登録されるまでしばらく待ちましょう。数日かかります。

あなたの役割(role)をcontent developerにします。

プロジェクトリードがあなたの役割をcontent developerにします。この時点でcommit権が与えられます。

プロジェクトリードの作業は以下の要になります。

http://ja.openoffice.org/servlets/ProjectMemberList
から、Add New Member をクリックでdeveloper にしたい人を選びます。
Grant these roles to all selected users:
で Content developer を選びます。

権限がcontent developerになったら、メールがくるはずです。また、日本語プロジェクトのメンバーリストから自分の権限を確認してください。

JAOOOのCVS(Concurrent Versions System) を使う

CVS は(同時バージョン管理システムとでも訳すのでしょうか?) ファイルのバージョン管理システムです。多人数で多くのファイル達を管理するのを目的として作られました。これを使うと「だれがいつどういう理由でどのファイルを変更したか」が明確になりますし、さらに「いつでも任意の前のバージョンに戻すことが出来る」という特徴があり、ja.openoffice.org では大変有効な手段です。簡単には、CVS レポジトリ(repository; 倉庫) という場所にファイルをためておき、差分という形で古いバージョンの履歴を持っています。
一般的な使い方についてはここでは触れません。CVS の基本的な仕組みについて、詳しくは書籍や webのものを参照してください。ここでは ja.OpenOffice.org にアクセスする場合の特有の方法について述べることになります。 maho というユーザの場合ですが、自分の OpenOffice.org での登録ユーザー名で置き換えてください。

SSHでトンネルを掘る
```
% ssh -2 -N -f -L 2401:localhost:2401 tunnel@openoffice.org
```
これですぐさまプロンプトが返ってきたら成功です。もし、
```
tunnel@openoffice.org's password: 
```
などとなれば、お知らせください。

CVSにlogin

% cvs -d:pserver:maho@localhost:/cvs login
Logging in to :pserver:maho@localhost:2401/cvs
CVS password: 
%

パスワードは OpenOffice.org の登録したときの物と共通になっています。

CVS レポジトリからファイルを取り出す(cvs checkout)
```
% cvs -d:pserver:maho@localhost:/cvs checkout ja
```
これで ja.openoffice.org にあるものをすべて持ってくることが出来ます。
ファイルの変更をCVS レポジトリとチェック(cvs diff)
ファイルを変更した場合、
```
% cvs -d:pserver:maho@localhost:/cvs diff -u filename.html
```
とします。これで実際にレポジトリにあるファイルと、変更した手元のファイルの違いを見ることが出来ます。これでどこが変更されるかちゃんと調べてから commit(後述) しましょう。
ファイルをCVS レポジトリに追加する(cvs add)
新しくファイルを追加したい場合
```
% cvs -d:pserver:maho@localhost:/cvs add filename.html
```
とします。このあと cvs commit することで実際の CVS レポジトリに反映させることができます。
ファイルを実際にCVS レポジトリに反映する(cvs commit)
ファイルを変更した場合
```
% cvs -d:pserver:maho@localhost:/cvs commit filename.html
```
で、実際の CVS レポジトリジに反映させることが出来ます。

commit log について

CVS commit する場合は どういう変更を加えたかという commit log を残します。
エディタが立ち上がります。適切なcommit log を書いてください。なかなか難しいですが、英語またはローマ字、で書いていただければ
と思います。

ファイルをCVS レポジトリから削除する(cvs remove)
ファイルを削除したい場合、
```
% rm filename.html

% cvs -d:pserver:maho@localhost:/cvs remove filename.html
```
とします。このあと cvs commit することで実際の CVS レポジトリに反映させることができます。
ディレクトリを追加したい場合(cvs add)
ディレクトリの作成は慎重に!!ディレクトリを削除するのは難しいのです。新たにディレクトリを追加したい場合
```
% cvs -d:pserver:maho@localhost:/cvs add dirname
```
このあと cvs commit することで実際の CVS レポジトリに反映させることができます。
ファイルをアップデートしたい場合(cvs update)
CVS の Concurrent とは「同時に」を意味するので、他の人はどんどんコミットしてゆきます。あるディレクトリを最新の物に更新したい場合は、そのディレクトリで update としてください。
```
% cvs -d:pserver:maho@localhost:/cvs update
```
CVSWeb(CVS の Web でのインターフェース)
```
ja.openoffice.org の CVS に関するログ、バージョン履歴は web browser を使って
見ることが出来ます。
ja.oo.o の CVSweb
を参照してください。誰が、いつ、どのファイルを変更したか、とその理由、および
任意の以前のバージョンを見ることが出来ます。
```
トラブルシューティング
- 接続できない: "tunnel@openoffice.org's password:"とでる。
  秘密鍵を~/.ssh/id_dsaに置いているか確認してください。
- 接続できない
  秘密鍵のパーミッションは600ですか?