Giraffe+ Manual
この文書はGiraffe+のデフォルト設定での簡単な使用法を簡潔に説明します。
入力文字列はString、キーボードショートカットはKeyと表示されます。
設定ダイアログから設定できるスクリプトの一覧はsettings.xmlを、
既出そうな質問はFAQを、
動作環境等基本的なことはReadmeを、
スクリプト言語の仕様はブログの[gs]カテゴリを、
それぞれ参照してください。
分からないところがあれば、メールやブログで質問してください。
Tutorial
順番に読みながら実践することで基本的な機能や操作法が理解できます。
Internet Explorerのアイテム登録とその登録アイテムの利用
パス入力の効率化機能と登録アイテムの扱いを学びます。
-
C:\Program Files\Internet Explorer\IEXPLORE.EXEの入力
- エディットボックスにC:\と打ち込むと、C:\に存在するファイルやフォルダの一覧がリストボックスに表示されます。
- そこからさらに、pを打つと、pで始まる名前のものだけに絞り込まれます。
- エディットボックスが自動的にC:\Program Filesとなったら\を打ちます。(ならなかった場合はなるまで残りのrogram Filesを打っていくか、カーソルキーでリストボックスから選択する。)
- するとC:\と打ち込んだ時と同じようにC:\Program Files\に存在するファイルやフォルダの一覧がリストボックスに表示されます。
- 同じような作業を繰り返し、C:\Program Files\Internet Explorer\IEXPLORE.EXEをエディットボックスに表示させます。
-
C:\Program Files\Internet Explorer\IEXPLORE.EXEのアイテム登録
- エディットボックスがC:\Program Files\Internet Explorer\IEXPLORE.EXEの状態でAlt+Aとすると、各種要素が入力済みのダイアログが表示されます。
- そのままEnterでIEXPLOREとして登録されます。
-
テキストのクリア
- Escでエディットボックスのテキストがクリアされます。
-
登録アイテムIEXPLOREの入力
- エディットボックスにiと打ち込むとIEXPLOREとなります。
-
登録アイテムIEXPLOREの実行
- エディットボックスがIEXPLOREの状態でEnterするとC:\Program Files\Internet Explorer\IEXPLORE.EXEが実行されます。
- 実行後、Giraffe+のメインウインドウは非表示化されます。
-
メインウインドウの表示と非表示化
- Win+Spaceで再表示されます。
- エディットボックスが空の状態でEscするとメインウインドウが非表示化されます。
- エディットボックスの状態に関わらず、表示されてる状態でWin+Spaceすると非表示化されます。
-
登録アイテムIEXPLOREからC:\Program Files\Internet Explorer\IEXPLORE.EXEへのアクセス
- エディットボックスがIEXPLOREの状態で\(日本語キーボードの、円記号かバックスラッシュの印字のあるキーどちらでもいい)を打つとエディットボックスがC:\Program Files\Internet Explorer\IEXPLORE.EXEとなります。
-
登録アイテムIEXPLOREからC:\Program Files\Internet Explorer\へのアクセス
- エディットボックスがIEXPLOREの状態でCtrl+\とするとC:\Program Files\Internet Explorer\となります。
-
C:\Program Files\Internet Explorer\IEXPLORE.EXEからC:\Program Files\Internet Explorer\へのアクセス
- エディットボックスがC:\Program Files\Internet Explorer\IEXPLORE.EXEの状態でCtrl+\とするとC:\Program Files\Internet Explorer\となります。
-
登録アイテムIEXPLOREからC:\Program Filesへのアクセス
- エディットボックスがIEXPLOREの状態でCtrl+Shift+\とするとC:\Program Files\Internet Explorerとなります。
- もう一度Ctrl+Shift+\とするとC:\Program Filesとなります。
-
登録アイテムIEXPLOREをIEへ名前変更
- エディットボックスがIEXPLOREの状態でCtrl+Rとすると名前変更のためのダイアログが開きます。
- IEXPLOREとなっている入力欄をIEとしてEnterします。
- エディットボックスにiと打ち込むとIEとなることを確認してください。
-
登録アイテムIEを削除
- エディットボックスがIEの状態でCtrl+Deleteとすると、エクスプローラでDeleteしたときと同じようになります。(確認ダイアログが出たりゴミ箱に送られたり設定によって変わる)
- エディットボックスにiと打ち込んでもIEとならないことを確認してください。
設定ダイアログを使ってホットキーによるGoogle検索を可能に
設定ダイアログとホットキーとGiraffe+の多態性について学びます。
-
設定ダイアログを開き、ホットキー一覧を表示する
- F5を打つと設定ダイアログが開きます。
- →を打つとSettingsが開きます。
- ↓を二回打つとhotkeyが選択され、右側にホットキーの一覧が表示されます。
-
Google Modeが発動するように設定する
- 「w-g google-mode Google Mode」という項を選択し、Spaceを打つとチェックされます。
- Enterで設定ダイアログをOKすると自動的に設定が更新、再読み込みされます。
-
Google Modeを使ってみる
- Win+Gを打つと、Googleのアイコンが表示されたGiraffe+のメインウインドウが表示されます。
- なんらかの語を入力します。
- Enterを打つとデフォルトのブラウザでGoogleの検索結果が表示されます。
Giraffe+のReadmeの内容をリストボックスに表示
Giraffe+でのテキストファイルの読み方を学びます。
-
Giraffe.exeの存在するディレクトリの表示
- F9を打つとエディットボックスがGiraffe.exeの存在するディレクトリ\となります。
-
Readmeファイルの表示
- エディットボックスがGiraffe.exeの存在するディレクトリ\readme_jp.txtの状態でAlt+Vとすると、Readmeファイルの内容がリストボックスに表示されます。
-
リストアイテムを選択せずにリストボックスをスクロール
- Ctrl+PageUpで上方向へ、Ctrl+PageDownで下方向へリストボックスがスクロールします。
16進数を10進数にし、2進数にし16進数に戻す
メインメニューの基数変換機能の使い方を学びます。
-
16進数の数値を入力する
-
メインメニューから10進数に変換する
- App(メニュー)キーでメインメニューを表示します。
- N, Dを押し、基数変換からDecを選択します。
- エディットボックスの0xffが255になったのを確認します。
-
10進数から2進数にし、16進数に戻す
- メインメニューの基数変換にあるBinを選択します。
- エディットボックスの255が11111111になったのを確認します。
- Home, 0, Bと打ち0bを先頭に加え、エディットボックスを0b11111111にします。
- メインメニューの基数変換にあるHexを選択します。
- エディットボックスの0b11111111がffになったのを確認します。
ファイルやフォルダの作成とそのコピーや削除
ファイルの操作法を学びます。
-
デスクトップにフォルダ作る
- ::(コロン2つ)をエディットボックスに入力します。
- Ctrl+Shift+Nを押し、フォルダ作成のダイアログを表示させます。
- giraffe_testと入力し、EnterでOKします。
-
作成したフォルダ内にファイルを作る
- エディットボックスが::\giraffe_testとなってる状態でCtrl+Nを打ちます。
- フォルダ作成時と同じようなダイアログが表示されるので、fileと入力し、Enterします。
-
作成したファイルをコピーする
- エディットボックスが::\giraffe_test\fileとなってる状態でCtrl+Shift+Cを打ち、ファイルをクリップボードにコピーします。
- Ctrl+Shift+\を打ち、エディットボックスを::\giraffe_testにし、Ctrl+Shift+Vでペーストします。
- ::\giraffe_test内に、fileのコピーが生成されたことを確認してください。
-
作成したフォルダ削除する
- エディットボックスが::\giraffe_testとなってる状態でCtrl+Deleteを打つと、giraffe_testがゴミ箱へ移動します。
Keyboard Shortcut
よく使う(と思われる)キーボードショートカットの一覧です。settings.xmlで全てのキーが確認できます。
- Enter実行
- Shift+Enterフォルダを開く
- Alt+Enterプロパティ
- Ctrl+Enterシェルコンテキストメニュー(エクスプローラのメニュー)
- Alt+Aアイテム登録
- Ctrl+Tabアイコン表示の切り替え
- Shift+Tab実行後非表示化の切り替え
- Appメインメニュー
- F1入力テキストをスクリプトとして実行
- F2設定の再読み込み
- F3設定の保存
- F4リストボックスの開閉
- F5設定ダイアログを開く
- \登録アイテムをパスに変換
- Ctrl+\登録アイテムをそのディレクトリのパスに変換
- Ctrl+Shift+\パスを上の階層に変換
- Alt+M選択中のリストアイテムのマークをトグル
- Alt+Shift+M全てのリストアイテムのマークをトグル
- Ctrl+Pパスのコピー
- Ctrl+Shift+Pパスのコピーのメニュー
- Ctrl+Nファイルの作成
- Ctrl+Shift+Nフォルダの作成
- Ctrl+Shift+Cファイルのコピー
- Ctrl+Shift+Xファイルの切り取り
- Ctrl+Shift+Vファイルの貼り付け
- Ctrl+Deleteファイルのゴミ箱への移動
- Ctrl+Shift+Deleteファイルの削除
Drag and Drop
Giraffe+へのドラッグアンドドロップと、Giraffe+からのドラッグアンドドロップの両方が可能です。
-
Giraffe+へのドロップによるアイテム登録
- Giraffe+のメインウインドウにドロップすると、アイテム登録のダイアログが開きます。
-
Giraffe+へのドロップによるテキスト入力
- Ctrlを押しながらドロップすると、エディットボックスにそのファイルのパスが入力されます。
-
Giraffe+からのドラッグアンドドロップ
- エディットボックスにファイルのパスがある状態でエディットボックスをドラッグします。(ウインドウが移動する場合は「枠」を掴んでいます)
- リストボックスのアイテムにマークある場合はそれがドラッグされるファイルになります。
Settings Dialog
F5で表示される設定ダイアログについて。
-
値の編集
- Settings::key, Settings::hotkey, Configの3つの設定ページのアイテムは編集可能です。編集するにはアイテムを選択しF2を打ちます。
-
キーボードショートカットの表記
- モディファイアキー(Ctrl等)とキーの区切りは+ではなく-です。
- モディファイアキーは頭文字で表されます。例:Ctrl+V = c-v
- 複数のモディファイアキーの使用は区切らず連結します。例:Ctrl+Shift+V = cs-v
- アルファベットと数字キー以外の大抵のキーには複数のキー名が与えられています。キー名は、一般的な呼称、日本語109キーボードの印字、WinUser.hのVK_定義、等に基づきます。キーコードを直接指定することも可能です。
- 例えば、円記号の印字のキーは、0xdc, \1, yen, oem_5、バックスラッシュの印字のキーは、0xe2, \2, \, backslash, oem_102で指定できます。
- キー名一覧がdoc/keymaps.txtで見れます。
未整理の情報
古いドキュメントにあった、有用ながら、少し内容が難しく、簡単に説明できそうにないものを、そのままここに置いておきます。
List Item Marking
リストアイテムのマークにより、複数アイテムの実行が可能です。
Alt+Mで選択中の、Alt+Shift+Mで全てのアイテムのマークを切り替えます。Shfit+Up/Downによる選択風マークと、Ctrl+Shfit+Up/Downによる選択風マーク解除もあります。
例えば、Alt+Shift+Mで全てをマークし、Alt+Enterでプロパティを実行すると、エクスプローラで複数選択時にAlt+Enterをしたのと同じようになります。
複数アイテムをマークした状態でCtrl+Pとすれば、マークされたファイルのパスが改行区切りでクリップボードにコピーされたり、Alt+Aとすれば、複数ファイルをドロップしたときのようになったりします。
ShellExecute
Windowsではファイルの実行には以下の5つの要素が用いられます。
- 実行されるファイル
- パラメータ
- 作業ディレクトリ
- 動作
- ウインドウの状態
Giraffe+では、これらの指定に';'で区切った文字列を用います。上記の順番どおり';'で区切り、file;parameter;working directory;verb;show windowとします。
「実行されるファイル」が登録アイテムであった場合、パラメータはその登録アイテムのパラメータに空白とともに追加され、それ以外は指定があれば上書き、という形になります。
"動作"とは何なのか。
これは、エクスプローラでファイルを右クリックしたときに出てくるメニューの項目です。
Windowsが提供する標準のものと、
レジストリに登録された関連付けがあります。
copy, paste, propertiesなどがWindows標準、
open, edit, printなどが関連付けです。
関連付けは、"HKEY_CLASSES_ROOT\ファイル種名\shell"以下に列挙されるキー名そのままです。
ウインドウの状態には数値を指定します、1が普通、3が最大化、7が最小化です。
Shell Namespace
エクスプローラやファイルダイアログで目にする、
デスクトップをルートとしたWindowsの世界です。
マイコンピュータとかコントロールパネルとか、
ファイルシステムとは別のフォルダが存在します。
Giraffe+では、"::\"で始まる文字列を表示ITEMIDLIST、
"::-"で始まる文字列を数値ITEMIDLISTとしています。
これらによってシェルネームスペースのアドレスを表現します。
表示ITEMIDLISTは完全ではありません。
ファイルやフォルダに区切り文字である'\'を含んだり、
同じフォルダに同じアイテム名のものが存在する場合などは表現できません。
一方、数値ITEMIDLISTは完全です。
バイト列であるITEMIDLISTをそのまま'-'区切りで表現します。
とりあえずコントロールパネルにアクセスしてみます。
::\と打ち込めばデスクトップがオートコンプリートされるはずなので、
そのままエクスプローラでアクセスするのと同じ要領でコントロールパネルに行けます。
Alt+AでDataにControlPanelとして登録しておけば、ControlPanelと入力して、
\を打てばコントロールパネルのアイテムに簡単にアクセスできます。
当然、アイテムをDataに登録することも可能です。
SES
Dataの追加時にTypeを.sesにすればsesファイルになります。
verbもショートカットに指定したい場合や、
lnkファイルの読み込みが遅く感じる時は、
sesファイルを使ってみるといいかもしれません。
Giraffe.iniの[Shell]セクションに「CreateShortcut.Type="ses"」を追加するとAlt+Aで表示されるダイアログのTypeがデフォルトでsesになります。
Script in Data
スクリプトをDataに置くことが出来ます。
試しに、引数をGoogleで検索するスクリプトを作ってみます。
以下4行をDataにGoogle.giraffeとして保存してください。
(Googleで検索)
(google.ico)
include((www))
Shell.Execute(cat((http://www.google.co.jp/search?ie=sjis&q=)www:url-encode(param(0))))
一行目はスクリプトの説明、二行目はアイコン名、三行目はwww:url-encodeを使うためのinclude、四行目が実行です。
四行目を解説すると、一つ目の引数(param(0))をURLエンコード(www:url-encode)し、それをhttp://以下と結合(cat)、
その結合したものをシェル実行(Shell.Execute)してます。
アイコンはhttp://www.google.com/favicon.icoをIconフォルダにgoogle.icoにリネームして置きますが、
この作業を自動化するスクリプトを同梱してあります。
Giraffe+に
@download-google-icon
と入力してF1を押せば完了します。
アイコンの指定にはURLをそのまま置くことも可能ですので、
そうすれば、これらの作業は必要ありません。
設定と設定ダイアログについて
-
リストアップするもの(パスの表記は正規表現):
- Settings = (Script2|Script)/settings/(key|hotkey|setup)/.*\.giraffe$
- Config = doc/reference/config-list.csvの中身
- Color = Color.iniの中身
-
扱われるポイント:
- Settings = Script/settings.giraffe
- Config = Script/Default.giraffeのLoadConfigとSaveConfig
- Color = Script/Default.giraffeのChangeColor
-
保存されるファイル:
- Settings = Settings.ini
- Config = Giraffe.ini
- Color = Color.ini
-
スクリプトの実行の順番:
- 大文字小文字を区別しないアルファベット順で実行されます。
- それを考慮すれば部分的な再定義などが可能です。
-
Settings以下のメニューによるスクリプトの編集や追加や削除について:
- スクリプトオーバライディングを反映しますので、その認識がないと奇妙な動作に感じられます。
-
事例:
- Script2にあるものを削除すると、Scriptにあるものが見えるようになる。
- Scriptにあるものと同じ名前のスクリプトを作れる。
- これらの事例は双方とも、ダイアログの見た目上はPathのみが変化することになります。
- 新規作成は常にScript2になされます。
- Edit This ScriptはNotepadが起動しますが、変数$settings:editorに起動したいものを記述することが出来ます。
-
値の編集:
- ConfigやSettings/(key|hotkey)では、F2キーか選択中のクリックで可能です。
-
keyとhotkeyでは、利便性のため以下の入力をできないようにしています。
- すでに設定されてるキー
- キーとして解読不能な文字列
例(キーの文字列をmod-keyとして):
- mod部分にc,s,a,w,*,?,!以外の文字がある場合。
- key部分に内部的にキーコードに変換できない文字列がある場合。
- キーコードに変換できる文字列は内部的な定義になっており、ユーザ定義などは出来ません。
- キー名がよく分からないときは、キーコードを調べて直接その数値を記述してください。
- Configの値のベリファイなどは行ってません。
- ConfigのPresetのボタンを押すと大雑把にですが設定が簡単にできます。これはConfig以外の設定には影響しません。
サイト: http://www.ric.hi-ho.ne.jp/giraffe/
ブログ: http://d.hatena.ne.jp/ijuhs/
メール: shu@freemail.lt