HTML Dwarf オンラインマニュアル

設置と初期設定 †

ファイルの入手 †

1. 配布ページからCGIファイルをダウンロードしてください。ファイルは圧縮されていますので、解凍ソフトを使ってファイルを解凍してください。
   ※ファイルをダウンロードした時点で、【小説HTMLの小人さん】の利用規約に同意したものとみなします。
2. 解凍すると、以下のファイル/フォルダが展開されます。（赤字はCGIが動作するのに最低限必要です。）

htmldwarf.cgi

「HTML Dwarf」本体

config.cgi

CGIの動作設定ファイル

index.html

ダミーファイル

Readme.txt

解説

[ module ] （フォルダ）

モジュール・ライブラリ群

[ module ] / cgi-lib.pl

フォーム処理用ライブラリ

[ module ] / imgSz.pl

画像サイズ取得用ライブラリ

[ module ] / session.pl

セッション管理用ライブラリ

[ module ] / [ session ]　（フォルダ）

セッションデータ

[ module ] / [ Archive ] / Zip.pm

zip圧縮モジュール

[ link ] （フォルダ）

テキストファイル群

[ link ] / tag.js

htmldwarf.cgiで使うjavascript

[ link ] / style.css

htmldwarf.cgiで使うスタイルシート

[ template ] （フォルダ）

テンプレート

[ template ] / [ index ] （フォルダ）

目次用テンプレート

[ novel ]　（フォルダ）

作成したファイルを入れるフォルダ

[ images ] （フォルダ）

画像を入れるフォルダ

perlのパスを設定 †

htmldwarf.cgiをテキストエディタ（メモ帳など）で開いてください。
1行目の

#!/usr/local/bin/perl

を、CGIを設置するサーバーの指定するperlのパスに書き換えてください。
※多くのサーバーではこのままで動作しますが、サーバーによっては書き換える必要があります。

ファイルをアップロード †

以下の設置例を参考に、ファイルとフォルダをサーバーにアップロードしてください。ファイルの転送はアスキーモード（テキストモード）で行ってください。

例１）CGIを設置する場所に制限のないサーバ（デフォルト設定） †

public_html / index.html （トップページ）
 │
 ＋ -- htmldwarf / index.html 
        │         htmldwarf.cgi
        │         config.cgi
        │    
        ＋ -- module / cgi-lib.pl
        │      │     imgSz.pl
        │      │     session.pl
        │      │
        │      ＋ -- Archive / Zip.pm
        │      │
        │      ＋ -- session /
        │      
        ＋ -- novel / index.html 
        │    
        ＋ -- template  / index.html 
        │      │        sample1.html
        │      │        sample2.html
        │      │
        │      ＋ -- index / sample1.html
        │                    sample2.html
        │    
        ＋ -- images / 
        │    
        ＋ -- link / tags.js
                     dwarf.css

例２）CGI専用のフォルダ内ではhtmlファイル・画像ファイル等を表示できないサーバ †

public_html / 
 │
 ＋ -- cgi-bin / 
 │     │
 │     ＋ -- htmldwarf / htmldwarf.cgi
 │             │        config.cgi
 │             │        
 │             ＋ -- module / cgi-lib.pl
 │             │      │     imgSz.pl
 │             │      │     session.pl
 │             │      │
 │             │      ＋ -- Archive / Zip.pm
 │             │      │
 │             │      ＋ -- session /
 │             │    
 │             ＋ -- template  / index.html 
 │                     │        sample1.html
 │                     │        sample2.html
 │                     │
 │                     ＋ -- index / sample1.html
 │                                   sample2.html
 │
 ＋ -- home /
        │    
 　     ＋ -- htmldwarf / htmldwarf.cgi
                │    
                ＋ -- link / tags.js 
                │           dwarf.css
                │    
                ＋ -- novel / 
                │    
                ＋ -- images / index.html 

※上記は一例です。設置の際にはご利用のサーバの解説を参照してください。 ※linkフォルダの置き場所を変更すると、画面のデザインが崩れます。CGI動作設定の「CSS,JSファイルのフォルダ」項目を適切に変更してください。（上記の構成の場合、「../../home/htmldwarf/link」か「../../htmldwarf/link」）

パーミッションを設定 †

以下のファイル・フォルダのパーミッションを変更してください。　[ ] 内は一般的なサーバーでのパーミッション値です。

• htmldwarf.cgi --- [ 705 ]
• config.cgi --- [ 606 ]
• [ session ]（フォルダ） --- [ 707 ]
• [ novel ]（フォルダ） --- [ 707 ]

推奨パーミッション値はサーバによって違うので、上記のパーミッションでは動かない場合があります。また、CGIやデータファイルを入れるフォルダのパーミッションが指定されているサーバーもあります。サーバーの解説やパーミッション設定も参考に設定してください。

ログインパスワードを登録 †

ブラウザからhtmldwarf.cgiにアクセスしてください。アドレスは「http://あなたのホームページのアドレス/htmldwarfを入れたフォルダ/htmldwarf.cgi」のようになります。
設置がうまくいっている場合は、ログインパスワードの登録画面になります。２回同じパスワードを入れて、登録ボタンを押して下さい。
適切なパスワードが登録されると、ログイン画面になるので、先ほど登録したパスワードでログインしてください。
※ログインにはクッキーを利用しているので、クッキーを有効にしてください。また、sessionフォルダが正しい位置にないと正常にログインできません。

設定を変更 †

ファイル･フォルダの位置をデフォルトから変更している場合、メニューのCGI動作設定から各フォルダへのパスを変更してください。