台灣百年圖書館史暨數位圖書館先導計畫建置手冊

6月 01, 2011 作品 , 政大圖檔 , 程式寫作 0 Comments Edit Copy Download

題名：台灣百年圖書館史暨數位圖書館先導計畫
網址：http://top.lias.nccu.edu.tw/modules/newbb/ (2011年已經失效)
負責建置時間：2007

大多數人對於台灣百年圖書館史數位圖書館先導計畫的印象都是DSpace系統，但該計畫在執行前期的時候，其實是用我架設的計畫網站來存放計畫相關文件。架設這個網站的時間點是繼系友網站與輔大圖資系網站之後，一樣都是以XOOPS技術建置而成，並有更進一步的長進。

以下是當時計畫告一段落的時候撰寫的建置手冊，描述一些建置的細節以及操作畫面。特別是管理介面的操作過程跟編輯畫面，當時實在是用了很多心力在修改啊。然而比較私密的部分，我也做了些修改，以避免不必要的麻煩。

當初匆促寫完這份文件，語氣上似乎也很不嚴謹，現在回頭看來還真是感到有趣啊。

摘要

計劃說明網站(以下稱為本系統)跟主要的數位圖書館暨數位典藏網站(以下稱為Dspace系統)是完全不同的兩個系統，本篇技術文件在敘述前者的建置過程及重點。本系統是由XOOPS建置而成，用XOOPS的CBB論壇提供的編輯器及管理功能，修改而成為一個可以直接使用瀏覽器進行編修、上傳檔案的網站系統。然而本系統卻因為之後將重心轉移到Dspace系統上，導致本系統在內容或是系統維護上逐漸荒廢。本系統的網頁管理功能可以彌補Dspace系統的不足，整合兩個系統是未來可以考慮的方向。

一、建置目的

原本計畫的說明應該要跟網站本身結合在一起，但是為了先做到宣傳效果，而決定另外先架起一個網站，負責擺置計畫的宣傳文宣。只是內容並沒有按照時程更新，導致本網站頗有被擺置荒廢的傾向。(實際上，2011年的時候，該網站已經消失了)

計畫網站的網址為http://top.lias.nccu.edu.tw/，與DSpace系統是在不同的伺服器上運作，是獨立的系統。

二、內容架構

計畫網站大致上是截取本計劃的總體計劃書內容，再加上近期的活動而建構而成。網站的架構圖大致如下：

首頁：包括近期活動廣告、會議記錄、參訪記錄、最新消息、網站搜尋、網站訂閱
最新消息：發佈最近的消息，但因為缺乏維護，所以消息過時。
使命：總體計劃書內容擷取，包括計畫緣起、計畫目標、執行團隊與分工、工作時程。不過有些資料在計畫後期有所改變，例如執行團隊與分工，還有實際進行的工作時程，這些是需要更新的項目。
參與人員：同上，多了e-mail連絡位址。一樣是有需要更新的問題。
會議記錄：放置每次開會的會議記錄，那是Word檔轉加密過後的PDF檔案。
參訪記錄：目前總共有兩次參訪記錄，各別是「交通大學楊英風數位美術館參訪紀錄」、「臺灣大學圖書館數位典藏計畫參訪記錄」。格式同上。
演講記錄：目前沒有資料。這個論壇的定位與研討會的定位頗有混淆的感覺。
相關資料：關於本計劃的相關書目及網站列表，特別是有些技術文件是來自於參訪單位所提供的私家資料。
臺灣圖書館事業與教育史研討會：研討會的相關資料。在該研討會開始之前，此頁面是拿來做廣告的用途。研討會結束之後，就只是擺放資料而已。

三、系統建置過程

伺服器及系統

本系統是以PHP&MySQL為基礎的XOOPS之CBB論壇模組修改而成。PHP伺服器端程式語言與MySQL皆是跨平台開放原始碼軟體，Windows需要另外安裝軟體，大部分Linux都有內建安裝。本系統是架設在Linux伺服器上，以XAMPP這個包含了PHP、MySQL以及資料庫管理程式PhpMyAdmin多合一的包裝程式做為網路伺服器。XOOPS是一種資源入口網站，提供基本平台，再由使用者自行安裝各種不同的模組程式，而有不同的應用。其中CBB論壇便是模組的一種，主要是用來作為討論區使用，網路上十分盛行。

版本及各別說明

Linux：雖然本身已經安裝了PHP與MySQL，但我們另外安裝XAMPP，方便整合管理。在Linux上的XAMPP，會改稱為lampp。
XAMPP 1.6.4套件控制首頁在http://140.119.61.142/。
- PHP 5.2.1：PHP5跟以前的版本有很大差異，請務必使用PHP5
- MySQL 5.0.33
- phpMyAdmin 2.9.2：網址是http://top.lias.nccu.edu.tw/phpmyadmin/，必須要通過兩段認證。
XOOPS 2.13：已經包括以下的CBB論壇。注意，要使用Unicode編碼，不要再回頭用Big-5了。
- CBB論壇 2.3：以下的修改並沒有作成XOOPS模組，所以如果要照下面的方式修改，必須要搭配相對應的版本。

調整php.ini增加檔案上傳大小上限

本系統要提供一些檔案給人下載，但是PHP預設的檔案上傳上限僅有2MB，必須要修改php.ini中的參數以提供大檔案的上傳。

參數有三個，用搜尋就可以找到了：

upload_max_filesize：上傳檔案最大上限。
post_max_size：POST最大傳遞檔案，因為檔案上傳是用POST方式傳送的，所以這個也要設定。
max_execution_time：最大執行時間，為避免檔案上傳耗時過久而伺服器將他斷線，所以調高一點會比較保險。

修改完php.ini之後要記得將伺服器重新啟動才會生效。

安裝XOOPS前，先做過UTF8化

安裝XOOPS本身並不是很困難，所以可是在安裝前卻有幾點要注意的。

MySQL建立資料庫的校對

即使XOOPS本身的程式是用PHP撰寫，這也要MySQL資料庫是以Unicode編碼建置才能夠搭配。MySQL在後來的版本裏面加入了「校正」的功能，這就是指資料存入資料庫時的編碼，資料庫的編碼與資料的編碼必須要相符，才能在phpMyAdmin看到正確的資料呈現。可惜MySQL預設校對的編碼是很奇怪的拉丁語系(明明Unicode都盛行這麼久了)，所以在建立資料庫，必須要手動將校正調整成為「uft8_general_ci」，請參考下圖：

XOOPS資料庫連線的編碼

然後必須要調整XOOPS資料庫連線的編碼設定為utf-8。請手動修改以下兩支程式：

1. XOOP建置資料庫(CREATE DATABASE)時，設定語系為utf8、校對為utf8_general_ci

檔案位置：/html/install/class/dbmanager.php
行數：62
原程式：
$result = $this->db->query("CREATE DATABASE ".XOOPS_DB_NAME);
修正後：
$result = $this->db->query("CREATE DATABASE ".XOOPS_DB_NAME." DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci");

資料庫連線(mysql connect)時，修改它連線的語系為uft8。

檔案位置：/html/class/database/mysqldatabase.php
行數：78~82
原程式：
if (XOOPS_DB_PCONNECT == 1) { $this->conn = @mysql_pconnect(XOOPS_DB_HOST, XOOPS_DB_USER, XOOPS_DB_PASS); } else { $this->conn = @mysql_connect(XOOPS_DB_HOST, XOOPS_DB_USER, XOOPS_DB_PASS); }
修正後：
if (XOOPS_DB_PCONNECT == 1) { $this->conn = @mysql_pconnect(XOOPS_DB_HOST, XOOPS_DB_USER, XOOPS_DB_PASS); } else { $this->conn = @mysql_connect(XOOPS_DB_HOST, XOOPS_DB_USER, XOOPS_DB_PASS); }mysql_query("SET NAMES utf8");

修改完成之後再進行安裝即可。

安裝之後再修改XOOPS參數設定

如果在安裝過程之後，卻發生資料庫或是網址變更的情況，請修改/html/mainfile.php這個檔案的設定。但是變更此檔案會導致範本快取的hash碼修改，可能會導致之後的修改無法套用，下面會再提到。

目前的參數設定：

資料庫名稱digilib_xoops
資料表前置詞{prefix}為digilib
XOOPS的網址為http://top.lias.nccu.edu.tw/，連入之後會自動導到CBB論壇的首頁

修改CBB論壇

由於CBB論壇具備發言、附件、權限控管等功能，所以我將CBB論壇調整成僅供管理者發言、修改及刪除，增加FCKeditor這個與Word較為相容的所見即得編輯器(但仍難以完全相容，這問題下面會再提到)，再將整個系統改成以CBB為主體呈現的網站。

修改權限這功能在XOOPS裡面即有提供，故省略不提。以下我想講的是需要手動修改的部份。

增加FCKeditor，提供較容易上手的Word編輯環境

CBB論壇本身即有提供Koivi Editor編輯器，如上圖。然而這個編輯器僅能提供基本的編輯功能，不堪使用。

FCKeditor是一個網頁上使用的所見即得編輯器，網站在http://www.fckeditor.net/，裡面有試用版本。比起Koivi Editor，多了幾個重要的功能：

1. 具備檔案上傳功能

提供整合性插入圖片、插入檔案的功能，在編輯上更為順手。然而檔案上傳管理功能還是十分陽春，如果檔案量過多將會難以管理，需要搭配FTP管理較佳。

2. 具備Word標籤清除功能

FCKeditor會在複製貼上文字時，自動偵測Microsoft Word的標籤，然後另外有個Word標籤清除功能。跟HTML格式標籤一樣，Word也有自己專屬的標籤。在從Word複製出來的文字內便會自動嵌入，貼到所見即得編輯器時將會轉換成網頁語法呈現，一般使用是難以察覺的。但是Word標籤有很多是多餘限制的贅碼，會導致在網頁顯示時會有錯誤的格式呈現，網頁HTML語法跟Word格式語法是有很大的差異，所以FCKeditor才提供這功能，讓使用者先把Word的標籤清空，再到FCKeditor編輯器設定格式。然而這功能並不能算十分完善，建議最好還是直接寫原生的HTML碼比較好，從Word複製貼上而來的資料只能算是權宜之計。

FCKeditor並不是專為XOOPS而設計，所以要將FCKeditor安裝上去要花一番功夫。需要手動修改的程式碼在/html/class/xoopseditor/裡面，詳細請自行研究程式碼。

如果後來的CBB論壇版本已經具備FCKeditor的話是比較好的，但是這會對我們在CBB論壇的修改上造成版本不合的問題。

XOOPS與CBB論壇模組

XOOPS及其外掛的輸出流程如下：

模組範本及CSS範本個別位於/html/modules/及/html/themes/裡面。由於要範本是使用XOOPS的特定語法，故我們不從這邊修改，而是修改後面流程的程式。

先從範本快取開始談起。範本快取的程式碼在於/html/templates_c/，這是最終輸出之前的PHP程式碼，因為是我們熟悉的PHP語言，所以在修改上較為容易，這也包括與資料庫連線、取用資料的方法。

需要注意的是範本快取所產生的檔名，他是由原本外掛的範本檔檔名加上XOOPS系統所計算出的hash碼而成，而這個hash碼會因為XOOPS對於伺服器設定不同而會有不同的變化。例如我想修改一個來自於/html/themes/7dana-soft/theme.html的範本，這是7dana-soft樣板的範本，會影響到XOOPS的外觀，那麼最後輸出到/html/templates_c/檔名則會是「%%23^23B^23BB62A0%%theme.html.php」，但如果移到其他伺服器、而修改XOOPS本身的設定，那麼XOOPS會重新產生範本快取，檔名則會改成「%%8D^8DC^8DCD7BBD%%theme.html.php」，導致之前的修改失效。

CBB論壇修改要點

主要要修改的有兩個部份，一個是PHP主程式碼，另一個是session、cookie等記錄身分用的程式。

PHP主程式碼

主要是修改範本快取，位於/html/templates_c/裡面。修改最多的是{hash}_theme.html.php這支程式。然而範本快取可以讀取session或cookie中的身分資料，但卻無法設定，必須要透過/html/include/裡面的程式來控制。

記錄身分資訊

位於/html/include/common.php裡面有詳細記錄XOOPS所使用的大部分session與cookie資料，他將這些資料設定成常數(語法是define("NAME", "VALUE"))及物件，而修改時也只能從這個地方著手。

請在此或同個資料的其他程式直接設定session或cookie，以供範本快取使用。

其他較常使用的常數有：

XOOPS_ROOT_PATH：XOOPS在伺服器上的根目錄位置
XOOPS_URL：XOOPS的網址

下面是我另外加入的，方便控制現在的顯示層級：

XOOPS_FORUM_ID：論壇的ID
XOOPS_TOPIC_ID：主題的ID
XOOPS_POST_ID：留言的ID

物件主要是儲存身分資訊的$xoopsUser，用$xoopsUser->getVar('欄位名稱')以取得登入的資料，欄位名稱可以參考MySQL中的{prefix}_users資料表。如果沒有登入，則$xoopsUser會等於null。

CBB論壇與網站對應

CBB論壇的架構有四層：類別、論壇、主題、留言。為了將這個CBB論壇的架構轉為網站型式，所以我將這個架構重新定義。

類別

我將類別分為網站目錄與系統管理。網站目錄類別裡面的論壇標題會顯示在網頁頂端的導覽列，包括最新消息、使命等等，如下圖。而系統管理則包含一些其他頁面使用的欄位，包括管理者登入介面、網站地圖編輯以及連絡方式，同樣包括在CBB論壇裡面以方便編輯。

論壇

主要是導覽列的標題。

主題

主題是在論壇裡面的個別主題，主題裡面包含了許多留言，其中有開新主題的首篇留言以及之後的回應留言，但是我們只取用到主題層級裡面的第一篇留言。

如上圖，「最新消息」是論壇層級，而「臺灣圖書館事業與教育史研討會順利結束」與「計畫網站開始運作」則是主題層次，點進去右邊的內容則是首篇留言的內容。

CBB論壇層級在資料庫裡面的架構對應如下表，其{prefix}則是資料庫名稱的前置詞，是在XOOPS安裝時即可設定的內容，目前是digilib：

CBB論壇層級	資料庫名稱
類別	{prefix}_bb_categories
論壇	{prefix}_bb_forums
主題	{prefix}_bb_topics
留言	{prefix}_bb_posts
留言的內文：跟留言是分開的，很特別的設計	{prefix}_bb_posts_text

XOOPS程式移殖注意事項

目前修改完成的XOOPS程式碼位於附件的xoops_top_html.zip。

如果要將此程式碼移植到其他伺服器，必須要注意以上的重新產生範本快取之外，還要注意權限開放。以下將重點重新整理列表：

增加php.ini的檔案上傳上限
修改/html/mainfile.php的資料庫連線與網址設定
要將原本修改的程式碼，對應到重新產生的範本快取
開放全部權限：
1. /html/cache
2. /html/templates_c
3. /html/uploads：這是FCKeditor檔案上傳所使用的空間

四、內容維護

為了方便理解，以下以Step by Step圖文解說方式，幾個管理內容的方式。

管理者登入

不管進行任何動作，都必須要先登入管理者才行。

位於每個網頁的下方，皆有一個 管理者登入 的連結。
輸入帳號密碼。
在允許編輯或是可以新增主題的地方，便會出現相對應的按鈕

發新主題

每個論壇都可以作發新主題的功能，以增加該論壇的內容。以下以「最新消息」做為示範。

登入管理者後，到「最新消息」
預設是使用FCKeditor編輯器，畫面如下，大部分功能應該看圖示就知道怎麼操作了。
上傳並插入圖片：將游標移到插入點，接著請參考下圖，按下「插入/.編輯影像」的圖示，網頁會跳出一個視窗，你可以按「瀏覽伺服器端」來選擇已經上傳的檔案，或是按「上傳」來另外上傳一個新的檔案。

上傳檔案的視窗如下圖：
插入任意檔案：步驟同上，只是要點選「插入/編輯超連結」，位置請看下圖：
從word複製貼上到FCKeditor：先隨便找一段Word文字來做測試，附帶一提，我是用Word 2003

將這些文字用複製起來，到FCKeditor點選「自Word貼上」的功能

FCKeditor便會開啟一個「自Word貼上」的編輯視窗，請在此選擇是否要「移除字型設定」或「移除樣式設定」(反正都是Word的格式啦)，編輯完成之後按下「確定」，就會把內容貼到 FCKeditor裡面供你繼續編輯。

但是這個功能並不保證能夠清除Word的格式，建議還是用FCKeditor內建的功能重新撰寫文件吧。
上傳附件的方法：雖然FCKeditor有提供上傳檔案的功能，但是要讓使用者下載的檔案，最好統一用附件的方式放上去。附件上傳的位置在編輯區下方，可允許多個檔案上傳。

但問題是上傳檔案的檔名並不會經過編碼處理，如果你使用非英數的中文字，IE6以前的使用者下載的檔名將會是亂碼。