簡單的說：請用
http://service.fhl.net/cgi-bin/gbook.cgi?username
http://service.fhl.net/cgi-bin/rogbook.cgi?username
username 就是你在信望愛站上的id ，就可以分別使用 留言版與公佈欄
如果你申請了信望愛站的domain name(假設名字是XXX.fhl.net)，更可以直接用
http://XXX.fhl.net/cgi-bin/gbook.cgi?username
http://XXX.fhl.net/cgi-bin/rogbook.cgi?username

以下是正式的說明書：

這是一個很陽春的留言版與公佈欄程式 (採 GPL 版權), 裝在您的網站上, 可以讓
每一位客戶使用.本留言版是由信望愛資訊中心（http://www.fhl.net）與高醫電
算中心(http://www.kmu.edu.tw/cc）共同開發，使用的是 CGIC 程式庫
(http://www.boutell.com/cgic/) 這個工具。也提供php版本的程式，您可以考慮
使用php版本的程式，速度會比較快一些。

1) 如何安裝

	1. edit CGIPATH (your webserver's CGI path) in Makefile
	   if needed edit PHPPATH in Makefile
	2. edit HTTP_GROUP (your user's homepage directory) in gbook_setup.sh
	   , rogbook_setup.sh and gbook.h
	3. make
	4. be root, make install
	   如果要安裝php版本的，就 make install_php
	5. 如果對內定的樣版不滿意，請自行修改 gbktmpl（留言版） 與
	   rogbktmpl（公佈欄）內的樣版，重新make install即可。
           目前的美工需要用到 http://service.fhl.net 裡面的幾個圖檔，這幾
           個圖檔已經放在source目錄下的img目錄裡面，可以將之安裝於自己的網
           頁下並修改樣版以連結到自己的網頁上。

安裝後系統會有:

CGIPATH/gbook.cgi (留言版 CGI 程式本身)
CGIPATH/gbkgbk.cgi(簡體版留言版 CGI 程式本身)
CGIPATH/rogbook.cgi (公佈欄 CGI 程式本身)
CGIPATH/rogbgbk.cgi (簡體版公佈欄 CGI 程式本身)
CGIPATH/rrgbook.cgi (秘密討論區 CGI 程式本身)
CGIPATH/rrgbgbk.cgi (秘密簡體版討論區 CGI 程式本身)
BINPATH/gbook-setup,gbook-secure(seuid 0) (使用者使用前需跑的設定程式)
BINPATH/rogbook-setup,rogbook-secure(seuid 0) (使用者使用前需跑的設定程式)
TMPLPATH/* (留言版樣式)
ROTMPLPATH/* (公佈欄樣式)
config.php gbook.php rogbook.php rrgbook.php(與gbook.php一樣）PHP版本的程式
gbgbk.php rogbgbk.php rrgbgbk.php 簡體版本php程式

另有 rrgbk 相關的程式，可以支援秘密討論區，不過用途很少，就沒有寫完相關的設
定程式。如果真的要用，請參考rrgbook.php這支程式。

    rr與ro兩個需要密碼的程式可以使用 html tag，一般留言板則會攔截掉所有的
html tag。

2) 如何使用

	1. run gbook-setup or rogbook-setup script
           /usr/local/bin/gbook-setup 1  設定第一號留言版
	   /usr/local/bin/rogbook-setup 2 設定第二號布告欄
	2. connect to 
           留言版
        http://your_web_site/cgi-bin/gbook.cgi?user=your_account&bid=board_id
	   公佈欄
        http://your_web_site/cgi-bin/rogbook.cgi?user=your_account&bid=board_id
           如果希望進去就可以直接看到最後一篇文章，可以改用
        http://your_web_site/cgi-bin/rogbook.cgi?user=your_account&bid=board_id&proc=read
        3. 如果要使用PHP版本的留言版，請將config.php、gbook.php與rogbook.php
	   放到Web的目錄下，對config.php做適當的修改並預先裝好PHP4。


3) SSI的功能

安裝完成之後，系統會在你的根目錄下建立一個gbook_bid目錄存放留言版資料，
rogbook_bid目錄存放公佈欄資料。
其中talk目錄就是放留言資料。
gbook.conf檔案第一行是放留言版的名字(公佈欄是rogbook.conf）
第二行放每頁留言版篇數。
第三行是放管理用的密碼。
而以下幾個檔案分別是程式的格式檔：
gedit EDIT時用的格式檔
gread READ時用的格式檔
glist List標題時用的格式檔
gadmin 刪除文章時用的格式檔
gpack  PHP版本用來打包留言資料的控制檔
各個格式檔使用HTML寫法，本程式並提供某一些特殊的標籤可以在特定的地方填入
特定的資料：
<!--$1--> 將List的資料show出來
<!--$2--> 將執行的CGI名字show出來
<!--$3--> 將文章標題show出來
<!--$4--> 將文章作者show出來
<!--$5--> 將文章張貼時間show出來
<!--$6--> 將文章內容show出來
<!--$7--> 將Edit文章時的內定標題show出來
<!--$8--> 將Edit文章時之內定內容show出來
<!--$9--> 將文章作者之Email show出來
<!--$10-->將文章作者之homepage show出來
<!--$11--> 將Edit時 O1到O9 選項所選定的整數show出來，例如：
到         <!--$11--> show 出 O1
<!--$19--> <!--$13--> show 出 O3
<!--$20-->show 出該篇文章被閱讀的次數
<!--$21-->將留言版所有者IDshow出來
<!--$22-->show出總共有幾篇留言來
<!--$23-->show出目前留言編號(限定List功能使用)
<!--$24-->show出下一頁的指標
<!--$25-->show出上一頁的指標
<!--$26-->show出最後一頁的指標
<!--$27-->show EDIT時所需要的隱藏欄位（在gedit中一定要加在form之中）
<!--$28-->用來在閱讀文章時安置「回應文章」的按鈕
<!--$29-->用來產生閱讀文章時的「下一筆」文章編號
<!--$30-->用來產生閱讀文章時的「上一筆」文章編號
<!--$31-->show出目前留言編號(限定READ功能使用)
<!--$32-->show出留言版Title
<!--$33-->show出每頁文章篇數
<!--$34-->show出文章文章的來源IP
<!--$35-->叫出殺文章用的點選表格
<!--$36-->討論區編號
<!--$37-->目前文章列表顏色一
<!--$38-->目前文章列表顏色二
<!--$39-->內定文章列表顏色一
<!--$40-->內定文章列表顏色二
<!--$41-->
到
<!--$50-->將管理功能中 ATT1到ATT10 選項所選定的字串show出來
<!--$51-->與 <!--$1--> 相似，只是show出文章內容
<!--$52-->與 <!--$1--> 相似，只是show出文章被閱讀的次數
<!--$53-->與 <!--$35--> 相似，只是1j6不show出<form>這個是為了符合w3c的標準
<!--$61-->
到
<!--$69-->將附件1到附件9（如果存在的話）的連結show出來
<!--$71-->
到
<!--$79-->將附件1到附件9（如果存在的話）當成圖形show出來

gpack檔案多了兩個特殊的標籤 <!--pack--> 與 <!--/pack-->用來標示文章區域。
gpack通常格式與gread一樣，但因gpack需要容納所有的討論文章，因此需要指定
文章出現的格式，在本程式中，就是利用<!--pack-->與<!--/pack-->來標示出每
一篇文章所要用的格式。

為了降低程式複雜度，簡體版的程式只會將 charset=big5"> 更換為
charset=gb2312"> 控制檔中這部份必須完全按照以上的字串來輸入，
才能順利做繁簡體轉換。

使用搜尋功能時，請用key把要查詢的參數傳入CGI中。

使用附件功能時，用af1 ... af9 變數把附件檔案傳進系統中。
另外別忘了form 必須用  enctype="multipart/form-data"才能上傳檔案。
附件的刪除使用了 unix 系統的 /bin/rm 指令，會影響這個留言板的可攜
性，未來可加以改進。

目前附件功能僅支援以下的格式： jpg png gif bmp doc ppt
mp3 rm ram zip wav xls sxw sxc sxd sxi sxg sxm 
在內文中引用時，可用[img$1]這樣的形式
來引用附件一中的圖形，用[link$1]來連結附件一。當然[img$7]就是引用附
件七中的圖形。為了系統的安全，我們不許留言板的使用者在內文中呼叫附件
的附加檔案，公佈欄的使用者則可以使用[img$1]與[link$2]這樣的功能。

若您有任何建議或發現任何程式錯誤, 請通知:
tjm@fhl.net 或 
cch@kmu.edu.tw.

後語：

以一個網路人的身份來說，基本上我是厭惡沒有身份確認機制的留言版的。
不過跟許多使用者互動之後，覺得或者我自己的心態可以開放一點，並不是
每個人都是壞人，因此我還是夥同cch一起寫了這個留言版與公佈欄。也感謝
信望愛站內的mikehsyu與maranatha提供美工。

基本上信望愛站與高醫電算中心都認同Open Source的理念，所以我們用Open 
Source的工具寫Open Source的程式。對我而言，Open Source運動有更深刻一點
的意義：我相信智慧與知識來自神，所以我理當樂意分享給人。

我們的程式寫的或者不怎樣，希望這只是拋磚引玉，讓更多人可以站在我們的肩
膀上前進。

tjm