BBWA Version 0.0.5 readme.txt
Teppei KAKU <teppei@sat.co.jp>
http://bbwa.sourcefoege.jp/


1. ABOUT

BBWA は、一言で言えば PHP ベースのウェブアルバムです。個人的な用途で PHP ベー
スのウェブアルバムを探していたのですが、どうも自分が求めていたようなものがな
かったので作ってみました。大したソフトではありませんが、特徴としては『見た目
重視』『日本語も問題なく扱える』『高品質なサムネイル作成』『コメントを書き込
めるので掲示板風に使える』ってところでしょうか。

BBWA は、そんなに大量の画像を登録することは想定していませんので、サーバの性能
や登録された画像の数によってはガクッとパフォーマンスが下がるかもしれません(改
善の予定はあります)。いちおう200枚程度の登録数ならばほとんどストレスなしでア
ルバムを表示できると思います。また、『自動縮小』機能については、パフォーマン
スはサーバの負荷状態や性能に大きく依存します。

また、BBWA は開発をはじめたばかりなので、未完成の機能やバグがたくさんあると思
われます。


2. FEATURES

○見た目がシンプルできれい(つもり)
○日本語の表示・入力に対応
○高品質なサムネイルを作成できる
○誰でも画像を登録できるモードと、アルバム管理者だけが登録できるモードを備える
○コメント登録機能と『コメント優先』の並べ替えによって、『画像投稿機能つき掲示
  板』のようにも使える
○携帯電話(JPEG 画像表示可能な機種に限る)からもアルバムの閲覧・コメント投稿が
  行える(やや未完成)
○CSS ファイルを切り替えて見た目を変更可能
○JPEG イメージに限り、あらかじめ縮小してアップロードしなくても『自動縮小』
  機能により指定した最大ピクセル数以下に縮小して画像登録できる


3. REQUIREMENT

BBWA を使用するためには、サーバ側に以下のソフトウェアが必要です。

○Apache 等の Web サーバ (Apache 1.3.9, 1.3.26 で動作確認)
○GD2.0 以降 (GD 2.0.1 で動作確認)
○GD2 および mbstring を組み込んだ PHP4.1 以降 (PHP4.2.2 で動作確認)
  ただし、safe-mode に設定された PHP にはたぶん対応していません。

また、クライアント側の Web ブラウザは、フレーム・JavaScript に対応したブラウ
ザが必要です。動作確認した機種は以下の通りです。

○Windows2000/SP1/2/3 + Microsoft Internet Explorer5/6
○WindowsXP + Microsoft Internet Explorer6
○Windows98SE + Microsoft Internet Explorer5
○Debian GNU/Linux unstable + Mozilla 1.0.0-3
○NTTDoCoMo P504i, SH251i
○J-Phone J-SA04, J-D51


4. INSTALL

bbwa-x.x.x.tar.gz を展開すると得られるファイルの中で重要なのは、以下のファイ
ルとフォルダです。

bbwa-x.x.x/
   +--- index.html (メインの HTML ファイル。ファイル名は変更可能)
   +--- variables.php (サーバ毎に変更が必要な変数を格納したファイル)
   +--- Pics/ (投稿画像を保存するフォルダ。名前変更可能)
           +--- INDEX (インデックスを書き込むファイル)
           +--- Messages/ (説明やコメント等を保存するフォルダ)
           +--- Thumbnails/ (サムネイル画像を保存するフォルダ)

variables.php ファイルは、このファイルに書かれた説明を参考にして変更してくだ
さい。最低限変更が必要な変数は、『$dirName』『$picUrl』『$homeUrl』
『$adminPass』です。また、『Pics』フォルダのフォルダ名は変更可能ですが、それ
にあわせて上記変数も適切に設定する必要があります。その他のファイル名・フォル
ダ名は変更しないでください。

変更が終わったら、変更したファイルを含む全てのファイルとフォルダをサーバ上の
ひとつのディレクトリにアップロードしてください。全てバイナリモードでアップ
ロードすることをお勧めします。それから、上記の例で言えば『Pics』ディレクトリ
とその下の『Messages』『Thumbnails』ディレクトリのパーミッションを『777』、
すなわち誰でも読み書き実行可能にしてください。また、『INDEX』ファイルについ
てはパーミッションを『666』に設定してください。

なお、0.0.5 以前のバージョンからアップグレードする場合、新バージョンの
スクリプトファイルを全てアップロードした後、ウェブブラウザから
『versionup.php』に一度だけアクセスしてください。エラーが出ずに『Done.』
とだけ表示されたら『INDEX』ファイルが正しく生成されたはずです。


5. USAGE

ウェブアルバム上の『ヘルプ』を参照してください。


6. LICENSE

BBWA のライセンスは GPL2(GNU General Public License Version 2) 準拠とします。
詳しくは同梱の copying.txt ファイルを参照してください。また、著作権者は
『Teppei KAKU <teppei@sat.co.jp>』 です。ただし、アイコン画像の著作権者は
『GNOME Project』です。

再配布・改変等は自由に行っていただいてけっこうです。著作権者への許諾なども必
要ありません。ただし再配布したり改変して配布する際も GPL2 に準拠することとオ
リジナル部分の著作権者を明確にしてください。また、BBWA は完全に無保証です。
このソフトウェアを使用したことが原因で何が起ころうとも、私はいっさい責任を
負いません。


7. HISTORY

2002/9/27 0.0.6
- スコアリング機能を追加
- スコア順で並べ替えできるようにした
- INDEX ファイルを生成するスクリプトを追加(バージョンアップ用)
- その他

2002/9/17 0.0.5
- 簡易テーマ機能を追加(CSS ファイルを切り替えるだけですが)
- いくつかのサンプル CSS ファイルを用意
- インデックスを作成するようにして一覧取得を高速化(?)
- ユーザインターフェイスの細かい調整
- その他

2002/9/3 0.0.4
- README ファイルなどのドキュメントを作成
- その他

2002/9/2 0.0.3
- 『自動縮小』機能を追加
- 投稿した画像のタイトルや説明などを後から修正できるようにした
- 『画像全一覧』機能を追加
- その他

2002/8/?? 0.0.2
- FRAME を使ったページにした
- 見た目を整理してわかりやすくした(つもり)
- 『コメント優先』『画像優先』などで並べ替えできるようにした
- その他

2002/?/?? 0.0.1
- 初リリース


8. CREDITS

BBWA は、Teppei KAKU <teppei@sat.co.jp> が開発しました。また、ちょっとした
アドバイスをいただいた『箕面の蒼い彗星』に感謝します。それから、けーたいから
の閲覧のチェックをさせていただいた『ばか部長』『ちょび』『オカン』『LalaBow』
に感謝します。

また、アイコン画像は GNOME Project(http://www.gnome.org/) の一部である
『gnome-libs』パッケージから流用させていただきました。gnome-libs のソースは
上記の URI から入手することができます。それらの画像の編集には、The GIMP
(http://www.gimp.org/) を使用いたしました。それぞれのプロジェクトの
方々に感謝します。

バグ報告・要望・パッチ・ファンレター・ラブレター・おみやげなどは、
Teppei KAKU <teppei@sat.co.jp>
までどうぞ。おみやげは台湾バナナを所望します。


9. TODO

○『写メール』など携帯からの写真を何らかの方法でアルバム登録できるようにする
○MySQL ベース版の開発
○複数のアルバムを一覧できるようなトップページを作る
○ブラウザ上で環境設定できるようにする
○検索機能・ジャンル分け機能など
○BMP 画像の登録に対応する
○etc.
