www.pudn.com > rsSearch.zip > rsSearchDoc.htm, change:1998-11-19,size:16279b


<HTML> 
<HEAD> 
   <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=big5"> 
   <META NAME="Author" CONTENT="Fu Hung-ming"> 
   <TITLE>RedSnow HomePage rsSearch Readme</TITLE> 
<STYLE type="text/css"> 
<!-- 
A:link {font-size: 12pt; color: #0000FF; text-decoration: underline} 
A:visited {font-size: 12pt; color: #C000FF; text-decoration: underline} 
A:hover{color: #FF0000; text-decoration: underline} 
--> 
</STYLE> 
<SCRIPT LANGUAGE="JavaScript"> 
<!-- 
function nomsg(){ 
  self.status=""; 
} 
//--> 
</SCRIPT> 
 
</HEAD> 
<BODY TEXT="#000000" BGCOLOR="#E0FFFF" LINK="#0000FF" VLINK="#0080FF" ALINK="#FF0000"> 
  
<CENTER><TABLE BORDER WIDTH="240" BGCOLOR="#D0D0FF" > 
<TR> 
<TD ALIGN=CENTER WIDTH="100%" BGCOLOR="#D0D0FF"><FONT COLOR="#FF0000" FACE="Comic Sans MS"><FONT SIZE=+2>RS Site-Search</FONT></FONT></TD> 
</TR> 
</TABLE></CENTER> 
 
  
<UL>  
<LI><FONT COLOR="#FF0000">程式名稱:</FONT><FONT COLOR="#3333FF">RedSnow Utility - rsSearch (RS Site-Search)</FONT> 
 
<LI><FONT COLOR="#FF0000">版本編號:</FONT><FONT COLOR="#3333FF">RS 1.22 - 1998/11/07</FONT> 
 
<LI><FONT COLOR="#FF0000">原創設計:</FONT><FONT COLOR="#3333FF">Jason Anthony 1997/02/18</FONT> 
<LI><FONT COLOR="#FF0000">本版作者:</FONT><FONT COLOR="#3333FF">RedSnow WorkRoom - 傅鴻銘</FONT> 
 
<LI><FONT COLOR="#FF0000">版權宣告:</FONT> 
<BR><FONT COLOR="#3333FF">本程式為傅鴻銘之個人作品,rssearch.pl CGI 程式的部分係參考自 Jason Anthony 所寫 1.1e 版之 jasearch.pl 程式,希望使用本版的網友們能保留程式內有關原作者及本作者的相關資訊。</FONT> 
 
<LI><FONT COLOR="#FF0000">原作者相關資訊:</FONT> 
<BR><FONT COLOR="#3333FF"> 
<table border=0 CELLSPACING=0 cellpadding=0> 
<tr><td>Copyright 1997 Jason Anthony</td> 
<td>  <a href="mailto:janthony@aquapal.co.uk">janthony@aquapal.co.uk</a></td> 
</tr> 
<tr><td>Scripts Archive at:</td> 
<td>  <a href="http://www.aquapal.co.uk/jason.html">http://www.aquapal.co.uk/jason.html</a></td> 
</tr> 
</table> 
<BR> 
</FONT> 
</UL> 
 
<UL> 
<LI><FONT COLOR="#FF0000">本版作者聲明:</FONT> 
<BR><FONT COLOR="#3333FF">本 (RS 1.22) 版 SiteSearch 為傅鴻銘製作發行的免費共享軟體,任何人均可在不違反法律及不損害作者權益之前提下免費合法的使用於不涉及商業行為的個人網頁上,本聲明可視為作者對使用者的保障聲明,如有違犯下列事項者將不受本聲明之保障,作者並保留所有法律追訴權利:</FONT> 
<OL TYPE="SQUARE"> 
<LI><FONT COLOR="#009900">不得放置在有直接或間接行使商業或營利行為的網頁上使用,如有商業用途須取得作者授權。</FONT> 
<LI><FONT COLOR="#009900">未獲作者授權不得將本程式灌錄於販售之媒體上,亦不得販售本程式或隨販售物品贈予客戶。</FONT> 
<LI><FONT COLOR="#009900">不得修改或刪除 Perl 程式中原作者與本版作者宣告文字以及本說明檔案的內容。</FONT> 
<LI><FONT COLOR="#009900">符合本文件宣告與聲明的使用者,可依據個人及運作環境之所需對程式作適當修改而使用。</FONT> 
<LI><FONT COLOR="#009900">若有非營利行為的大量傳播行為或為教學使用時請以書面文件知會作者,作者無條件授予使用權利之書面文件。</FONT> 
<LI><FONT COLOR="#009900">作者歡迎有意願傳播本程式者將程式置於個人網頁上供他人下載使用,惟須知會作者並經作者同意,且傳播本程式時必須包含本說明文件檔,傳播者亦有義務讓被傳播對象了解作者聲明,以免被傳播者侵犯作者權益。</FONT> 
</OL> 
</UL> 
 
<UL> 
<LI><FONT COLOR="#FF0000">緣起:</FONT> 
<BR>作者在設計了數個 CGI 程式之後,對使用 Perl 來設計 CGI 程式已經有了相當的經驗,因此當紅雪網頁的內容越來越多,參觀的網友也增多時,我就開始考量如何才能使網友們在瀏覽時,能夠有一個方便的介面,因此我著手修改原先的多層次選單為單層固定式選單,避免參觀時有陷入迷宮的窘境,儘管如此,還是有網友會留言或寫信詢問一些在網頁上已經有的資訊,因此我興起了寫作搜尋引擎的想法,但是我對於這樣的動作是第一次嘗試,所以就先去尋找適當的範例來參考,結果找到了一大堆類似的程式,經過一一測試之後,覺得 Jason Anthony 所寫的 jasearch.pl 最符合我的需要,但是原程式的輸出資料過於簡單,不符合我的需要,於是開始動手修改成我理想中的搜尋引擎,就這樣我完成了 rsSearch.pl,使用了一段時間之後曾有網友向我索取本程式,但是因為尚未確認其功能都運作正常,這份說明文件也未能動手撰寫,所以就一直延宕下來了,現在經過一段時日的測試,尚未發現重大的缺失,因此利用了工作的空檔時間趕寫了本文件,並開放本程式的下載,希望對有相同需求的網友們能有所幫助。 
</UL> 
 
<UL> 
<LI><FONT COLOR="#FF0000">安裝 RS 1.22 版 SiteSearch:</FONT> 
<OL TYPE="SQUARE"> 
<LI>本程式的安裝很簡單,只要將 rsSearch.zip 解壓縮到任何一個目錄內。 
<LI>以瀏覽程式查看 rsSearchDoc.htm 檔,也就是和您現在所看的這個檔一樣的說明文件。 
<LI>RS 1.22 的網頁搜索程式構成的部分為:<font color="#0000FF">rssearch.pl</font> (搜尋主程式) 一個 Perl 程式,及 <font color="#0000FF">rsSearch.htm</font> (使用者介面檔) 一個 HTML 網頁檔案。 
<LI>利用文書處理程式對 <font color="#FF9000">rsSearch.htm</font> 檔作一些適當的修改與設定,然後將相關檔案 FTP 到網頁所屬的目錄內及設定適當的屬性就可以了,細部說明請閱讀下一段。 
</OL> 
</UL> 
 
<UL> 
<LI><FONT COLOR="#FF0000">使用 RS 1.22 版 SiteSearch 的方法:</FONT> 
<OL TYPE="SQUARE"> 
<LI><FONT COLOR="#FF0000">注意!</FONT><FONT COLOR="#C000FF">若無十足把握,請勿隨意更改 Perl 程式內容,如果程式修改不當,將容易造成程式不正常運作,網站系統也可能因此加重負擔。</FONT> 
<br><br> 
 
<LI><FONT COLOR="#C000FF">請先確定您在放置網頁的網站上有 CGI 的使用權,否則是無法使用本程式留言板的。</FONT> 
<br><br> 
 
<LI><FONT COLOR="#C000FF">rsSearch.htm 設定值說明:</FONT> 
<UL type="A"> 
<LI>BODY 段的 BACKGROUND="...." 設定為留言版面所使用的底圖。 
<LI>BODY 段的 BGCOLOR="...." 設定為留言版面所使用的底色。 
<LI>主要設定值一覽表:<br> 
<TABLE BORDER CELLSPACING=0 CELLPADDING=0 COLS=3 WIDTH="90%" > 
<TR BGCOLOR="#FFFFCC"> 
<TD ALIGN=CENTER WIDTH="90" BGCOLOR="#CCFFFF"><FONT COLOR="#009900">變數名稱</FONT></TD> 
<TD ALIGN=CENTER BGCOLOR="#CCFFFF"><FONT COLOR="#009900">功能說明</FONT></TD> 
<TD ALIGN=CENTER WIDTH="134" BGCOLOR="#CCFFFF"><FONT COLOR="#009900">設定值內容</FONT></TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">base</FONT></TD> 
<TD ALIGN=LEFT>欲搜尋資料的目錄位置。</TD> 
<TD ALIGN=CENTER>伺服主機真實路徑</TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">rbase</FONT></TD> 
<TD ALIGN=LEFT>欲搜尋資料的目錄位置。</TD> 
<TD ALIGN=CENTER>完整 HTTP 網址</TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">sv</FONT></TD> 
<TD ALIGN=LEFT>欲搜尋的文字字樣。</TD> 
<TD ALIGN=CENTER>中/英文字串,若有多個字樣需以空白字元區隔</TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">type</FONT></TD> 
<TD ALIGN=LEFT>設定搜尋多個關鍵字樣時,是找到其中任何一個(OR)關鍵字即顯示,或是必須含有(AND)全部的關鍵字才顯示。</TD> 
<TD ALIGN=CENTER>AND 或是 OR</TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">subdir</FONT></TD> 
<TD ALIGN=LEFT>設定搜尋時是否要包含次目錄,不設定(使用內定值)或是設為 YES 時,搜尋會包含次目錄內的資料。</TD> 
<TD ALIGN=CENTER>NO 或是 YES</TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">ext</FONT></TD> 
<TD ALIGN=LEFT>設定要做搜尋處理的檔案種類,本項可設定多個檔案類別,各個類別以分號區隔,例:"<font color="#FF0000">htm</font>;<font color="#FF0000">html</font>;<font color="#FF0000">txt</font>",若未設定本項參數則僅對 .htm 型態的檔案作搜尋比對的處理。</TD> 
<TD ALIGN=CENTER>副檔名</TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">log</FONT></TD> 
<TD ALIGN=LEFT>記錄檔的檔案名稱,若設定本項目,會將使用本程式的<font color="#FF0000">搜尋關鍵字樣</font>、<font color="#FF0000">搜尋的類別(AND/OR)</font>、<font color="#FF0000">時間</font>、<font color="#FF0000">使用者 IP 位址</font>,這四項資料記錄於指定的檔案中。<br>(<font color="#FF0000">本項所設定之檔案於第一搜尋資料時會自動建立</font>)</TD> 
<TD ALIGN=CENTER>完整文字檔案名稱</TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">background</FONT></TD> 
<TD ALIGN=LEFT>設定搜尋結果版面上端標示框欲顯示的背景圖檔。</TD> 
<TD ALIGN=CENTER>完整 HTTP 網址(或相對目錄)與圖檔名稱</TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">bgcolor</FONT></TD> 
<TD ALIGN=LEFT>設定搜尋結果版面上顯示的背景顏色。</TD> 
<TD ALIGN=CENTER>16 進位 RGB 值<br>#<font color="#FF0000">RR</font><font color="#009900">GG</font><font color="#0000FF">BB</font></TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">text</FONT></TD> 
<TD ALIGN=LEFT>設定搜尋結果版面上顯示的文字顏色。</TD> 
<TD ALIGN=CENTER>16 進位 RGB 值<br>#<font color="#FF0000">RR</font><font color="#009900">GG</font><font color="#0000FF">BB</font></TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">link</FONT></TD> 
<TD ALIGN=LEFT>設定搜尋結果版面上顯示的超連結文字顏色。</TD> 
<TD ALIGN=CENTER>16 進位 RGB 值<br>#<font color="#FF0000">RR</font><font color="#009900">GG</font><font color="#0000FF">BB</font></TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">alink</FONT></TD> 
<TD ALIGN=LEFT>設定搜尋結果版面上顯示的超連結文字顏色(點選連結項目時)。</TD> 
<TD ALIGN=CENTER>16 進位 RGB 值<br>#<font color="#FF0000">RR</font><font color="#009900">GG</font><font color="#0000FF">BB</font></TD> 
</TR> 
 
<TR> 
<TD ALIGN=CENTER VALIGN=CENTER BGCOLOR="#FFFFCC"><FONT COLOR="#FF6600">vlink</FONT></TD> 
<TD ALIGN=LEFT>設定搜尋結果版面上顯示的超連結文字顏色(已執行過連結的)。</TD> 
<TD ALIGN=CENTER>16 進位 RGB 值<br>#<font color="#FF0000">RR</font><font color="#009900">GG</font><font color="#0000FF">BB</font></TD> 
</TR> 
 
</TABLE> 
</UL> 
<BR> 
 
<LI><FONT COLOR="#C000FF">如果您不是 TacoCity 的居民,請您先查看您的網頁所屬站台的 Perl 程式宣告是否為 <font color="#FF0000">#!/usr/local/bin/perl</font>?如果不是的話,請將 rssearch.pl 程式中第一行的宣告做一適當的修改。</font> 
<BR><BR> 
 
<LI><FONT COLOR="#C000FF">接下來開始將留言板作個人化風格的修改與相關設定,首先修改 rsSearch.htm 這個使用者介面檔,修改 BODY 段的 BACKGROUND="...." 及 BGCOLOR="...." 這兩項參數為您喜歡的底圖及底色。</FONT> 
<br><br> 
 
<LI><FONT COLOR="#C000FF">其次找到 rsSearch.htm 檔案中下列 FORM 的位置,並修改 ACTION 的宣告敘述 (以 TacoCity 為例)</FONT>:<br> 
<FORM METHOD=POST ACTION="http://tacocity.com.tw/cgi-bin/cgiwrap/<font color="#FF0000">urid</font>/rssearch.pl"><br> 
<BR>將 <font color="#FF0000">urid</font> 字樣改成您自己的帳號名稱。 
 
<BR><BR> 
 
<LI><FONT COLOR="#C000FF">接下來找到並修改 rsSearch.htm 的主要設定值 (以 TacoCity 為例)</FONT>: 
<BR><input type=hidden name="<font color="#0090FF">base</font>"       value="<font color="#FF9000">/home/city1/<font color="#FF0000">urid</font>/www</font>"> 
<BR><input type=hidden name="<font color="#0090FF">rbase</font>"      value="<font color="#FF9000">http://tacocity.com.tw/<font color="#FF0000">urid</font></font>"> 
<BR><input type=hidden name="<font color="#0090FF">log</font>"        value="<font color="#FF9000">rssearch.log</font>"> 
<BR><input type=hidden name="<font color="#0090FF">background</font>" value="<font color="#009900">0005.jpg</font>"> 
<BR><input type=hidden name="<font color="#0090FF">bgcolor</font>"    value="<font color="#0000FF">#E0FFE0</font>"> 
<BR><input type=hidden name="<font color="#0090FF">text</font>"       value="<font color="#0000FF">#0000FF</font>"> 
 
<BR> 
<BR>修改說明: 
<OL type="A"> 
<LI>將 2 個 <font color="#FF0000">urid</font> 改成您自己的帳號名稱。 
<LI><font color="#0090FF">log</font> 這個參數的檔案名稱可以設成您喜歡使用的任何名稱,<font color="#FF0000">如果不想啟用本功能的話,可以省略本項目的設定</font>。 
<LI>將 <font color="#009900">0005.jpg</font> 改成搜尋結果版面上端標示框欲使用的背景圖檔。 
<LI>將 <font color="#0090FF">bgcolor</font> 參數的 <font color="#0000FF">#E0FFE0</font> 改成您的搜尋結果版面上想要使用的背景顏色,<font color="#FF0000">請注意不要忘了加上井字號</font>。 
<LI>將 <font color="#0090FF">text</font> 參數的 <font color="#0000FF">#0000FF</font> 改成您的搜尋結果版面上顯示文字想要使用的顏色,<font color="#FF0000">請注意不要忘了加上井字號</font>。 
<LI>如果您不希望在搜尋時包含次目錄的檔案在內,請多設定一項 <font color="#0090FF">subdir</font>,並將參數設為 <font color="#FF0000">no</font>。 
<LI>另外 <font color="#009900">link</font>、<font color="#009900">alink</font>、<font color="#009900">vlink</font> 三個參數,請視需要自行加上去,未設定的話,系統會以內定值來使用。 
<LI><font color="#0000FF">如果您曾經使用過原版本的 jasearch.pl,則相同名稱的變數均可將設定值直接套用。</font> 
</OL> 
 
<BR> 
 
<LI><FONT COLOR="#C000FF">記得要將 rsSearch.htm 檔案內的標題字樣改為您需要的字樣或圖徽。</FONT> 
 
<BR><BR> 
 
<LI><FONT COLOR="#FF0000">注意!</FONT><FONT COLOR="#C000FF">如果您是編修網頁的新手,您可以做最低程度的修改試著讓留言板先能運作,然後再加強之,最低程度的修改項目如下 (rsSearch.htm):</FONT> 
<OL TYPE="A"> 
<LI><font color="#0000FF"><FORM METHOD=POST ACTION="http://tacocity.com.tw/cgi-bin/cgiwrap/<font color="#FF0000">urid</font>/rssearch.pl"></font> 的宣告。 
<LI><font color="#FF9000">base</font>、<font color="#FF9000">rbase</font> 這兩個設定項。 
<LI>如果您的網頁所屬站台不是 TacoCity,請檢查 <font color="#FF9000">rssearch.pl</font> 檔案中第一行的 Perl 解譯器路徑及名稱的宣告是否相符? 
</OL> 
<BR> 
 
<LI><FONT COLOR="#FF0000">注意!</FONT><FONT COLOR="#C000FF">如果您有一些檔案不希望被本程式搜尋內容,可以在檔案的 HEAD 段設定一個 "<font color="#FF0000"><!--NOSEARCH--></font>" 的標籤字樣,本程式若檢查到檔案中有 "<font color="#FF0000">NOSEARCH</font>" 的字樣時,將會掠過不作搜尋比對的處理。</FONT> 
<BR><BR> 
 
<LI><FONT COLOR="#C000FF">將 CGI 程式 (<font color="#FF0000">rssearch.pl</font>)、使用者介面檔 (<font color="#FF0000">rsSearch.htm</font>),以 FTP 程式上載到網站上:</FONT> 
<font color="0000FF"> 
<br>千萬記得要使用 ASCII 模式上載喔! 
<br>rssearch.pl <font color="#FF0000">→</font> 您的帳號目錄內的 <font color="#009900">cgi-bin</font> 次目錄 
<br>rsSearch.htm <font color="#FF0000">→</font> 您的帳號根目錄或是其它次目錄 
<br><font color="#FF0000">(如果沒有上述的次目錄,請自行建立同名的次目錄)</font> 
</font> 
 
<br><br> 
 
<LI><FONT COLOR="#C000FF">更改相關檔案的屬性:</FONT> 
<br><font color="#0000FF">rssearch.pl</font> 屬性設為 <font color="#0000FF">700</font>。 
<br><font color="#0000FF">rsSearch.htm</font> 屬性設為 <font color="#0000FF">644</font>。 
<br><font color="#FF0000">注意:</font>某些站台的屬性要求有不一樣,應以各站台的規定為準。 
 
<br><br> 
 
</OL> 
</UL> 
 
<UL> 
<LI><FONT COLOR="#FF0000">其它事項:</FONT> 
<OL> 
<LI>本程式參考自 Jason Anthony 所寫 1.1e 版之 jasearch.pl 程式,為了與原程式有所區別,本版程式名稱取為 rssearch.pl,在此作一說明。 
<LI>使用本程式需在 Web Server 的 <font color="#0000FF">CGI</font> 能提供正常服務時,才能發揮適切的作用,如果 CGI 不能運作,本留言版程式亦無法動彈。 
<LI>如果您想讓更多的網友能享用本程式,作者十分歡迎您連結到紅雪網頁來。 
<LI>如果您對本程式或說明文件有任何意見或想給作者一點鼓勵,歡迎您到作者網頁留言或來信指教。 
<LI>RS 網頁搜尋程式版面上留有原程式名稱、版本及網頁連結的標示,作者並不強制要求該標示一定要擺在版面上,但是希望能在適當頁面標示類似訊息並設連結,讓更多的人知道本程式並可以使用它,以下連結供您參考:<br> 
<font color="#006600"> 
<a href="http://tacocity.com.tw/redsnow/index.htm"><font face="Comic Sans MS" size=3><b>RedSnow HomePage Free Web Tools - </b><font color="#0000FF"><i>rsSearch 1.22</i></font></font></a><br> 
<a href="http://tacocity.com.tw/redsnow/index.htm"><font face="Comic Sans MS" size=3><br> 
<b>RedSnow HomePage Free Web Tools - </b><br> 
<font color="#0000FF"><i>rsSearch 1.22</i></font></font></a> 
</font> 
 
</OL> 
</UL> 
 
<BR> 
<font face="Comic Sans MS"> 
<P> 聯絡作者:<A HREF="mailto:redsnow@pemail.net" onmouseover="window.status='作者的主要聯絡信箱'; return true;" onMouseOut="nomsg();return true">redsnow@pemail.net</A> <A HREF="mailto:redsnow@SoftHome.net" onmouseover="window.status='作者的備用聯絡信箱'; return true;" onMouseOut="nomsg();return true">redsnow@SoftHome.net</A> 
 
<P> 作者網頁:<A HREF="http://tacocity.com.tw/redsnow/index.htm" onmouseover="window.status='紅雪網頁的首頁'; return true;" onMouseOut="nomsg();return true">http://tacocity.com.tw/redsnow/index.htm</A> 
<BR> 
<BR> 
 
<P> 本文撰寫於中華民國87年11月01日 修改於中華民國87年11月09日 
</font> 
<BR><BR> 
</font> 
</BODY> 
</HTML>