|
DiaryCGI nicky! DELUXE
中文簡易說明文件
1. 簡介
nicky!是一個優秀的網路日記撰寫CGI程式，本中文化套件亦包含部份的相關輔助工具。
nicky!有以下幾項主要特徵：
．無須修改程式本體，所有設定都可於網路上直接進行。
．附有讀者回應功能。（可自由開啟或關閉）
．對應部份JAVA繪圖板程式。（PaintBBS、しぃペインター）
．可將日記內容輸出為HTML檔案。
．隨時可編寫、修改當天或過去日記，也可以在同一天撰寫多篇日記。
．可輕鬆上傳圖像，並指定圖像顯示的位置及尺寸。
．藉由同捆附屬程式可以提供不同的版面顯示，或是進行日記備份的作業。
．對應TrackBack功能。
2.版權宣告及免責事項
本程式經測試並未有重大錯誤，但若因使用本程式導致任何問題，原作者及中文化作者不負任何責任。
原作者及中文化作者並沒有隨時修改或更新程式的義務。
原作者並未准許本程式經過任何修改之後重新公開，請使用者切勿私下傳播。
3. 檔案內容
本套件包含以下檔案：
nicky.cgi----------nicky!日記撰寫CGI主程式(ver.2004/09/27c)
list.cgi--------------nicky!版型顯示擴充程式(ver.2004/07/12c)
nickyTool.cgi----nicky!日記檔案備份管理程式(ver.2004/01/15c)
tb.cgi---------------nicky!專用TrackBack程式(ver.2004/09/03c)
tbcheck.cgi------檢查TrackBack是否可正常運作(ver.2004/05/07c)
readme.html-----本說明檔案
4. 安裝方式
安裝主程式
a. 請確認您的網頁空間支援CGI功能。
b. 部份網頁空間限定可執行CGI的資料夾（如CGI-BIN），請確認您要上傳的資料夾可執行CGI。
c. 將各檔案中第一行的perl路徑設為伺服器的設定值。
d. 以ASCII模式上傳所有檔案（readme.html除外），並將檔案權限(CHMOD)設定為755。
e. 將nicky!所在的資料夾權限(CHMOD)設定為755或777。
安裝繪圖程式
若需要使用JAVA繪圖板功能，請前往 しぃ堂 Shi-dow 下載しぃペインター或是PaintBBS。
PaintBBS使用法：
下載該網頁之pbbsxxx_x.zip（xxx為版本數字），解壓縮之後將PaintBBS.jar以BINARY模式上傳至nicky.cgi所在之資料夾即可。
しぃペインター使用法：
1.下載該網頁之sptrxxxx.zip以及pchview_xxx.zip兩個檔案（xxx為版本數字）。
2.解開該兩個壓縮檔會得到若干檔案（若有相同檔案可忽略），將PCHViewer.jar及spainter.jar兩個檔案以BINARY模式上傳至nicky.cgi所在之資料夾，並將檔案權限設為666。
3.在nicky.cgi所在之資料夾新增名為res之資料夾，並且將兩個壓縮檔中res之資料夾裡所有檔案，全部以BINARY模式上傳至剛才新增之資料夾中。
4.將res資料夾之權限設為755。
其他
部份網頁空間不允許將圖像檔案置於CGI路徑，或是將WWW及CGI伺服器分開，若有此類問題請洽詢熟悉CGI的朋友修改CGI內容，本套件不提供相關的修改服務。
5. 初期設定
密碼設定
請以瀏覽器直接開啟nicky.cgi所在路徑。（如http://nicky設置路徑/nicky.cgi）
出現密碼設定畫面之後，請指定您想使用的管理者密碼，設定好之後便可進入編寫畫面。
日記編寫
編寫畫面會出現歡迎用留言以及修改日記、修改意見、刪除、個人設定、檔頭及檔尾、寫日記等六種功能鍵。
先前設定的密碼已儲存為Cookie，因此您設定密碼的這台電腦可直接進入管理畫面，在其他電腦並不會看到上述的功能鍵。（除非輸入管理者密碼）
日記顯示
為減少伺服器負擔，nicky.cgi可以將最新的日記頁面輸出為html檔案。
預設是在nicky.cgi的相同路徑輸出名為nicky.html的檔案，因此將網址設定為 http://nicky設置路徑/nicky.html 便可讀取日記。
版面設定
點選「個人設定」便可以進行細部的日記版面設定。
在「個人設定」頁面中若有任何修改，請務必點選「設定」按鍵讓修改內容生效。
即使不進行設定，nicky!亦可依照初期設定正常運作，懶得設定的話可以省略本步驟。
6.輔助指令集
以下並非所有的指令集，只列出較有可能使用的指令。
密碼設定：http://nicky設置路徑/nicky.cgi?PassWord
設定或是修改密碼。
要是忘記密碼，請刪除位於 nicky.cgi 相同路徑的 NickyAdmin.cgi 之後重新設定密碼。
要在別台電腦進入日記管理畫面也是使用本指令。
另外在密碼設定頁面點選 DUMMY PASSWORD，便可取消該台電腦的日記管理權限。
寫新日記：http://nicky設置路徑/nicky.cgi?New
日記全部被刪除，無法顯示功能按鍵時可以使用本指令。
檔頭及檔尾編輯：http://nicky設置路徑/nicky.cgi?HEADEDIT
用於檔頭語法撰寫錯誤，導致無法顯示功能按鍵時。
顯示最新日記：http://nicky設置路徑/nicky.cgi?page=0
也可以用為重新讀取的指令。
日記內文搜尋：http://nicky設置路徑/nicky.cgi?SetSearch
使用者自訂模式：http://nicky設置路徑/nicky.cgi?UserCustom
可以自由設定日記日期／標題／內文的HTML標籤，適用於擅長自己撰寫HTML的人。
標題列表：http://nicky設置路徑/nicky.cgi?TitleList
若當天日記附有圖像將會特別註明。
7. list.cgi的使用
list.cgi為nicky.cgi專用的顯示輔助程式。以下詳述 list.cgi 提供的顯示指令。
日曆型顯示：http://nicky設置路徑/list.cgi?Calendar
顯示成日曆的形式，該日有日記便會附上連結以便點選。
附屬指令：
不顯示檔頭 list.cgi?headder=OFF?Calendar
指定年份顏色 list.cgi?yearcolor=RRGGBB?Calendar
指定月份顏色 list.cgi?monthcolor=RRGGBB?Calendar
指定星期顏色 list.cgi?weekcolor=RRGGBB?Calendar
顯示寫入頻率 list.cgi?monthform=per?Calendar
表示是否有圖像 list.cgi?grp=on?Calendar
每列顯示月份數 list.cgi?wn=3?Calendar
以上指令可以同時使用，但請將?Calendar置於最後。
例：list.cgi?lang=2?monthcolor=000000?weekcolor=808080?Calendar
標題列表：http://nicky設置路徑/list.cgi?TitleList
在頁面顯示每篇日記的標題，各標題會附上連結以便點選。
附屬指令：
指定顯示件數 list.cgi?num=件數?TitleList
指定對齊方式 list.cgi?align=left/center/right?TitleList
目標視窗指定 list.cgi?target=目標視窗名?TitleList
畫面下方月份列表之行距 list.cgi?brnum=數字?TitleList
關閉畫面下方月份列表 list.cgi?monthlist=OFF?TitleList
顯示一個月份的日曆 list.cgi?clnum=1?TitleList
顯示一個月份的日曆（不顯示標題）
list.cgi?clnum=1?num=-1?TitleList
顯示一個月份的日曆（包含前後月份之連結）
list.cgi?clnum=1?vect=ON?TitleList
額外參數：加上：lang=3可顯示年份
圖像一覽：http://nicky設置路徑/list.cgi?Illust
附屬指令：
圖像顯示寬度 list.cgi?size=數字?Illust
每列張數 list.cgi?wn=數字?Illust
每行張數 list.cgi?hn=數字?Illust
圖像間隔寬度 list.cgi?spacing=數字?Illust
邊框粗細 list.cgi?border=數字?Illust
關閉圖像尺寸的顯示 list.cgi?ps=OFF?Illust
指定顯示的frame list.cgi?target=frame2?Illust
檔頭指定 list.cgi?usehead=first?Illust
若設為usehead=second，將會使用nicky.cgi中「檔頭＆檔尾編輯」的第二組檔頭。
檔尾指定 list.cgi?usefoot=first?Illust
若設為usefoot=second，將會使用nicky.cgi中「檔頭＆檔尾編輯」的第二組檔尾。
以上指令可以同時使用，但請將?Illust置於最後。
例：list.cgi?size=300?wn=4?hn=4?Illust
8. nickyTool.cgi的使用
list.cgi為nicky.cgi專用的備份輔助程式。
以瀏覽器直接開啟 nickyTool.cgi 所在路徑（如http://nicky設置路徑/nickyTool.cgi），輸入與nicky.cgi相同的管理者密碼即可使用。
nickyTool.cgi提供的功能如下：
刪除未使用檔案：刪除日記中沒有使用的檔案
日記檔案備份與刪除作業：將日記檔案打包備份或刪除
備份檔案解壓縮與刪除作業：進行解開或刪除備份檔的作業
在主機遷移或是更改日記CGI所在位置時，便可以藉由本輔助程式備份日記（副檔名為nac），將備份檔以BINARY模式上傳至新位置之後，重新以本程式解壓縮即完成搬遷作業。
部份主機會禁止直接由CGI執行路徑下載備份檔，遇到此狀況的網友請改以FTP軟體下載備份檔。
9. TrackBack的使用
簡介
TrackBack屬於日記撰寫者之間的連絡管道。若是您對他人的記事有所共鳴，並且在自己的日記中引用該記事或者撰寫相關感想時，可以藉由TrackBack功能提供的引用網址，告知對方您對他的記事有所回應，無形中成為各日記作家的互通網。
事前準備
請先執行http://nicky設置路徑/tbcheck.cgi，出現「inst = 4, OK」字樣即表示可以正常使用TrackBack功能。 [範例]
在nicky!安裝Trackback功能
首先以下列連結設定管理用密碼。
http://nicky設置路徑/tb.cgi?__mode=PassWord
注意：tb.cgi?__mode=的『 __ 』是兩條底線。
以下列網址進入nicky!的使用者自訂模式：
http://nicky設置路徑/nicky.cgi?UserCustom
將以下的程式碼複製到最下方「加入TrackBack(使用變數$tbTag)」的欄位中：
使用方法
tb.cgi安裝無誤後，開啟nicky!撰寫新日記，並勾選日記編寫頁面中「接受Trackback」的選項。
日記寫好後，該篇記事右下方會出現這樣的連結：
Trackback(0)
點選該連結即進入TrackBack頁面。該頁面的欄位「接收TrackBack之URL」即為您打算引用的他人記事。您可在該欄輸入下列URI進行測試：
http://haniwa25.cool.ne.jp/cgi-bin/diary/tb.cgi/20041102A
註：在測試過程中，請勿隨意對其他網站送出TrackBack，造成該位站長的困擾！
附屬指令
密碼設定： http://nicky設置路徑/tb.cgi?__mode=PassWord
若是忘記密碼，請刪除伺服器的tb_admin.cgi檔案並進入此連結。
個人化編輯：http://nicky設置路徑/tb.cgi?__mode=custom
可針對TrackBack頁面進行編寫，寫錯時刪除伺服器的tb_custom.cgi檔案即可。
注意：tb.cgi?__mode=的『 __ 』是兩條底線。
10. 常見問題
上傳之後出現ERROR而無法使用。
本程式釋出前已確認可正常運作，出現ERROR時請檢查下列項目：
1.確定該伺服器支援CGI功能
大部分的免費網頁均不提供，請自行詢問網頁空間提供者。
2.nicky.cgi所在子目錄沒有執行CGI權限
請確定該目錄權限有設定為777或755，並請檢查CGI檔案權限是否設為755。
3.並非以ASCII模式上傳
請各自參考FTP軟體的上傳設定
4.perl執行路徑錯誤
CGI檔案中的第一行即為perl執行路徑的設定。各網頁伺服器的執行路徑有可能不同，請依據伺服器所提供資料進行修正。
我有使用舊版的nicky!，要怎麼更新版本？
新版程式完全向下相容，只需覆蓋掉原檔案即可。
要如何關閉意見欄？
在個人設定的「意見欄相關」中，設定意見欄預留行數為「無」即可關閉。要針對每篇日記進行設定，可在日記編寫頁中自行設定意見欄行數。
為什麼不用密碼就能寫日記？
本程式是以cookie管理密碼，只有曾經輸入管理者密碼的電腦，才會出現編修日記或設定管理的選項。。若您要在其他電腦寫日記，或是取消該電腦的管理權限，請參照說明檔內「輔助指令集」的「密碼設定」。
|