[hns documentation]

Hyper NIKKI System Version 2.10

Installation of hns


To use hns

You need the system below.

You can use hns, if you can use the software above.

If you can't use shell, you would be better to install hns-lite.

There is a installation documentation for begginers, はいぱ〜日記システムによるWeb日記のすすめ。(Japanese only).

Now,

we recieved reports that hns worked on above environment (not tested all any mix) . If you want to know hns-ready-ISPs, please see List of ISPs which hns worked.

HOWTO Documentation may help you.

You need the environment that Namazu works to search your diary. See Full Text Search by Namazu for hns for the detail


Getting hns

Get the latest hns from http://www.h14m.org/dist/ (hns-2.10-pl?.tar.gz).
deb for Debian and port for FreeBSD are also available from http://www.h14m.org/dist/binaries/.
rpm will be released soon.


Installing hns

Diary Directory(the directory to put every day hnf) is "~/diary/", Web Diary Directory(the directory accessible from web) is "~/public_html/diary/".

  1. $ gzip -dc hns-2.10-pl?.tar.gz | tar xvf -
    (or $ tar zxvf hns-2.10-pl?.tar.gz)
  2. $ cd hns-2.10
  3. If you use interactive setup program;
    $ sh hns-setup.ja
    and answer the questions.
    Caution:
    You can't input the letter "!". If you use it, installation fails. If you want use the letter "!" in your configuration, you must edit configuration file of hns after installation completed.

  4. Below is in case not to use interactive setup program.
    $ vi Makefile
    NIKKITITLE is your diary tilte
    NIKKITITLE = HNS: Hoge's Diary

    USERMAIL is your email address (the address is embedded in every diary page)
    USERMAIL = hoge@example.ne.jp

    DIARYMAIL is your email address(to) for Updating Diary via Email .
    DIARYMAIL = hoge@example.ne.jp

    FROMADDR is your email address(from) for Updating Diary via Email (the address is for authorization).
    FROMADDR = hoge@example.ne.jp

    PASSWORD is password for Updating Diary via Email
    PASSWORD = hirakegoma

    Set UNAGIUSE ON if you want search form of Namazu for hns in your diary page. You need to install "Namazu for hns" to search your diary.
    UNAGIUSE = OFF

    MYDIARYURI is your diary URL
    MYDIARYURI = http://www.example.ne.jp/~hoge/diary/
    Caution:
    index.cgi を DirectoryIndex に指定できない場合(上記の URL に アクセスするとディレクトリの中身が見えてしまう場合など)は、
    MYDIARYURI = http://www.example.ne.jp/~hoge/diary/index.cgi
    と設定して下さい。

    Set the theme name that you want in THEME. Default theme is japanese.
    THEME = ruribaka

    ANTENNA には, Hoshino Antennaに 捕捉された場合,星野アンテナに登録してよいかどうかを記載します. 星野アンテナに登録してかまわない場合は OK と,登録して欲しくない場合には, NG と指定します.Default is OK.
    ANTENNA = OK

    Set the path of Perl5 to PERL_PATH.
    PERL_PATH = /usr/local/bin/perl

    Set the path of sendmail to SENDMAIL_PATH.
    SENDMAIL_PATH = /usr/sbin/sendmail

    Set the path of nkf to NKF_PATH.
    NKF_PATH = /usr/local/bin/nkf

    DIARYDIR is diary directory, HTMLDIR is web diary directory. Change these only if you want.
  5. Type
    $ make install
    hns is going to be installed.
    Caution:
    Installer installs Apache access control file, .htaccess to your web diary directory. .htaccess is blow:
    DirectoryIndex index.cgi index.html
    <Files "*.pm">
     deny from all
    </Files>
    <Files "*.ph">
     deny from all
    </Files>
    <Files "*.bak">
     deny from all
    </Files>
    
    Your Apache configuration may cause Internal Server Error when you access to your diary. In this case, if you can ask webmaster to change Apache configuration, plese do. Or you can remove .htaccess. But if you remove .htaccess, then configuration files etc. are readable via web brower.
  6. If installation finished successfully, go to How to Set up Config File

Hyper NIKKI System Version 2.10


Index