XML-RSS-1.02

名前
概要
説明
メソッド
- RSS 1.0 モジュール
ソースの取得場所(=SOURCE AVAILABILITY)
作者(=AUTHOR)
著作権(=COPYRIGHT)
クレジット(=CREDITS)
参考資料

名前¶

XML::RSS - RSSファイルを作成し更新します

概要¶

 # RSS 1.0ファイル(http://purl.org/rss/1.0/)を作成します
 use XML::RSS;
 my $rss = new XML::RSS (version => '1.0');
 $rss->channel(
   title        => "freshmeat.net",
   link         => "http://freshmeat.net",
   description  => "the one-stop-shop for all your Linux software needs",
   dc => {
     date       => '2000-08-23T07:00+00:00',
     subject    => "Linux Software",
     creator    => 'scoop@freshmeat.net',
     publisher  => 'scoop@freshmeat.net',
     rights     => 'Copyright 1999, Freshmeat.net',
     language   => 'en-us',
   },
   syn => {
     updatePeriod     => "hourly",
     updateFrequency  => "1",
     updateBase       => "1901-01-01T00:00+00:00",
   },
   taxo => [
     'http://dmoz.org/Computers/Internet',
     'http://dmoz.org/Computers/PC'
   ]
 );

 $rss->image(
   title  => "freshmeat.net",
   url    => "http://freshmeat.net/images/fm.mini.jpg",
   link   => "http://freshmeat.net",
   dc => {
     creator  => "G. Raphics (graphics at freshmeat.net)",
   },
 );

 $rss->add_item(
   title       => "GTKeyboard 0.85",
   link        => "http://freshmeat.net/news/1999/06/21/930003829.html",
   description => "GTKeyboard is a graphical keyboard that ...",
   dc => {
     subject  => "X11/Utilities",
     creator  => "David Allen (s2mdalle at titan.vcu.edu)",
   },
   taxo => [
     'http://dmoz.org/Computers/Internet',
     'http://dmoz.org/Computers/PC'
   ]
 );

 $rss->textinput(
   title        => "quick finder",
   description  => "Use the text input below to search freshmeat",
   name         => "query",
   link         => "http://core.freshmeat.net/search.php3",
 );

 # オプションで標準ではないmodule/namespaceの要素の混在

 $rss->add_module(prefix=>'my', uri=>'http://purl.org/my/rss/module/');

 $rss->add_item(
   title       => "xIrc 2.4pre2"
   link        => "http://freshmeat.net/projects/xirc/",
   description => "xIrc is an X11-based IRC client which ...",
   my => {
     rating    => "A+",
     category  => "X11/IRC",
   },
 );

  $rss->add_item (title=>$title, link=>$link, slash=>{ topic=>$topic });

 # RSS 0.91ファイルの作成
 use XML::RSS;
 my $rss = new XML::RSS (version => '0.91');
 $rss->channel(title          => 'freshmeat.net',
               link           => 'http://freshmeat.net',
               language       => 'en',
               description    => 'the one-stop-shop for all your Linux software needs',
               rating         => '(PICS-1.1 "http://www.classify.org/safesurf/" 1 r (SS~~000 1))',
               copyright      => 'Copyright 1999, Freshmeat.net',
               pubDate        => 'Thu, 23 Aug 1999 07:00:00 GMT',
               lastBuildDate  => 'Thu, 23 Aug 1999 16:20:26 GMT',
               docs           => 'http://www.blahblah.org/fm.cdf',
               managingEditor => 'scoop@freshmeat.net',
               webMaster      => 'scoop@freshmeat.net'
               );

 $rss->image(title       => 'freshmeat.net',
             url         => 'http://freshmeat.net/images/fm.mini.jpg',
             link        => 'http://freshmeat.net',
             width       => 88,
             height      => 31,
             description => 'This is the Freshmeat image stupid'
             );

 $rss->add_item(title => "GTKeyboard 0.85",
                link  => "http://freshmeat.net/news/1999/06/21/930003829.html",
                description => 'blah blah'
                );

 $rss->skipHours(hour => 2);
 $rss->skipDays(day => 1);

 $rss->textinput(title => "quick finder",
                 description => "Use the text input below to search freshmeat",
                 name  => "query",
                 link  => "http://core.freshmeat.net/search.php3"
                 );

 # RSS 0.9ファイルの作成
 use XML::RSS;
 my $rss = new XML::RSS (version => '0.9');
 $rss->channel(title => "freshmeat.net",
               link  => "http://freshmeat.net",
               description => "the one-stop-shop for all your Linux software needs",
               );

 $rss->image(title => "freshmeat.net",
             url   => "http://freshmeat.net/images/fm.mini.jpg",
             link  => "http://freshmeat.net"
             );

 $rss->add_item(title => "GTKeyboard 0.85",
                link  => "http://freshmeat.net/news/1999/06/21/930003829.html"
                );

 $rss->textinput(title => "quick finder",
                 description => "Use the text input below to search freshmeat",
                 name  => "query",
                 link  => "http://core.freshmeat.net/search.php3"
                 );

 # RSSを文字列で出力
 print $rss->as_string;

 # それをファイルに保存
 $rss->save("fm.rdf");

 # RSSファイルに要素を挿入し、既に15個の要素があるならば、
 # 最も古い要素を削除します
 my $rss = new XML::RSS;
 $rss->parsefile("fm.rdf");
 pop(@{$rss->{'items'}}) if (@{$rss->{'items'}} == 15);
 $rss->add_item(title => "MpegTV Player (mtv) 1.0.9.7",
                link  => "http://freshmeat.net/news/1999/06/21/930003958.html",
                mode  => 'insert'
                );

 # ファイルの代わりに文字列を解析します
 $rss->parse($string);

 # 各RSS要素のtitleとlinkを出力します
 foreach my $item (@{$rss->{'items'}}) {
     print "title: $item->{'title'}\n";
     print "link: $item->{'link'}\n\n";
 }

 # RSS 0.9あるいは0.91ファイルをRSS 1.0で出力します
 $rss->{output} = '1.0';
 print $rss->as_string;

説明¶

このモジュールはRDF Site Summary(RSS)の作成と管理のための基本的なフレームワークを提供します。このディストリビューションにはさまざまな例が入っています。それによりRSSからのHTMLの生成、0.9、0.91、1.0の間の変換、その他の気の利いたことを可能にしてくれます。これは、あなたのWebサイトにSlashdotやFreshmeatのような情報源からのニュースの提供をいれたいのであれば、あるいはあなた自身のコンテンツを配信したいのであれば便利でしょう。

XML::RSSは現在、RSSの0.9、0.91、そして1.0バージョンをサポートしています。 RSS 0.91についての情報は http://my.netscape.com/publish/help/mnn20/quickstart.html をご覧ください。RSS 0.90 については http://my.netscape.com/publish/help/ をご覧ください。RSS 1.0については http://purl.org/rss/1.0/ 。

RSSは初めはNetscapeによってNetscape Netcenterチャンネルのために開発されました。しかし多くのWebサイトが、それ以来、簡単な配信フォーマットとしてそれを採用してきました。RSS 1.0ができてからは、ユーザは今ではニュースの見出し、スレッド化されたメッセージ、製品カタログなどを含めた多くの異なる種類の配信が可能になりました。

メソッド¶

new XML::RSS (version=>$version, encoding=>$encoding, output=>$output)

XML::RSSのコンストラクタ。XML::RSSオブジェクトへのリファレンスを返します。 RSSのバージョンと使用するXMLエンコーディングを渡すこともできます。デフォルトのversionは1.0です。デフォルトのencodingはUTF-8です。入力のバージョンとは関係なく出力(output)フォーマットを指定することもできます。これによりバージョン間でRSSを変換したいときに役に立ちます。<encode_output>を設定すると、XML::RSSモジュールは生成されるRSSでのすべてのエンティティを確実にエンコードします。現在では、これがデフォルトで有効になっています。

add_item (title=>$title, link=>$link, description=>$desc, mode=>$mode)

XML::RSSオブジェクトに要素を追加します。modeとdescriptionはオプションです。デフォルトのmodeはappendで、これはその要素をリストの最後に追加します。要素を挿入するためには、modeをinsertに設定してください。

要素は配列array @{$obj->{'items'}}に格納されます。ここでの $objはXML::RSSオブジェクトへのリファレンスです。

as_string;

そのXML::RSSオブジェクトのためのRSSが入った文字列を返します。そのさい、このメソッドは特殊文字のエンコードも行います。

channel (title=>$title, link=>$link, description=>$desc, language=>$language, rating=>$rating, copyright=>$copyright, pubDate=>$pubDate, lastBuildDate=>$lastBuild, docs=>$docs, managingEditor=>$editor, webMaster=>$webMaster)

RSSではチャンネル情報が必須です。RSS 0.9で出力するときには、 titleは40文字、linkは500文字、descriptionは500文字よりも長くすることはできません。title、 link、そしてdescriptionは RSS 1.0が必須です。RSS 0.91ではlanguageが必須です。そのほかのパラメータはRSS 0.91と1.0でのオプションです。

チャンネルの値を取り出すためには、以下のようにその値の名前(title、linkあるいはdescription)を先頭で唯一の引数として渡してください:

$title = channel('title');

image (title=>$title, url=>$url, link=>$link, width=>$width, height=>$height, description=>$desc)

imegeを追加することは必須ではありません。urlは画像のURL、 linkはその画像がリンクされるURLです。title、 url、linkは RSSファイルのなかでimageを使うのであれば必須です。残りのimage要素は RSS 0.91で使われるか、rss091名前空間を通してオプションでRSS 1.0にインポートされています。

imageのための値を取り出すための方法は、channel()のための方法と同じです。

parse ($string)

parse()に先頭のパラメータとして渡された、RDF Site Summaryを解析します。

文字列が解析されるとき、自動的にモジュールを追加する命令については add_module()メソッドをご覧ください。

parsefile ($file)

文字列ではなくファイルを解析するという点を除けばparse()と同じです。

文字列が解析されるとき、自動的にモジュールを追加する命令については add_module()メソッドをご覧ください。

save ($file)

指定されたファイルにRSSを保存します。

skipHours (hour=>$hour)

RSSファイルを取得する前にサーバーが待たなければならない時間数を指定します。skipHoursメソッドを使うときには、hourが必須です。このメソッドは現在、壊れています。

skipDays (day=>$day)

RSSファイルを取得する前にサーバーが待たなければならない日数を指定します。skipDaysメソッドを使うときには、dayが必須です。このメソッドは現在、壊れています。

strict ($boolean)

1に設定されると、Netscape Netcenterの必要条件によって指定されている長さを頑なに守ります。デフォルトでは0に設定されます。あなたが生成するRSSファイルがNetcenterのためのものであれば、これを使ってください。strictはRSS 0.9と0.91だけで機能します。 RSS 1.0では使わないでください。

textinput (title=>$title, description=>$desc, name=>$name, link=>$link);

このRSS要素もオプションです。これを使うとユーザにHTMLフォームを通して Webサーバー上のプログラムに問い合わせを提示(submit)することができます。nameは HTMLフォームの名前、linkはそのプログラムへのURLです。内容はGETメソッドを使って提示されます。

textinputの値にアクセスは、channel()やimage()と同じです。

add_module(prefix=>$prefix, uri=>$uri)

XML::RSSオブジェクトにモジュール名前空間宣言を追加します。これにより標準のRSS 1.0モジュールの外側にモジュールを追加することができます。利便性を考え、現在、標準モジュールDublin Core (dc) と Syndication (syn) が事前に定義されています。Taxonomy (taxo)も内部的にサポートされています。

モジュールはハッシュ %{$obj->{'modules'}}に格納されます。ここでの $objはXML::RSSオブジェクトへのリファレンスです。

もしパーザーが見つけたモジュールを自動的に名前空間に追加したければ、 $XML::RSS::AUTO_ADD変数にtrue値を設定してください。デフォルトではその値はfalseです。

RSS 1.0 モジュール¶

XML名前空間をベースとしたモジュール化によりRSS1.0に区画に仕切られた拡張性を与えています。RSS 1.0で"あらかじめ"備えているモジュールは Dublin Core (http://purl.org/rss/1.0/modules/dc/)、 Syndication (http://purl.org/rss/1.0/modules/syndication/)、そして Taxonomy (http://purl.org/rss/1.0/modules/taxonomy/)だけです。更なる情報については適切なモジュールのドキュメントにあたってください。

これらのモジュールからXML::RSSに要素を追加することは、title、link、そして descriptionのような他の属性を追加することと同じくらい簡単です。違いは、第2レベルのハッシュでそれらのキー/値のペアの区画分けだけです。

  $rss->add_item (title=>$title, link=>$link, dc=>{ subject=>$subject, creator=>$creator });

Dublin Coreモジュールの要素には、キー 'dc'を、 Syndicationモジュールの要素には'syn'、Taxonomyモジュールの要素には'taxo'を使ってください。これらはRSS XML それ自身で使われる接頭辞です。これらは適切なURIをベースとした名前空間で関連付けられます:

  syn:  http://purl.org/rss/1.0/modules/syndication/
  dc:   http://purl.org/dc/elements/1.1/
  taxo: http://purl.org/rss/1.0/modules/taxonomy/

Dublin Core 要素はchannel、item、textinputで発生するかもしれません -- 例えimageやtextinputの下で見つけることがあまりなかったとしても。 Syndication要素はchannel要素に限られています。Taxonomyはchannelあるいは item要素で発生することができます。

XML::RSSを使ってRSS 1.0ドキュメントを解析した後、モジュール要素へのアクセスは、あなたの都合に合わせて接頭辞あるいは名前空間URIのどちらかを通してください。

  print $rss->{items}->[0]->{dc}->{subject};

  または

  print $rss->{items}->[0]->{'http://purl.org/dc/elements/1.1/'}->{subject};

XML::RSSは、channel、image、item、そしてtextinputレベルでの"標準ではない" RSS 1.0 モジュール化もサポートしています。RSSドキュメントの解析は、出現するかもしれない他の名前空間の要素をすべて捕らえます。XML::RSSは、RSSドキュメントを構築するとき任意の名前空間と関連付けられた要素を入れることも許しています。

例えば、作られた"My"モジュールの要素を追加するためには、まず接頭辞をURIに関連付けることにより名前空間を宣言します:

  $rss->add_module(prefix=>'my', uri=>'http://purl.org/my/rss/module/');

それから通常通り続けていきます:

  $rss->add_item (title=>$title, link=>$link, my=>{ rating=>$rating });

しかし標準では名前空間は、現在のところ簡単な接頭辞を通してアクセスすることはできません;それらの名前空間URLを通してアクセスしてください。そのため以下のようになります:

  print $rss->{items}->[0]->{'http://purl.org/my/rss/module/'}->{rating};

XML::RSSはそれらが現れたように標準のRSS 1.0 モジュールの組込みサポートを提供し続けます。

ソースの取得場所(=SOURCE AVAILABILITY)¶

このソースはSourceForgeプロジェクトの一部となっており、そこでは CVSに最新のソースが前のリリースと同様に入っています。

        https://sourceforge.net/projects/perl-rss/
        http://perl-rss.sourceforge.net

もし、私がこの世からいなくなっても、プロジェクトの他のメンバーのだれかが、このモジュールを適切に導くことができます。

作者(=AUTHOR)¶

        元のコード: Jonathan Eisenzopf <eisen@pobox.com>
        さらなる変更: Rael Dornfest <rael@oreilly.com>
        
        現在: perl-rss project (http://perl-rss.sourceforge.net)

著作権(=COPYRIGHT)¶

XML::RSS is free software. You can redistribute it and/or modify it under the same terms as Perl itself.

クレジット(=CREDITS)¶

 Wojciech Zwiefka <wojtekz@cnt.pl>
 Chris Nandor <pudge@pobox.com>
 Jim Hebert <jim@cosource.com>
 Randal Schwartz <merlyn@stonehenge.com>
 rjp@browser.org
 Kellan <kellan@protest.net>
 Rafe Colburn <rafe@rafe.us>
 Adam Trickett <adam.trickett@btinternet.com>
 Aaron Straup Cope <asc@vineyard.net>
 Ian Davis <iand@internetalchemy.org>

参考資料¶

perl(1), XML::Parser(3).