Moai+Easter ユーザーマニュアル
Moai
Manual
Advanced Manual
ご案内
インストール
Easterの詳細
VirtualUSERSの詳細
Moaiアップグレードの詳細
仮想ブラウジング
コレクション
設定
BoxMapビューア
はじめに
この記事ではEasterのコア機能の一つである「Box」について説明します.
またそれを閲覧、操作するためのBoxMapビューアについても解説します.
尚、この記事の内容はエキスパート向けのもので、一般ユーザには必要ない内容となっています.
Easterコレクションについての知識も前提となるため、まずはそちらを一読しておくことをお勧めします.
目次
概要
Easterではコレクションやキャッシュが格納された特殊ディレクトリを特にBoxと呼びます.
またBoxMapビューアではBoxの中身をファイルシステム上の実ディレクトリレベルで直接閲覧したり管理を行うことができます.
EasterのBoxをファイルシステム上の実ディレクトリに対応付ける操作を「Boxを実ディレクトリにマッピングする」と呼びます.
(UNIXシステムなどにおけるマウントと形式的には似た概念です).
BoxMapビューアという名前の由来はここから来ています.
このBoxは「コレクション」の画面では「お気に入りボックス」と表記されています.
お気に入り登録されたされたファイルの実体はこのBoxに格納されています.
ここに格納された画像などは(特にユーザがそれを明示的に削除などしない限り)永続保存されます.
これは問題等発生した場合のメンテナンス用のためのものであり、通常はここからファイルを閲覧する必要はありません.
「コレクション」画面にある「お気に入りボックス」より閲覧するのがほとんどの場合望ましいです.
デフォルトではmoai_profile/favoriteディレクトリが実体となりますが、環境変数EST_FAVORITE_DIRを指定することにより、その実ディレクトリをユーザが自由に変更することもできます.
(環境変数による変更を反映させるにはmoai本体を一度終了させ、再び起動させる必要があります)
このBoxは「コレクション」の画面では「ストックボックス」と表記されています.
ストックされたファイルの実体はこのBoxに格納されています.
ここに格納された画像などは(特にユーザがそれを明示的に削除などしない限り)永続保存されます.
これは問題等発生した場合のメンテナンス用のためのものであり、通常はここからファイルを閲覧する必要はありません.
「コレクション」画面にある「ストックボックス」より閲覧するのがほとんどの場合望ましいです.
デフォルトではmoai_profile/stockboxディレクトリが実体となりますが、環境変数EST_STOCKBOX_DIRを指定することにより、その実ディレクトリをユーザが自由に変更することもできます.
(環境変数による変更を反映させるにはmoai本体を一度終了させ、再び起動させる必要があります)
favoriteとそっくりですが、実のところ実装としての内部構造はどちらもほぼ同じものです.
一応favoriteは本分類した画像の格納用を想定したものに対し、stockboxは仮分類した画像の格納用を想定したものとなります.
stockboxに分類された画像をfavoriteへ分類するといったことができますが、Easterの内部実装ではこれをfavoritizeと呼びます.
また逆に favoriteに分類された画像を stockboxへ分類することもできますが、Easterの内部実装ではこれをstockと呼びます.
Easterが管理するキャッシュはEasterキャッシュと呼ばれます.
EasterキャッシュもまたBox構造で管理されており、このBoxが該当します.
(この中身は、古いものより定期的にEasterのゴミ箱へ移されます).
Moaiディレクトリ直下のcgis/easter/cacheboxディレクトリが実体となります.
(現バージョンではこの位置を変更することはできません).
これは問題等発生した場合のメンテナンス用のためのものであり、通常はここからファイルを閲覧する必要はありません.
Easterのゴミ箱もまたBox構造で管理されており、このBoxが該当します.
(この中身は、古いものより定期的に本当に削除されます).
Moaiディレクトリ直下のcgis/easter/dustboxディレクトリが実体となります.
(現バージョンではこの位置を変更することはできません).
これは問題等発生した場合のメンテナンス用のためのものであり、通常はここからファイルを閲覧する必要はありません.
このBoxはユーザが自由な用途で使用できます(ユーザボックスと呼びます).
例えばEasterとは無関係なローカルなディレクトリにあなたがこれまでに集めた画像が大量に格納されているとします.
これをディレクトリごとuserboxディレクトリ配下へ移動して、その画像をEasterの画像ビューアで閲覧したり、favoriteやstockboxに分類するというのが典型的な使い方になるでしょう(詳しくは後述します).
デフォルトではmoai_profile/userboxディレクトリが実体となりますが、環境変数EST_USERBOX_DIRを指定することにより、その実ディレクトリをユーザが自由に変更することもできます.
(環境変数による変更を反映させるにはmoai本体を一度終了させ、再び起動させる必要があります)
目次に戻る
BoxMapビューアから既存のフォルダの内容を閲覧する
ここではユーザボックスの典型的な使い方の例を挙げましょう.
また以下ではWindows環境で説明しますが、Linuxなどの環境でも同様な処理が可能です.
既に述べましたが、ユーザボックスの実体はデフォルトではmoai_profile/userboxディレクトリとなります.
最初の状態ではこのuserboxディレクトリは空になっていると思います.
従って、BoxMapビューアからuserboxを選ぶとおそらく以下のように何もない状態として表示されるでしょう.
例えば今、WindowsのExplore上に「未分類」という名前のフォルダがあり、その中にあなたが今までダウンロードした画像などのファイルが格納されているとしましょう.
フォルダの名前から分かるとおり、この中のファイルは分類されておらずグチャグチャな状態になっているものとします.
つまり今回の説明の目的は、まずはこれをEasterコレクション管理下に置いて閲覧できる状態にし、次にタグなどを使って綺麗に分類することです.
しかしこのままではこの「未分類」フォルダをEasterからは見ることはできません.
Easterからユーザボックスとして見えるのはmoai_profile\userbox配下に存在するものだけだからです.
では、WindowsのExplore上から一旦この「未分類」というフォルダをmoai_profile\userboxフォルダ配下へ移動しましょう.
以下のようになるでしょう.
筆者の環境ではC:\znk_projectというフォルダがまずトップにあり、更にその中にmoai_profileフォルダやmoai本体のフォルダなどを置いています.
さて、この状態で再びEasterのBoxMapビューアに戻りましょう.
「userbox」とある部分を押すと、userbox内の最新の状態に表示が更新されます.
今度は以下のようにBoxMapビューア上に「未分類」フォルダが表示されると思います.
ではこれを開いてみます.
「フォルダ一覧」の中にある「未分類」を押し、このフォルダを開きましょう.
以下のように「未分類」フォルダの中身をBoxMapビューア上から表示することができます.
この画面では、「未分類」フォルダ内に存在するサブフォルダとファイルの一覧が表示されています.
また一番下方にあるのはEasterコレクションへの分類に関するボタンです.
分類についての説明は次のセクションで後回しするとして、とりあえず今回は閲覧に関するものだけ以下に挙げておきましょう.
目次に戻る
BoxMapビューアからEasterコレクションへ分類する
このセクションは前セクションの続きです.
「未分類」フォルダ内に存在するファイルをEasterコレクションへ分類する方法について詳しく述べます.
フォルダ一覧やファイル一覧のそれぞれの要素には、よく見るとすべてチェックボタンがついています.
BoxMapビューアでは、これらの要素のうちチェックをつけたものに関して分類処理を行うことができます.
この操作はBoxMapビューア下方にあるボタンで行います.
「全部にCheckを入れる」ボタンや「全部のCheckを外す」ボタンは、今現在表示されているページ内のファイルに関してこれらすべてにチェックを入れたり外したりするための便利ボタンです.
(フォルダは対象外です).
「Check項目の一括削除」ボタンは、チェックを入れた不要な要素を一括で削除します.
実際の様子を以下で見てみましょう. do_not_eat.pngとkeshikaran.pngという二つのファイルを一度に一括削除してみたいと思います.
まずこれらにチェックを入れます.
「Check項目の一括削除」ボタンを押すと以下のように「削除の確認」画面が表示されます.
この状態ではまだ実際には削除されていません.
削除しようとしているものに間違いがなければ、「はい、実際に削除します」を選びましょう.
やっぱりやめたい場合は「いいえ、何もせずに戻ります」を選びましょう. (あるいは何もせず、「削除の確認」画面をブラウザのタブごと閉じてもかまいません).
この「削除の確認」画面から削除項目の修正を行うこともできます.
例えば、やっぱり do_not_eat.png だけは残しておきたいと思ったなら、以下のようにこれのチェックを外しておけばよいです.
ではこれで実際に削除してみます. 削除に成功すると以下のように表示されます.
「戻る」ボタンを押すと元の「未分類」フォルダの中身の表示に戻ります.
今削除したファイルは結局keshikaran.pngだけとなりましたが、これがもう表示されていないことがわかります.
参考:「削除」されたファイルについて
ところで「削除」とは言いましたが、正確に言えば上記の操作で本当にファイルシステム上から削除されているわけではなく、
指定ファイルがEasterのゴミ箱(moaiディレクトリ直下にあるcgis/easter/dustbox)へ移動されただけです.
従って万一誤って「削除」してしまっても、その直後ならEasterのゴミ箱を開けばその中にそのファイルはまだ残っており、そこからサルベージすることもできます.
Easterシステムでは１日に一回のペースでcache_task.cgiというプロセスをバックグラウンドで自動的に起動させます.
(といっても勝手に起動するわけではなく、その日初めてEasterを起動させたタイミングで子プロセスを起動させる方式をとっています)
Easter周りの定期的なメンテナンスも行いますが、Easterのゴミ箱はこのときに掃除されます.
そしてこのとき初めてファイルシステム上から本当に削除されます.
(ただしすべて削除されるわけではなく、初期設定では最終更新日が５日前より古いものが削除されます).
この操作も上述した「削除」の方法とほぼ同様に行えます.
つまりまずは、あらかじめ分類したいファイルにチェックを入れておき、それらについて一括でストックあるいはお気に入り登録するということです.
(「削除」のときとは異なり、確認画面は出ません ).
ここでの「分類」の意味はEaster Image Viewerでの画像の分類とほぼ同じです.
Easter Image Viewerとの違いはチェックを入れたファイルを一括して分類することができるという点です.
次にこれらのボタンの下方に「タグ一覧」がありますから、そこから付加したいタグをチェックします.
これは今から分類されるファイルすべてに共通してこのタグが付加されることを意味します.
最後に「Check項目を一括でストック」または「Check項目を一括でお気に入りへ」ボタンを押すと、それぞれ「ストックボックス」または「お気に入りボックス」へのタグ付け分類が完了します.
分類したファイルの実体はこの「userbox/未分類」フォルダからmoai_profile/stockboxまたはmoai_profile/favoriteフォルダへ移動されます.
またファイル名もデータ内容のMD5をとったものに替わりますので注意してください.
（ファイルの拡張子についてははそのままです)
参考:「分類」されたファイルについて
favoriteへ分類されたファイルはmoai_profile/favoriteへ移動されますが、さらにその下は以下のような形式になってその実体が保存されています.
また付加されたタグ情報やコメントについては以下のファイルにその実体が記録されてあります.
拡張子/MD5の最初の2文字/info_list.myf
stockboxについても同様です.
これらは「コレクション」の画面から「ストックボックス」または「お気に入りボックス」を押すと閲覧できます.
これらを再閲覧する方法については
こちらを参照してください.
BoxMapビューアでキャッシュの内容を直接閲覧する
通常必要ないことではありますが、EasterのキャッシュファイルはBoxMapビューアで直接閲覧することもできます.
システムの内部構造を探索するのが好きなあなたのために、ここではその方法について極簡単にヒントを示しておきましょう.
画像掲示板ふたばちゃんねるを例とします.
- まずBoxMapビューアより「cachebox」を開きます.
Easterでふたばちゃんねるを閲覧したことがあるならば、「フォルダ一覧」に「futaba」という名前のフォルダが存在するはずです.
- 「futaba」フォルダを開きますと、「フォルダ一覧」にホスト名が付けられたフォルダが表示されるかと思います.
例えば「may.2chan.net」や「www.2chan.net」といったようなフォルダになります.
ここでは「may.2chan.net」フォルダを開いてみます.
- 「may.2chan.net」フォルダには、過去にmay.2chan.netで閲覧したキャッシュが保存されています.
「フォルダ一覧」には「b」や「bin」といったようなフォルダが表示されていると思います.
これ以降、フォルダの階層は掲示板(今回の場合ふたばちゃんねる)のURLの構造をそのまま反映したものになっています.
may.2chan.netの場合「b」には画像やスレッドの本体(HTML)などが格納されているようです.
また「bin」にはjavascriptやcssなどのファイルが格納されているようです.
(Easterではjavascriptはキャッシュ対象外のファイルタイプであるため保存されません)
ここでは「b」フォルダを開いてみます.
- 「b」フォルダを開きますと、「フォルダ一覧」に「res」や「src」といったフォルダが表示されるかと思います.
「res」にはスレッド本体(HTML)がキャッシュとして保存されています.
また「src」には、Easter Image Viewerで今まで開いたことのある画像(画像本体でサムネイルではない)がキャッシュとして保存されています.
目次に戻る
This article was written by:
