簡單的說:請用 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寫法,本程式並提供某一些特殊的標籤可以在特定的地方填入 特定的資料: 將List的資料show出來 將執行的CGI名字show出來 將文章標題show出來 將文章作者show出來 將文章張貼時間show出來 將文章內容show出來 將Edit文章時的內定標題show出來 將Edit文章時之內定內容show出來 將文章作者之Email show出來 將文章作者之homepage show出來 將Edit時 O1到O9 選項所選定的整數show出來,例如: 到 show 出 O1 show 出 O3 show 出該篇文章被閱讀的次數 將留言版所有者IDshow出來 show出總共有幾篇留言來 show出目前留言編號(限定List功能使用) show出下一頁的指標 show出上一頁的指標 show出最後一頁的指標 show EDIT時所需要的隱藏欄位(在gedit中一定要加在form之中) 用來在閱讀文章時安置「回應文章」的按鈕 用來產生閱讀文章時的「下一筆」文章編號 用來產生閱讀文章時的「上一筆」文章編號 show出目前留言編號(限定READ功能使用) show出留言版Title show出每頁文章篇數 show出文章文章的來源IP 叫出殺文章用的點選表格 討論區編號 目前文章列表顏色一 目前文章列表顏色二 內定文章列表顏色一 內定文章列表顏色二 將管理功能中 ATT1到ATT10 選項所選定的字串show出來 相似,只是show出文章內容 相似,只是show出文章被閱讀的次數 相似,只是1j6不show出
這個是為了符合w3c的標準 將附件1到附件9(如果存在的話)的連結show出來 將附件1到附件9(如果存在的話)當成圖形show出來 gpack檔案多了兩個特殊的標籤 用來標示文章區域。 gpack通常格式與gread一樣,但因gpack需要容納所有的討論文章,因此需要指定 文章出現的格式,在本程式中,就是利用來標示出每 一篇文章所要用的格式。 為了降低程式複雜度,簡體版的程式只會將 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