BBZCmdEx 0.1 Documentation
==========================




概要
	BBZCmdEx はキーボード派向けのプラグインです。
	テキストボックスにコマンドを入力することで
	何らかの動作 -- 例えば Bro@m の送信や任意のファイルを開くなど -- を
	実行することができます。
	できることは Broambox と似ていますが、より便利になっています。
	# BBSystemBar に対する BBSystemBarEx みたいなものです。 by NC-17


	現在のバージョン:
		http://desktopian.org/bb/files/bbzcmdex01.zip

	loose-screws.com にあるスレッド:
		http://forums.loose-screws.com/viewtopic.php?t=1683


	アーカイブを展開すると色々ファイルがありますが、
	必要なのは以下のものだけです (残りはソースコード)。

		bbzcmdex.chm		ヘルプ
		BBZCmdEx.dll		プラグイン本体
		bbzcmdex.rc		設定
		boxengine.dll		(多分) プラグインの一部
		history.txt		コマンドの履歴
		zcmdaliases.txt		エイリアスの設定
		zcmdengines.txt		サーチエンジンの設定

	これらのファイルを適当なディレクトリに配置して、
	plugins.rc に BBZCmdEx.dll へのパスを追加すれば Ok。

	プラグインがロードされると小さなテキストボックスが表示されます。
	これにコマンドを入力して色々な動作を実行できます。
	主な機能は以下の通り:

		# Bro@m の送信
		- 任意のファイルを開く / アプリケーションを起動
		+ 指定したキーワードをサーチエンジンで検索
		+ 電卓
		+ 入力したコマンドの履歴を保存
		+ コマンドの履歴から補完
		+ いくつかの内臓コマンド

	# '+' は Broambox にないものです。




内臓コマンド
	'.' から始まるコマンドは内蔵コマンドとなっています。
	内臓コマンドは以下の通り:

		.about		BBZCmdEx についてのダイアログを表示
		.help		ヘルプファイルを表示
		.exit		シェル (BB4W) の終了
		.quit		.exit と等価
		.shutdown	PC のシャットダウン
		.reboot		  -- 再起動
		.logoff		  -- ログオフ
		.hibernate	  -- 休止状態
		.suspend	  -- スタンバイ
		.lock		  -- ロック
		.clear		コマンドの履歴を削除
		.run		「ファイル名を指定して実行」ダイアログを表示
		.reconfig	BB4W に設定ファイルを読み直させる
		.restart	BB4W の再起動
		.editstyle	現在適用しているスタイルの編集
		.editmenu	menu.rc の編集
		.editplugins	plugins.rc の編集
		.editextensions	extensions.rc の編集
		.who		ユーザー名を表示
		.kill <app>	タイトルに <app> を含むウィンドウを閉じる
				# 条件に合致する*全ての*ウィンドウを閉じます

	ちなみに内臓コマンドの ".about" を入力しようとして
	".あぼうｔ" と入力すると同名のファイルを開こうとします。


Bro@m
	'@' で始まるコマンドを入力すると、Bro@m として送信されます。

	……送信されるのですが、
	現在 (0.1) は Bro@m が送信されると同時に
	同名のファイルも開こうとします。
	例えば @BBHidePlugins を入力すると、
	プラグインが非表示になり、かつ
	「Error: 指定されたファイルが見つかりません。」
	というダイアログが表示されます。
	恐らくバグと思われます。

	# でも「Bro@m の送信ができます」とはオリジナルのドキュメントに
	# 一言も書かれていないので、判断に困ります。


検索
	'?' で始まるコマンドを入力すると、
	'?' 以降の文字列をサーチエンジンから検索します。
	例えば "?BB4Wjj
	# 実際には '?' 以降の文字列を検索する URI を開くだけです。

	URI に使えない文字は自動でエスケープされるので日本語も通ります。

	同梱の設定のままだとデフォルトで Google から検索しますが、
	他のサーチエンジンから検索することも可能です。
	例えば "?Amazon 萌え単" と入力すると
	Amazon から「萌え単」を検索します。

	サーチエンジンの設定は zcmdengines.txt に記述されています。
	例えば "?a" で Amazon.co.jp から検索するようにするには
	以下のようにします (実際には一行)。

		a	http://www.amazon.co.jp/exec/obidos/external-search/
			?keyword=<args>

	入力されたキーワードは <args> の部分に展開されます。
	# 同梱されているサンプルを見ると、
	# <arg1> や <arg2> のようにして n 番目のキーワードを展開したり、
	# <arg3+> のようにして n 番目とそれ以降のキーワードを展開することも
	# できるようなのですが、期待通りの展開がされていないようです。

	なお、スペースを含むキーワードを検索することはできないようです。
	# '"' で括って検索しようとすると <args> が空文字列に展開されている。

	'?' とキーワードの間にスペースは省略できますが、
	デフォルトのサーチエンジンから検索するつもりで、
	例えば "?お兄ちゃんどいて!_そいつ殺せない" ('_' はスペース) と
	入力すると、「お兄ちゃんどいて!」から「そいつ殺せない」を
	検索しようとします (で、そんな定義は多分ないでしょうから
	「Error: Unknown Search Engine: お兄ちゃんどいて!」と怒られます)。

	なお、デフォルトのサーチエンジンは zcmdengines.txt の
	先頭に記述されているものになります。


電卓
	'=' で始まるコマンドを入力すると、
	'=' 以降の数式を計算した結果を表示します。
	使える演算は以下の通り:

		+	加算
		-	減算
		*	乗算
		/	除算
		^	累乗

	# あー、"=日本語" なんて入力するとシェルごと落ちるので注意。


ファイルを開く / アプリケーションを起動
	上記のどれでもないコマンドが入力された場合は、
	該当するファイルを探して開きます。
	また、"http://"、"https://"、"ftp://" から始まるコマンドを入力すると
	(ブラウザで) その URI を開きます。

	また、ファイルや URI に対してエイリアスを定義することもできます。
	エイリアスは zcmdaliases.txt に記述されています。
	新たなエイリアスを追加するには、上記ファイルに

		box.cm.us http://box.crackmonkey.us/

	のように「エイリアス名」と「実際に開くファイルまたは URI」を
	スペースで区切って記述します。

	なお、Bro@m や内臓コマンド、数式に対するエイリアスは定義できません。




コマンドの入力履歴
	入力されたコマンドは全て history.txt に保存されます。
	テキストボックスでカーソルキーの上下を入力すると
	履歴を参照することができます。
	また、この履歴はコマンドの補完にも利用されます。

	同じコマンドは 1 つしか保存されませんので、
	ファイルがどんどん巨大になっていくことはありません
	(し、仮に保存されたところで大したことありません)。

	履歴を削除するには内臓コマンドの .clear を使うか、
	あるいは手動で history.txt を編集 / 削除します。


補完
	コマンドを途中まで入力して Shift を押すと、
	入力履歴から該当するコマンドを検索し、それに補完します。
	この手のアプリケーションには必要不可欠な機能ですね。

	# ただし、BBZCmdEx の補完は (私としては) 不便です。
	# 補完できるのは入力履歴から*だけ*です。
	# エイリアスや内臓コマンド、あるいはファイル名などの補完はできません。
	# というか、何で補完のキーが Shift なんでしょう。
	# 記号を入力しようとして補完されてしまうことがしばしば。
	# テンキーがなければ電卓は使えたものではありません。


設定
	エイリアスとサーチエンジン以外の設定は bbzcmdex.rc に保存されます。

		bbzcmdex.x: <value>	プラグインの表示位置 (X 座標/ピクセル)
		bbzcmdex.y: <value>	プラグインの表示位置 (Y 座標/ピクセル)
		bbzcmdex.width: <value>	テキストボックスの幅 (ピクセル)
		bbzcmdex.inslit: <bool>	スリットに入れるか否か




作者
	Copyright (C) 2004 Procic Konstantin <admin_kostya AT mail DOT ru>




その他
	BBZCmdEx は ZCmd および Broambox を元に作られています。
	ZCmd は Zealot-6 さんが作った Aston というシェルのプラグイン、
	Broambox は Tres`ni さんが作った BB4W のプラグインです。

	ソースコードは Delphi6 と VC6 からできてます。

	# そういえば BBZCmdEx にフォーカスを移すにはどうすればいいんでしょう。
	# それがキーボードからできないと、マウスを使わざるを得ない部分が
	# 出るので、かなり不満。Bro@m のどれかにあるかな。

	# 後、単体の実行ファイルで Bro@ms を送信できるものがないかな。
	# 他のツール (例えば bluewind) と絡めれば便利そうなのですが。
	# bluewind <http://cspace.s2.xrea.com/software/bluewind/index.php>

	# 2004-02-22T07:21:01+09:00  あー、BBController がありました。

	# 2004-03-23T17:50:30+09:00  
        #     http://nicht.s8.xrea.com/trash#software-blackbox




# 初版: 2004-02-06T17:50:59+09:00
# $Id$
[EOF]