ＣＧＩ雑記帖

• 表示部がHTML形式になっているので、動作が軽くサーバーに負担をかけません。
• 目次が書かれたトップページがあり、各ページにリンクが張られます。
• 目次に段落づけができます。見栄えのいいページが作成可能です。
• タグなども自由に使用できます。
• 編集、削除、挿入なども容易に行えます。　new！！
• 日付が未来のものであっても入力できます。
• キーワードで検索（AND／OR）ができます。
• メニュー部分、本文、両ページの上下に共通のHTMLを挿入できます。
• 各種設定がWeb上から行えます。これにより、画面の色設定などが簡単に変更できます。
• 各種設定後に、全てのデータをもう一度再作成することができます。

　コラム作成支援CGI「Column HTML」の別バージョンタイプです。Column HTMLがフレームタイプなのに対して、こちらは１つのページに目次を生成するタイプです。うだうだ説明するよりはサンプルを見た方が早いんでまずは見てやって下さい（笑）。

　掲示板を書くように連載記事が書けます。
　目次の段落づけなども簡単にできますので、連載記事だけではなくQ&A、小説など用途は無限に考えられます。ページを作成してFTP転送、なんていう手間はかかりません。充実したHPが簡単に作成できます。

• サンプルはこちらにあります。
  パスワードは0123です。このサンプル版ではタグは使えないようになってますが、ホンモノは使えます。また、１００件以上の書き込み、大容量の書き込みはできないようにしてあります。

サンプル

• 以下の書庫（圧縮）ファイルをダウンロードします。書庫ファイルは LHA形式と ZIP形式のいずれかをお選びください。

• 改めてここで断っておきますが、本スクリプトはフリーソフトです。ですので、
  • 改変、再配布等は自由ですが、著作権は放棄しません。
  • 著作権表示を消さないで、「見える」ようにしておいて下さい。
  • このスクリプトを使用したことによるいかなる損害に対しても、作者は責任を負いません。

Ver 1.10
LHA形式 press.lzh		ZIP形式 press.zip

• ダウンロード後、解凍します。解凍すると以下のフォルダとファイルが展開されます（lzh形式の場合、フォルダが圧縮の時になくなってしまうようです。申し訳ありませんが、ご自分で空のフォルダを作成して下さい）。
• lockフォルダ
• pressh.cgi
• pressh.log
• jcode.pl
• index.html
• config.dat
• style.css

具体的な説明に入る前に、各フォルダ／ファイルの説明をしておきます。

　念のため、でしかないんですが、同時書き込みができないようにファイルロック処理を行っています。自分以外が書き込むことはない筈なんで必要ないんですが、本に書いてあったのでつい……（笑）。
　CGIが使用するだけで表に出ない（アドレスとして利用者には判らない）ものなので、そのままのフォルダ名で構わないと思います。

　CGI本体です。
　いろんなパラメーターが中に書かれています。そのままでは１００％動かないので、パラメーターは書き直して下さい（後述）。

　拡張子で想像できる通り、ログファイルです。
　中身はエディタで見れば判る通りなんで省略しますが、６種類のデータしか書き込んでいないので、理解はしやすいと思います。
　ないことを祈りますが、CGIの不備等により正常なメンテナンスができなくなった場合、最悪ここを書き直せば何とかなるかもしれません。

　実はよく知らないんですが（笑）、なんでも日本語処理をするためのライブラリらしいです。お願いですからライブラリって何？　なんて訊かないで下さい。

　CGIを設置したら、まずここにアクセスします。
　一度何か記事を書いたら、内容は変わります。どう変わるかはやってみてのお楽しみ（笑）

　本スクリプトはWeb上で各種設定が更新できます。その設定を保存しておくファイルです。各設定値の意味は、見れば一発で判る筈です（ホントです（笑））。

　v.1.10から、スタイルシートを外部参照形式に変更しました。今まではスタイルシートが埋め込まれていましたが、これからは自分で好きなようにカスタマイズできます。

　pressh.cgiをエディタで開いて、以下のパラメーターを適切なものに設定しなおして下さい。
　ここでは「最低これだけを書き換えればCGIが動作する」というものを挙げています。表示に関わる部分など、細かい設定はpressh.cgiを参照して下さい。多分（笑）判ると思います。

　以上を変更すれば、とりあえずCGIは動作する筈です。

• パラメーターの設定が終わったら、ファイルをアップロードします。全体のディレクトリ構成とファイルの位置は以下の通りです。
  また、［　］内はパーミッションの設定です。この通りにして下さい。

public_html / index.html (トップページ)
     |
     +-- press110 / pressh.cgi  [755]
            |       presso.log  [666]
            |       jcode.pl    [644]
            |       index.html  [644]
            |       config.dat  [666]
            |       style.css   [666]
            +-- lock [777] /

　パーミッションを設定すれば設置は完了です。

　先ほど設置したindex.htmlにアクセスして下さい。「書き込み画面へ」というリンクが貼られていますので、それをクリックします。
　管理モードへの入室画面になりますので、「書込」を選択してパスワードを入力して下さい。パスワードが認証されると、書き込みフォームが現れます。

　あとは、フォームに記事の内容を書いて送信ボタンを押すと、フレームのトップファイル、メニューファイル、記事ファイルが作成されます。
　２回目以降は、記事ファイルの上のメニューの「管理用」から入って下さい。

　本スクリプトはトップの目次画面の作成に命をかけてます（笑）。
　だから、というわけではないんですが、ちょっとだけ目次画面の作成方法は面倒です。

　先に説明した「書込」で書き込みモードに入ると、こんな画面になります。

　この中の「見出し位置」と「見出しのみ」という２つのパラメーターがポイントです。

「見出し位置」は、見出しの段落を決めます。このとき、

• ０を指定すると、左端から見出しを書き始め、同時に直前の見出しとの境目を一行開けます。
• １を設定すると、左端から２つスペースを開けて見出しを書き始めます。
• ２を設定すると、左端から４つスペースを開けて見出しを書き始めます。

　以下、初期値では７（環境設定によって変更可能）まで設定でき、最高で１４文字分のスペースを開けて見出しを書きます。

「見出しのみ」のチェックを入れると、見出しだけ作成できます。
　なんでこんなものがあるの？　と思うかもしれませんが、実際にHPを作成しはじめると「見出しだけほしい」なんていうケースが出てくるんです。そのためにこういうパラメーターを作りました。
　
　例えば、こんな見出しができるわけです（あくまでイメージですが（笑）、ほぼ正確です）。

　見出しは書かれた通りに忠実に再現されます（笑）ので、例えば「見出し０のときは頭に■をつける」とかご自分でルールを決めて下さい。そうすればもっとかっこいい目次ができます。

　基本的には上記の処理をすれば動く筈です。
　ただ、それだけでは本当にただ動くだけです。戻り先も決めていないし、色やフォントもデフォルトのままです。
　これを変更するには、管理モードの「環境」を選択して下さい。

　１つ１つのパラメータについては、煩雑になりますので説明はしません。別にいろいろ試しても困る類のものでもないので（笑）、いろいろ試してみて下さい。

　v.1.10から環境設定の項目が変わっています。v.1.01お使いの方がv.1.10を導入する場合、必ず設定をし直して下さい。
　その際、以前のconfig.datは上書きされてしまいますので、アップロード前に退避しておくことをお勧めします。

　本スクリプトはHTMLデータを生成するので、運用途中でフォントや色設定、題名（記事１つ１つではなく、そのものの方）などを変更した場合、その変更分は今まで作成したページには反映されません。一応、「ログモードで入って、全てのデータを変更する」ことで対処できるんですが、１００件もデータがたまった日にはそれだけでも一苦労です（笑）。そこで作成したのがこの全書替モードです。

　処理の方法はいたって単純で、管理モードから全書替を選択するだけです。自動的に全てのデータを処理しなおします。

　ただし、あまりにもデータが多い場合、サーバに多大な負荷をかけることになってしまいます。１０００件を超えるようなデータであれば、ローカルな環境で実施することをお薦めします。

　v.1.10からできた項目です。

　今までの本スクリプトでは、データの作成と編集・削除しか行えませんでしたが、それだけでは不便ということで挿入機能をつけました。

　使用方法は単純です。
　まず、「ログ」を選択します。
　今まで「修正」「削除」となっていたところに「挿入」という項目が増えましたので、それを選択します。その時、同時にログのうち１つを選択して下さい。選択したログの前に、新しいデータが挿入されます。
　例えば、２３番を選択した場合、新しいデータは２３番のデータとなり、今まで２３番だったデータは２４番、２４番だったデータは２５番、以下２６番、２７番……と繰り上がっていきます。
　前後ページへのリンクは自動的に修正されますが、本文中に書かれたリンクを修正することはできません（それができたら神だよなぁ……）。ですので、もしも本文中にリンクを書いている場合、それはご自分で修正して下さい。

　新機能ですが非常に危ない機能でもありますので、できることならご自分の環境でも一度はテストをして下さい。その際、ログは必ず退避しておくようお願いします。この機能のせいで今まで書いたデータがぶち壊れた……と言われても、白砂は責任を負いません。

　質問などはサポート掲示板の方にお願いします。
　いろいろ質問が出揃えば、FAQみたいなものも作ると思います。

　Column HTMLを作成して、白砂のHPは実はこればっかになってしまいました（笑）。なにしろラクなんで。

　ただ、フレーム式だと、見出しに長い文字が使えない（２行にも３行にもなっちゃうんでカッコ悪くなっちゃう）という欠点があります。連載形式でちょっと長めのものを書きたい場合、ちょっと不便なんです。まぁ、元がコラム用CGIなんで当然なんですが……。

　というわけで作成したのが本スクリプトです。

　できるだけ見栄えをちゃんとしたかったので、目次のページ（index.htmlのページです）の作り方にはこだわりました。スクリプトが読める方は一度読んでみて下さい。結構面倒なことをしてます（笑）。特に、途中のページを削除した時の処理は一目見ただけでは判らないかもしれません。単に作り込みがヘタなだけかもしれませんが……（泣）。

　というわけで、白砂制作のスクリプト第２弾をお届けします。