區網架設內部MediaWiki網站

安裝MediaWiki

安裝MediaWiki完整資訊參考Manual:Running MediaWiki on Debian or Ubuntu

下載MediaWiki

MediaWiki官網

由MediaWiki官網下載1.27.1版 mediawiki-1.27.1.tar.gz

解壓縮與複製至目的地

• 解壓縮

可用圖形界面點滑鼠右鍵->在此解壓縮
或是
tar -xvzf /pathtofile/mediawiki-*.tar.gz
注意pathtofile為檔案存放的路徑

• 複製至目的地

sudo mkdir /var/lib/mediawiki
sudo mv mediawiki-*/* /var/lib/mediawiki

下載XAMPP

由於MediaWiki需要基於一些基本工具才能動作,而XAMPP正是將這些工具打包成一個安裝包的東西,所以直接下載使用

XAMPP包含Apache + MariaDB + PHP + Perl

Apache : web server

MariaDB : database MySQL的分支

XAMPP官網

由XAMPP官網下載xampp-linux-x64-5.6.24-1-installer.run
修改mode為可執行檔
sudo chmod +x /pathtofile/xampp-linux-x64-5.6.24-1-installer.run

安裝XAMPP

執行xampp-linux-x64-5.6.24-1-installer.run,下一步直到完成,完成後可看到其安裝在/opt/lampp目錄底下

設定database

由於我們是安裝XAMPP所以database是在/opt/lampp底下,與一般直接安裝MySQL不同,所以設定方式也會不同於MediaWiki官網,請注意

• 設定root password

官網為

mysqladmin -u root password "<enter the new password here>"
history -c

但XAMPP的database則是在

cd /opt/lampp/bin/
./mysqladmin -u root password "<enter the new password here>"
history -c

如果遇到./mysqladmin: connect to server at 'localhost' failed的問題可能是mysql沒有run
執行下行確認
./mysql.server  status
 * MySQL is not running
啟動mysql
./mysql.server  start
啟動成功後再次執行
./mysqladmin -u root password "<enter the new password here>"
history -c

以下主要以XAMPP方式為主,不再闡述與官網差異

• Secure setup

cd /opt/lampp/bin/
./mysql_secure_installation

設定PHP

修改 /opt/lampp/etc/php.ini中的upload_max_filesize與memory_limit

upload_max_filesize=128M

memory_limit=128M

設定MediaWiki首頁

cd /opt/lampp/htdocs
sudo ln -s /var/lib/mediawiki mediawiki

啟動lampp

cd /opt/lampp/
./lampp start

若要變更port可修改/opt/lampp/etc/httpd.conf中的Listen 再./lampp restart

完成以上步驟後即可使用瀏覽器開啟MediaWiki首頁(但安裝尚未完成)

設定MediaWiki

MediaWiki的設定是透過瀏覽器界面產生LocalSettings.php

• 開啟瀏覽器至http://web-server/mediawiki/

其中web-server為主機的電腦名稱(domain name)或是IP

該頁面會檢查是否有LocalSettings.php檔,若無則會自動進入設定頁面

• 依頁面指示完成設定

為避免未來缺乏某些外掛工具,所以在外掛工具選擇時全部選取

管理者帳號設定為 xxx_admin

完成後下載LocalSettings.php

• 套用LocalSettings.php

sudo mv ~/Downloads/LocalSettings.php /var/lib/mediawiki/

安裝完成

完成後再次開啟瀏覽器至http://web-server/mediawiki/則可開始使用此wiki網站

可使用xxx_admin登入,建立其他使用者帳號等

後續設定

web-server首頁

目前XAMPP的設定開啟瀏覽器至http://web-server/會跳轉到http://web-server/dashboard/

可修改/opt/lampp/htdocs/index.php中的

header('Location: '.$uri.'/dashboard/');

改為

header('Location: '.$uri.'/mediawiki/');

如此http://web-server/就會跳轉到http://web-server/mediawiki/首頁了

設定wikieditor

修改/var/lib/mediawiki/LocalSettings.php加入

# Enables use of WikiEditor by default but still allows users to disable it in preferences
$wgDefaultUserOptions['usebetatoolbar'] = 1;

# Enables link and table wizards by default but still allows users to disable them in preferences
$wgDefaultUserOptions['usebetatoolbar-cgd'] = 1;

# Displays the Preview and Changes tabs
$wgDefaultUserOptions['wikieditor-preview'] = 1;

# Displays the Publish and Cancel buttons on the top right side
$wgDefaultUserOptions['wikieditor-publish'] = 1;

讓編輯頁面時套用wikieditor外掛使編輯更加簡易

重新開機自動啟動

因為xampp服務在重新開機後不會自動啟動,須手動登入機器並啟動wiki網站才開始工作,

所以修改/etc/rc.local加入啟動xampp的命令如下,以後只要啟動機器即可

sudo /opt/lampp/xampp start

上傳檔案設定

上傳檔案功能需要更改image目錄權限才可使用

cd /var/lib/mediawiki/
sudo chmod 777 images

確認/var/lib/mediawiki/LocalSettings.php中的wgEnableUploads設定為true

## To enable image uploads, make sure the 'images' directory
## is writable, then set this to true:
$wgEnableUploads = true;

常用wiki語法教學

wiki語法教學頁面
http://etkenchen.blogspot.com/2016/10/wiki.html