March 5,2006 20:37
安裝維基筆記 2
最近幾天家裡換新電腦，所有軟體都要重新安裝，利用這個機會給維基筆記做一次全面性的升級。
前次和本次安裝測試所用的軟體對照如下：
預計要安裝的平台：
Windows XP SP2 繁體中文版
前次和本次安裝測試所用的軟體對照如下：
| Apache | 2.0.54 | 2.0.55 |
| MySQL | 4.1.14 | 5.0.18 |
| PHP | 5.0.5 | 5.1.2 |
| MediaWiki | 1.4.10 | 1.5.6 |
預計要安裝的平台：
Windows XP SP2 繁體中文版
注意：本篇文章的內容已經過時，請參閱安裝維基筆記 3。
所謂AMP是指Apache+MySQL+PHP，是源碼開放環境下廣泛使用的網站伺服器架構。傳統上AMP是設計來安裝於Linux上（稱為LAMP），想將之安裝在Windows上（稱為WAMP）會遭遇到一些細節困擾。
Apache 2.0有Windows Installer安裝套件，下載後直接執行即可。在安裝過程中會要求使用者輸入一些設定值：
Network Domain/Server Name：輸入localhost即可。
E-Mail：隨便，甚至可以是不存在的信箱位址。
Windows XP SP2的防火牆會詢問你是否要封鎖Apache。因為本次測試的目的是要建立個人私用的維基筆記，所以當然是欣然接受囉。
MySQL 5.0也有Windows Installer安裝套件，下載後直接執行即可。安裝過程中會詢問使用者是否報名登入MySQL.com，選擇略過（Skip Sign-Up）即可。
在安裝結束的時候會詢問使用者是否要立刻設定Configuration，選擇執行，即會進入Configuration Wizard程式，以下依序說明各項設定，未特別提到的選預設值即可：
a. Configuration type
選擇Detailed Configuration以便調整一些細部選項。
b. Server type
由於是要個人私用的維基筆記，我們選擇消耗記憶體最少的Developer Machine形式。
c. Database usage
可以選擇Non-Transactional Database Only，因為我們的目標是維基筆記，同一時間只有一個使用者在存取，不需要資料同步的驗證。
d. Approximate number of concurrent connections
我們的連線數量不多，選擇大約20人份的Decision Support (DSS)/OLAP即可。注意雖然只有我們一個人在使用，但是你在瀏覽器裡每打開一個頁面，就等於是增加一個連線。
e. Default character set
可以選擇Best Support for Multilingualism
注意：會有什麼影響尚不清楚，保守點的人可以選擇Latin-1。
f. Security options
這裡要指定MySQL的root密碼，要牢牢記住，後面還會用到。
PHP 5.1有Windows Installer安裝套件和單純的ZIP壓縮檔。在這裡，我們要選擇ZIP壓縮檔，因為Windows Installer安裝套件中沒有延伸套件，無法和MySQL搭配。
台灣地區的朋友在下載PHP的時候可能會遇到一些麻煩：在選擇鏡像網站時不管點入哪一個都會連到空白頁面。據我個人的經驗，那是因為台大的PHP鏡像網站有點問題，而大部分台灣地區的連線都會自動連到那邊去。解決之道是手動把網址改一下：將「www.php.net」改為「tw2.php.net」（使用台灣的另一個鏡像網站），這樣應該就可以順利下載了。
將ZIP壓縮檔在你喜歡的路徑上解開，此即為PHP的安裝路徑。這次安裝測試中設定的路徑是C:\PHP5。目錄中要有php.exe。
MediaWiki 1.5是一個ZIP壓縮檔。在Apache指定的網頁根目錄之中建立一個名為wiki的子目錄，然後將MediaWiki在此解開。目錄中要有index.php。
注意：提醒兩件事情。
由於AMP原先是設計給Linux使用，因此檔案路徑中的分隔字元用的是正斜字元’/’，而不是Windows慣用的反斜字元’\’。記得以下在修改設定檔的時候，所有的路徑都要使用正斜字元。
所有的文字檔案要修改前必先複製備份。不可以用Windows內附的「記事本」（Notepad）去儲存PHP檔案，因為PHP檔案是使用Unicode UTF-8來儲存，而記事本遇到這種編碼，會在檔案開頭多加三個隱藏的標記字元，如此一來PHP解譯器就看不懂了。請事先準備好UltraEditor之類的文字編輯器。
以UltraEditor為例，請在其Configuration中找到「Auto detect UTF-8 files」之類的選項，將之關閉。
這裡的重點是讓Apache知道網頁會放在電腦的哪個目錄裡，以及讓它能使用PHP來產生頁面。
在Apache的安裝目錄中找到conf目錄，在其中有個httpd.conf，用文字編輯器開啟。
a. 監聽位址與埠號
尋找”Listen"。這是Apache伺服器持續監聽的IP Address和Port。請寫上本地機器的標準位址和埠號：
Listen 127.0.0.1:80
注意：請記得將行首的’#’字元去掉，否則這行會被視為註解而不起作用。
b. 網頁根目錄
尋找”DocumentRoot"。這個是你的網頁根目錄，預設值是Apache的安裝目錄加上”/htdocs”，像這樣：
“C:/Program Files/Apache Group/Apache2/htdocs”
這次安裝測試中預計使用的是D:\WikiNotes，因此請將出現這個字串的地方改為：
"D:/WikiNotes"
應該有兩個地方要修改。
c. 節省系統資源
尋找”ThreadsPerChild”，將之從250改為16。
d. 運行PHP
在檔案最後加上三行敘述：
LoadModule php5_module "c:/php5/php5apache2.dll"
AddType application/x-httpd-php .php
PHPIniDir "c:/php5"
儲存httpd.conf之後，點選右下角的Apache圖示，重新啟動（restart）Apache 服務。如果Apache設定無誤，這時候打開電腦中的瀏覽器，在網址中輸入localhost，應該可以看到由Apache所產生的頁面。
如果無法啟動，八成是上面的設定有什麼地方打錯字了，請再仔細檢查一次。
這裡著眼的是一個重要問題：我們的維基筆記到底是儲存在哪裡？事實上它是一個由MySQL管理的資料庫，由許多表格所組成。當我們想備份筆記時，就是要備份這個資料庫。不過MySQL的資料庫在Windows中的預設位置，是在它的安裝目錄之下一個叫data的目錄中，十分的不方便。因此我們接著要把 MySQL的data目錄移到D:\WikiNotes下面。
MySQL在Windows中是一個常駐服務（Service），在修改它的設定之前，我們必須要先停止服務。請在「我的電腦」上面按滑鼠右鍵，選擇「管理」。然後在其中找到「服務及應用程式」，再選擇「服務」。在眾多常駐服務中找到MySQL，選擇「停止」。請先別關閉這個視窗，稍後我們要從這裡再次啟動MySQL。
在MySQL的安裝目錄下，找到data目錄，將之整個複製到D:\WikiNotes之下，改名為mysqldata。此目錄不正常會導致MySQL無法啟動，為防萬一請先備份。
在MySQL的安裝目錄下，找到my.ini，用文字編輯器開啟。
尋找”datadir”，將之改為指定的目錄，注意末尾有正斜字元’/’。
datadir="D:/WikiNotes/mysqldata/"
儲存。
回到電腦管理的「服務」程式中，啟動MySQL服務。
這裡的重點是讓PHP能夠使用電腦上的MySQL服務。
在PHP的安裝目錄下，將php.ini-recommended複製一份，然後改名為php.ini。用文字編輯器開啟。
找到”;extension=php_mysql.dll"，將前面的分號去掉。
找到"extension_dir = "./"" ，將後面的 "./" 改為 "c:/php5/ext" 。
儲存。
設定完後須重新啟動Apache。
在瀏覽器的網址列輸入localhost/wiki，然後點選index.php。網頁上會提供你一個設定MediaWiki的鏈結。
注意：如果當你點選index.php的時候變成「下載該檔案」，那表示你在Apache中的PHP設定有誤，請回頭再檢查一次。然後當你再次開啟localhost/wiki的時候，記得要清除網頁快取（cache）。
在MediaWiki的設定頁中，有幾個欄位是必須的：
Site Name：這是你的網站名稱，同時也是當你的Wiki架設好後，管理系統頁面的「命名空間」～～也許有些人不知道這是什麼，沒關係。總之這個名字最好是使用英文，而且要簡短。
Language：依照個人習慣決定。中文的語言代碼是zh，又分成zh（繁簡自動轉換），zh-cn（大陸、簡體）、zh-tw（台灣、繁體）、zh-hk（香港、繁體）、zh-sg（新加坡、簡體）。沒事請不要選繁簡自動轉換。
Sysop Account Name：這是維基管理者的使用者帳號。由於你就是唯一的使用者與管理者，請在這裡輸入能代表你自己的名字。可以使用中文。
Database Name：這邊是告訴MySQL你的維基筆記資料庫要叫什麼名字。系統預設的wikidb不錯，可沿用之。使用者名稱也可以不改。至於密碼你自己要選一個，而且要記得抄一份保存好。
DB Root Password：這裡要輸入剛才你設定MySQL時所選擇的root password。
設定妥當後，點選最下面的Install。如果一切順利的話，最後一個步驟是將在config目錄之下新產生的LocalSettings.php複製到 wiki的根目錄下。再次在瀏覽器的網址列中輸入localhost/wiki/index.php，你就會進入MediaWiki的首頁了！
不順利的話呢？
安裝失敗絕大部分都和PHP與MySQL之間的溝通不良有關。如果頁面上出現一些奇怪的錯誤訊息，請依照以下順序再試一次：
a. 停止MySQL服務。
b. 將MySQL datadir下剛才由MediaWiki產生的database目錄刪除。
c. 啟動MySQL服務。
d. 將瀏覽器的網頁快取清除。
e. 再次進入MediaWiki的安裝頁面，或許做一些修正。
若是反覆試驗還是不行，恐怕你得重頭再來一次試試看了。
剛進入MediaWiki的時候，有個地方你可能會看著礙眼，就是網頁標題上會顯示「維基百科」～～可我們並不是在寫維基百科啊。這時候請點選左邊工具框 中的「特殊頁面」，然後再點選「系統界面」。這裡面的表格，左邊是預設值、右邊是目前使用值。適合更改的是sitetitle和 sitesubtitle。
此外是字型的問題。預設的內文字型有點小，所以我們要透過描述網頁格式的CSS檔案來加以修改。這又和你所選的「皮膚」（skin）有關。假定你使用的是預設的MonoBook，那麼請到skins\monobook目錄下找到main.css檔案，用文字編輯器開啟。
請找到有個地方是：
#bodyContent h1, #bodyContent h2 {
margin-bottom: .6em;
}
這是指在 #bodyContent 「風格」（style）之下對標題的一些設定。我們可以在前面加一個對整個 #bodyContent ，也就是每個條目的內文所在之處的一個風格調整：
#bodyContent {
font-size: 115%;
}
這就是將整個條目內文放大 1.15 倍的意思，視覺上會比較舒服一點。
1. 安裝AMP及MediaWiki
所謂AMP是指Apache+MySQL+PHP，是源碼開放環境下廣泛使用的網站伺服器架構。傳統上AMP是設計來安裝於Linux上（稱為LAMP），想將之安裝在Windows上（稱為WAMP）會遭遇到一些細節困擾。
1.1 安裝Apache 2.0
Apache 2.0有Windows Installer安裝套件，下載後直接執行即可。在安裝過程中會要求使用者輸入一些設定值：
Network Domain/Server Name：輸入localhost即可。
E-Mail：隨便，甚至可以是不存在的信箱位址。
Windows XP SP2的防火牆會詢問你是否要封鎖Apache。因為本次測試的目的是要建立個人私用的維基筆記，所以當然是欣然接受囉。
1.2 安裝MySQL 5.0
MySQL 5.0也有Windows Installer安裝套件，下載後直接執行即可。安裝過程中會詢問使用者是否報名登入MySQL.com，選擇略過（Skip Sign-Up）即可。
在安裝結束的時候會詢問使用者是否要立刻設定Configuration，選擇執行，即會進入Configuration Wizard程式，以下依序說明各項設定，未特別提到的選預設值即可：
a. Configuration type
選擇Detailed Configuration以便調整一些細部選項。
b. Server type
由於是要個人私用的維基筆記，我們選擇消耗記憶體最少的Developer Machine形式。
c. Database usage
可以選擇Non-Transactional Database Only，因為我們的目標是維基筆記，同一時間只有一個使用者在存取，不需要資料同步的驗證。
d. Approximate number of concurrent connections
我們的連線數量不多，選擇大約20人份的Decision Support (DSS)/OLAP即可。注意雖然只有我們一個人在使用，但是你在瀏覽器裡每打開一個頁面，就等於是增加一個連線。
e. Default character set
可以選擇Best Support for Multilingualism
注意：會有什麼影響尚不清楚，保守點的人可以選擇Latin-1。
f. Security options
這裡要指定MySQL的root密碼，要牢牢記住，後面還會用到。
1.3 安裝PHP 5.1
PHP 5.1有Windows Installer安裝套件和單純的ZIP壓縮檔。在這裡，我們要選擇ZIP壓縮檔，因為Windows Installer安裝套件中沒有延伸套件，無法和MySQL搭配。
台灣地區的朋友在下載PHP的時候可能會遇到一些麻煩：在選擇鏡像網站時不管點入哪一個都會連到空白頁面。據我個人的經驗，那是因為台大的PHP鏡像網站有點問題，而大部分台灣地區的連線都會自動連到那邊去。解決之道是手動把網址改一下：將「www.php.net」改為「tw2.php.net」（使用台灣的另一個鏡像網站），這樣應該就可以順利下載了。
將ZIP壓縮檔在你喜歡的路徑上解開，此即為PHP的安裝路徑。這次安裝測試中設定的路徑是C:\PHP5。目錄中要有php.exe。
1.4 安裝MediaWiki 1.5
MediaWiki 1.5是一個ZIP壓縮檔。在Apache指定的網頁根目錄之中建立一個名為wiki的子目錄，然後將MediaWiki在此解開。目錄中要有index.php。
2. 設定AMP與MediaWiki
注意：提醒兩件事情。
由於AMP原先是設計給Linux使用，因此檔案路徑中的分隔字元用的是正斜字元’/’，而不是Windows慣用的反斜字元’\’。記得以下在修改設定檔的時候，所有的路徑都要使用正斜字元。
所有的文字檔案要修改前必先複製備份。不可以用Windows內附的「記事本」（Notepad）去儲存PHP檔案，因為PHP檔案是使用Unicode UTF-8來儲存，而記事本遇到這種編碼，會在檔案開頭多加三個隱藏的標記字元，如此一來PHP解譯器就看不懂了。請事先準備好UltraEditor之類的文字編輯器。
以UltraEditor為例，請在其Configuration中找到「Auto detect UTF-8 files」之類的選項，將之關閉。
2.1 設定Apache 2.0
這裡的重點是讓Apache知道網頁會放在電腦的哪個目錄裡，以及讓它能使用PHP來產生頁面。
在Apache的安裝目錄中找到conf目錄，在其中有個httpd.conf，用文字編輯器開啟。
a. 監聽位址與埠號
尋找”Listen"。這是Apache伺服器持續監聽的IP Address和Port。請寫上本地機器的標準位址和埠號：
Listen 127.0.0.1:80
注意：請記得將行首的’#’字元去掉，否則這行會被視為註解而不起作用。
b. 網頁根目錄
尋找”DocumentRoot"。這個是你的網頁根目錄，預設值是Apache的安裝目錄加上”/htdocs”，像這樣：
“C:/Program Files/Apache Group/Apache2/htdocs”
這次安裝測試中預計使用的是D:\WikiNotes，因此請將出現這個字串的地方改為：
"D:/WikiNotes"
應該有兩個地方要修改。
c. 節省系統資源
尋找”ThreadsPerChild”，將之從250改為16。
d. 運行PHP
在檔案最後加上三行敘述：
LoadModule php5_module "c:/php5/php5apache2.dll"
AddType application/x-httpd-php .php
PHPIniDir "c:/php5"
儲存httpd.conf之後，點選右下角的Apache圖示，重新啟動（restart）Apache 服務。如果Apache設定無誤，這時候打開電腦中的瀏覽器，在網址中輸入localhost，應該可以看到由Apache所產生的頁面。
如果無法啟動，八成是上面的設定有什麼地方打錯字了，請再仔細檢查一次。
2.2 設定MySQL
這裡著眼的是一個重要問題：我們的維基筆記到底是儲存在哪裡？事實上它是一個由MySQL管理的資料庫，由許多表格所組成。當我們想備份筆記時，就是要備份這個資料庫。不過MySQL的資料庫在Windows中的預設位置，是在它的安裝目錄之下一個叫data的目錄中，十分的不方便。因此我們接著要把 MySQL的data目錄移到D:\WikiNotes下面。
MySQL在Windows中是一個常駐服務（Service），在修改它的設定之前，我們必須要先停止服務。請在「我的電腦」上面按滑鼠右鍵，選擇「管理」。然後在其中找到「服務及應用程式」，再選擇「服務」。在眾多常駐服務中找到MySQL，選擇「停止」。請先別關閉這個視窗，稍後我們要從這裡再次啟動MySQL。
在MySQL的安裝目錄下，找到data目錄，將之整個複製到D:\WikiNotes之下，改名為mysqldata。此目錄不正常會導致MySQL無法啟動，為防萬一請先備份。
在MySQL的安裝目錄下，找到my.ini，用文字編輯器開啟。
尋找”datadir”，將之改為指定的目錄，注意末尾有正斜字元’/’。
datadir="D:/WikiNotes/mysqldata/"
儲存。
回到電腦管理的「服務」程式中，啟動MySQL服務。
2.3 設定PHP 5
這裡的重點是讓PHP能夠使用電腦上的MySQL服務。
在PHP的安裝目錄下，將php.ini-recommended複製一份，然後改名為php.ini。用文字編輯器開啟。
找到”;extension=php_mysql.dll"，將前面的分號去掉。
找到"extension_dir = "./"" ，將後面的 "./" 改為 "c:/php5/ext" 。
儲存。
設定完後須重新啟動Apache。
2.5 設定MediaWiki 1.5
在瀏覽器的網址列輸入localhost/wiki，然後點選index.php。網頁上會提供你一個設定MediaWiki的鏈結。
注意：如果當你點選index.php的時候變成「下載該檔案」，那表示你在Apache中的PHP設定有誤，請回頭再檢查一次。然後當你再次開啟localhost/wiki的時候，記得要清除網頁快取（cache）。
在MediaWiki的設定頁中，有幾個欄位是必須的：
Site Name：這是你的網站名稱，同時也是當你的Wiki架設好後，管理系統頁面的「命名空間」～～也許有些人不知道這是什麼，沒關係。總之這個名字最好是使用英文，而且要簡短。
Language：依照個人習慣決定。中文的語言代碼是zh，又分成zh（繁簡自動轉換），zh-cn（大陸、簡體）、zh-tw（台灣、繁體）、zh-hk（香港、繁體）、zh-sg（新加坡、簡體）。沒事請不要選繁簡自動轉換。
Sysop Account Name：這是維基管理者的使用者帳號。由於你就是唯一的使用者與管理者，請在這裡輸入能代表你自己的名字。可以使用中文。
Database Name：這邊是告訴MySQL你的維基筆記資料庫要叫什麼名字。系統預設的wikidb不錯，可沿用之。使用者名稱也可以不改。至於密碼你自己要選一個，而且要記得抄一份保存好。
DB Root Password：這裡要輸入剛才你設定MySQL時所選擇的root password。
設定妥當後，點選最下面的Install。如果一切順利的話，最後一個步驟是將在config目錄之下新產生的LocalSettings.php複製到 wiki的根目錄下。再次在瀏覽器的網址列中輸入localhost/wiki/index.php，你就會進入MediaWiki的首頁了！
不順利的話呢？
安裝失敗絕大部分都和PHP與MySQL之間的溝通不良有關。如果頁面上出現一些奇怪的錯誤訊息，請依照以下順序再試一次：
a. 停止MySQL服務。
b. 將MySQL datadir下剛才由MediaWiki產生的database目錄刪除。
c. 啟動MySQL服務。
d. 將瀏覽器的網頁快取清除。
e. 再次進入MediaWiki的安裝頁面，或許做一些修正。
若是反覆試驗還是不行，恐怕你得重頭再來一次試試看了。
2.5 MediaWiki的頁面調整
剛進入MediaWiki的時候，有個地方你可能會看著礙眼，就是網頁標題上會顯示「維基百科」～～可我們並不是在寫維基百科啊。這時候請點選左邊工具框 中的「特殊頁面」，然後再點選「系統界面」。這裡面的表格，左邊是預設值、右邊是目前使用值。適合更改的是sitetitle和 sitesubtitle。
此外是字型的問題。預設的內文字型有點小，所以我們要透過描述網頁格式的CSS檔案來加以修改。這又和你所選的「皮膚」（skin）有關。假定你使用的是預設的MonoBook，那麼請到skins\monobook目錄下找到main.css檔案，用文字編輯器開啟。
請找到有個地方是：
#bodyContent h1, #bodyContent h2 {
margin-bottom: .6em;
}
這是指在 #bodyContent 「風格」（style）之下對標題的一些設定。我們可以在前面加一個對整個 #bodyContent ，也就是每個條目的內文所在之處的一個風格調整：
#bodyContent {
font-size: 115%;
}
這就是將整個條目內文放大 1.15 倍的意思，視覺上會比較舒服一點。
引用URL
http://cgi.blog.roodo.com/trackback/1209924