annecho Ver0.97 (行事曆) 中文化二版 by 驚直 [2001.1.27]

　　　　★ 第一次架設的朋友請捲到下面看一看設置注意事項．謝謝 ★

───▼特別注意▼──────────────────────────────

由於本程式改版後加入了一個新的欄位「記事摘要」，記事記錄檔格式跟原版並不相同。
如果你現在有使用其他中文化版本的annecho ，請勿嘗試以本程式覆蓋舊程式「升級」，
否則程式執行時會有不可預期的後果。正確做法是使用零位元組的記錄檔，重新安裝好。
(首次架設者毋須理會此段訊息)

───【版本更新異動】────────────────────────────

2001.01.27 / Ver0.97 中文二版．有點小差(這次不干原作者的事) ... 很抱歉 m(_ _)m
　☆主要修正了兩個臭蟲，是在「不使用行事曆標題圖檔」時才發現的。
　．在沒有預設文字色時所有文字變綠色，因為我把$tcolor跟$textcolor搞混了！
　　已安裝好不欲更新者，請搜尋第一個"$tcolor"將它改為"$textcolor"即可。
　．不使用標題圖檔時，文字標題變得很小，因為把$pt_mini跟$pt_title搞混了！
　　已安裝好不欲更新者，請搜尋第二個"$titlelogo"附近應該有秀出標題的地方，
　　(大約第306行) 將$pt_mini改為$pt_title即可。
　．當然又修正＆改寫了一些不起眼的註解部份^^;

2001.01.22 / Ver0.97 中文版．驚直翻的首個中文化版出來囉！^^;

───【有的沒的】──────────────────────────────

我的心願是將最好的東西，跟最好的朋友一起分享。

已經是第六件公開發表的ＣＧＩ中文化作品囉。這是繼I-BOARD/LR留言板之後，另一個
因為架設ＴＹ網站而特別製作的中文化程式。而這個程式給我的感覺是，特別適合架設
在公益團體或學校網站來發揮程式的優點。為啥？就是因為它叫作「行事曆」。除非你
經常有很多計劃、工作要記錄下來，或是作為網站建設的「進度表」，否則這個行事曆
程式真的不大適合用於個人網站裡面。 在happychan中文版讀我檔案裡面弟就有提到，
「過去的日子」是比較適合寫在 happychan紀念冊，因為通常別人都不會把行事曆「翻
查舊賬」，而且假如要在annecho 登錄自己的生日，每次只會登錄在其中的一年，要在
每個年份都登錄一次，顯得沒啥意思。不過我跟你說，把annecho 改成一個「節日表」
也是一個不錯的想法啦！^^;

※請注意：本程式不能夠用作商業用途。

　▼小小的要求
　　如果你想要跟我交換連結，我可是非常歡迎。但我希望大家不要把我的站站說成是
　　「CGI 下載站」之類什麼的，造成別人誤會，我的站站不是一個「資源網站」ㄚ！
　　假如你這樣做是希望我開發更多中文化程式，或者提高敝站的瀏覽人次，那我惟有
　　謝謝你的好意，而我卻是窩在心裡說不喜歡。請大家以後把我的站站分類作「個人
　　網站」或者「推薦好站」就已經很足夠了。拜託！

　▼中文化心得
　　偷偷滴向大家推薦一下EditPlus這個純文字編輯器。偶中文化這個CGI時 都是靠它
　　來幫助完成的。覺得自己有點不忠，因為自己本來就是EmEditor的長期支持者咩！
　　最近發現EditPlus居然有更多比EmEditor優勝的地方，害我靜悄悄的把一些原本
　　關聯給EmEditor都改了給EditPlus。總之兩者都顯的很卡哇伊，功能滿豐富的^_^;
　　　　EditPlus的網站 → http://www.editplus.com/  (韓國人開發的)
　　　　EmEditor的網站 → http://www.emurasoft.com/ (日本人開發的)

───【功能介紹】──────────────────────────────

Tacky寫的annecho行事曆程式是以日曆表格的方式來顯示出某個月份的重要記事，跟
其他同類記事程式顯得有點兒「與別不同」，又有別於寫日記的tackynote。

現簡介其主要功能如下：

　★　除了日曆上方的按鈕可以向前向後顯示不同月份，下方的選單還可以跳到任何
　　　一個年份和月份的組合；無論跳到哪一個月份，日曆底下的記事列表都會顯示
　　　對應月份的記事內容。

　★　按下去「顯示程式保存的所有記事記錄」按鈕，即可檢視全部已寫入的記事內容。

　★　提供記事記錄下載功能(目前月份或所有記錄)，讓使用者可以離線閱讀。

　★　應用COOKIE技術，讓記事者不用每次都要輸入相同的個人資料。

　★　寫入記事者可以透過輸入記事編號及密碼自行管理記事記錄(編輯或刪除)，一旦
　　　寫錯了便可以自己進去編輯，毋須麻煩管理者親自修改。這好處對於一個由多人
　　　管理＆編輯(例如班會網站、教會網站等)的行事曆程式尤其顯著。當然，管理者
　　　亦可以使用「萬用密碼」來處理所有記事記錄。

　★　支援HTML語法的輸入，可以在「記事摘要」及「記事內容」兩個欄位貼圖貼連結。

　★　記事內容自動連結功能，只要出現"http://"的字串即會轉換成"LINK HERE"連結。

　★　可設定禁止來自某個網域的使用者寫入資料；可設定記事內容最高字元數。

　★　如果你不想讓使用者胡亂塗鴉行事曆，而想自己全權管理的話，只要把 $form_flg
　　　設為"2" 即可將輸入表單完全隱藏起來，只有你以秘密連結來進入直接編輯的輸入
　　　表單才能夠寫入記事資料。(秘密連結方法見下面設置注意事項第7項)

───【中文版新增及變動功能】────────────────────────

除了把所有的日文完完全全的翻成中文、一絲不苟＆盡量追求完美以外，小弟還著實
花了不少時間在增刪功能、修改版面的工作上，事實上要比日翻中所花的還要多！@@

以下是我根據日本語＆國文在語言、地域、文化等差異而作的修改：
　．刪除jcode(轉換日文漢字)部份
　．改用中國及台灣的時區(CST-8)
　．改用中文長寫式星期制
　．將日期格式改為YYYY/M/D，月日不前置零或空白
　．秀出來的HTML加入繁體中文語系標籤
　．半形逗號(,)重現眼前
　．「隱形連結」變成 LINK HERE
　．自己做了一套新的圖檔，包括標題圖檔、連結圖檔及日曆上方顯示的三個按鈕圖檔
　．將日本假期改為台灣假期，並加入香港假期作為參考，方便兩地的用家
　　(為了要把假期準確加進去，曾經到訪過台灣行政院＆香港特區政府的網站找資料:p)
　．把日本「可計算非固定假期」的部份改作參考用途

以下是我根據自己的個人喜好、原程式缺陷及錯漏等緣故而作的修改：（☆＝主要修改）
　．新增一個img資料夾用來存放程式圖檔。
☆☆將原有的假期矩陣改為兩個分別設定屬於固定假期(@fixholiday)與及非固定假期
　　(@holiday)的矩陣，主要是因為港台兩地有很多假期是使用農曆計算，分列矩陣
　　後在非固定假期加入年份作為對照條件，避免「每年中秋可會是同一天」的問題。
　．加入「滑鼠經過時的連結顏色」設定值($hovercolor)
　☆修正原程式遺漏的「整體字形大小」設定值($pt)
　☆加入「微縮字形大小」設定值($pt_mini)，主要套用於日曆裡面的文字
　．加入其他自定字形大小的設定值($pt_title等)
　☆加入英文專屬字形集($e_font)，讓英數文字顯示出來更好看！
　．在線上及離線閱讀頁面分別加入CSS樣式表
　☆把原本的CSS樣式表分拆成分別屬於輸入欄位、按鈕及下拉選單，然後再按中英文
　　差別換成五張不同的樣式表，並清楚註明套用的地方。
　　(詳見$css_style,$css_style_e,$css_button,$css_select,$css_select_e的設定)
　．加入大量顏色設定值，讓管理者可以更彈性地修改日曆及記事列表等表格的顏色
　．可自定三類別的「日數顏色」，包括星期日及特別假期($cal_holiday)、
　　星期六($cal_saturday)及星期一至五非假期($cal_mon2fri)
　☆改變原版只可使用正方形方格來顯示日曆，新修改現在可使用闊度跟高度不一的
　　長方形方格顯示日曆($calsize_w,$calsize_h)
　☆加入「行事曆內今天所在的背景顏色」設定值($caltodaycolor)，另加粗體字顯示，
　　讓使用者能夠一眼便看得出來「今天」是位於日曆上的哪個位置！：Ｄ
　☆在適當的頁面加上「返回日曆模式」的連結，令使用者不致無所適從
　☆當目標月份或程式根本沒有記錄時，顯示「沒有列出記錄」的訊息
☆☆新增「記事摘要」欄位，比原日文版在日曆顯示出來的是記事者的名字更有意思；
　　另外在記事列表上又可以作為該項記事的「簡單標題」
　☆記事列表的資訊列上改為可以選擇用圖檔連結記事者的電子郵箱＆個人網站
　　(參考$maillinklogo及$homelinklogo的設定)
　．加入「顯示記事者的HOST位址」功能(見$hostflag設定)
　．查閱記事內容的連結改以新視窗方式開啟
　．將原程式只能選擇前後10年改為自定的前後年差(說不定這是原作者改漏了的地方)
　．改變管理模式輸入表單的表格配置，使之跟一般模式的輸入表單一致
　．加入HyperMart及Virtual Avenue的廣告語法。(搜尋"HyperMart"字串便可以找到)
　．其他一大堆不大不小的語法修正、版面修改…

───【設置注意事項】────────────────────────────

1. 以下是使用本程式最低限度要修改設定的部份：
     * 請將$url改為你自己的網站位址(首頁)
     * 將$password(密碼)改掉

2. 使用香港假期的管理者，請找出【香港的固定假期】部份，依照設定說明指示刪去
   註解字元並把對應的台灣假期設定部份刪掉即可。(非固定假期的設定亦同)

3. 如果伺服器的perl程式路徑所在與預設的不同，
   嘗試將第一行的 #!/usr/local/bin/perl 改為 #!/usr/bin/perl

4. 上傳檔案至提供CGI程式執行的主機伺服器時，要把檔案及資料夾設定正確權限：
     程式所在的資料夾一般都會自動設為"755"，但也可以自行改為更安全的"711"。
     程式檔 annecho.cgi 設成"755" (或更安全的"700")
     讀寫檔 annecho.txt 設成"666" (或更安全的"600")
     其餘圖檔設成"644"即可。

5. 程式原始碼其中一行 $ENV{'TZ'} = "CST-8"; 表示目前使用的是中國或台灣時間。
   請根據你所在的地理位置修改時區。（例如日本要改成"JST-9"）

6. 執行程式的連結很簡單，只要直接呼叫CGI程式的路徑即可。
   例如： http://xxxx.virtualave.net/scheduler/annecho.cgi

   你可以在瀏覽器的網址列輸入這個網址直接呼叫CGI程式，也可以在html裡面做一個
   連結按下去看看。例如： <a href="....../annecho.cgi">我的行事曆</a>

7. 管理者可以使用以下秘密連結，直接進入行事曆的編輯模式輸入記事記錄：
   http://∼/annecho.cgi?action=input&pass=管理者密碼
   (註: 如果你設$form_flg=2時，只有使用這個連結才可以寫入記事記錄)

8. 驚直有發現在原始碼第六百多行附近，原作者所設「當星期日同時是特別假期，設定
   之後的一天(星期一)為調整假期」這計算法並不可靠！ :(

   以下有兩個證據可以證明這個計算法的確有失：

   (1) 此計算法不適用於跨月份的調整假期
       實例：2002年3月31日(星期日)是復活節。在香港，應該有一天調整假期在翌日。
       可是在實際操作時，2002年4月1日(星期一)未有被列為紅色假期。

   (2) 此計算法不適用於因相連假期而跟特別假期重複的調整假期
       實例：2005年12月25日(星期日)是聖誕節。在香港，12月26日(即聖誕節翌日)
       也是公眾假期，所以會將調整假期設在聖誕節後第二個週日，即27日(星期二)。
       可是在實際操作時，2005年12月27日(星期二)未有被列為紅色假期。

   所以建議大家在設定假期矩陣的時候，不要太信任這計算法，因為真的很不實用呢！
   昨晚乘勢上網搜尋關於每年復活節所在日子的計算法，發現有人列出一大堆數據&表格
   (裡面填滿數字)並加以詳細解釋如何計算復活節的日子！

   曆法果然是一門令人有夠累的學問ㄝ！

───【聯絡方法】──────────────────────────────

歡迎大家來為我打氣：

天真的驚直  http://home.pacific.net.hk/~kxxk
            http://i.am/kxxk
            http://come.to/kxxk
            http://coolsite.to/kxxk
            http://kxxk.cjb.net/

我的伊媚兒  kxxk@pacific.net.hk
            kxxk@ms52.url.com.tw