= planet.rb

planet.rb is a RSS aggregator to make "planet" site such as
((<URL:http://planet.debian.net>)).

== Requires

  * Ruby 1.8.2 or later.

    planet.rb uses YAML, ERb, RSS, REXML, iconv, fcntl, gdbm, etc.

  * HTree

    HTree is a HTML/XML tree library.
    It can get from:
      * ((<URL:http://cvs.m17n.org/~akr/htree/>))
      * ((<URL:http://raa.ruby-lang.org/project/htree/>))

=== Optional

  * Uconv

    You should install Uconv If you will process RSS encoded in EUC-JP.
    It can get from:
      * ((<URL:http://www.yoshidam.net/Ruby.html#uconv>))

== Install

  * edit shebang line of bin/planet.rb.
  * cp bin/planet.rb /path/to/dir
  * chmod +x /path/to/dir/planet.rb

== Usage

  * edit config file and template files.
  * run /path/to/dir/planet.rb config-file

You can write config file as YAML.
And you can write templete files as eRuby.
Examples is in "examples" directory.

== Live examples

  * ((<URL:http://planet.yendot.org>)) (Japanese, UTF-8)

    It aggregates some feeds of my friends.

  * ((<URL:http://planet.yendot.org/tdiary.html>))

    It contains same as the above and uses a theme of tDiary.
    The theme is selected randomly at update time.

== NOTE

planet.rb is in ALPHA status.
The code, config, template, etc may be changed.

== Author

  * akira yamada ((<URL:http://arika.org>))
