HeRO DataBase CGI 配布所

RSS Converter Version1.02 2004/11/26

- 新着情報のRSS生成 と SSINEWS(タイプ2) -

TOP
  テーブル自由設計型データベース(Perl CGI)
RSS Converter とは
サンプル
ダウンロード
設置説明
用語( IT用語辞典 e-Words を利用 )
 RSS Converter とは
  • RSS とは、タイトルや日付などで構成されるホームページの更新情報などを伝える規格です。サイトのヘッドラインとして使われています。asahi.com や nikkeibp.jp などが、ニュースを一般のホームページに表示できるように利用していたりします。詳しい内容に関しては、検索エンジンなどを利用して調べてください。

  • HeRO RSS Converter を使うと、ヒロ・データベースで入力した「新着情報」を元にして RSS を生成することができます。生成した RSS を、他のサイトで表示してもらったり、RSS リーダーなどで閲覧してもらうことができます。

  • HeRO RSS Converter は、利用する Perl のバージョンによって出力する XML の文字コードが変わります。Encode.pm がインストールされている Perl Version 5.8 では、UTF-8 で生成できますが、Encode.pm がインストールされていない旧バージョンでは、Shift-JIS で生成します。本サイトは、Perl Version 5.5 なので、Shift-JIS で生成されるようになっています。

  • 当サイトのTOPページの新着情報は、この CGI と SSI を利用しています。

  • 登録できるデータ項目は、(新テーブル)ssirss には「タイトル」という項目が追加されるので、(旧テーブル)ssinews との互換性はありません。でも、ssinews.cgi と ssinews2.cgi は項目が違うだけで、同じ動きをします。

  • 利用するためには、ヒロ・データベース本体が必要ですので、あらかじめインストールしておいてください。
 サンプル
  • 入力画面(管理者専用モードなので、編集はできません) :: まずは編集して
  • 編集画面

  • SSI-News(ssinews2.cgi) で表示した例 :: ホームページの中に表示
  • ssinews2.cgi をそのまま実行した場合

    ssinews2.cgi を ssinews2.shtml の中で実行した場合
    ※これは、ssinews.cgi と同じですので、そちらを参考にしてください。

  • HeRO RSS Converter(herorss.cgi) で出力した例 :: RSS で他サイトへ新着情報を公開
  • Perl 5.0005 の場合は、Shift_JIS で出力します。

    Perl 5.8 の場合は、UTF-8 で出力します。

  • RSS を他のサイトで表示した例 :: 他サイトが RSS を表示

 

(参考リンク)PukiWiki :: PukiWikiについての説明

(参考リンク)XOOPS :: XOOPSについての説明

 SSI を使うためには
  • SSI って何?という方は、とほほのSSI入門 などで勉強してみてください。

  • お使いのサーバーで SSI が利用できるか、利用できないかを調べてください。

  • HTML のファイル名(拡張子)が .shtml になっていないと動作しない場合があります。

  • HeRO DB の機能を利用しますから、 ヒロ・データベース本体が使える状態になっていること が前提です。

  • もうひとつ。 HeRO DB の核になる部分が改造されている場合は正しく動作しないこともあります。
 新着情報の表示 SSI のダウンロード
  • 使用条件 (スクリプトをダウンロードする場合、無条件に同意したものとみなします。)

    1. ご利用の際には全てにおいて自己責任で行ってください。
    2. 設置したHP及びCGIへのリンクを当ホームページ内に設置させてください。

  • それでは、どうぞ↓
    クリックでダウンロード  LZH形式 herorss102.lzh Version 1.02 2004/11/26

    公開履歴(重要な項目のみ表示)
    Version 1.00 2004/11/24: RSS Converterの公開
    Version 1.01 2004/11/25: RSS画像の表示位置を調整
    Version 1.02 2004/11/26: 文字数を調整
       
  • ご注意

    Version 1.16 以降の HeRO DB に対応しています。これより古いバージョンをお使いの方は HeRO DB 本体を最新版に変更してください。

    この CGI を利用した事によるいかなる損害も作者は一切の責任を負いませんのであらかじめご了承ください。

 設置説明  ※説明が長くてちょっと難しい気もしますが、実は単純なことの繰り返し。じっくり取り組めば必ずできます。がんばってっ!
    [ダウンロード後の設置方法]

  • ダウンロード後に解凍を行うとファイルが展開されます。
    展開されるファイルは herorss.cgissinews2.cgirss.png 及び ssirss ディレクトリ内のファイル一式です。
    hero.pl / cgi-lib.pl / jcode.pl / herodb.cgi は含まれておりません。

    展開されたファイルをサーバーに転送してください。
    全体のディレクトリ・ファイル構成とパーミッション設定値の例を書いておきます。(太字がディレクトリです)

    ヒロ・データベースと同一ディレクトリに転送してください。
    ヒロ・データベースを先にインストールされることをお勧めします。
ディレクトリ構成例 パーミッション 備考
herodb    
  |    
  |-- ssirss [777]  
  |   |-- bin [777]  
  |   |-- bin_del [777]  
  |   |-- csv [777]  
  |   |-- lock [777]  
  |   |-- config.pl [644] 表示設定
  |   |-- rec.dat [666] テーブルデータ
  |   |-- rec_del.dat [666] 削除データ
  |   |-- table.def [644] テーブル定義
  |    
  |-- cgi-lib.pl [644]  
  |-- hero.pl [644]  
  |-- herodb.cgi [755] 本体
  |-- herorss.cgi [755] RSS生成CGI
  |-- rss.png [644] RSS画像
  |-- ssinews2.cgi [755] 新着情報表示SSI
  |-- ssinews2.shtml [644] テスト用
  |-- jcode.pl [644]  

(パーミッション設定 : ○○○.dat=[666] ○○○.cgi=[755] ディレクトリ=[777] その他=[644])



    [試しに動かしてみる]

  • それでは試しに動かしてみましょう。(緑色は転送先サーバーのアドレスです)

    ssinews2.shtml は動作確認用の HTMLファイルです。ssinews2.shtml までの URL をブラウザのアドレス欄に入力してください。
    http://www.xxx.xxx/~user/herodb/ssinews2.shtml
    HeRO DB は動いているけど、ssinews2.shtml では何も表示されない。
    という場合は各ファイルのパーミッションを確認してください。
    あるいは、動作確認用shtml(拡張子)を html や htm などに変更して動作させてみてください。
    サーバーによっては、SSI自体が使えない場合がありますので、その点はあらかじめ確認しておいてください。



    [herodb.cgi でデータを編集する]

  • 新着情報を登録、修正、削除する場合は、次の方法でherodb.cgi を起動してください。
    詳しくは本体の説明をご覧くださいね。 ※テーブル名は ssirss です。

     http://www.xxx.xxx/~user/
    herodb/herodb.cgi?table=ssirss

  • データを1〜2件、登録してから、ssinews2.shtml に表示されるか確認してみましょう。



  • [index.shtml で新着情報を表示したい場合]

  • ssinews2.shtml の中身を参考にしながら、ご自身のホームページの適切な部分に SSI を動かす記述をしてください。

    たとえば、http://www.xxx.xxx/~user/index.shtml からSSI を動かしたい場合は、index.shtml の中に次のような書き方をします。
    ※↓これをコピペしても駄目です。コピペするなら ssinews2.shtml からどうぞ。
    <table border="0" width="500">    
    <tr>
    <td>
    <!--#exec cgi="./herodb/ssinews2.cgi" -->
    </td>
    </tr>
    </table>

  • ssinews2.cgi の書き換え

    特に注意するべき点は、$datpath 及び、 $dbcgi です。ssinews2.cgi を設置するディレクトリが上記の「ディレクトリ構成例」と同じ状態で使用する場合は変更不要ですが、別の場所に保管する場合はこれらのパス設定を正しく行ってください。

# テーブルのデータ格納ディレクトリ(テーブル・ディレクトリまでのパスです)
$datpath = "./";

# herodb.cgi の役割をするファイルパス
$dbcgi = "./herodb.cgi";


次の1行はあなたのサイトに合わせて必ず設定してください。

# herodb.cgi の役割をするファイルURL
$mtncgi = "http://www.***.com/~user/herodb/herodb.cgi";



    [RSS生成スクリプト(herorss.cgi) の設置]
  • herorss.cgi の書き換え

    RSSを生成する場合は、このファイルを注意深く設定する必要があります。ファイル中のコメントを読みながら設定してください。特筆するべき部分のみ記載しておきます。


    # Perl のバージョンによる設定
    # Encode.pm がインストールされている場合のみ有効
    # エラーが発生する場合は下の3行の各先頭に # を付けてください。
    use Encode qw/from_to/;
    use Encode::Guess qw/euc-jp shift-jis/;
    $encpm = 1;


    ↑「3行の先頭に#を付ける」とは、次のようになります。エラーが発生しない場合は変更しないでください。
    #use Encode qw/from_to/;
    #use Encode::Guess qw/euc-jp shift-jis/;
    #$encpm = 1;



    次の行はあなたのサイトに合わせて必ず設定してください。

    # ホームページTOPアドレス(http://〜)
    $hpurl = "http://www.***.com/~user/";

    # スクリプトのファイル名(http://〜)
    $script = "http://www.***.com/~user/herodb/herorss.cgi";



    次の行は、 ssinews2.cgi と同じく、上記の「ディレクトリ構成例」と同じ状態で使用する場合は変更不要です。

    # テーブルのデータ格納ディレクトリ(テーブル・ディレクトリまでのパスです)
    # → パスの最後は / で終わること
    $datpath = "./";

    # herodb.cgi の役割をするファイルパス(名前を変えた場合のみ)
    $dbcgi = "./herodb.cgi";



    [共通事項 と 注意事項]
  • config.pl の書き換え

このファイルは、HeRO DB データベース本体と同じものです。色の設定や、$hero'title、 $tablecom を必要に応じて変更してください。

  • table.def の設定

基本的に変更はしないでください。

「新着記事」の入力TEXTは タグ利用不可能 となっています。

 

 用語( IT用語辞典 e-Words を利用 )
 参考サイト

下記のサイトを参考にさせて頂きました。各サイトオーナー様に感謝申し上げます。

Copyright (c) 2002-2004 By HeRO.