|
•前言…
本CGI程式為免費軟體，但不表示作者放棄著作權。
因此在使用時請務必遵守使用規定。
•My Diary 簡介
本CGI主要是用來撰寫日記之用。
（拿來用作其他用途也不大方便就是。）
跟舊版本比起來，本版本不止格式大幅變更，設置的難度也降低了許多。
不過因為中文版直接使用新版本，因此在此並不贅述。
•著作權宣告
My Diary 是由數位朋友所共同完成的。
以下便詳細記述著作權之歸屬。
•CGI Script(xxxxx.cgi)之著作權
著作權為「じゃわ＠中澤重人」所有。
即使已經針對程式進行任何修改，亦不會將著作權轉讓給其他人。
不過只要註明著作權所有人，便可以任意散佈本程式或予以修改。
•中文化版本之著作權
中文化版本為哈泥蛙所製作。
中文化之進行以及成品發佈均已經過原作者じゃわ＠中澤重人同意。
如果使用者針對中文化後之版本進行修改，仍請保留相關之中文化作者宣告。
除此之外一切使用規定均與原作者相同。
•GIF圖像(xxxxx.gif)之著作權
所有的GIF圖像均使用網友牛飼い的作品。
因此圖像著作權當然為網友牛飼い所有。
牛飼いとアイコンの部屋 http://www.ushikai.com/
重要宣告
本GIF圖像是不能隨意散佈的。
若要將本CGI另外發佈，請務必向牛飼い網友重新獲得使用許可。
如果要使用在 My Diary 程式之外的地方，也請前往牛飼い網友的網站詳讀使用條件。
另外如果想要自行使用不同的圖像，請參照文中「關於圖像的注意事項」。
•設置方法
第一次設定，或是不知道如何設定的網友，可以前往原作者網頁 CGI-StaTion 中之 "初めてのＣＧＩ設置講座" 。
以下僅能進行簡單的說明…(^_^;;
•各檔案之簡單說明
解開 diary.zip 之後，請確認裡頭包含以下檔案。
readme.htm ... 本檔案 layout.htm ... 補充說明用檔案 diary.cgi ... CGI程式 diary.log ... 記錄檔 ame.gif ... 天氣用圖像檔案(ushikai) hare.gif ... 天氣用圖像檔案(ushikai) kumori.gif ... 天氣用圖像檔案(ushikai) taifu.gif ... 天氣用圖像檔案(ushikai) yuki.gif ... 天氣用圖像檔案(ushikai) diaryback.gif... 背景圖像用檔案(free) jcode.pl ... 日文轉換用函式庫(Kazumasa Utashiro)
•設定執行路徑
總之先設定執行路徑（設定執行路徑是必要的）。
用記事本之類的文書編輯軟體打開 diary.cgi 吧！
第一行的 #!/usr/local/bin/perl 請務必確認是否正確。
1|#!/usr/local/bin/perl 2| 3|#| XXXXX Version x.xx 4|#| This script is free. |
這裡雖然已經寫好 Perl 路徑設定，不過不同的伺服器可能會有不同路徑，請務必確認是否正確。(^_^;
•以FTP上傳檔案
一般來說，只要將解開的檔案上傳至同一子目錄即可。
（除非使用之伺服器有所指定才需變更）
jcode.pl 雖然是日文轉碼用檔案，但仍請務必上傳。
另外各檔案之上傳格式跟存取權限請參照下表。
readme.htm ... 不需上傳，最好也不要上傳。 layout.htm ... 同上。 diary.cgi ... 以ASCII模式上傳，權限設為[755]。 diary.log ... 以ASCII模式上傳，權限設為[666]。 ame.gif ... 以BINARY模式上傳，權限設為[644]。 hare.gif ... 以BINARY模式上傳，權限設為[644]。 kumori.gif ... 以BINARY模式上傳，權限設為[644]。 taifu.gif ... 以BINARY模式上傳，權限設為[644]。 yuki.gif ... 以BINARY模式上傳，權限設為[644]。 diaryback.gif... 以BINARY模式上傳，權限設為[644]。 jcode.pl ... 以ASCII模式上傳，權限設為[755]。•以瀏覽器進行確認
上傳完成之後請以瀏覽器進行確認，直接呼叫 diary.cgi 所在路徑以確定是否能正常執行。
將來日記的所在路徑便是 diary.cgi 的URL位置。
有沒有正常顯示出畫面呢？
如果出現問題的話，就看看下面的「問題處理」部分吧！（一般來說生手大概會有八成的機率失敗，哈泥蛙在進行測試時也吃了不少苦頭=_=）
•問題處理
如果按照以上所說進行設定，但仍然會發生問題的話（如出現ERROR或是出現亂碼等等），請各位自行參考網路上相關之CGI設定解說，或是前往原作者的網頁CGI-StaTion，裡頭將會有比較詳細的說明（不過是日文）。
原則上哈泥蛙不受理任何相關的詢問（包含寄信或是留言），敬請見諒。
•個人設定
※ diary.cgi之個人設定
請以文書編輯軟體開啟diary.cgi。
其中將有以下的幾個部分可進行個人設定。
點選藍色部分便可以檢視細部說明。
左方的數字代表所在的位置行數。
30|# ---------------------------------------------------------- 31|# 日記管理者（就是你）的資料。 32|# ---------------------------------------------------------- 33| 34|$admin_name = '管理人'; # 請寫入你的名字 35|$admin_email = 'mail@mail.com'; # 你的Email 36|$master = 'password'; # 管理用密碼設定 37| 38|# ---------------------------------------------------------- 39|# 本日記之個人設定項目。 30|# ---------------------------------------------------------- 41| 42|$diary_title = "My Diary"; # 日記頁面標題（不可使用語法標籤） 43|$body_text = '#000000'; # <BODY>標籤之設定 44|$body_link = '#0000FF'; # 連結顏色 45|$body_alink = '#0000DD'; # 按下連結時的顏色 46|$body_vlink = '#FF0000'; # 已去過連結的顏色 47|$body_bgcolor = '#FFFFFF'; # 背景顏色 48|$body_back = 'diaryback.gif'; # 背景圖像 49| 50|$back_url = "http://www.xxxxx.com.tw/~homepage/"; 51| # 主頁URL（建議使用絕對URL） 52|$image_url = "."; 53| # 圖像所在URL（建議使用絕對URL） 54| 55|$title_color = '#0000FF'; # 日記標題之顏色 56|$title_bgcolor = '#FFEEEE'; # 日記標題之背景色 57|$title_brcolor = '#000000'; # 日記邊框顏色 58|$msg_bgcolor = '#FFFCFC'; # 日記內容之背景色 59|$date_color = '#FF0000'; # 日期之顏色 60| 61|$youbi[0] = "Sun"; # 星期之設定 62|$youbi[1] = "Mon"; 63|$youbi[2] = "Tue"; 64|$youbi[3] = "Wed"; 65|$youbi[4] = "Thu"; 66|$youbi[5] = "Fri"; 67|$youbi[6] = "Sat"; 68| 69|# -------------------- # 天氣用圖像檔案 70| 不變更的話就不用修改 71| 72|$tenki_gif[0] = "hare.gif"; $tenki_name[0] = "晴天"; 73|$tenki_gif[1] = "kumori.gif"; $tenki_name[1] = "陰天"; 74|$tenki_gif[2] = "ame.gif"; $tenki_name[2] = "雨天"; 75|$tenki_gif[3] = "taifu.gif"; $tenki_name[3] = "颱風"; 76|$tenki_gif[4] = "yuki.gif"; $tenki_name[4] = "下雪"; 78| 78|$html_layout = 0; # HTML輸出格式變更 (0 - 1) 79|$page_layout = 0; # PAGE輸出格式變更 (0 - 1) 80|$tenki_flag = 1; # 天氣圖像表示 (0:否 1:是) 81|$page = 30; # 每一頁顯示的日記天數 82| # (PAGE輸出格式為 0 時才有效) 83|$admin_enter = 2; # 管理者用入口之位置 84| 85|$max_size = 1024 * 99; # 登錄最大byte數 (1Kbyte = 1024byte) 86|$end_date = 0; # 日期是否要延遲十二小時 (0:否 1:是) 87| 88|# -------------------- # 以下為檔案處理相關的設定，原則上不需變更 89| 90|$method = 'POST'; # METHOD設定('POST' or 'GET') 91|$tz = "CST-8"; # 時區 92|#$cashe = 1; #（未使用） 93|$cginame = './diary.cgi'; # 本CGI之檔名 94|$jcode = './jcode.pl'; # jcode.pl位置 95|$logfile = './diary.log'; # 記錄用檔案名 96|$savetype = 0; # 日記記錄方式 0:標準 1:Temp利用 97|$lock1 = './diary1.lock'; # 鎖定用檔案(1) 98|$lock2 = './diary2.lock'; # 鎖定用檔案(2) 99|$lock_flag = 1; # 鎖定用檔案 1:使用 0:不使用 100|$htmldir = './'; # 過去記錄自動匯出之路徑 101|$htmldir_url = './'; # 過去記錄自動匯出之URL 102|$htmldir_flag = 0; # 過去記錄自動匯出為HTML功能 1:使用 0:不使用 |
除此之外，以下的部分也是可以修改的。
•想更改日記的標題。
•想使用JavaScript或CSS語法。
•我必須在程式中加入廣告。
請寫入你的名字:$admin_name = '∼';
請將日記管理者（就是你）的名字寫在這裡。
請將∼的部分取代成為你的名字。
<< 返回
你的Email:$admin_email = '∼';
請將日記管理者（就是你）的Email寫在這裡。
請將∼的部分取代成為你的Email。
<< 返回
管理用密碼設定:$master = '∼'; （極重要！）
本密碼為進入日記撰寫模式時使用的。
請務必改成其他英數半形8個字以內的密碼。
使用本密碼將可以修改或刪除之前的日記。
請將∼的部分取代成為你的登入密碼。
<< 返回
日記頁面標題:$diary_title = '∼';
顯示在瀏覽器上面的日記標題。
在這裡使用語法標籤是無意義的，請勿使用。
想知道如何更改日記內文的標題，請到這裡。
請將∼的部分取代成為適當內容。
<< 返回
<BODY>標籤之設定:$body_xxxxx = '∼';
此為<BODY>標籤之設定。
可以設定基本的配色跟背景圖像。
$body_text = '#000000'; 為日記內文的顏色。
$body_link = '#0000FF'; 為日記中之連結所顯示的顏色。
$body_alink = '#0000DD'; 為按下日記中之連結時所顯示的顏色。
$body_vlink = '#FF0000'; 為已經到訪過之連結的顏色。
$body_bgcolor = '#F4F4E5'; 為頁面背景色。
$body_back = 'diaryback.gif'; 為所指定的背景圖像。
請分別將∼的部分取代成為適當內容。
<< 返回
主頁URL:$back_url = '∼';
離開日記時要返回的網頁路徑。
請以絕對路徑（http://∼的URL）進行設定。
請將∼的部分取代成為適當內容。
<< 返回
圖像所在URL:$image_url = '∼';
設定圖像所在之路徑。
一般來說如果使用內建圖像的話不需要特別更改。
如果真的無法顯示，請改為使用絕對路徑（http://∼的URL）進行設定。
例如「hare.gif」這張圖的位置在
http://www.xxxxx.com.tw/~homepage/diary/hare.gif
則請去掉「hare.gif」這幾個字，然後設定路徑為
http://www.xxxxx.com.tw/~homepage/diary/
換句話說就是：
$image_url = 'http://www.xxxxx.com.tw/~homepage/diary/';
請將∼的部分取代成為適當內容。
<< 返回
顏色指定:$xxxxxx_color = '∼';
這裡可以指定日記中各部分的顏色。
$title_color 為日記每天標題的顏色，預設為 ■[#0000FF]。
$title_bgcolor 為日記標題之背景色，預設為 ■[#FFEEEE]。
$title_brcolor 為日記邊框顏色，預設為 ■[#AA9999]。
$msg_bgcolor 為日記內容之背景色，預設為 ■[#FFFCFC]。
$date_color 為日期之顏色，預設為 ■[#FF0000]。
|
xx/xx/xx(xxx)
請分別將∼的部分取代成為適當內容。
<< 返回
星期之設定:$youbi[n] = '∼';
此為星期之設定。
從上而下為星期日、一、二……直到星期六。
要改成其他的寫法也可以。
（例如換掉英文改成日文或中文。）
請分別將∼的部分取代成為適當內容。
<< 返回
天氣用圖像檔案:$tenki_gif[n] = '∼'; $tenki_name[n] = '∼';
天氣用圖像檔案可以隨意變更、增加或刪除。
天氣用圖像檔案的數量並沒有特別的限制，不過多起來也是很麻煩的。
只要在$tenki_gif 寫入檔案名、$tenki_name 寫入代表的天氣種類就可以了。
設定時有一個地方要注意，那就是n 需要寫入的數字。
這個數字必須從 0 開始依序以整數寫入而且不能中斷，例如不能故意跳過 3 而寫成0,1,2,4,5 等等。
另外相同數字的 $tenki_gif 跟 $tenki_name 是一組的。
以下便是最簡單的例子。
☆ 要增加新圖像的話↓ $tenki_gif[0] = "hare.gif"; $tenki_name[0] = "晴天"; $tenki_gif[1] = "kumori.gif"; $tenki_name[1] = "陰天"; $tenki_gif[2] = "ame.gif"; $tenki_name[2] = "雨天"; $tenki_gif[3] = "taifu.gif"; $tenki_name[3] = "颱風"; $tenki_gif[4] = "yuki.gif"; $tenki_name[4] = "下雪"; $tenki_gif[5] = "xxxxx.gif"; $tenki_name[5] = "∼"; 只要如同上例將 n 從 5 開始增加就可以了。要繼續增加就是接著使用 6,7,8,…這樣。 ☆ 要刪除舊有的圖像↓ 例如要刪除 n 代表 2 的圖像： $tenki_gif[0] = "hare.gif"; $tenki_name[0] = "晴天"; $tenki_gif[1] = "kumori.gif"; $tenki_name[1] = "陰天";其實，只要n 的部分有按照順序就可以了。$tenki_gif[2] = "ame.gif"; $tenki_name[2] = "雨天";$tenki_gif[3] = "taifu.gif"; $tenki_name[3] = "颱風"; $tenki_gif[4] = "yuki.gif"; $tenki_name[4] = "下雪"; 上例將會導致顯示的問題（只有 0,1,3,4 而沒有 2 ），所以必須修正成： $tenki_gif[0] = "hare.gif"; $tenki_name[0] = "晴天"; $tenki_gif[1] = "kumori.gif"; $tenki_name[1] = "陰天"; $tenki_gif[2] = "taifu.gif"; $tenki_name[2] = "颱風"; $tenki_gif[3] = "yuki.gif"; $tenki_name[3] = "下雪"; 要把 3 改成 2 、把 4 改成 3 ，或是直接把 4 改成 2 。
另外要更改圖像所在路徑的話，請前往設定圖像所在之路徑進行修改。
至於要使用自己所準備的圖像，則請務必詳讀「圖像使用注意事項」。
請分別將n 與 ∼ 的部分取代成為適當內容。
<< 返回
顯示格式設定
關於顯示格式設定，請參考layout.htm。
本參數可以更改顯示格式的設定。
<< 返回
設定登錄最大byte數:$max_size = 1024 * n;
日記寫久了，記錄內容自然就會變得很多。
如果實在是太多了將會導致系統不穩，因此必須稍微做個限制。
MyDiary 可以指定登錄最大byte數。
寫這樣可能很難懂，不過簡單的說就是「限制字數」的意思（大概…）
基本上使用 1024 * n 的方式來設定。
而預設值為 1024 * 99 ，也就是可以寫入 99KByte 的內容。
這個設定值會反映在日記編輯模式裡，因此隨時都可以進行確認。
請在n 的部分指定數字大小。
<< 返回
時間延遲之設定:$end_date = n;
將CGI的設定時間延遲十二個小時，舉例來說，一號中午∼二號中午都算是一號。
如果常常會在凌晨才寫前一天日記的人，或許設定成 $end_date = 1;會比較方便。
請將n 的部分設定為0或1。
<< 返回
METHOD 設定:$method = '∼';
有些ISP會指定使用者設定為 METHOD=GET
所以若有需要的話便請把「POST」更改成「GET」。
請將∼的部分取代成為適當內容。
<< 返回
時區設定:$tz = '∼';
預設值已更改為台灣時間。
如果您所在的時區不同，請自行至其他網站參考時區寫法。
請將∼的部分取代成為適當內容。
<< 返回
快取檔案設定:$cashe = n;
此版本已經停止使用。
<< 返回
本CGI之檔名:$cginame = '∼';
請輸入本CGI之檔名。
只有在ISP要求更改檔名時才需更改本參數。（例如須把：xxxxx.cgi 改為 xxxxx.pl）
一般來說本參數不需更改。
請將∼的部分取代成為適當內容。
<< 返回
jcode.pl所在位置:$jcode = '∼';
指定jcode.pl（日文轉換用函式庫）的所在位置。
本CGI雖已經中文化成功，但這個函式庫仍然是必須的，因此請務必一起上傳，原則上本參數不需更改。
請將∼的部分取代成為適當內容。
<< 返回
記錄用檔案:$logfile = '∼';
指定記錄用檔案名，一般來說並不需要修改。
請將∼的部分取代成為適當內容。
<< 返回
日記記錄方式:$savetype = n;
指定記錄用檔案的記錄方式。
「0:標準」是基本的記錄方式，所有的ISP都能對應，因此設為預設值。
「1:Temp利用」因為要使用到 chmod 指令，因此有些ISP無法使用。
不過相對於標準模式檔案比較不會消失，因此擔心記錄檔會被砍的話可以嘗試看看。
例如在 Biglobe，只要設定「1:Temp利用」之後記錄檔幾乎永遠存在。
請將n 的部分指定為0 或 1 。
<< 返回
鎖定用檔案:$lock1,$lock2 = '∼';
指定鎖定用檔案的所在路徑。
鎖定用檔案會自動產生及刪除，因此一般來說不需要特地設定路徑。
請將∼的部分取代成為適當內容。
<< 返回
鎖定用檔案之使用:$lock_flag = n;
決定是否要使用鎖定用檔案。
如果ISP使用的伺服器平台為 WinNT 的話最好關閉。
不過一般來說是不需要變更的。
請將n 的部分指定為0 或 1 。
<< 返回
過去記錄匯出為HTML之功能
本功能可以將過去記錄匯出為HTML格式。
預設值並不使用本功能。
開啟本功能的話，將會自動產生 kako.html、wdxxxxxx.html 等檔案。
匯出的HTML格式之記錄檔將永遠留存。
在某些ISP主機上可能會不好設定，因此請慎重處理。
另外在某些主機上，有可能會因為安全性的因素而無法使用。
請在 $htmldir = '∼'; 的 ∼ 部分取代成為適當內容。
請在 $htmldir_url = '∼'; 的 ∼ 部分設定為 HTML文章匯出時的ＵＲＬ路徑。（也可以設成http://∼的絕對路徑）
預設值為設置 MyDiary 的子目錄。
設定的子目錄請記得開啟CGI寫入的權限。
（一般來說權限應設為700或777，不過如果ISP不允許的話便無法使用本功能。）
請在設定完成之後，將 $htmldir_flag = 0; 更改為 $htmldir_flag = 1; 。
雖然記錄匯出功能很方便，不過設定上有點麻煩，而且有些ISP是無法提供本功能的。
<< 返回
自用HTML之撰寫:$html_xxxxxx=<<"_EOF_";
使用者可以自由更改日記檔頭，或是增加 JavaScript、CSS或是廣告BANNER等等。
撰寫時直接使用HTML原始碼即可。
（不過像是 $ 或 @ 等特殊符號必須更改為 \$ 及 \@ 等等…）
# -------------------- # 標題部分的HTML內文 $html_title=<<"_EOF_"; <BR> <CENTER> <HR SIZE=1 NOSHADE WIDTH=75%> <TT><FONT COLOR="#008800"> ☆<BIG>★</BIG>☆∼<B><BIG>My Diary</BIG></B>∼☆<BIG>★</BIG>☆ </FONT></TT> </FONT> <HR SIZE=1 NOSHADE WIDTH=75%> </CENTER> <BR> _EOF_ # ↑ _EOF_這幾個字請務必留著！ |
請針對顏色不同的部分進行必要的修改。
（換句話說千萬不要改掉 _EOF_ 的部分！）
<< 返回
•關於圖像使用的注意事項
如果不使用 MyDiary 內建之牛飼い網友製作的圖像，為了防止誤會必須改寫著作權相關的部分。
在個人設定的部分最後為以下所示：
# ------------------------------------------ #
# (警告) 以下為著作權相關的部分。(警告) #
# 請仔細閱讀readme.htm。 #
# ------------------------------------------ #
$image_auther_url = "http://www.ushikai.com/"; # 圖像作者之URL (若有引用請尊重原作者)
$image_auther = "牛飼い"; # 圖像作者名 (若有引用請尊重原作者)
|
請在顏色不同的部分清楚註明著作權及原作者網頁。
•使用本CGI之注意事項
在一開始便有提到，本CGI程式雖為免費軟體，但不表示作者放棄著作權。
所有使用本中文化CGI者均有義務在頁面中顯示以下文字：
原作：じゃわ
中文化：哈泥蛙
如果更改本部分或是予以刪除，原作者有權力禁止您的使用甚至提出告訴。
•原作者的話…
要完成這個CGI可說是耗費了相當大的勞力跟資金（是真的…）
所以請在享受本程式之餘遵守以上的規定。
雖然本CGI程式是免費軟體，不過能獲得大家的贊助當然更好了(^_^)/
有意贊助原作者的朋友，請使用日本的郵局匯款（金額請在日幣1000∼3000之內）。
贊助絕對沒有強迫性，畢竟本程式本來就是為了大家而免費散佈的。
贊助的金錢主要會用在支付電話費上，因為日本的學生宿舍電話沒有減價時段…(>_<)
|
最後感謝各位下載本程式。
之後也請對我的網頁多多指教。
•中文化作者的話…
本程式的中文化包含以下作業：
1.內文中文化。
2.顯示編碼、時區調整為台灣區設定。
3.更正因為jcode.pl而導致的編碼錯誤。
原本這個程式只是為了自己使用而中文化的。
不料獲得相當多朋友的好評，並且紛紛詢問本程式的來源出處。
基於好東西共享的原則，所以哈泥蛙抽出一些時間將本程式徹底中文化並釋出。
各位要使用本程式當然是免費的，但正如前面所說，請務必保留著作權宣告部分。
如果有其他網站希望能收集本程式提供他人下載，也請記得註明相關著作權。
贊助？唉，再說吧，反正網路還不就是這麼一回事……
不過如果能告知您使用本程式的位置，或是其他站長所提供轉載的地點，哈泥蛙就很高興了……^_^；