sisimai 4.20.1 → 4.20.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 70437a1cc3c7c27e7145fe5596271abee0a41cb2
-  data.tar.gz: 41e3102528283f6c5e8e88d1f225120525cb72ed
+  metadata.gz: 1ae65a92e8ce97f94a3a2e9d49afac7daf4dd616
+  data.tar.gz: ac6fb8541ef2fcdfb931fb144ff6fcb6eab19774
 SHA512:
-  metadata.gz: 6704f85c5e8191df829fe1d3559195febfa3c02395cf225ae359d3ade99fb6f930498e360c4d86c620b72ff9f858b669d3fc4d16345c8ac82fe1859750b1c891
-  data.tar.gz: 317e9d5c37602a583d2d05d87d355d93cdcd12f05bd949e105543705ee29354694b1146c61a871799525f70c90a208e81268f1d7570e6889d0fa205592f4c0b7
+  metadata.gz: 2ccd7a6266707802d83a0ad80c9e76e27660a93210c20620a0b9f641b9d5d0e2bc72560f1934b89c641e0ba9b1ab081eaa101d8289966a46db9da100d63b692f
+  data.tar.gz: bec6463ca315a9eae480c1302f1d7227c4dc8c389e911a65f2634c4cf1f7de5efd6ae8df94557d192714fb60eb9c303f5e7ece6519d7b8e42a7cfc981eb81e39

data/.rubocop.yml

@@ -73,8 +73,12 @@ Style/EmptyLineBetweenDefs:
     - 'lib/sisimai/msp.rb'
     - 'lib/sisimai/mta/*'
     - 'lib/sisimai/msp/*/*'
-    - 'lib/sisimai/rfc3463.rb'
+    - 'lib/sisimai/ced/*.rb'
+    - 'lib/sisimai/reason/*.rb'
+    - 'lib/sisimai/rfc3464.rb'
     - 'lib/sisimai/rfc3834.rb'
+    - 'lib/sisimai/order.rb'
+    - 'lib/sisimai/order/*.rb'
 
 # Cop supports --auto-correct.
 # Configuration parameters: EnforcedStyle, SupportedStyles.
@@ -157,6 +161,8 @@ Style/SingleLineMethods:
     - 'lib/sisimai/rfc3464.rb'
     - 'lib/sisimai/rfc3834.rb'
     - 'lib/sisimai/reason/*.rb'
+    - 'lib/sisimai/order.rb'
+    - 'lib/sisimai/order/*.rb'
 
 # Cop supports --auto-correct.
 Style/SpaceAfterComma:
@@ -170,7 +176,7 @@ Style/TrailingBlankLines:
 
 # Cop supports --auto-correct.
 # Configuration parameters: EnforcedStyleForMultiline, SupportedStyles.
-Style/TrailingComma:
+Style/TrailingCommaInLiteral:
   Enabled: false
   EnforcedStyleForMultiline: comma
 
@@ -183,3 +189,7 @@ Style/UnneededPercentQ:
   Exclude:
     - 'spec/*'
 
+Style/ZeroLengthPredicate:
+  Enabled: false
+
+

data/Changes

@@ -1,4 +1,14 @@
-Revision history for Ruby version of Sisimai
+Revision history for the Ruby version of Sisimai
+
+4.20.2  Sat, 11 Mar 2017 16:32:48 +0900 (JST)
+    - Pull-Request #63 Add some error message patterns from Amazon SES SMTP
+      endpoint.
+    - Fix regular expression in Sisimai::Message::Email.headers for resolving
+      a bug reported from @rdeavila at issue #65.
+    - Issue #67, Fix code in Sisimai.make method for reading bounce email data
+      from STDIN. Thanks to @marine_dayo.
+    - Callback feature improvement: import pull-request from sisimai/p5-Sisimai
+      https://github.com/sisimai/p5-Sisimai/pull/210.
 
 4.20.1  Sat, 31 Dec 2016 20:10:22 +0900 (JST)
     - Fix the Java version of Gem file.

data/README-JA.md

@@ -1,37 +1,70 @@
+![](http://libsisimai.org/static/images/logo/sisimai-x01.png)
+
 [![License](https://img.shields.io/badge/license-BSD%202--Clause-orange.svg)](https://github.com/sisimai/rb-Sisimai/blob/master/LICENSE)
 [![Coverage Status](https://img.shields.io/coveralls/sisimai/rb-Sisimai.svg)](https://coveralls.io/r/sisimai/rb-Sisimai)
 [![Build Status](https://travis-ci.org/sisimai/rb-Sisimai.svg?branch=master)](https://travis-ci.org/sisimai/rb-Sisimai) 
 [![Codacy Badge](https://api.codacy.com/project/badge/grade/38340177e6284a65be69c0c7c3dc2b58)](https://www.codacy.com/app/azumakuniyuki/rb-Sisimai)
-[![Ruby](https://img.shields.io/badge/ruby-v2.1.0--v2.3.0-red.svg)](https://www.ruby-lang.org/)
+[![Ruby](https://img.shields.io/badge/ruby-v2.1.0--v2.4.0-red.svg)](https://www.ruby-lang.org/)
 [![Gem Version](https://badge.fury.io/rb/sisimai.svg)](https://badge.fury.io/rb/sisimai)
 
-![](http://41.media.tumblr.com/45c8d33bea2f92da707f4bbe66251d6b/tumblr_nuf7bgeyH51uz9e9oo1_1280.png)
-
-シシマイ?
-=========
+- [**README(English)**](README.md)
+- [シシマイ? | What is Sisimai](#what-is-sisimai)
+    - [主な特徴的機能 | Key features](#key-features)
+    - [コマンドラインでのデモ | Command line demo](#command-line-demo)
+- [シシマイを使う準備 | Setting Up Sisimai](#setting-up-sisimai)
+    - [動作環境 | System requirements](#system-requirements)
+    - [インストール | Install](#install)
+        - [RubyGemsから | From RubyGems](#from-rubygems)
+        - [GitHubから | From GitHub](#from-github)
+- [使い方 | Usage](#usage)
+    - [基本的な使い方 | Basic usage](#basic-usage)
+    - [解析結果をJSONで得る | Convert to JSON](#convert-to-json)
+    - [バウンスオブジェクトを読む | Read bounce object](#read-bounce-object)
+    - [コールバック機能 | Callback feature](#callback-feature)
+    - [ワンライナー | One-Liner](#one-liner)
+    - [出力例 | Output example](#output-example)
+- [シシマイの仕様 | Sisimai Specification](#sisimai-specification)
+    - [Ruby版とPerl版の違い | Differences between Ruby version and Perl version](#differences-between-ruby-version-and-perl-version)
+    - [その他の仕様詳細 | Other specification of Sisimai](#other-specification-of-sisimai)
+- [Contributing](#contributing)
+    - [バグ報告 | Bug report](#bug-report)
+    - [解析できないメール | Emails could not be parsed](#emails-could-not-be-parsed)
+- [その他の情報 | Other Information](#other-information)
+    - [関連サイト | Related sites](#related-sites)
+    - [参考情報| See also](#see-also)
+- [作者 | Author](#author)
+- [著作権 | Copyright](#copyright)
+- [ライセンス | License](#license)
+
+What is Sisimai
+===============================================================================
 Sisimai(シシマイ)はRFC5322準拠のエラーメールを解析し、解析結果をデータ構造に
 変換するインターフェイスを提供するRubyライブラリです。
 [github.com/sisimai/p5-Sisimai](https://github.com/sisimai/p5-Sisimai/)
 で公開しているPerl版シシマイから移植しました。
 
-主な特徴的機能
---------------
+![](http://libsisimai.org/static/images/figure/sisimai-overview-1.png)
+
+Key features
+-------------------------------------------------------------------------------
 * __エラーメールをデータ構造に変換__
-  * Perlのデータ形式とJSONに対応
+  * Rubyのデータ形式(HashとArray)とJSON(String)に対応
 * __インストールも使用も簡単__
   * gem install
   * git clone & make
 * __高い解析精度__
-  * 解析精度はbounceHammerの二倍
+  * 解析精度はbounceHammerの2倍
   * 27種類のMTAに対応
   * 21種類の著名なMSPに対応
+  * 2種類の著名なメール配信クラウドに対応(JSON)
   * Feedback Loopにも対応
   * 27種類のエラー理由を検出
 
-シシマイを使う準備
-==================
-動作環境
---------
+Setting Up Sisimai
+===============================================================================
+
+System requirements
+-------------------------------------------------------------------------------
 Sisimaiの動作環境についての詳細は
 [Sisimai | シシマイを使ってみる](http://libsisimai.org/ja/start)をご覧ください。
 
@@ -41,16 +74,16 @@ Sisimaiの動作環境についての詳細は
 * Also works on [JRuby 9.0.4.0 or later](http://jruby.org)
   * [__JrJackson | A mostly native JRuby wrapper for the java jackson json processor jar__](https://rubygems.org/gems/jrjackson)
 
-インストール
-------------
+Install
+-------------------------------------------------------------------------------
 ### From RubyGems.org
 
 ```shell
-% sudo gem install sisimai
-Fetching: sisimai-4.16.0.gem (100%)
-Successfully installed sisimai-4.16.0
-Parsing documentation for sisimai-4.16.0
-Installing ri documentation for sisimai-4.16.0
+$ sudo gem install sisimai
+Fetching: sisimai-4.20.2.gem (100%)
+Successfully installed sisimai-4.20.2
+Parsing documentation for sisimai-4.20.2
+Installing ri documentation for sisimai-4.20.2
 Done installing documentation for sisimai after 6 seconds
 1 gem installed
 ```
@@ -58,10 +91,10 @@ Done installing documentation for sisimai after 6 seconds
 ### From GitHub
 
 ```shell
-% cd /usr/local/src
-% git clone https://github.com/sisimai/rb-Sisimai.git
-% cd ./rb-Sisimai
-% sudo make depend install-from-local
+$ cd /usr/local/src
+$ git clone https://github.com/sisimai/rb-Sisimai.git
+$ cd ./rb-Sisimai
+$ sudo make depend install-from-local
 gem install bundle rake rspec coveralls
 Successfully installed bundle-0.0.1
 Parsing documentation for bundle-0.0.1
@@ -77,14 +110,15 @@ Parsing documentation for coveralls-0.8.10
 Done installing documentation for coveralls after 0 seconds
 4 gems installed
 bundle exec rake install
-sisimai 4.14.2 built to pkg/sisimai-4.16.0.gem.
-sisimai (4.14.2) installed.
+sisimai 4.20.2 built to pkg/sisimai-4.20.2.gem.
+sisimai (4.20.2) installed.
 ```
 
-使い方
+Usage
 ======
-基本的な使い方
---------------
+
+Basic usage
+-------------------------------------------------------------------------------
 下記のようにSisimaiの`make()`メソッドをmboxかMaildirのPATHを引数にして実行すると
 解析結果が配列で返ってきます。
 
@@ -115,7 +149,14 @@ if v.is_a? Array
     puts e.dump('json')         # JSON formatted bounce data
   end
 end
+```
 
+Convert to JSON
+-------------------------------------------------------------------------------
+下記のようにSisimaiの`dump()`メソッドをmboxかMaildirのPATHを引数にして実行すると
+解析結果が文字列(JSON)で返ってきます。
+
+```ruby
 # Get JSON string from parsed mailbox or Maildir/
 puts Sisimai.dump('/path/to/mbox')  # or path to Maildir/
 
@@ -123,8 +164,8 @@ puts Sisimai.dump('/path/to/mbox')  # or path to Maildir/
 puts Sisimai.dump('/path/to/mbox', delivered: true)
 ```
 
-バウンスオブジェクト(JSON)を読む
---------------------------------
+Read bounce object
+-------------------------------------------------------------------------------
 メール配信クラウドからAPIで取得したバウンスオブジェクト(JSON)を読んで解析する
 場合は、次のようなコードを書いてください。この機能はSisimai v4.20.0で実装され
 ました。
@@ -145,27 +186,29 @@ end
 ```
 現時点ではAmazon SESとSendGridのみをサポートしています。
 
-
-コールバック機能
-----------------
-Sisimai 4.19.0から、`Sisimai.make()`と`Sisimai.dump()`にLamda(Procオブジェクト)
-を引数`hook`に指定できるようになりました。`hook`に指定したコードによって処理さ
-れた結果は`Sisimai::Data.catch`メソッドで得ることができます。
+Callback feature
+-------------------------------------------------------------------------------
+Sisimai 4.19.0から`Sisimai.make()`と`Sisimai.dump()`にLamda(Procオブジェクト)
+を引数`hook`に指定できるコールバック機能が実装されました。
+`hook`に指定したコードによって処理された結果は`Sisimai::Data.catch`
+メソッドで得ることができます。
 
 ```ruby
 #! /usr/bin/env ruby
 require 'sisimai'
 callbackto = lambda do |v|
-  r = { 'x-mailer' => '' }
+  r = { 'x-mailer' => '', 'queue-id' => '' }
 
-  if cv = v['message'].match(/^X-Mailer:\s*(.+)$/)
-    r['x-mailer'] = cv[1]
+  if cv = v['message'].match(/^X-Postfix-Queue-ID:\s*(.+)$/)
+    r['queue-id'] = cv[1]
   end
+  r['x-mailer'] = v['headers']['x-mailer'] || ''
   return r
 end
 
-data = Sisimai.make('/path/to/mbox', hook: callbackto)
-json = Sisimai.dump('/path/to/mbox', hook: callbackto)
+list = ['X-Mailer']
+data = Sisimai.make('/path/to/mbox', hook: callbackto, field: list)
+json = Sisimai.dump('/path/to/mbox', hook: callbackto, field: list)
 
 puts data[0].catch['x-mailer']      # Apple Mail (2.1283)
 ```
@@ -175,26 +218,28 @@ puts data[0].catch['x-mailer']      # Apple Mail (2.1283)
 をご覧ください。
 
 
-ワンライナーで
---------------
+One-Liner
+-------------------------------------------------------------------------------
 
 ```shell
-% ruby -rsisimai -e 'puts Sisimai.dump($*.shift)' /path/to/mbox
+$ ruby -rsisimai -e 'puts Sisimai.dump($*.shift)' /path/to/mbox
 ```
 
-解析結果の例(JSON)
-------------------
+Output example
+-------------------------------------------------------------------------------
+![](http://libsisimai.org/static/images/demo/sisimai-dump-02.gif)
+
 ```json
 [{"recipient": "kijitora@example.jp", "addresser": "shironeko@1jo.example.org", "feedbacktype": "", "action": "failed", "subject": "Nyaaaaan", "smtpcommand": "DATA", "diagnosticcode": "550 Unknown user kijitora@example.jp", "listid": "", "destination": "example.jp", "smtpagent": "Courier", "lhost": "1jo.example.org", "deliverystatus": "5.0.0", "timestamp": 1291954879, "messageid": "201012100421.oBA4LJFU042012@1jo.example.org", "diagnostictype": "SMTP", "timezoneoffset": "+0900", "reason": "filtered", "token": "ce999a4c869e3f5e4d8a77b2e310b23960fb32ab", "alias": "", "senderdomain": "1jo.example.org", "rhost": "mfsmax.example.jp"}, {"diagnostictype": "SMTP", "timezoneoffset": "+0900", "reason": "userunknown", "timestamp": 1381900535, "messageid": "E1C50F1B-1C83-4820-BC36-AC6FBFBE8568@example.org", "token": "9fe754876e9133aae5d20f0fd8dd7f05b4e9d9f0", "alias": "", "senderdomain": "example.org", "rhost": "mx.bouncehammer.jp", "action": "failed", "addresser": "kijitora@example.org", "recipient": "userunknown@bouncehammer.jp", "feedbacktype": "", "smtpcommand": "DATA", "subject": "バウンスメールのテスト(日本語)", "destination": "bouncehammer.jp", "listid": "", "diagnosticcode": "550 5.1.1 <userunknown@bouncehammer.jp>... User Unknown", "deliverystatus": "5.1.1", "lhost": "p0000-ipbfpfx00kyoto.kyoto.example.co.jp", "smtpagent": "Sendmail"}]
 ```
 
-シシマイの仕様
-==============
+Sisimai Specification
+===============================================================================
 
-Perl版Sisimaiとの違い
----------------------
+Differences between Ruby version and Perl version
+-------------------------------------------------------------------------------
 公開中のPerl版Sisimai(p5-Sisimai)とRuby版Sisimai(rb-Sisimai)は下記のような違いが
-あります。bounceHammer version 2.7.13p3とSisimai(シシマイ)の違いについては
+あります。bounceHammer 2.7.13p3とSisimai(シシマイ)の違いについては
 [Sisimai | 違いの一覧](http://libsisimai.org/ja/diff)をご覧ください。
 
 | 機能                                        | Ruby version   | Perl version  |
@@ -212,153 +257,41 @@ Perl版Sisimaiとの違い
 
 1. [./ANALYTICAL-PRECISION](https://github.com/sisimai/rb-Sisimai/blob/master/ANALYTICAL-PRECISION)を参照
 
-MTA/MSPモジュール一覧
----------------------
-下記はSisimaiに含まれてるMTA/MSP(メールサービスプロバイダ)モジュールの一覧です。
-より詳しい情報は[Sisimai | 解析エンジン](http://libsisimai.org/ja/engine)を
-ご覧ください。
-
-| Module Name(Sisimai::)   | Description                                       |
-|--------------------------|---------------------------------------------------|
-| MTA::Activehunter        | TransWARE Active!hunter                           |
-| MTA::ApacheJames         | Java Apache Mail Enterprise Server                |
-| MTA::Courier             | Courier MTA                                       |
-| MTA::Domino              | IBM Domino Server                                 |
-| MTA::Exchange2003        | Microsoft Exchange Server 2003                    |
-| MTA::Exchange2007        | Microsoft Exchange Server 2007 (> v4.18.0)        |
-| MTA::Exim                | Exim                                              |
-| MTA::IMailServer         | IPSWITCH IMail Server                             |
-| MTA::InterScanMSS        | Trend Micro InterScan Messaging Security Suite    |
-| MTA::MXLogic             | McAfee SaaS                                       |
-| MTA::MailFoundry         | MailFoundry                                       |
-| MTA::MailMarshalSMTP     | Trustwave Secure Email Gateway                    |
-| MTA::McAfee              | McAfee Email Appliance                            |
-| MTA::MessagingServer     | Oracle Communications Messaging Server            |
-| MTA::MFILTER             | Digital Arts m-FILTER                             |
-| MTA::Notes               | Lotus Notes                                       |
-| MTA::OpenSMTPD           | OpenSMTPD                                         |
-| MTA::Postfix             | Postfix                                           |
-| MTA::Qmail               | qmail                                             |
-| MTA::Sendmail            | V8Sendmail: /usr/sbin/sendmail                    |
-| MTA::SurfControl         | WebSense SurfControl                              |
-| MTA::V5sendmail          | Sendmail version 5                                |
-| MTA::X1                  | Unknown MTA #1                                    |
-| MTA::X2                  | Unknown MTA #2                                    |
-| MTA::X3                  | Unknown MTA #3                                    |
-| MTA::X4                  | Unknown MTA #4 qmail clones                       |
-| MTA::X5                  | Unknown MTA #5                                    |
-| MSP::DE::EinsUndEins     | 1&1: http://www.1and1.de                          |
-| MSP::DE::GMX             | GMX: http://www.gmx.net                           |
-| MSP::JP::Biglobe         | BIGLOBE: http://www.biglobe.ne.jp                 |
-| MSP::JP::EZweb           | au EZweb: http://www.au.kddi.com/mobile/          |
-| MSP::JP::KDDI            | au by KDDI: http://www.au.kddi.com                |
-| MSP::RU::MailRu          | @mail.ru: https://mail.ru                         |
-| MSP::RU::Yandex          | Yandex.Mail: http://www.yandex.ru                 |
-| MSP::UK::MessageLabs     | Symantec.cloud http://www.messagelabs.com         |
-| MSP::US::AmazonSES       | AmazonSES(Sending): http://aws.amazon.com/ses/    |
-| MSP::US::AmazonWorkMail  | Amazon WorkMail: https://aws.amazon.com/workmail/ |
-| MSP::US::Aol             | Aol Mail: http://www.aol.com                      |
-| MSP::US::Bigfoot         | Bigfoot: http://www.bigfoot.com                   |
-| MSP::US::Facebook        | Facebook: https://www.facebook.com                |
-| MSP::US::Google          | Google Gmail: https://mail.google.com             |
-| MSP::US::Office365       | Microsoft Office 365: http://office.microsoft.com/|
-| MSP::US::Outlook         | Microsoft Outlook.com: https://www.outlook.com/   |
-| MSP::US::ReceivingSES    | AmazonSES(Receiving): http://aws.amazon.com/ses/  |
-| MSP::US::SendGrid        | SendGrid: http://sendgrid.com/                    |
-| MSP::US::Verizon         | Verizon Wireless: http://www.verizonwireless.com  |
-| MSP::US::Yahoo           | Yahoo! MAIL: https://www.yahoo.com                |
-| MSP::US::Zoho            | Zoho Mail: https://www.zoho.com                   |
-| ARF                      | Abuse Feedback Reporting Format                   |
-| RFC3464                  | Fallback Module for MTAs                          |
-| RFC3834                  | Detector for auto replied message                 |
-
-バウンス理由の一覧
-------------------
-Sisimaiは下記のエラー27種を検出します。バウンス理由についてのより詳細な情報は
-[Sisimai | バウンス理由の一覧](http://libsisimai.org/ja/reason)をご覧ください。
-
-| バウンス理由   | 理由の説明                                 | 実装バージョン |
-|----------------|--------------------------------------------|----------------|
-| Blocked        | IPアドレスやホスト名による拒否             |                |
-| ContentError   | 不正な形式のヘッダまたはメール             |                |
-| Delivered[1]   | 正常に配信された                           | v4.16.0        |
-| ExceedLimit    | メールサイズの超過                         |                |
-| Expired        | 配送時間切れ                               |                |
-| Feedback       | 元メールへの苦情によるバウンス(FBL形式の)  |                |
-| Filtered       | DATAコマンド以降で拒否された               |                |
-| HasMoved       | 宛先メールアドレスは移動した               |                |
-| HostUnknown    | 宛先ホスト名が存在しない                   |                |
-| MailboxFull    | メールボックスが一杯                       |                |
-| MailerError    | メールプログラムのエラー                   |                |
-| MesgTooBig     | メールが大き過ぎる                         |                |
-| NetworkError   | DNS等ネットワーク関係のエラー              |                |
-| NotAccept      | 宛先ホストはメールを受けとらない           |                |
-| OnHold         | エラー理由の特定は保留                     |                |
-| Rejected       | エンベロープFromで拒否された               |                |
-| NoRelaying     | リレーの拒否                               |                |
-| SecurityError  | ウィルスの検出または認証失敗               |                |
-| SpamDetected   | メールはスパムとして判定された             |                |
-| Suspend        | 宛先アカウントは一時的に停止中             |                |
-| SyntaxError    | SMTPの文法エラー                           | v4.17.0        |
-| SystemError    | 宛先サーバでのOSレベルのエラー             |                |
-| SystemFull     | 宛先サーバのディスクが一杯                 |                |
-| TooManyConn    | 接続制限数を超過した                       |                |
-| UserUnknown    | 宛先メールアドレスは存在しない             |                |
-| Undefined      | バウンスした理由は特定出来ず               |                |
-| Vacation       | 自動応答メッセージ                         | v4.1.28        |
-
-1. このバウンス理由は標準では解析結果に含まれません
-
-
-解析後のデータ構造
-------------------
-下記の表は解析後のバウンスメールの構造(`Sisimai::Data`)です。データ構造のより詳細な情報は
-[Sisimai | Sisimai::Dataのデータ構造](http://libsisimai.org/ja/data)をご覧ください。
-
-| アクセサ名     | 値の説明                                                    |
-|----------------|-------------------------------------------------------------|
-| action         | Action:ヘッダの値                                           |
-| addresser      | 送信者のアドレス                                            |
-| alias          | 受信者アドレスのエイリアス                                  |
-| catch          | 引数に指定したフックメソッドが返すデータ                    |
-| destination    | "recipient"のドメイン部分                                   |
-| deliverystatus | 配信状態(DSN)の値(例: 5.1.1, 4.4.7)                         |
-| diagnosticcode | エラーメッセージ                                            |
-| diagnostictype | エラーメッセージの種別                                      |
-| feedbacktype   | Feedback-Typeのフィールド                                   |
-| lhost          | 送信側MTAのホスト名                                         |
-| listid         | 本メールのList-Idヘッダの値                                 |
-| messageid      | 元メールのMessage-Idヘッダの値                              |
-| reason         | 検出したバウンスした理由                                    |
-| recipient      | バウンスした受信者のアドレス                                |
-| replycode      | SMTP応答コード(例: 550, 421)                                |
-| rhost          | 受信側MTAのホスト名                                         |
-| senderdomain   | "addresser"のドメイン部分                                   |
-| softbounce     | ソフトバウンスであるかどうか(0=hard,1=soft,-1=不明)         |
-| smtpagent      | 解析に使用したMTA/MSPのモジュール名(Sisimai::MTA::,MSP::)   |
-| smtpcommand    | セッション中最後のSMTPコマンド                              |
-| subject        | 元メールのSubjectヘッダの値(UTF-8)                          |
-| timestamp      | バウンスした日時(UNIXマシンタイム)                          |
-| timezoneoffset | タイムゾーンの時差(例:+0900)                                |
-| token          | 送信者と受信者・時刻から作られるハッシュ値                  |
-
-解析出来ないメール
-------------------
-解析出来ないバウンスメールは`set-of-emails/to-be-debugged-because/sisimai-cannot-parse-yet`
-ディレクトリにはいっています。もしもSisimaiで解析出来ないメールを見つけたら、
-このディレクトリに追加してPull-Requestを送ってください。
-
-その他の情報
-============
-関連サイト
-----------
+Other spec of Sisimai
+-------------------------------------------------------------------------------
+- [**解析モジュールの一覧**](http://libsisimai.org/ja/engine)
+- [**バウンス理由の一覧**](http://libsisimai.org/ja/reason)
+- [**Sisimai::Dataのデータ構造**](http://libsisimai.org/ja/data)
+
+Contributing
+===============================================================================
+
+Bug report
+-------------------------------------------------------------------------------
+もしもSisimaiにバグを発見した場合は[Issues](https://github.com/sisimai/rb-Sisimai/issues)
+にて連絡をいただけると助かります。
+
+Emails could not be parsed
+-------------------------------------------------------------------------------
+Sisimaiで解析できないバウンスメールは
+[set-of-emails/to-be-debugged-because/sisimai-cannot-parse-yet](https://github.com/sisimai/set-of-emails/tree/master/to-be-debugged-because/sisimai-cannot-parse-yet)リポジトリに追加してPull-Requestを送ってください。
+
+Other Information
+===============================================================================
+
+Related sites
+-------------------------------------------------------------------------------
 * __@libsisimai__ | [Sisimai on Twitter (@libsisimai)](https://twitter.com/libsisimai)
-* __libsisimai.org__ | [Sisimai | The successor to bounceHammer, Library to parse bounce mails](http://libsisimai.org/)
+* __libSISIMAI.ORG__ | [Sisimai | The successor to bounceHammer, Library to parse bounce mails](http://libsisimai.org/)
+* __Sisimai Blog__ | [blog.libsisimai.org](http://blog.libsisimai.org/)
+* __Facebook Page__ | [facebook.com/libsisimai](https://www.facebook.com/libsisimai/)
 * __GitHub__ | [github.com/sisimai/rb-Sisimai](https://github.com/sisimai/rb-Sisimai)
+* __RubyGems.org__ | [rubygems.org/gems/sisimai](https://rubygems.org/gems/sisimai)
 * __Perl verson__ | [Perl version of Sisimai](https://github.com/sisimai/p5-Sisimai)
+* __Fixtures__ | [set-of-emails - Sample emails for "make test"](https://github.com/sisimai/set-of-emails)
 
-参考情報
---------
+See also
+-------------------------------------------------------------------------------
 * [README.md - README.md in English](https://github.com/sisimai/rb-Sisimai/blob/master/README.md)
 * [RFC3463 - Enhanced Mail System Status Codes](https://tools.ietf.org/html/rfc3463)
 * [RFC3464 - An Extensible Message Format for Delivery Status Notifications](https://tools.ietf.org/html/rfc3464)
@@ -366,15 +299,15 @@ Sisimaiは下記のエラー27種を検出します。バウンス理由につ
 * [RFC5321 - Simple Mail Transfer Protocol](https://tools.ietf.org/html/rfc5321)
 * [RFC5322 - Internet Message Format](https://tools.ietf.org/html/rfc5322)
 
-作者
-----
+Author
+===============================================================================
 [@azumakuniyuki](https://twitter.com/azumakuniyuki)
 
-著作権
-------
-Copyright (C) 2015-2016 azumakuniyuki, All Rights Reserved.
+Copyright
+===============================================================================
+Copyright (C) 2015-2017 azumakuniyuki, All Rights Reserved.
 
-ライセンス
-----------
+License
+===============================================================================
 This software is distributed under The BSD 2-Clause License.