Kanji Database Project: Windowsで開発に参加する方法

はじめに

この文書は、Kanji Database Projectに参加したいものの、CSVやUnixに親しみがなく敷居の高さを感じている文系Windowsユーザ（笑）のために書かれたものです。内容については当然、無保証ですので、何らかの不具合があっても一切責任を持ちませんし、ソフトウェアはどんどんバージョンアップしていくので、すぐに使い物にならなくなるかもしれません。また、筆者はWindows 2000 Professionalしか持っていないので、他の環境については書くことが出来ません。あらかじめご容赦ください。

開発に参加するには、以下に説明するツール類のほかに、

が必要です。前者はホームページ上で簡単に取得できます。後者については管理者（moroshigeki、kawabata）にお尋ねください。

ツールの入手とインストール

CVSクライアント

Windows用のCVSは、以下のソフトウェアが使いやすいでしょう。

WinCVS 1.2は、ダウンロードしたファイル（WinCvs120.zip）を解凍し、SETUP.EXEを実行するとインストールできます。

日本語化する場合には、ごった煮版のバイナリ（wincvs120-sjis_gottani.20010327.bin.lzh）をダウンロードしてから解凍し、そのファイルを英語版WinCVS 1.2（デフォルトのフォルダはC:\Program Files\GNU\WinCvs 1.2\）に上書きすればメニューなどが日本語化します。

SSHクライアント

データを自分のところにダウンロードするだけなら必要ありませんが、作業した結果をSourceForgeのサーバに格納（コミット）するには、SSHクライアントが必要です。

インストールは、ダウンロードしたファイル（SSHWin-2.4.0-pl2.exe）を実行します。

インストール後、SSHをインストールしたフォルダ（インストール時に特に設定しなければ、C:\Program Files\SSH Communications Security\SSH Secure Shell）にあるssh2.exeというファイルの名前をssh.exeに変更します。

Unix環境

Windows上でUnixのコマンドを動かすものとしては、cygwin等があります。

インストール方法については、「ちょ～簡単Cygwin のinstall」を参照してください。

SourceForgeサーバへの接続

SSHで接続する

SSH経由で、cvs.kanji-database.sourceforge.netにログインします。インターネットに接続している状態でコマンドプロンプトを立ち上げ、

C:\>ssh -l あなたのアカウント名 cvs.kanji-database.sourceforge.net

と入力します。「あなたのアカウント名」のところはそれぞれユーザによって異なります。入力すると、

Host key not found from database.
Key fingerprint:
ひとそれぞれ-ひとそれぞれ-ひとそれぞれ---
You can get a public key's fingerprint by running
% ssh-keygen -F publickey.pub
on the keyfile.
Are you sure you want to continue connecting (yes/no)? yes

と表示されますので、続行するためにyesと入力します。すると、

Host key saved to ひとそれぞれ
host key for cvs.kanji-database.sourceforge.net, accepted by moro Tue May 08 2001 13:22:20
あなたのアカウント名's password:

と表示されますので、SourceForgeのパスワードを入力します（ただし、画面には表示されない）。

Authentication successful.
Last login: Wed May  2 12:54:16 2001 from ひとそれぞれ

Most of the programs included with the Debian GNU/Linux system are
freely redistributable; the exact distribution terms for each program
are described in the individual files in /usr/doc/*/copyright

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.

Welcome to cvs.sourceforge.net

This is a restricted Shell Account
You cannot execute anything here.

Connection to cvs.kanji-database.sourceforge.net closed.

C:\>

これで、SSHの準備ができました。

WinCVSで接続

WinCVSを起動し、以下のとおり設定を行います（プロキシなどの設定はそれぞれやってください）。

  1. メニューの［管理］→［設定］を開く。
  2. ［CVSROOT（CVSリポジトリの場所）を入力］に「あなたのアカウント@cvs.kanji-database.sourceforge.net:/cvsroot/kanji-database/」を入力。
  3. ［認証方法］は「SSH 経由で接続」とする。

次にkanji-databaseのCVSサーバに接続し、チェックアウト（サーバに作業用コピーを要求すること）します。

  1. メニューの［作成］→［チェックアウト］を開く。
  2. ［モジュールの名前又はサーバ上のパスを入力］に「kanji-database」を入力。
  3. ［ローカルディスク上のチェックアウト先］に、ダウンロード先（例えばC:\kanji-database）を入力。

ここでOKを押すと、チェックアウトされます。

実際の作業

ファイル一行目の、

# $Id: for_windows_developers.html,v 1.1 2002/02/07 01:25:54 moroshigeki Exp $

は、自動的に変更されるので勝手にいじらないで下さい。

ローカルディスクにあるファイルを変更して（WinCVS上では、アイコンが赤い色になる）サーバに反映させたい場合は、

  1. そのファイルを選択してメニューの［修正］→［格納（coMmit）］（あるいは右クリックの［格納（coMmit）］）をクリック。
  2. ［更新ログ］に、変更内容を英語で書き込む（これはあとあと見直すときに必要なので具体的に書く）。
  3. 別ウィンドウでコマンドプロンプトが起動するので、パスワードを入力する。

という手順で、サーバのファイルを更新します。

誰か他の人が更新した結果を自分のローカルファイルに反映したい場合には、

  1. そのファイルを選択してメニューの［修正］→［更新（Update）］（あるいは右クリックの［更新（Update）］）をクリック。
  2. 別ウィンドウでコマンドプロンプトが起動するので、パスワードを入力する。

という手順でローカルファイルを更新します。

競合（conflict）した場合

ファイルを変更しコミットしようとしても、次のようなエラーが出ることがあります。

cvs server: Up-to-date check failed for `index.html'
cvs [server aborted]: correct above errors first!

これは共同作業者の誰かがあなたの作業中にファイルを修正したことを示します。この場合はファイルをアップデートして、変更結果をマージします。しかし、他の人とあなたが、同じ箇所を別々に修正したために、競合（コンフリクト）が起きる場合があります。その場合、ファイルをアップデートすると競合した箇所が次のようになっていると思います。

<<<<<<< index.html
            もともと包摂された文字が台湾字形主導で変更された例。
=======
            もともと包摂された文字が中国字形主導で変更された例。
>>>>>>> 1.14

上があなたのファイル、下が他の人の変更です。この例では「台湾」「中国」の部分がぶつかっています。この部分を適切に修正し（場合によっては競合した人と話し合って）、コミットします。

mailto: moroshigeki Last update: 2001/May/14