『書物の迷宮』予告篇

思い出したように本を読み、本の読み方を思い出す

CustomFeedプラグインの意訳

技術

CustomFeedのperldocを全部訳してみた。多分参考にはなるはず。
authorに付記されていたメールアドレスを削除した以外はそのまま。
そして、CustomFeed全部なので長い。<追記>
こちらにwikiをたててみました。
http://mywiki.jp/hazymoon/plagger%83h%83L%83%85%83%81%83%93%83g%98a%96%F3/

CustomFeed::2chSearch

名前
Plagger::Plugin::CustomFeed::2chSearch − Custom feed for 2ch Search
       with Moritapo
モリタポを使った2ch検索のためのCustom feed。

概要
         global:
           user_agent:
             cookies: /path/to/cookies.txt

         plugins:
           − module: Subscription::Config
             config:
               feed:
                 − http://find.2ch.net/index.php?BBS=2ch&TYPE=BODY&STR=Plagger&COUNT=10
           − module: CustomFeed::2chSearch

説明
	このプラグインは2ch検索 http://find.2ch.net/.からcustom feedを作ります。
	2ch検索は全文検索にモリタポを必要とするため、global user_agentの設定で有効なcookieをセットする必要があります。

       This plugin creates a custom feed off of 2ch search
       http://find.2ch.net/. Since 2ch search requires Moritapo to search by
       fulltext, this plugin also requires a valid login cookie set to global
       user_agent config.

検索の頻度
デフォルトでは、お金(モリタポ)を節約するために、このプラグインは一時間に一回以上検索しません。検索の頻度をさらに減らしたい場合(一日に一回など)、Subscription::Configをトリガーするために、Plagger::Rule::DateTimeCronを使うことを検討してください。If you want to reduce seach frequency more (like once in a day), consider using Plagger::Rule::DateTimeCron to trigger Subscription::Config for it.(?)

作者(=AUTHOR)
       Tatsuhiko Miyagawa

参考資料
       Plagger, http://find.2ch.net/

CustomFeed::AmazonAssociateReportJP

名前
       Plagger::Plugin::CustomFeed::AmazonAssociateReportJP − Amazon.co.jp アソシエイト・セントラルのためのCustom feed

概要
         − module: CustomFeed::AmazonAssociateReportJP
           config:
             email: foobar@example.com
             password: barbaz

説明
	 このプラグインは、あなたのAmazonアフィリエイトのレポートを取得します。

CONFIGRATION
       email, password
           Amazon.co.jp アソシエイト・セントラルにログインするために必要です。

作者(=AUTHOR)
       Naoya Ito

参考資料
       Plagger, Plagger::Mechanize

CustomFeed::AmazonWebService

名前
       Plagger::Plugin::CustomFeed::AmazonWebService − Amazon Web Service
       Custom Feed

概要
         − module: CustomFeed::AmazonWebService
           config:
             developer_token: XXXXXXXXXXXXXXXXXXXX
             associate_id: xxxxxxxxxx−22
             keywords:
               − Tom Cruise
               − Jonny Depp
             mode: dvd
             sort: salesrank
             locale: jp

説明
このプラグインはAmazon Web Serviceからcustom feedを作ります。

CONFIG
       developer_token
		あなたのAmazon Web Service developer token。

       associate_id
		あなたのAmazon アソシエイトID。

       mode  検索モードをセットします。デフォルトの値はbooksです。

       sort  検索結果のソート順を設定します。デフォルトの値はdaterankです。詳しくはNet::Amazon::Request::Sortを参照。

       locale
		web serviceのロケールを設定します。デフォルトの値はjpです。

参考資料
	このプラグインは元々id:wata_dさんによって作られました。http://d.hatena.ne.jp/wata_d/20060821を参照。

       Plagger, Net::Amazon

作者(=AUTHOR)
       Gosuke Miyashita

CustomFeed::BloglinesCitations

名前
       Plagger::Plugin::CustomFeed::BloglinesCitations − Bloglines Citations(引用文)のためのcustom feed

概要
         − module: Subscription::Config
           config:
             feed:
               − http://bloglines.com/citations?url=http%3A//blog.bulknews.net/

         − module: CustomFeed::BloglinesCitations

説明
       このプラグインはBloglines Citations page からcustom feedを作ります。

作者(=AUTHOR)
       Tatsuhiko Miyagawa

参考資料
       Plagger, http://bloglines.com/citations

CustomFeed::Config

名前
       Plagger::Plugin::CustomFeed::Config − タイトルとリンクのみのcustom feedを作る設定(カスタマイズ?)可能な方法

概要
         − module: Subscription::Config
           config:
             feed:
               − http://www.softantenna.com/index.html

         − module: CustomFeed::Config

説明
       このプラグインはHTMLページからcutom feedを作ります。記事の全文と正確な日時を取得するには、EnrtyFullTextプラグインと併用してください。

       yaml形式のファイルをassets pluginディレクトリ以下に置くことで、custom feed handlerを書くことが出来ます。

作者(=AUTHOR)
       Kazushi Tominaga

参考資料
       Plagger

CustomFeed::Debug

NAME
       Plagger::Plugin::CustomFeed::Debug − Feed in config.yaml

SYNOPSIS
         − module: CustomFeed::Debug
           config:
             title: ’My Feed’
             link: ’http://localhost/’
             entry:
               − title: ’First Entry’
                 link: ’http://localhost/1’
                 body: ’Hello World! :)’
               − title: ’Second Entry’
                 link: ’http://localhost/2’
                 body: ’Good Bye! :P’
                 enclosure:
                   − url: http://localhost/debug.flv
                     filename: debug.flv
                     type: video/x−flv

説明
       このプラグインは、"config.yaml"の中にあなたのフィードを定義することを許可します。それによって、あなたのプラグイン開発を容易にするでしょう。
       This plugin allows you to define your feed in "config.yaml", which
       makes it easier creating a testing environment for your Plugin
       development.

作者(=AUTHOR)
       Naoya Ito

参考資料
       Plagger

CustomFeed::FlickrSearch

名前
       Plagger::Plugin::CustomFeed::FlickrSearch − Flickr APIをCustom Feedとして扱う

概要
         − module: CustomFeed::FlickrSearch
           config:
            api_key: YOUR−FLICKR−APIKEY
            method: flickr.photos.search
            params:
              tags: plagger

作者(=AUTHOR)
       Casey West

       Tatsuhiko Miyagawa

参考資料
       Plagger, http://www.flickr.com/, Flickr::API

CustomFeed::Frepa

名前
       Plagger::Plugin::CustomFeed::Frepa − livedoor FrepaのためのCustom feed

概要
         − module: CustomFeed::Frepa
           config:
             livedoor_id: your−id
             password: password
             fetch_body: 1
             show_icon: 1
             feed_type:
               − FriendDiary
               − FriendStatus
               − RecentComment

説明
       このプラグインはあなたの友人のブログ更新をlivedoor Frepa(http://frepa.livedoor.com/)から取得し、custom feedを作ります。

CONFIGURATION
       "fetch_body"や"fetch_body_interval"、"show_icon"についてはPlagger::Plugin::CustomFeed::Mixiを参照。

       以下のように設定ファイル中のglobal cookie_jarに有効なログインセッションを含む場合、livedoor_idとパスワードを補う必要がないことに注意。

         global:
           user_agent:
             cookies: /path/to/cookies.txt

       詳細はPlagger::Cookiesを参照。

作者(=AUTHOR)
       Kazuhiro Osawa

       Tokuhiro Matsuno

       Tatsuhiko Miyagawa

参考資料
       Plagger, Plagger::Plugin::CustomFeed::Mixi, Plagger::Mechanize,
       http://frepa.livedoor.com/

CustomFeed::GoogleNews

名前
       Plagger::Plugin::CustomFeed::GoogleNews − Google Newsのcustom feedを作ります。

概要
         − module: Subscription::Config
           config:
             feed:
               − http://news.google.com/news?ned=jp&rec=0&topic=s
               − http://news.google.co.jp/news?hl=ja&ned=jp&q=%E5%9B%B2%E7%A2%81

         − module: CustomFeed::GoogleNews

説明
       このプラグインはGoogle NewsのHTMLページからcustom feedを作ります。記事の全文と正確な日時を取得するために、Filter::EntryFullTextと一緒に使ってください。

作者(=AUTHOR)
       Tatsuhiko Miyagawa

参考資料
       Plagger

CustomFeed::iTunesRecentPlay

名前
       Plagger::Plugin::CustomFeed::iTunesRecentPlay − iTunes Recent Playのcustom feed

概要
         # entries updated within 120 minutes
         − module: CustomFeed::iTunesRecentPlay
           config:
             library_path: /path/to/iTunes Music Library.xml
             duration: 120
             title_format: %track − %artist
             aws_developer_token: XXXXXXXXXXXXXXXXXXXX
             aws_associate_id: xxxxxxxxxx−22
             aws_locale: jp

説明
       このプラグインはiTunes、またはiPodで最近再生された音楽の情報を取得します。

CONFIG
       library_path
           iTunes Music Library.xmlのパス名。このパラメータが省略された場合、このプラグインは自動的に探そうと試みます。

       duration
           最後に再生された時間がこのパラメータ以内の場合、このプラグインは最近再生された音楽を見つけます。このパラメータをCronでplaggerを実行するperiodと同じに定義すると、メモリ使用量の節約になります。

       title_format
           エントリーのタイトルフォーマットを設定します。%trackや%artist、%albumが使えます。

       aws_developer_token
           このパラメータを設定すると、このプラグインはAmazon web serviceからトラックの情報を得ます。

       aws_associate_id
           あなたのAmazonアソシエイトID

       aws_locale
           web serviceのロケールを設定

作者(=AUTHOR)
       Gosuke Miyashita

       Tatsuhiko Miyagawa

参考資料
       Plagger

CustomFeed::Mailman

名前
       Plagger::Plugin::CustomFeed::Mailman − Mailman pipemailのためのcustom feed

概要
         − module: Subscription::Config
           config:
             feed:
               − http://lists.rawmode.org/pipermail/catalyst/

説明
       このプラグインはMailmanのpipemail URLからcustom feedを
       作ります。
       
作者(=AUTHOR)
       Tatsuhiko Miyagawa

参考資料
       Plagger

CustomFeed::Mixi

名前
       Plagger::Plugin::CustomFeed::Mixi −  mixi.jpのためのCustom feed

概要
           − module: CustomFeed::Mixi
             config:
               email: email@example.com
               password: password
               fetch_body: 1
               show_icon: 1
               feed_type:
                 − RecentComment
                 − FriendDiary
                 − Message

説明
       このプラグインは、mixi(http://mixi.jp/)からマイミク日記の更新を取得し、custom feedを作ります。

CONFIGURATION
       email, password
           mixi.jpにログインするため、証明が必要です。

                  以下のように、設定ファイル中のglobal cookie_jarに有効なログインセッションを含む場合、emailとパスワードを補う必要がないことに注意。

             global:
               user_agent:
                 cookies: /path/to/cookies.txt

           詳細はPlagger::Cookiesを参照。

       fetch_body
           このオプションを用いると、このプラグインはエントリーへのリンクだけではなく、entry body HTMLを取得します。デフォルトは 0 です。

       fetch_body_interval
           "fetch_body"を用いると、Plagger scriptはmixi.jpを負荷をかけるのを避けるために、少し待つように要求します。デフォルトは1.5です。

       show_icon: 1
           このオプションを用いると、このプラグインはmixi.jpからユーザーのbuddy iconを取得します。このオプションは、出力されたHTMLをとてもユーザ・フレンドリーにします。

       feed_type
           このオプションを用いると、フィードの種類を設定できます。
           サポート中: RecentComment, FriendDiary, Message
           デフォルト: FriendDiary

スクリーンショット(=SCREENSHOT)
       http://blog.bulknews.net/mt/archives/plagger−mixi−icon.gif

作者(=AUTHOR)
       Tatsuhiko Miyagawa

参考資料
       Plagger, WWW::Mixi

CustomFeed::MixiDiarySearch

名前
       Plagger::Plugin::CustomFeed::MixiDiarySearch − mixi日記検索のためのcustom feed

概要
         global:
           user_agent:
             cookies: /path/to/cookies.txt

         plugins:
           − module: Subscription::Config
             config:
               feed:
                 − http://mixi.jp/search_diary.pl?submit=search&keyword=Plagger
           − module: CustomFeed::MixiDiarySearch

説明
       このプラグインはmixi日記検索からcustom feedを作ります。mixiはすべてのページでログイン認証を要求するため、このプラグインはglobal user_agent confiに有効なログインcookieの設定を要求します。

作者(=AUTHOR)
       Tatsuhiko Miyagawa

参考資料
       Plagger, http://mixi.jp/

CustomFeed::PerlMonks

名前
       Plagger::Plugin::CustomFeed::PerlMonks − Perl Monks 最新ノードの Custom Feed

概要
         − module: Subscription::Config
           config:
             feed:
               − http://perlmonks.org/?node_id=30175

         − module: CustomFeed::PerlMonks

説明
       このプラグインはPerl Monks 最新ノードのXMLフィードからフィードを作ります。

作者(=AUTHOR)
       Jeff Bisbee

参考資料
       Plagger

CustomFeed::POP3

名前
       Plagger::Plugin::CustomFeed::POP3 − POP3のためのCustom feed

概要
         − module: CustomFeed::POP3
           config:
               host: example.com
               username: tokuhirom
               password: PASSW0RD
               #delete: 1

TODO support $entry−>enclosures
作者(=AUTHOR)
       Tokuhiro Matsuno

THANKS TO
           grzm

参考資料
       Plagger

CustomFeed::Simple

名前
       Plagger::Plugin::CustomFeed::Simple − タイトルとリンクだけのcustom feedを作るシンプルな方法

概要
         − module: Subscription::Config
           config:
             feed:
               − url: http://sportsnavi.yahoo.co.jp/index.html
                 meta:
                   follow_link: /headlines/
               − url: http://d.hatena.ne.jp/antipop/20050628/1119966355
                 meta:
                   follow_xpath: //ul[@class="xoxo" or @class="subscriptionlist"]//a

         − module: CustomFeed::Simple

説明
作者(=AUTHOR)
       Tatsuhiko Miyagawa

参考資料
       Plagger

CustomFeed::SVNLog

名前
       Plagger::Plugin::CustomFeed::SVNLog −  SVN LogのためのCustom feed

概要
           − module: CustomFeed::SVNLog
             config:
               target: scheme://url/to/repository
               title: SVN Log of blah blah blah
               link: http://url/to/repository/viewer
               revision_from: 5
               revision_to: 123
               reverse: 1
               fetch_items: 20

説明
       このプラグインはsvnリポジトリからログを取得し、custom feedを作ります。

CONFIGURATION
       target
           リポジトリのURLを指定します。

       title
           フィードのタイトルを指定します。指定されない場合、デフォルトは’SVN Log’です。

       link
           レポジトリのviewer urlを指定します。

       revision_from
           publishし始めたいrevision numberを指定します。デフォルトは1です。
           Specifies a revision number you wish to start publish from.
           default is 1.

       revision_to
           publishし終えたいrevision numberを指定します。デフォルトは’HEAD’です。

       reverse
           値を1にセットすると、このオプションはフィードを逆順に並べます。デフォルトは0です。

       fetch_items
           publishを限定する数値を指定します。この機能はreverse、revision_from、revision_toなどのオプションと併用できます。

作者(=AUTHOR)
       Michiya Honda

参考資料
       Plagger, SVN::Client

CustomFeed::Yahoo360JP

名前
       Plagger::Plugin::CustomFeed::Yahoo360JP − Yahoo! 360 JAPAN custom feed

概要
         − module: CustomFeed::Yahoo360JP
           config:
             username: your−yahoo−id
             password: xxxxxxxx
             fetch_body: 1
             fetch_blast: 1

説明
       このプラグインは、Yahoo! JAPAN 360から友人のブログ更新とblast updateを取得し、そこからcustom feedを作成します。

CONFIG
       username, password
           ログインするためにあなたのYahoo! IDとpassword

           以下のように設定ファイル中のglobal cookie_jarに有効なログインセッションを含む場合、これらの変数を補う必要がないことに注意。

             global:
               user_agent:
                 cookies: /path/to/cookies.txt

           詳細はPlagger::Cookiesを参照。

       fetch_body
           このプラグインが友人のブログを取得するかどうか指定します。デフォルトは0です。

       fetch_blast
           このプラグインが友人のblastのリストを取得するかどうか指定します。デフォルトは0です。
           
作者(=AUTHOR)
       Tatsuhiko Miyagawa

参考資料
       Plagger, Plagger::Mechanize, Plagger::Plugin::CustomFeed::Mixi

CustomFeed::YouTube

名前
       Plagger::Plugin::CustomFeed::YouTube − YouTubeの検索結果、またはRSSを取得します。
       
概要
         − module: CustomFeed::YouTube
           config:
             query: Twenty Four
             sort: video_date_uploaded
             page: 5

説明
       このプラグインYouTubeの検索結果、RSS、指定されたタグなどを取得します。

CONFIG
       query
           search queryを指定します。

       sort
           ソート条件を指定します。有効な条件は以下の通り。デフォルトはvideo_date_uploadedです。

             relevance
             video_date_uploaded
             video_view_count
             video_avg_rating

       page
           取得する検索結果のページ数。デフォルトは1です。

作者(=AUTHOR)
       Gosuke Miyashita

参考資料
       Plagger