夢カウンタの使い方

■ 使い方

「夢カウンタ」には、設置個数に上限はありません。
画像の切り替えや、時計やカレンダの表示も、「タグ」の変更でワンタッチ切り替えが可能です。
以下に、表示例を示しながらタグの使い方を説明します。
- タグの使い方の基本は、dream.cgi の後に、?A=B&C=D&E=F... という引数を付加します。
- とにかく、最初に ? をつけて、A=B というコマンドを、& で区切りながら、ズラズラを後ろにイモヅル式に付けていきます。

カウンタの表示 (デフォルト) (id=ログファイル名)

dream.cgi?id=kent
id名のみ指定。GIF画像を省略した場合にはgif1ディレクトリの画像となり、桁数は５桁となります。
カウンタの表示 (桁数を変更) (fig=桁数)

dream.cgi?id=kent&fig=7
数字の桁数を7桁にする場合です。
カウンタの表示 (画像を指定) (gif=画像タイプ)

dream.cgi?id=kent&gif=2
GIF画像を指定します。例はgif2ディレクトリの画像となります。
時計の表示 (デフォルト) (mode=time)

dream.cgi?mode=time
GIF画像を指定しない場合にはgif1ディレクトリの画像となります。
時計の表示 (画像を指定) (mode=time&gif=画像タイプ)

dream.cgi?mode=time&gif=4
GIF画像を指定する場合で、サンプルはgif4ディレクトリの画像の場合です。
時計の表示 (24時間表示) (mode=time&type=24)

dream.cgi?mode=time&type=24
時計を24時間制で表示させたい場合。
カレンダの表示 (デフォルト) (mode=date)

dream.cgi?mode=date
GIF画像を指定しない場合にはgif1ディレクトリの画像となります。
カレンダの表示 (西暦4桁 & 画像指定) (mode=date&year=4&gif=画像タイプ)

dream.cgi?mode=date&year=4&gif=4
GIF画像を指定し、gif4ディレクトリの画像の場合です。
任意の数字指定 (num=任意の数字)

dream.cgi?num=12345&gif=4
GIF画像を指定し、gif4ディレクトリの画像の場合です。

■ 応用編

以下に、「夢カウンタ」の応用的な使い方と「秘技・最終更新日／サイズ容量の表示」をご紹介します。
「秘技・最終更新日／サイズ容量の表示」は中級者以上向けで質問は受け付けませんので、十分にご注意ください。

画像をランダムに表示 (mode=rand)

dream.cgi?mode=rand
数字をアトランダムに表示させることができます。
このページを再読み込みすると、数字が変わるのが分かると思います。
カウンタに枠を付ける

<table border=1 bgcolor="navy"><tr><td>
<img src="path/dream.cgi?id=kent"> </td></tr></table>
これはカウンタの機能ではなく、HTMLタグで解決します。

▼ 以下の使用方法は質問は受け付けませんので十分にご注意ください。

秘技・最終更新日の表示（中級者以上向け）

dream.cgi?file=フルパス指定のファイル名&gif=指定画像
最終更新日を表示させたいファイルを「フルパス」で指定します。またできるだけ専用のGIF画像を指定します。

秘技・ファイルサイズ数の表示（中級者以上向け）

dream.zipのファイル容量：
bytes dream.cgi?size=フルパス指定のファイル名&gif=指定画像
ファイルサイズ数を表示させたいファイルを「フルパス」で指定します。またできるだけ専用のGIF画像を指定します。
【KB/MB単位表示】
サイズ数は Kbytes および Mbytes 単位表示も可能です。

KB表示：dream.cgi?size=フルパス指定のファイル名&p=k&gif=指定画像

MB表示：dream.cgi?size=フルパス指定のファイル名&p=m&gif=指定画像

【解説および設置法】

通常だとSSIかJavaScriptでしか実現できなかった「ファイル最終更新日」や「ファイルサイズ数」の自動表示を、夢カウンタで可能となりました。
SSIは使用禁止のプロバイダが多く、JavaScriptはブラウザに依存し且つ動作が不安定なため、これは大変便利な機能だと思います。
特に最終更新日の表示では、スラッシュ "/" を年月日に使用した方が美しいので、KENT WEB でオリジナル画像を作成しました。以下からダウンロードしてください。

ZIP圧縮：cntgif.zip (0.gif～9.gif, a.gif, p.gif, c.gif, d.gif, s.gif)
特に注意する部分は「フルパスの指定」です。ここで言うフルパスとは http:// からのURLパスではなく、/ から始るフルパスのことです。（「フルパス」については FAQ1 FAQ2 参照のこと）
ちなみにファイルは相対パス（注：相対パスだと dream.cgi から見たパスとなります）で指定しても構いませんが、フルパスで指定された方が確実だと思います。
「秘技」機能では v2.1 より、上記の専用画像ではなくても表示可能となりましたので、他の画像ファイルを使用しても構いません。最終更新日表示機能では、画像ファイルにスラッシュがない場合は、自動的にダッシュ "-" が代用されます。

《最終更新日の設置例》　フルパス記述例：<img src="count/dream.cgi?file=/home/kent/public_html/index.html&gif=2"> 　相対パス記述例：<img src="count/dream.cgi?file=../index.html&gif=2">
```
/home/kent/public_html/ index.html ... (ここにファイルの最終更新日のタグを記述)
              |                        (更新日表示対象のファイルもこのindex.htmlとする)
              |
              +-- count / dream.cgi
                    |     gifcat.pl
                    |
                    +-- gif1 / 0.gif .. 9.gif
                    |
                    +-- gif2 / 0.gif .. 9.gif a.gif p.gif c.gif d.gif s.gif ... (専用GIF画像)
```
今回の「秘技」機能はある程度のCGI設置経験者でないと難しいかもしれません。フルパスの求め方やファイルの位置関係を必ず十分に理解した上で設置を試みるようにして下さい。またこの設置に関するご質問はお受けいたしませんので、あしからずご了承ください。

■ 余話

開発背景
1. 実は、この「夢カウンタ」を開発しようと思い立ったのは、かの有名な Muquit のフリーソフト wwwcountを意識してのことでした。
2. ご存知の方も多いと思いますが、wwwcountは大変優秀なカウンタで、プロバイダ側が会員のホームページに用意するカウンタは大抵これが使用されています。(@nifty, BIGLOBEなど）
3. どうしてかというと、カウンタ、時計、カレンダの３機能を装備し、画像連結機能ももちろんサポートし、画像の切り替えはＯＫ、また複数ページに設置が可能等の理由からだと思います。
4. ただし、設置する上での決定的なマイナス要因が１つあります。それはプログラムがＣ言語でできており、設置にはコンパイル作業が必要だということです。
5. これはほとんどのプロバイダでUNIXシェルが開放されていない日本では、とってもつらいことです。また、たとえシェルが使用できる環境だとしても、コンパイル作業にはそれなりに専門知識が必要です。
6. 「何とかPerlでwwwcountを実現したい」という動機が「夢カウンタ」の開発背景です。
7. 「夢カウンタ」はもちろんフリーソフトです。Perlなので初心者にも簡単に設置が可能です。
8. 最後に、Perlで画像連結ライブラリを実現する「ライブラリソフト(gifcat.pl)」をフリー公開してくださっているとほほさんに感謝いたします。
wwwcountとの無意味な比較
1. あこがれの wwwcount を設置してみました。もしあなたの環境でシェルが使用でき、「シェル操作なんてたやすいもんだぜえ～」という方は、どうぞ wwwcount の設置を試みて下さい。
  
  - wwwcount - - 夢カウンタ -
2. また、シェルは開放されていないが、Cコンパイラである gcc のパスが通っている（使用できる）プロバイダ(BIGLOBE等）の方は、がまさんの telnetもどき を使う裏技でコンパイルするなんていう方法もあります。（あくまで各自の責任でどうぞ。。）