ハイパー日記システムのインストール

### ハイパー日記システム Version 2.10

# ハイパー日記システムのインストール

### hns を使用するためには

基本的に以下のシステムが必要です。

- ウェブ・サーバ (Apache など)
- Perl 5.004 以降 (5.003用のパッチが寄贈されています)
- sendmail相当のプログラム (メールで日記を更新する場合/webif mail2nikkiモードを使用する場合のみ)
- ftp (webif ftpモードを使用する場合のみ)
- nkf (なくても可)

以上のソフトウェアが使用可能ならば hns を使用できます。

シェル(shell) が使えないサーバの場合は、 hns-lite を インストールするのが簡単でしょう。

また、初心者向けのインストール解説ドキュメントとして、 はいぱ〜日記システムによるWeb日記のすすめ。 があります。

現在，

- FreeBSD 2.2.5, 2.2.6, 2.2.7, 2.2.8, 3.1, 3.2, 3.3, 3.4, 4.0, 4.1
  Linux 2.0.34, 2.0.36, 2.1, 2.2.9, 2.2.13, 2.2.16, 2,2,17
  - MkLinux DR3
  - RedHat 5.2J, Vine 1.1, 2,1, LASER5 Linux 6.0, Slackware 3.4, Cobalt Linux 3.0
  - Debian GNU/Linux 2.1, 2.2
  - TuroboLinux Server 6.0, TuroboLinux 6.0
  OSF1 1.3, 4.0d
  DigitalUnix 4.0B, 4.0D(Rev. 878), 4.0F
  Solaris 2.6 for Sparc
  Solaris 2.6, Solaris 2.7 for Intel
  NetBSD 1.3.4, 1.4.1
  SunOS 4.1.4-JLE1.1.4, 5.6
  BSDI 4.1
- Apache 1.2.1, 1.2.6, 1.3.1 Cobalt, 1.3.3, 1.3.4, 1.3.6, 1.3.9, 1.3.11, 1.3.12
- Perl 5.004_01, 5.004_03, 5.004_04, 5.004_05, 5.004_25
  5.005_02, 5.005_03, 5.005_54, 5.005_56, 5.6.0
  jperl 5.004_04-980303, 5.005_02-981225, 5.005_03

での動作が報告されています(全ての組み合わせでテストされた 訳ではありません)。また動作が確認されたプロバイダなどは、 動作確認されたプロバイダなどの一覧 を 参照下さい。

上記のインストールは， HOWTOドキュメント に参考文献があります。

日記の全文検索を行うには Namazu の動作環境が必要です。 全文検索の詳細は，Namazu for hns による日記の全文検索 を参照願います。

### hns をダウンロードする

http://www.h14m.org/dist/ にあります(hns-2.10-pl?.tar.gz)。 最新版をダウンロードして下さい。
現在 Debian用の deb が用意されています。 http://www.h14m.org/dist/binaries/ を御覧下さい。FreeBSD用の port および Vine用の rpm も提供される予定です。

### hns をインストールする

日記ディレクトリ(毎日の日記 hnf を置くディレクトリ)を ~/diary/， ウェブ日記ディレクトリ(ウェブ上で公開する時のディレクトリ)を ~/public_html/diary/ とします。

1. $ gzip -dc hns-2.10-pl?.tar.gz | tar xvf -
   (又は $ tar zxvf hns-2.10-pl?.tar.gz)
2. $ cd hns-2.10-pl?
3. 対話型のインストール・プログラムを利用してインストールする場合は，
   $ sh hns-setup.ja
   と入力して，インストール・プログラムの質問に答えて下さい。
   注意:
   入力文字に ! は使用しないで下さい。インストールが正常に終了しません。 ! を使用したい場合は、インストール完了後に設定ファイルを 手で書き直して下さい。
4. 以下は，対話型のインストール・プログラムを利用しない場合です。
   $ vi Makefile
   `NIKKITITLE` に日記のタイトルを記載
   `NIKKITITLE = HNS: Hoge's Diary`
   `USERMAIL` に自分のメール・アドレスを記載 (このメール・アドレスは日記ページに埋め込まれます)
   `USERMAIL = hoge@foo.bar.jp`
   `AUTHOR` に日記の作者名を記載(空欄でも可)
   `AUTHOR = Hoge`
   `MESMAIL` には読者からのメッセージを 受け取るメール・アドレスを記載 (サーバに sendmail相当のプログラムが必要です。受け取らない 場合は、空欄にして下さい)
   `MESMAIL = hoge@foo.bar.jp`
   `DIARYMAIL` に メールで日記を更新 する場合の， 更新用メールを受け取るメール・アドレスを記載します。
   `DIARYMAIL = hoge@foo.bar.jp`
   `FROMADDR` に メールで日記を更新 する場合の， 送信するメールの発信アドレスを記載します (このアドレスは認証に利用されます)。
   `FROMADDR = hoge@foo.bar.jp`
   `PASSWORD` に メールで日記を更新 する場合の， パスワードを記載します。半角英数記号を指定してください．
   `PASSWORD = hirakegoma`
   `UNAGIUSE` には，Namazu for hns をインストールして，その検索フォームを 日記に表示したい場合は ON と 記載します。日記の検索には，別途 Namazu for hns のインストールが必要です。
   `UNAGIUSE = OFF`
   `MYDIARYURI` に日記URL を記載します。
   `MYDIARYURI = http://www.foo.bar.jp/~hoge/diary/`
   注意:
   index.cgi を DirectoryIndex に指定できない場合(上記の URL に アクセスするとディレクトリの中身が見えてしまう場合など)は、
   `MYDIARYURI = http://www.foo.bar.jp/~hoge/diary/index.cgi`
   と設定して下さい。
   `THEME` には使用するテーマ名を記載します。デフォルトは japanese です。
   `THEME = ruribaka`
   `ANTENNA` には， 星野アンテナに 捕捉された場合，星野アンテナに登録してよいかどうかを記載します。 星野アンテナに登録してかまわない場合は OK と，登録して欲しくない場合には， NG と指定します。デフォルトは OK です．
   `ANTENNA = OK`
   `NEWREVERSE` は一日の日記の内で新しいセクション(段落)順に表示する場合は、1 と記載します。 デフォルトは 0 です(古い順に表示します)。
   `NEWREVERSE = 0`
   `STARTYEAR` には日記を書き始めた年を記載します。
   `STARTYEAR = 2000`
   `PERL_PATH` に Perl5 へのパスを記載
   `PERL_PATH = /usr/local/bin/perl`
   `SENDMAIL_PATH` に sendmail へのパスを記載
   `SENDMAIL_PATH = /usr/sbin/sendmail`
   `NKF_PATH` に nkf へのパスを記載
   `NKF_PATH = /usr/local/bin/nkf`
   `DIARYDIR` は 日記ディレクトリ，`HTMLDIR` は ウェブ日記ディレクトリです。必要な場合のみ変更してください．
5. $ make install
   で hns がインストールされます。
   注意:
   インストーラは，Apache のアクセス・コントロール・ファイル.htaccess を ウェブ日記ディレクトリにインストールします。 .htaccess の内容は，

       DirectoryIndex index.cgi index.html
       <Files "*.pm">
        deny from all
       </Files>
       <Files "*.ph">
        deny from all
       </Files>
       <Files "*.bak">
        deny from all
       </Files>
       <Files "*.pl">
        deny from all
       </Files>

   となっています。Apache の設定によっては，日記にアクセスすると Internal Server Error が 表示される可能性があります。 その場合は，webmaster に Apache の設定を変更してもらって下さい。それが無理な場合は、 .htaccess を削除する方法がありますが、設定ファイルなどがウェブから 見えてしまいます。
6. 正常にインストールできましたら，設定ファイルconfig.ph の 設定をして下さい。
   うまくインストールできない場合やうまく動かない場合は、 ユーザ・サポートMLのアーカイブ を検索すると何かわかるかも知れません。また、 わからない場合は、 ユーザ・サポートML で質問すると何かわかるかも知れません。

### ハイパー日記システム Version 2.10

Index