なつみかん(NATSU-MICAN)

「なつみかん」ドキュメント

バージョンアップの手引き

ここでは、旧バージョンの「なつみかん」から、最新版ver.2.3に簡単にバージョンアップするための手引きを記しています。

ver.2.2からバージョンアップ

最新版ver.2.3は、基本的にver2.0をはじめとして2.2をベースに開発されています。そのため、新規機能が追加された以外は、変更する設定はほとんどありません。

• 各ファイル
  
  1. 下記ファイルを上書きします。
     LIRS.pm
nm_info.pl
nm_lib.pl
nm_tg.pl
nm_mf.pl
nm_op.pl

• nm.ph
  
  1. 下記部分を書き換えます
     書き換え前
     ### 入出力ファイルのファイル名(ファイル名のみ：入力元は$datadirで、出力先は$outputdirで指定)
# 入力configファイル
$cfg = 'natsumican.cfg';

     書き換え後
     ### 入力ファイル名(ファイル名のみ：入力元はhttpか$datadir下)
# リモートアンテナ設定ファイル
# URLで指定することも可能。そのとき$datadir下の同ファイル名で保存され、取得失敗時はそのファイルを使うようになる
$remcfg = 'remote.cfg';

# 更新時刻取得対象設定ファイル
# URLで指定することも可能。そのとき$datadir下の同ファイル名で保存され、取得失敗時はそのファイルを使うようになる
# $remcfgと$cfgは同じ物を指定することで、なつみかん2.2等と同様、設定ファイルを一つに保持することができる。
$cfg = 'sites.lirs';
これに伴って、リモートアンテナを設定したファイルと、更新時刻取得対象設定をした設定ファイルを分割して下さい。両方同じファイルを指定した場合は分割する必要はありません。
  2. あとはお好みに応じて、コメント文などを2.2のものからコピーして下さい。
     なお、137行目あたりから下の設定に、新たに「%vv%」という置換指定子が使えるようになっていますので、関連のコメントをコピーしておいた方がいいでしょう。
     
• base.html(ベースとなるHTMLファイル)
  
  1. 置換指定子「<!--NATSUMICAN_OUTPUT-->」の書式が変わりました。
     <!--NATSUMICAN_OUTPUT:/home/hoge/public_html/natsu/natsumican.lirs-->
のようになります。「:」より後ろの部分で、その場に読み込む元となるLIRSファイルを指定します。
     
• その他
  誤動作する可能性がありますので、なつみかんが生成したLIRSファイルやリモートアンテナの情報などは、一旦全て削除して下さい。
  

ver.2.0からバージョンアップ

最新版ver.2.3は、基本的にver2.0をベースに開発されています。そのため、新規機能が追加された以外は、変更する設定はほとんどありません。

• 各ファイル
  
  1. 下記ファイルを上書きします。
     LIRS.pm
nm_info.pl
nm_lib.pl
nm_tg.pl
nm_mf.pl

  2. 下記ファイルを新規に書き込みます。
     nm_op.pl

• natsumican.cfg
  
  1. リモート情報設定の行の末尾に、それぞれのリモート情報取得元サイトの時差情報を追加します。
     REMOTE,<A HREF="http://amano.hauN.org/">e</A>,天野アンテナ(LIRS),http://amano.hauN.org/,r_amano.lirs,http://amano.hauN.org/natsumican.lirs.gz,32400,
太字の部分をそれぞれのリモート情報取得元サイトの設定に追加します。
• nm.sh
  
  1. 他形式データ出力スクリプト「nm_op.pl」を実行させる必要がある(hina.txtやDI形式出力)ときは、下記の一行をnm.shの適当な場所(nm_mf.pl実行行の前など)に追加します。
     $PERL nm_op.pl ./nm.ph

• nm.ph
  
  1. 下記の二行を削除します。
     #更新時刻情報を無視するまでの時間(＝Expires：秒で)。
$expiresCount = "18000";
この設定は、プログラム内部で処理するようになったため、このバージョンから使用できなくなりました。
     
  2. 下記の二行を70行目あたりに追加します。
     # HTML出力の際ソートして出力するか(yes/no)
$sortoption = 'yes';

  3. 下記部分を書き換えます
     書き換え前
     ### 入出力ファイルのファイル名(ファイル名のみ：入力元は$datadirで、出力先は$outputdirで指定)
# 入力configファイル
$cfg = 'natsumican.cfg';

     書き換え後
     ### 入力ファイル名(ファイル名のみ：入力元はhttpか$datadir下)
# リモートアンテナ設定ファイル
# URLで指定することも可能。そのとき$datadir下の同ファイル名で保存され、取得失敗時はそのファイルを使うようになる
$remcfg = 'remote.cfg';

# 更新時刻取得対象設定ファイル
# URLで指定することも可能。そのとき$datadir下の同ファイル名で保存され、取得失敗時はそのファイルを使うようになる
# $remcfgと$cfgは同じ物を指定することで、なつみかん2.2等と同様、設定ファイルを一つに保持することができる。
$cfg = 'sites.lirs';
これに伴って、リモートアンテナを設定したファイルと、更新時刻取得対象設定をした設定ファイルを分割して下さい。両方同じファイルを指定した場合は分割する必要はありません。
  4. あとはお好みに応じて、コメント文などを2.2のものからコピーして下さい。
     なお、138行目あたりから下の設定に、新たに「%tz%」「%vv%」という置換指定子が使えるようになっていますので、関連のコメントをコピーしておいた方がいいでしょう。
     
• base.html(ベースとなるHTMLファイル)
  
  1. 置換指定子「<!--NATSUMICAN_OUTPUT-->」の書式が変わりました。
     <!--NATSUMICAN_OUTPUT:/home/hoge/public_html/natsu/natsumican.lirs-->
のようになります。「:」より後ろの部分で、その場に読み込む元となるLIRSファイルを指定します。
     
• その他
  誤動作する可能性がありますので、なつみかんが生成したLIRSファイルやリモートアンテナの情報などは、一旦全て削除して下さい。
  ver.2.2から、テンポラリディレクトリ($tmpdir：./tmp/)下のファイルは作成・改変後3時間経過すると、サブディレクトリの中のファイルも含めて自動的に削除されるようになりました。$basedirや$datadirと同一のディレクトリを指定している場合は、必ず変更してください。
  

ver.1.0、1.0aからバージョンアップ

natsumican.cfgの書式が大幅に変わっていますので、これを「cfgconv.pl」でコンバートする必要があります。

• 各ファイル
  
  1. 下記ファイルを上書きします。
     nm_info.pl
nm_lib.pl
nm_tg.pl
nm_mf.pl

  2. 下記ファイルを新規に書き込みます。
     LIRS.pm
nm_op.pl

• natsumican.cfg
  
  1. 「cfgconv.pl」でコンバートする必要があります。
     % perl cfgconv.pl ./data/natsumican.cfg ./data/natsumican_new.cfg
「perl cfgconv.pl 置換元ファイル 置換先ファイル」のように実行してコンバートして下さい。
     なお、「cfgconv.pl」を実行するには、同梱されている「LIRS.pm」が同じディレクトリに必要です。
     「cfgconv.pl」実行における一切の支障などに関しては誰も責任を負いませんので、ご自身の責任において実行して下さい。一応、動作することは確認済みです。
     
  2. 「nm.ph」の項にもありますが、リモート情報部分と取得元サイト情報とで分割することができます。
     
• nm.sh
  
  1. 他形式データ出力スクリプト「nm_op.pl」を実行させる必要がある(hina.txtやDI形式出力)ときは、下記の一行をnm.shの適当な場所(nm_mf.pl実行行の前など)に追加します。
     $PERL nm_op.pl ./nm.ph

• nm.ph
  
  1. 下記の四行を66行目あたりに追加します。
     #サーバーの時刻帯(GMTよりの誤差を秒で：日本は(+)32400)
$localTimeZone = "32400";
# HTML出力の際ソートして出力するか(yes/no)
$sortoption = 'yes';

  2. 下記部分を書き換えます
     書き換え前
     ### 入出力ファイルのファイル名(ファイル名のみ：入力元は$datadirで、出力先は$outputdirで指定)
# 入力configファイル
$cfg = 'natsumican.cfg';

     書き換え後
     ### 入力ファイル名(ファイル名のみ：入力元はhttpか$datadir下)
# リモートアンテナ設定ファイル
# URLで指定することも可能。そのとき$datadir下の同ファイル名で保存され、取得失敗時はそのファイルを使うようになる
$remcfg = 'remote.cfg';

# 更新時刻取得対象設定ファイル
# URLで指定することも可能。そのとき$datadir下の同ファイル名で保存され、取得失敗時はそのファイルを使うようになる
# $remcfgと$cfgは同じ物を指定することで、なつみかん2.2等と同様、設定ファイルを一つに保持することができる。
$cfg = 'sites.lirs';
これに伴って、リモートアンテナを設定したファイルと、更新時刻取得対象設定をした設定ファイルを分割して下さい。両方同じファイルを指定した場合は分割する必要はありません。
  3. あとはお好みに応じて、コメント文などを2.2のものからコピーして下さい。
     なお、138行目あたりから下の設定に、新たに「%tz%」「%vv%」という置換指定子が使えるようになっていますので、関連のコメントをコピーしておいた方がいいでしょう。
     
• base.html(ベースとなるHTMLファイル)
  
  1. 置換指定子「<!--NATSUMICAN_OUTPUT-->」の書式が変わりました。
     <!--NATSUMICAN_OUTPUT:/home/hoge/public_html/natsu/natsumican.lirs-->
のようになります。「:」より後ろの部分で、その場に読み込む元となるLIRSファイルを指定します。
     
• その他
  誤動作する可能性がありますので、なつみかんが生成したLIRSファイルやリモートアンテナの情報などは、一旦全て削除して下さい。
  ver.2.2から、テンポラリディレクトリ($tmpdir：./tmp/)下のファイルは作成・改変後3時間経過すると、サブディレクトリの中のファイルも含めて自動的に削除されるようになりました。$basedirや$datadirと同一のディレクトリを指定している場合は、必ず変更してください。
  ver.2.0から、基準となるHTML(base.html)に使える置換指定子が増えています。最新版のbase.htmlを参照して、適宜付け加えて下さい。
  ver.1.0、1.0aではhina.txtとDI形式の出力が主流でしたが、最新版ver.2.2ではLIRS形式での出力をメインにしています。また、DI形式の出力の重要度がかなり格下げされています。
  

ver.1.3n0x以下のバージョンからのバージョンアップ

最新版ver.2.2をベースにして、ver.1.3n0xやver0.4n0xの各設定ファイルを参照しながらそれぞれの部分を直していった方が良いと思います:-)

• mican.cfgはnatsumican.cfgと命名変更し、これを置くディレクトリが./data/以下になっています。また、書式が大幅に変わっています。
  ver.1.0、1.0aからのバージョンアップと同様「cfgconv.pl」を使用することができますが、これはver.1.3n0x形式やver0.4n0x形式のリモートサイトの設定行を解釈できません。このため、リモートサイトの設定については新たに手で書き直す必要があります。ターゲットサイトに関しては「cfgconv.pl」が利用できます。
  
• ver1.0からテンポラリディレクトリの概念が導入されています。
  ver.2.2から、テンポラリディレクトリ($tmpdir：./tmp/)下のファイルは作成・改変後3時間経過すると、サブディレクトリの中のファイルも含めて自動的に削除されるようになりました。
  
• ver.2.0から、基準となるHTML(base.html)に使える置換指定子が増えています。最新版のbase.htmlを参照して、適宜付け加えて下さい。
  
• ver.1.3n0x以下ではhina.txt、ver.1.0、1.0aになるとhina.txtとDI形式の出力が主流でしたが、ver.2.0以上、最新版ver.2.3ではLIRS形式での出力をメインにしています。
  
• nmdama.phの設定は、nm.phに統合されました。