Fumy Merge RSS

• 「Fumy Merge RSS」は、複数のRSSフィードやAtomフィードを結合して、1つの大きなRSS（Atom）フィードを作成できるCGIです。
• 結合するRSS（Atom）フィードの個数に制限はありません。いくつでも結合できます。
• 結合元のフィードは、RSS1.0・RSS2.0・Atomの各種類が混在していても構いません。

• 結合した結果のRSS（Atom）フィードは、そのままブラウザ上に表示することもできますし、ファイルに出力することもできます。
  
  • 直接表示させれば、動的にRSSを結合することになり、常に最新の結合結果が得られます。
  • ファイル化すれば、頻繁にアクセスされてもサーバの負荷を低く抑えることができます。

• 結合するRSS（Atom）フィードのリストは、別途データファイルとして用意します。 ですから、設置するCGIは1つだけで、データファイルさえ追加すれば、いくつでもRSS（Atom）フィードの結合パターンを用意できます。
• 結合結果のRSS（Atom）フィードを、どの形式で出力するか、また表示するのかファイル化するのか、…といった事項も、データファイルごとに設定できます。

• このCGIをブログツールなどの Update Ping の送信先に指定することで、 ブログツールがRSSフィードを更新すると同時に、そのフィードを元に結合処理を行うことができます。これによって、ブログの更新と同期させることができます。 （※ファイル化する場合に限ります。直接表示する場合は、そもそも動的に最新の情報を結合させるのでPing送信先に設定するまでもなく、常に同期します。）
  ※ファイル化する場合、「Pingサーバ」の標準的な応答を模倣して返すこともできるので、ブログツールにエラーは表示されません。（データファイルに、Pingサーバとして応答する設定を行った場合のみ。）

• 必要なPerlは、Perl 5 以上です。多くのサーバで問題なく利用できるでしょう。
• データファイルは、テキストエディタで簡単に作れます。基本的には、結合したいRSS（Atom）フィードのURLを列挙するだけです。
• このCGIを動作させるためには、「XML::TreePP」モジュールと「XML::FeedPP」モジュールが必要です。 これらのモジュールがサーバになくても、このCGIと同じディレクトリに「XML」サブディレクトリを作成し、そこに2つのモジュール（TreePP.pm と FeedPP.pm）を配置するだけで使えます。

「Fumy Merge RSS」は、フリーCGIとして配布しています。どなたでも無料でご利用頂けます。個人サイト・商用サイト共に、ご自由にご利用下さい。

Ver 1.00 をダウンロードする （このサイトから）
ZIP形式で圧縮しています。
ダウンロード後、展開して下さい。

このCGIには、以下の2つのモジュールが必要です。サーバにインストールされていない場合は、以下の公開サイトからダウンロードして、このCGIと同じディレクトリに格納する必要があります。

• XML::TreePPモジュール：（ TreePP.pm ファイルだけあればOKです。）
• XML::FeedPPモジュール：（ FeedPP.pm ファイルだけあればOKです。）

上記のモジュール作者サイトのほか、CPANからも入手可能です。
もし、サーバにPerlモジュールをインストールする権限があるなら、ppmを使ってインストールすることをお勧め致します。

CGIの設置環境

• CGIは Perl で記述しています。動作には、Perl 5 が必要です。（※CGIが設置可能なサーバであれば問題ないでしょう。）
• Perlモジュールとして、以下の2つのモジュールが必須です。
  • XML::TreePP （TreePP.pm）
  • XML::FeedPP （FeedPP.pm）
  これらのモジュールがサーバにインストールされていない場合は、上記のリンク先からダウンロードして下さい。
  （たいていインストールされていないと思いますので、今ダウンロードしておくことをお勧めします。）
  

CGIの設置方法（パーミッションの設定）

CGIとデータファイルを、同一のディレクトリに格納して、次のパーミッションに設定して下さい。

ファイル名	パーミッション	補足
実行ファイル
mergerss.cgi	755	メインCGI
データファイル
sample1.dat など	644	データファイル（※自由な名称で好きなだけ作成可）

※データファイル名は何でも自由に付けることができます。データファイルの個数に制限はありません。サンプルとして付属しているデータファイルは不要ならアップロードしなくて構いません。
※結合したRSS（Atom）フィードをファイル化する場合は、このCGIを格納するディレクトリそのもののパーミッションを「777」にする必要がある場合があります。書き込みに失敗するようなら「777」に設定して下さい。（※ディレクトリを777にできない場合やしたくない場合は、生成される予定のファイル名でダミーファイルを作成しておき、そのファイルのパーミッションを「666」（＝書き込み権限を付加）にしておけばOKです。このCGIは、余計な一時ファイルなどは生成しませんから、出力するのはユーザが指定したファイルのみです。）

モジュールも一緒に格納する場合は、次のパーミッションに設定して下さい。

ファイル名	パーミッション	補足
Perlモジュール
TreePP.pm	644	XMLを解析・作成するPerlモジュール
FeedPP.pm	644	RSS・RDF・Atomフィードを解析・作成するPerlモジュール

※上記のPerlモジュールは、CGIと同じディレクトリ内に「XML」というサブディレクトリを作成し、そこにアップロードします。（詳しくは後述のディレクトリ構造図を参照）

CGIの設置方法（アップロード）

アップロードは、すべて「アスキーモード」（テキストモード）で行います。（Perlモジュールもテキストモードでアップロードします。）
CGIの文字コードは、SHIFT-JISのままアップロードされることをお勧めしますが、他の文字コードに変換してアップロードしても構いません。（※その場合は、CGIの39行目にある文字コードの記述を修正する必要がある点に注意して下さい。）

ディレクトリ構造は以下のようにして下さい。

※Perlモジュールをアップロードしない場合は、XMLサブディレクトリは不要です。

CGIの設置方法（CGIファイルの書き換え）

CGIのカスタマイズ方法

シンプルなCGIなので、特別なカスタマイズはありません。
データファイルの作成方法は、下記をご参照下さい。（サンプルのデータファイルを見るだけでも分かると思います。）

CGIの使用

CGIをパラメータなしで実行すれば、データファイルの一覧が表示されます。 パラメータにデータファイル名を指定すると、そのデータファイル内に記述されたRSSフィードのリストを読み込んで、RSSフィードの統合処理を行います。 例えば、データファイル名として「 favorite.dat 」を指定する場合は、 というURLにアクセスすることになります。

どのようなRSSフィードを作成するかの設定は、各データファイル内に記述することで行えます。（下記参照）

データファイルの作成

データファイルは、自由なファイル名で作成可能です。サンプルの「 sample1.dat 」などを参考にすると分かりやすいと思います。
データファイルの拡張子を「.dat」にすれば、CGI上から一覧で表示されます。（表示させたくない場合は、「dat」以外の拡張子で作って下さい。）

データファイルの中身は、以下のような感じになります。 上記の例では、最初の3行でフィードの種類・出力文字コード・出力方法を指定し、4行目以降で統合するRSSフィードのURLを指定しています。 （3つのRSSフィードを、RSS2.0形式でSHIFT-JISコードで画面に表示する設定です。）

• #フィードの種類
  • 「 # 」に続いて「 RSS 」と書けば、RSS 2.0フィードを作成します。
  • 「 # 」に続いて「 RDF 」と書けば、RSS 1.0フィードを作成します。
  • 「 # 」に続いて「 Atom 」と書けば、Atomフィードを作成します。
  • この行を省略すると、デフォルトの設定が使われます。（標準ではRSS2.0）
• %出力文字コード
  • 「 % 」に続いて「 UTF-8 」と書けば、UTF-8コードで出力します。
  • 「 % 」に続いて「 Shift_JIS 」と書けば、SHIFT-JISコードで出力します。
  • この行を省略すると、デフォルトの設定が使われます。（標準ではUTF-8）
  • 出力文字コードは、結合元のフィードと同じにしておいた方が良いような気がします。結果が文字化けしてしまう場合は、元のフィードに合わせてみて下さい。
• @出力方法
  • 「 @ 」に続いて「 show 」と書けば、作成したフィードをそのまま表示します。
  • 「 @ 」に続いて「 file 」と書けば、作成したフィードをファイルに出力します。(※)
  • 「 @ 」に続いて「 file-ping 」と書けば、作成したフィードをファイルに出力し、その後Pingサーバの応答を模倣して返します。(※)
  • この行を省略すると、デフォルトの設定が使われます。（標準ではshow）
• 結合したいフィードのURLを列挙
  • 結合したいフィードのURLは、1行1URLで何個でも列挙できます。
  • 「 http:// 」から始まるURLを指定して下さい。
  • 同一サーバ内にあるフィードを結合したい場合は、相対パスでも指定できます。
  • 数に制限はありませんが、最低1つは指定して下さい。（当たり前ですが）

結合したいフィードのURL以外は、すべて省略可能です。省略すると、CGI内で指定したデフォルトの設定が使われます。
同じ種類の設定を2回以上記述した場合は、後に書いた方が採用されます。

※ファイル化する際のファイル名には、データファイルと同じファイル名で拡張子を「.xml」に変えたものが使われます。
たとえば、データファイル名が「 apple.dat 」なら、出力されるRSS（Atom）フィードは「 apple.xml 」となります。（データファイル名に制限はありませんが、拡張子をxmlにはしないで下さい。また、拡張子のないファイル名にしないで下さい。何らかの要因でファイル名が生成できなかった場合は「default.xml」で生成します。）
ファイルに出力する場合は、ディレクトリに書き込み権限を付加する必要がある点に注意して下さい。（ディレクトリに書き込み権源を付加できない場合は、生成される予定のファイル名でダミーファイルを作成し、そのファイルに書き込み権限を付加しておけばOKです。）

---

書き方の例： 上記は、2つのフィードを結合させ、「RSS 1.0」形式（RDF）で文字コード「UTF-8」にして画面に表示します。

上記は、4つのフィードを結合させ、「Atom」形式で文字コード「UTF-8」にしてファイルに主力します。（画面には、出力が完了した旨のメッセージとリンクが表示されます。）
このデータファイル名が「 sakura.dat 」だとすると、出力されるファイル名は「 sakura.xml 」になります。

上記は、3つのフィードを結合させ、「RSS 2.0」形式で文字コード「SHIFT-JIS」にしてファイルに出力し、その後、標準的なPingサーバと同じ応答（XML）を返します。
このデータファイル名が「 tomoyo.txt 」だとすると、出力されるファイル名は「 tomoyo.xml 」になります。

※どの行も順不同です。（設定がURLの後でも構いませんし、途中に混ざっても構いません。ただし、フィードの結合は記述した順番で行われます。）

CGIのエラーについて

指定されたデータファイルが読めなかった（見つからなかった）場合には、その旨のエラーメッセージが表示されます。

データファイル中に指定されたURLに、フィードが見つからなかった場合や、指定されたURLがRSS（またはAtom）フィードではなかった場合は、500 Internal Server Errorになってしまいます。この場合、エラーの内容を示すメッセージは表示されないのでご注意下さい。

このCGIを使ってみたご感想、ご意見などをぜひお送り下さい。
ご要望にはできるだけ応じたいと考えています。
ご連絡はメールなどでどうぞ。

XML::FeedPP と XML::TreePP という、非常に高機能なPerlモジュールを開発された作者の方に感謝致します。 このCGIのメイン機能は、ハッキリ言ってこのモジュールをそのまま使っているだけです。(^_^;)