Movable Type:: Emacs フロントエンド「mapae」

ミニバッファでアップロードするファイルと， リモートでのファイル名を指定します．リモートでのファイル名は Blog があるディレクトリからの 相対パスで指定します．ディレクトリのみを指定した場合は，アップロードファイルのファイル名が補完されます．アップロードに成功すると，キルリングにアップロードしたファイルを 参照する URL が入ります．

また，Image::Magick モジュールがインストールされており，かつアップロードされたファイルが画像ファイルであれば，サムネイルを作成するかどうかを聞いてきます．サムネイルのサイズは，後述の設定による上限値を元に決定されますが，手動で決めることも可能です．サイズは，「幅x高さ」で指定します．幅，高さのいずれかを自動決定させたい場合は，「幅x」または「x高さ」と指定します．

さらに，以下の条件が全て満たされる場合，画質調整のウィンドウが開き，サムネイルの画質調整を行うことができます．

• Tk モジュールがインストールされている
• 画像形式が，JPEG または PNG である
• mapae-use-tk が真である
• Emacs(または Meadow)がターミナルで動作していない

mapae では，2通りのプレビュー方法が用意されています．一つは「(完全な)プレビュー」，そしてもう一つは「簡易プレビュー」です．どちらのプレビューが用いられるかは，XML-RPC サーバの URL によって決まります．即ち，ココログの XML-RPC サーバの場合は「簡易プレビュー」，それ以外であれば「(完全な)プレビュー」が用いられます ^*11．また，コマンドの先頭に C-u を入力することにより，この選択を一時的に反転することができます．

以下に，二つのプレビューの違いを説明します．

4.3.1. プレビュー

4.3.2. 簡易プレビュー

$RPCSERVER

mt-xmlrpc.cgi の url．

$RPCTIMEOUT

XMLRPC のタイムアウト秒数．(defult:40)

$RPCPROXY

$RPCSERVERにアクセスするために必要なプロキシ．

$BLOGID

対象とする Blog ID. (default:1)

$USERNAME

Movable Type のユーザ名

$PASSWORD

Movable Type のパスワード

$VAR_DIR

キャッシュデータ等を保存するディレクトリ．絶対パスか，mapae.pl からの相対パスで指定．現在のところ，はてなダイアリーキーワードのキャッシュ保存にのみ使用．(default: var)

%CHARSET

mapae 各部で用いる文字コード．通常は変更する必要はありません．

rpc

XML-RPC サーバとの通信に用いる文字コード

perl

perl 内部で扱う文字コード

emacs

Emacs(Meadow,xyzzy)との通信に用いる文字コード

default:

%CHARSET = ( 'emacs' => 'euc-jp', );

例(Emacs での文字コードを shift-jis にする場合):

$CHARSET{emacs} = 'shift-jis';

$ELEMENTSEPARATOR

各要素を区切るセパレータ．mapae.el の mapae-separator と同じ値でなければなりません．(default:-----)

@ELEMENTLABEL

XMLRPC で用いる要素名と表示する要素名とのマッピングを配列で指定します．編集モードで各要素が表示される順序は，ここで指定した順となります．

label

XMLRPC で用いる要素名

type

データの型

necessary

真のであれば，データがない場合は空文字列があるものとして扱われます．現在のところ，type が「string」である要素以外での動作は未定義です．

check

真であれば，整形式チェックの対象になります．

hatena

真であれば，はてなダイアリーキーワード変換の対象になります．

default:

( POST_ID     => { label=>'postid', type=>'int' },
  TIMESTAMP   => { label=>'dateCreated', type=>'string',
                   necessary=>1 },
  TITLE       => { label=>'title', type=>'string',
                   necessary=>1 },
  DESCRIPTION => { label=>'description', type=>'string',
                   necessary=>1, check=>1, hatena=>1 },
  EXTENDED    => { label=>'mt_text_more', type=>'string',
                   necessary=>1, check=>1, hatena=>1 },
  EXCERPT     => { label=>'mt_excerpt', type=>'string',
                   necessary=>1 },
  TRACKBACK   => { label=>'mt_tb_ping_urls', type=>'array'} )

$USE_GETRECENTPOSTS

真の場合，mt.getRecentPostTitles の代わりに metaWeblog.getrecentPosts を使います．

$BLOGNAME

Blog の名前．

$BLOGURL

Blog の URL

@PINGURL

Ping を送信する URL の配列．

例:

@PINGURL
  = ( 'http://www.blogpeople.net/servlet/weblogUpdates',
      'http://ping.myblog.jp/' );

$HTTP_PROXY

更新 Ping を送信する際にプロキシを経由する必要がある場合，ここに指定します．通常は $RPCPROXY と同じなので，

$HTTP_PROXY = $RPCPROXY;

と指定することになるでしょう．

$HTTP_TIMEOUT

更新 Ping を送信する際のタイムアウト秒数を指定します．

%DISCOVER_TB

Trackback URL を取得する条件 ^*13を指定します．これを指定しない場合は，Trackback URLの取得を行いません．以下の例では，スペースで始る指定に対し Trackback URL の取得を行い，取得の際には，そのスペースを除去します．

例:

%DISCOVER_TB
  = ( pattern=>'^ ', remove=>1 );

その他

Trackback URL を取得する際のプロキシ， タイムアウトは前述の$HTTP_PROXY，$HTTP_TIMEOUTに従います．

$THUMBNAIL_POST_PROCESS

サムネイル作成時，サイズ変更に加え別の処理を行いたい場合は，その処理をする関数のリファレンスを指定します．ここで指定された関数には，サイズの変更直後の Image::Magick オブジェクトが渡されます．

$NEW_MEDIA_OBJECT_URL_FILTER

ファイルをアップロードしたときにキルリングに格納される URL のフィルタ関数へのリファレンスを指定します．フィルタ関数の戻り値は，文字列でなければなりません．フィルタ関数へは，以下の値がハッシュで渡されます．「ref_」で始る値以外は，直前に処理されたファイルに関する値であり，例えば，サムネイルアップロード時の「width」は，サムネイルの幅を指します．この関数は，画像がアップロードされる度に呼び出されます．つまり，ある画像とそのサムネイルをアップロードした場合，その両方で呼び出されるので注意してください．アップロードされたファイルがサムネイルであるかどうかは，「ref_」で始る値を見れば分かります．

url

アップロードされたファイルにアクセスできる URL．

filesize

アップロードされたファイルのファイルサイズ．(バイト)

ref_url

サムネイルがアップロードされた場合，元画像の URL．

ref_filesize

サムネイルがアップロードされた場合，元画像のファイルサイズ．(バイト)

magick

アップロードされたファイルが画像の場合は，画像の形式．(Image::Magick による値)

width

アップロードされたファイルが画像の場合は，画像の幅．(Image::Magick による値)

height

アップロードされたファイルが画像の場合は，画像の高さ．(Image::Magick による値)

なお，Movable Type から返ってきた URL をそのまま使う場合は，この変数を指定する必要はありません．

$PREVIEW_TEMPLATE

プレビュー用テンプレートの名前

また，必要に応じて，以下の変数を指定してください．

$PREVIEW_URL_FILTER

プレビュー URL を変換する無名関数を指定します．

$PREVIEW_URL_FILTER =
  sub {
    my $url = shift;
    $url =~ s!^http://nyam.info/!http://localhost/!;
    return $url;
  };

%PREVIEW_DUMMY_ID

プレビュー作成時に用いる仮のエントリ ID．あくまで仮なので，既に登録されているエントリ ID でも，上書きされることはないはずですが，利用しているプラグイン等によっては上書きされることがあるかもしれません．

id

仮のエントリ ID

must

真の場合は，常に上記のエントリ ID を用います．偽の場合は，まだ登録されていない新規投稿の場合のみ上記のエントリ ID を用い，既に一度登録されているエントリを編集している場合は，そのエントリ ID が用いられます．

default:

( id=>1, must=>0 )

$LOCAL_PREVIEW

真であれば，簡易プレビューが優先されます．ただし，$RPCSERVER がココログのサーバをさしている場合は，本変数が真でなくても簡易プレビューが優先されます．

$LOCAL_PREVIEW_TEMPLATE

簡易プレビューで用いるテンプレートファイル名．mapae.pl からの相対パス，または絶対パスで指定．(default: preview_template.html)

$LOCAL_PREVIEW_FILE

簡易プレビューを出力するファイル名．mapae.pl からの相対パス，または絶対パスで指定．(default: tmp/preview.html)

$LOCAL_PREVIEW_CONVERT_BRAKES

真であれば，簡易プレビューを作成する際に改行が <br /> タグに置換されます． ^*14

%REBUILD_UNIT

一度に再構築を行う単位．デフォルトの設定では，エントリ: 40 エントリ毎，日別: 40日毎，週別: 4週毎，月別: 1月毎，カテゴリ別: 1カテゴリ毎に再構築が行われます．
default:

( Individual => 40,
  Dairy      => 40,
  Weekly     =>  4,
  Monthly    =>  1,
  Category   =>  1 )

$HATENA_CLASS

アンカーで使用するクラス．(default: hatena)

$HATENA_EXPIRE

キーワードキャッシュファイルの有効期限．(秒) (default: 86400)

@HATENA_IGNORE_TAG

キーワード変換から除外したい要素名の配列．(default: ('a'))
例:

@HATENA_IGNORE_TAG = qw(a code var script);

除外する要素(タグ)は，「(@HATENA_IGNORE_TAGで指定された)要素+単語境界」で判定されるので，次のような指定も出来ます．
例:

@HATENA_IGNORE_TAG = ('a', 'span class="nohatena');

この場合，終了タグの判定では，要素内の最初の単語境界以降は無視されます ^*15．

なお，ここに空要素の要素名を指定したり，エントリ内での入れ子関係が正しくない場合の動作は保証しません．

複数の Blog を扱う場合，設定セットにより操作対象の Blog を変更することができます．使用する設定セットは，「M-x mapae-blogset」で切り替えることが出来ます．ここで指定した文字列が mapae.ph に引渡されます．デフォルトは「1」 ^*16です．

引渡された文字列は，mapae.ph を処理する際に，変数 $BLOGSET に格納されています．これを用いて使用する設定を切り替えることが出来るわけです．

複数の設定セットを利用する場合の mapae.ph は，一般的には次のようになるでしょう．

## mapae.ph 設定例

全セットに共通する設定

if ( $BLOGSET eq '1' ) {
  設定セット「1」の設定
} elsif ( $BLOGSET eq 'hoge' ) {
  設定セット「2」の設定
} else {
  fault("設定セット「$BLOGSET」は定義されていません．");
}

1;

なお，定義されていない設定セットで呼び出された場合は，この例のように fault 関数を呼び出すことにより，エラーを Emacs 側に通知して，処理を中断させることができます．

mapae-perl-command

mapae.pl を実行するための perl コマンドを絶対パスで指定します．(default: /usr/bin/perl)

mapae-command

mapae.pl を絶対パスで指定します．

mapae-blogset

設定セットの初期値．(default: "1")

mapae-default-process-coding-system

mapae.pl との通信に用いる文字コード．$CHARSET{emacs} が指す文字コードとそろえる必要があります．

mapae-separator

各要素のセパレータを指定します．mapae.pl の $ELEMENTSEPARATOR と同じ値でなければなりません． (default:-----)

mapae-postid-tag

エントリID を示す要素名を指定します．(default:POST_ID)

mapae-favorite-mode

編集モードで基本とする既存のモードを指定します． (default:text-mode)

例:

(setq mapae-favorite-mode 'html-helper-mode)

mapae-local-data-dir

アップロードファイルのローカルデフォルトディレクトリ

mapae-remote-data-dir

アップロードファイルのリモートデフォルトディレクトリ

設定セット別に指定する場合は，設定セット名をキーとするコンスセルのリストを指定してください．
例:

(setq mapae-remote-data-dir '(("3" . "old/images/")
                              (t . "archives/data/")))

なお，設定セット名でマッチする設定がなかった場合は，この例のようにキーが t で指定されたディレクトリが用いられます．

mapae-thumbnail-suffix

サムネイルを生成するときファイル名に付ける接尾辞．ここで指定された文字列が，拡張子の前に挿入されます．(default: _tn)

mapae-thumbnail-max-width

サムネイルの最大幅．ここで指定された値を元にサイズが決められますが，実行時にその値を変更することは可能です．(default: 200)

mapae-thumbnail-max-height

サムネイルの最大の高さ．ここで指定された値を元にサイズが決められますが，実行時にその値を変更することは可能です．(default: 300)

mapae-use-tk

画像のアップロード時 Tk による画質調整を行わない場合は，nil を指定します．(default: t)

mapae-mode-map

編集モードのキーマップ

mapae-mode-hook

編集モード起動時のフック

mapae-hatena-keyword-hide

真の場合，はてなダイアリキーワードにリンクされた部分は下線で表示され，タグ部分は隠されます．(default: nil)

mapae-category-mode-map

カテゴリモードのキーマップ

mapae-recent-post-count

タイトル一覧で取得するデフォルトのエントリ数 (default: 15 )

mapae-title-list-mode-map

タイトル一覧モードのキーマップ

mapae-browser-command

プレビュー等に用いるブラウザの起動コマンド．文字列であれば，外部のウェブブラウザとして認識され，Emacs の関数シンボルであれば Emacs 内で動くウェブブラウザとして認識されます．

mapae-browser-option

ブラウザを起動する際に用いる引数のリスト．実行時に文字列 "<URL>" が表示する URL に置換されます．mapae-browser-command で外部のウェブブラウザがしていされている場合は，全要素が文字列でなければなりません．
default: (UNIX系OS における，Mozilla/Firebird での設定です)

("-remote" "openurl(<URL>)")

例: (Windows における，Mozilla/Firebird の場合)

(setq mapae-browser-option '("<URL>"))