小正正的流言簿程式 3.0 安裝說明

1998/08/03

這個版本支援 Windows95/98/NT 和 UNIX、Linux 環境下的 WWW server 使用。

在使用前請先注意:

  • 你該具備哪些知識
    你最好對網頁的寫作和運作方式有一定程度的瞭解,會使用 FTP,知道如何修改網頁伺服器上檔案的使用權限。

  • 是否能使用 CGI
    若你放置網頁的伺服器不支援個人的 CGI 程式,或是不能使用由 C 語言寫的 CGI 程式,或者你沒有權限存取放置 CGI 程式的目錄,你就無法使用這個程式。

  • 放置 CGI 的目錄
    在安裝之前請先確定網頁伺服器上的 CGI 程式放置的目錄。有些伺服器有規定特別的目錄來放置 CGI 程式 (例如: cgi-bin),有些可以放置在自己的目錄下。如果你不確定或不清楚,請詢問你的網頁伺服器管理者。

  • 是否需要重新編譯程式
    如果你的伺服器是 Windows95/98/NT 系統,你可以直接使用內付的 guest.exe 這個檔案,不需要重新編譯程式。如果是 UNIX、Linux 系統,你必須依照後面的步驟在伺服器上編譯程式,因為 UNIX、Linux 系統相容性不一,所以別台機器上編譯的程式,在你的機器上不一定能用。

  • 是否可以修改流言簿的畫面
    如果你熟悉 HTML,那麼你可以依照後面的步驟修改流言簿的畫面,改成具有自己風格的樣式。如果你不熟悉或不懂 HTML,強烈建議你使用預設的畫面,以免修改後流言簿無法運作。

如果以上的問題你都瞭解了,就可以開始安裝小正正的流言簿程式了。請務必詳細閱讀安裝說明,依照步驟一步一步安裝。如果沒有詳細閱讀說明安裝不成功寫信來問我,我是不會裡你的。

如果你有使用過舊版的流言簿程式,想要知道新版增加了哪些功能,可以先去看看版本更新資訊

強烈的建議你先不要修改任何的畫面,依照基本安裝步驟安裝,測試成功之後,再依你的喜好修改畫面或使用特異功能

 


本文件包含下列資訊:(請注意小正正教室中流言簿程式更新的訊息)

安裝成功以後,請寄得到小正正教室去註冊你的網頁,讓大家都可以看到你的流言簿。以後有任何流言簿的最新消息,也會主動通知你!!

 

流言簿檔案一覽表
0_install.htm 本安裝說明文件
guest.exe 流言簿主程式 (Windows的版本)
guest.htm 流言簿主畫面
guest.ini 流言簿資訊檔
guest.dat 流言簿系統資料檔 (不要用手動改變其內容)
guest.tmp 流言簿暫存檔 (不可將之刪除)
*guest.log 流言簿記錄檔
guestadd.htm 填寫流言簿的畫面
guest_index.htm 流言簿索引
guestframe.htm 流言簿索引的分割視窗
guest1.htm~guest10.htm 留給自動換頁時使用的流言簿文件
*adm.htm 流言簿管理的畫面
*index.htm 自動將畫面轉換到流言簿的頁面
[guestpic]目錄 流言簿的圖形檔
[docs]目錄 流言簿相關的說明文件
[source]目錄 流言簿程式的 source code

* 為3.0版新增項目。

 

 

 

基本安裝

1. 將流言簿壓縮檔解壓縮到一個暫時的目錄,裡面應該有上述的檔案

2. 根據自己的狀況,修改流言簿資訊檔 ( guest.ini )。修改方式請看修改設定參數

3. 根據自己的狀況,分別修改流言簿幾個畫面的內容 :
guest.htmguest_index.htmguestadd.htmadm.htm

4. 將所有檔案 ( docs、source 目錄和 index.htm 除外) 用 FTP 上傳到網頁伺服器上面,你要放置流言簿的位置去。若自己本身的電腦就是網頁伺服器,用檔案總管將檔案放至適當的目錄即可。

※放置的位置和參數設定可以參考安裝範例

注意!! 使用 FTP 上傳檔案時,除了 guest.exe圖形檔用 Binary 傳檔以外,其他檔案皆用 ASCII 的方式傳檔。

5. 更改下列檔案的使用權限為 Internet 來賓帳戶變更 (Windows NT) 或 chmod a+rw (UNIX、Liunix)。

Windows NT 更改檔案使用權限的方法可以看這裡,Windows 95 不需要更改使用權限。UNIX、Linux 更改權限的方法請參考相關書籍,或使用一些 FTP 軟體可以更改檔案的使用權限。

guest.htm
guest.dat
guest.log
guest.tmp
guest_index.htm
guest1.htm ~ guest10.htm

6. 將流言簿主程式 (guest.exe) 放置到網頁伺服器上指定的 CGI 目錄。

注意!! 在 UNIX、Liunix 系統中,你必須先在你的伺服器上重新 編譯流言簿主程式 的 source code,再放置到指定的 CGI 目錄,並且更改流言簿主程式檔案的使用權限為 chmod a+rx。 guest.exe 只能在 Windows 環境下使用。

在WWW上,CGI 程式都必須放在特定的、可以執行的目錄下。以 MS IIS 來舉例,CGI程式是放在 C:\InetPub\Scripts 這個目錄下,或是系統規定的 cgi-bin 目錄,你必須先瞭解系統規定的 CGI 目錄為何,然後把主程式 guest.exe ( 或你編譯的 guest.cgi) 放在裡面。

如果你有管理的權限,你也可以另外設定一個目錄來放置 CGI 程式,或用自己原本的目錄,但記得更改此目錄的使用權限為可執行 (不同的 WWW server 有不同的更改方式,請參閱你使用的 server 的文件)。

7. 確定你的電腦有連上網路,便可以使用瀏覽器來瀏覽你剛安裝的 guest.htm 畫面,開始測試使用。

如果你要在自己的電腦上測試,你也必須透過網頁伺服器來流瀏覽畫面 (例如: Windows 95/98 的 Personal Web Server 或 Windows NT 的 IIS),請注意網址的部份應該是 http:// 開頭,而不是 file:// 或其他的。

8. 你可以修改流言簿畫面 (非必要),變成自己的網頁風格,但必須遵照後面修改規則來修改,否則流言簿無法正常運作哦!!

 

※關於 index.htm 這個檔案

如果你自己建立的一個目錄,專門用來放置流言簿,你可以把 index.htm 這個檔案放在流言簿的目錄中,以避免別人直接瀏覽看到目錄中的其它檔案 (最重要的就是管理畫面的檔案)。index.htm 也會自動把畫面換到流言簿的第一頁去。

如果你已經有自己的 index.htm,就不需要上傳這個檔案了。

如果有需要,把 index.htm 重新命名成你的網站預設首頁的檔名,例如: default.htm 或 index.html,這樣才能避免別人直接瀏覽你的目錄。

 

 

 

修改設定參數
流言簿程式大部份的資訊都放在 guest.ini 這個檔案中,用一個純文字編輯器將它打開即可編輯,例如:記事本或 UltraEditor。(千萬不能用Word Pad!!)

自行修改下列項目的內容,但不要變動項目的標題 ( [ ] 引號中的文字 )。有些地方你可以使用預設值,但有 * 的你一定要修改。

[Bookmaster_email]
*流言簿管理者的 E-mail 帳號。

[Guest_Book_URL]
*流言簿頁面的 URL 網址。

[Homepage_URL]
*流言簿管理者的 homepage 首頁 URL。

[Guest_Book_Work_Dir]
*流言簿檔案的工作目錄。這裡請寫上以主程式為基準,guest.htm, guest.dat ...所存放目錄的相對路徑路徑。

例如:主程式在 C:\InetPub\Scripts,流言簿檔案在 C:\InetPub\wwwroot\guest,這邊就要寫 ..\wwwroot\gurst\,以此類推。

注意!! 最後面一定要加上目錄分隔符號 " \ " ( UNIX 和 Linux 中的目錄分隔符號是 " / ")。

[Guest_Pictures_Dir]
圖形檔案是否放在 guestpic 目錄中,預設值是YES

如果你的伺服器不支援自己建立目錄,圖形檔案和流言簿頁面必須放在同一個目錄中的話,就用 NO (全部大寫)。

[CGI_Filename]
*CGI 檔案的檔案名稱,guest.exe 或是 guest.cgi。

[Guest_Book_Filename]
流言簿主畫面的檔案名稱。

[Guest_Add_Filename]
填寫流言簿畫面的檔案名稱。

[Guest_Index_Filename]
流言簿索引畫面的檔案名稱。

[Guest_Dat_Filename]
流言簿系統資料檔的檔案名稱。

[Guest_INI_Filename]
流言簿資訊檔的檔案名稱。

[Guest_Temp_Filename]
流言簿暫存檔的檔案名稱。

[Guest_Log_Filename]
流言簿紀錄檔的檔案名稱。

[Guest_Templet_Filename]
流言簿樣板檔的檔案名稱。如果沒有使用樣板 (使用內定預設的樣板),這邊就留空白。

[Success_message]
流言成功送出的訊息。

[Next_Page_message]
下一頁的訊息。

[Wrote_message]
回應流言時,顯示的訊息。

[Reply_message]
回應流言時,標題前附加的訊息。

[MAX_Message_Number]
每一頁最多包含的流言數目,請用數字。當流言超過最大流言數目時,就會自動換頁。

[Allow_HTML]
是否容許在流言中使用 HTML 標記,預設值是YES。如果不要的話就用 NO (全部大寫)。

 


guest.htm

在這個檔案中,有幾個地方要修改:(要改的地方用紅色顯示,大小寫有差別)

  1. 找到這一行:
    <!-- action="..." 的地方指定,以 guest.htm 為基準,流言簿程式的 URL 位址-->
    <form action="
    guest.cgi" method="POST" name="Guest">

  2. 找到這一行:
    <!--下面這一行 value 中指定了,以 guest.exe (或 guest.cgi) 所在的目錄為基準,流言簿資訊檔的檔案路徑位置-->
    <input TYPE=hidden name="CfgPath" value="
    guest.ini">

  3. 檢查是否有單獨一行 <!--PAGE-->,下面緊接著一行
    <input type="hidden" value="" name="ReplyPage">

  4. 檢查是否有單獨一行 <!--START-->,這是流言內容開始的地方。

  5. 檢查是否有單獨一行 <!--END-->,這是流言內容結束的地方。

如有需要請自行修改頁面中的超連結和圖片位置。基本安裝請勿修改。

 


guest_index.htm

  1. 要有這一行,流言索引表格開始。
    <TABLE CELLPADDING=5 BORDER=0 CELLSPACING=0>

  2. 檢查是否有單獨一行 <!--START-->,這是流言索引內容開始的地方。

  3. 檢查是否有單獨一行 <!--END-->,這是流言索引內容結束的地方。

  4. 要有這一行,流言索引表格結束。
    </TABLE>

如有需要請自行修改頁面中的超連結和圖片位置。基本安裝請勿修改。

 


guestadd.htm

在這個檔案中,有幾個地方要修改:(要改的地方用紅色顯示,大小寫有差別)

  1. 找到這一行:
    //以下是警告訊息,你可以自行更改。訊息要在兩個""(引號)中間!!
    //送出前的確認訊息.
    askmsg = "
    填寫的資料都正確無誤,可以送出了嗎!?"

    還有一些其他的訊息,你可以依照自己的需要,自行修改,或是使用預設值。
    JavaScript 程式碼的地方請勿變動,除非你很熟悉 JavaScript。

  2. 找到這一行:
    <!-- action="..." 的地方指定流言簿程式的檔案名稱,
    只要檔案名稱就好,不要任何路徑-->
    <form action="
    guest.cgi" method="POST" name="Guest">

  3. 找到這一行:
    <!--下面這一行 value 中指定了,以 guest.exe (或 guest.cgi) 所在的目錄為基準,流言簿資訊檔的檔案路徑位置-->
    <input TYPE=hidden name="CfgPath" value="
    guest.ini">

  4. 檢查是否有單獨一行 <!--TITLE-->,下面緊接著一行
    <INPUT SIZE=45 MAXLENGTH=100 NAME="title" VALUE="">

  5. 檢查是否有單獨一行 <!--CONTENT-->,下面緊接著兩行
    <TEXTAREA NAME="content" ROWS=10 COLS=45>
    </TEXTAREA>

如有需要請自行修改頁面中的超連結和圖片位置。基本安裝請勿修改。

注意!! guestadd.htm 在使用時會被 CGI 程式讀取,再顯示給使用者看,並不是直接顯示給使用者看到。所以這個頁面中所有超連結和圖形檔案的路徑,都要以 guest.exe (或 guest.cgi) 為基準,而不是以頁面所在的目錄為基準。

例如:主程式在 C:\InetPub\Scripts,流言簿圖片檔案在 C:\InetPub\wwwroot\guest\guestpic,頁面中用到的圖形就要寫 ..\wwwroot\gurst\guestpic\XXXX.gif,以此類推。

 


adm.htm

這是流言簿管理的畫面,可以刪除流言。由於並沒有做非常安全的密碼保護,因此你必須:

  1. 更改這個頁面的檔案名稱,只有你自己知道這個頁面,讓別人無法找到。不過你得記住這個頁面的名稱。

  2. 找到這一行:
    <!-- action="..." 的地方指定,以 adm.htm 為基準,流言簿程式的 URL 位址-->
    <form action="
    guest.cgi" method="POST" name="Guest">

  3. 找到這一行:
    <!--下面這一行 value 中指定了,以 guest.exe (或 guest.cgi) 所在的目錄為基準,流言簿資訊檔的檔案路徑位置-->
    <input TYPE=hidden name="CfgPath" value="
    guest.ini">

  4. 找到這一行:
    <!--你更改過後的管理畫面的檔案名稱-->
    <input type="hidden" name="AdmPage" value="
    myadm.htm">

  5. 找到這一行:
    <!--你的密碼-->
    <input type="hidden" name="Password" value="
    1234">
    密碼不需要背下來,它只是給系統確認用的而已。

如有需要請自行修改頁面中的超連結和圖片位置。基本安裝請勿修改。

 

※如果你還是不太懂,可以參考安裝範例

 

 

 

修改流言簿畫面
你可以自行修改流言簿的畫面或標題圖形,但你必須對 HTML 非常熟悉,並且注意修改設定參數中所提到的東西,以免修改到其他重要的部份,以致程式無法正確執行。

強烈建議在基本安裝時請勿修改,安裝完成運作沒有問題後,再自行修改。

 

 

 

常見錯誤 & 問題

請看小正正流言簿的 FAQ

 

 

特異功能

小正正的流言簿有許多特異的功能,可以讓你自行設定。這些特異功能的使用方法,請看小正正流言簿的特異功能使用說明

 

 

版本更新資訊

3.0 版

2.1 版

2.0 版

 

 

 

版權宣告

如果你要使用本流言簿程式,表示你完全同意下面的敘述。

你可以:

你不可以:

 

小正正將保留其他的權利。

 

 


(C) 版權所有 Alex Wang

Email: gaspy@ksts.seed.net.tw