postmail.vim : メール送信用vimエディタプラグイン

プラグインの構成

このプラグインは次のファイルから構成されます。

このメール送信プラグインは「postmail.conf」から設定を読み込んで、
メールサーバに接続、メールを送信する仕組みになっています。

動作環境

このプラグインを利用するには、動作環境が次の条件を満たす必要があります。

• 'compatible'オプションがセットされていない、
• '+python', '+iconv', '+multi_byte'オプション付きでコンパイルされたVimエディタを使用している
• Pythonが適切にインストール、使用できる状態にある

ダウンロード、解凍

まず、 プラグイン をダウンロードし、
次に、 ダウンロードした圧縮ファイルを解凍してください。

runtimepathディレクトリにコピーする

'postmail.zip' を解凍後、生成されたファイルを'runtimepath'ディレクトリの'plugin'、'doc'ディレクトリにコピーします。
'runtimepath'ディレクトリがどういうものか分からない場合は、
Windows環境なら「$HOME/vimfiles」ディレクトリを、
Mac OSX環境では「$HOME/.vim」ディレクトリを使用してください。

':helptags'コマンドを実行する

':helptags'コマンドを'postmail.vim'をインストールした'doc'ディレクトリに実行してください。

" Windows環境の場合のコマンド例
:helptags $HOME/vimfiles/doc

" Mac OSX環境の場合のコマンド例
:helptags $HOME/.vim/doc

メール送信設定ファイル「postmail.conf」を編集する。

「postmail.conf」設定ファイルを編集します。 「postmail.conf」には、いくつかのメール送信用の設定例が書かれているので、 余分な設定をコメントアウトしてから、 自分の環境にあわせて設定を変更するとプラグインを利用できるようになります。
設定の詳細については、 'postmail.conf'の設定方法 を見てください。

" vimエディタのencodingの値を確認する
:echo &encoding

':Mail'コマンドのフォーマット

:[range]Mail

メールを送信します。範囲を指定すると選択した範囲のテキストを、 範囲を指定しないとカレントバッファ全文を送信します。

:[range]Mail {to_mailaddress}

{to_mailaddress}にメールを送信します。 範囲を指定すると選択した範囲のテキストを、範囲を指定しないとカレントバッファ全文を送信します。

:[range]Mail {to_mailaddress1} {to_mailaddress2}, {to_mailaddress3}

{to_mailaddress1}、{to_mailaddress2}、{to_mailaddress3}の3メールアドレスにメールを送信します。 送信先はいくらでも指定できます。 範囲を指定すると選択した範囲のテキストを、範囲を指定しないとカレントバッファ全文を送信します。

':Mail'コマンドの使い方の例

:Mail

メールを送信します。 送信されるメッセージはカレントバッファ全文です。

:Mail mail@nanasi.jp

カレントバッファ全文を'mail@nanasi.jp'に送信します。

:6,20Mail mail@nanasi.jp

6行目から20行目の範囲のテキストを'mail@nanasi.jp'に送信します。

GMailをメール送信サーバにする場合

元からある設定「basic configuration」を削除後、 「gmail configuration」の箇所のコメントを削除して有効にしてください。

" GMailを利用する場合のサンプル設定ファイル。
{
    'auth_type':          'TLS'                     ,
    'smtp_host':          'smtp.gmail.com'          ,
    'smtp_port':          '587'                     ,
    'login_user':         'please_change@gmail.com' ,
    'login_pass':         'xxxxxxxxxxxx'            ,
    'mail_encoding':      'ISO-2022-JP'             ,
    'from_address':       'user@example.jp'         ,
    'default_to_address': 'user@example.jp'         ,
    'default_subject':    'default subject'
}

Outbound Port25 Blockingのメールサーバでメールを送信する場合

Outbound Port25 Blockingを採用しているメールサーバからメールを送信する場合は、 「outbound port 25 blocking configuration」の項の設定例を参考にしてみてください。

" Outbound Port25 Blocking
{
    'auth_type':          'None'                    ,
    'smtp_host':          'smtp.example.jp'         ,
    'smtp_port':          '587'                     ,
    'login_user':         'please_change@gmail.com' ,
    'login_pass':         'xxxxxxxxxxxx'            ,
    'mail_encoding':      'ISO-2022-JP'             ,
    'from_address':       'user@example.jp'         ,
    'default_to_address': 'user@example.jp'         ,
    'default_subject':    'default subject'
}

POP Before SMTP認証のメールサーバでメールを送信する場合

POP Before SMTP認証を採用しているメールサーバなら、次のように設定します。 認証方式の都合上、POP Before SMTP認証でメールを送信する場合、設定項目がいくつか必要になります。

" POP Before SMTP認証
{
    'auth_type':          'POP'                     ,
    'pop_host':           'pop.example.jp'          ,
    'pop_port':           '110'                     ,
    'pop_user':           'user@example.jp'         ,
    'pop_pass':           'xxxxxxxxxxxx'            ,
    'smtp_host':          'smtp.example.jp'         ,
    'smtp_port':          '25'                      ,
    'login_user':         'please_change@gmail.com' ,
    'login_pass':         'xxxxxxxxxxxx'            ,
    'mail_encoding':      'ISO-2022-JP'             ,
    'from_address':       'user@example.jp'         ,
    'default_to_address': 'user@example.jp'         ,
    'default_subject':    'default subject'
}

Vimエディタのバージョン。

Vimエディタのバージョンが7以降でないと動作しません。
次のコマンドを実行して、Vimエディタのバージョンを調べてください。

:version

'compatible' オプション。

'compatible' オプションがonだと動作しません。
次のコマンドを実行して、Vimエディタのオプションを調べてください。
0が返ってくれば、OKです。

:echo &compatible

Vimエディタのコンパイルオプション。

'+python'、'+iconv'、'+multi_byte'付きでコンパイルされたVimエディタを使用していますか？
次のコマンドを実行して、Vimエディタのコンパイルオプションを調べてください。
'+python'、'+iconv'、'+multi_byte'が見つかればOKです。

:version

もしくは、次のコマンドを実行し、全てのコマンドの結果が1になればOKです。

:echo has("python")
:echo has("iconv")
:echo has("multi_byte")

Python環境。

Pythonがインストールされて、かつ、使用できるようにPATHがセットされていますか？
次のコマンドを実行して、Pythonの状態を確認してください。
'python is installed.'と、返ってくればOKです。

:python print "python is installed."

Pythonのバージョン。

環境がMS-Windowsで、Vimエディタが'+python/dyn'付きでコンパイルされている場合は、
Pythonのバージョンをコンパイル時と揃える必要があります。
次のコマンドを実行して、Pythonのバージョンが揃っているか、確認してください。

" Vimエディタで使用できるPythonのバージョンを確認
:help python-dynamic@en

" Pythonの実行環境のバージョンを確認
:!python --version

postmail.conf。

'postmail.conf'設定ファイルは適切に設定されていますか？
もし、まだなら、'postmail.conf'ファイルを編集してください。
'postmail.conf'ファイルのテンプレートファイルは、pluginディレクトリに入っています。

SMTPサーバの認証の種類。

メール送信サーバの認証は、プラグインでサポートされているタイプですか？
postmail.vimは、'POP Before SMTP認証'と'TLS認証'しかサポートしていません。

ネットワーク。

ネットワークの環境を確認してください。
別のメーラーを使用してメールを送信できますか？