Mediawiki

出自NoahWiki

About Mediawiki

本站源碼自 mediawiki，使用版本為 1.12.0

環境需求

Apache web server 或 IIS web server
PHP 5.x以上
Database Server：MySQL 4.x以上 或 PostgreSQL 8.1以上

Mediawiki 的安裝與設定

從官網下載，下載頁面
解開後，放到 web 下，
如為 linux 環境，則需修改 config 資料夾的權限

chmod a+w config

安裝完後，將 wikiroot/config/LocalSettings.php copy 到 /wikiroot
復原 config 資料夾權限

chmod a-w config

修改 LocalSettings.php
- 如果存成utf-8時，檔案不能含有unicode BOM標記，避免mediawiki無法正常運作。
  - ps:Notepad另存會utf-8會產生BOM，可用UltraEdit(File=>Conversions=>ASCII to UTF-8(Unicode Editing))或其他工具作另存
- 可從 wikiroot/include/DefaultSettings.php copy 一些要修改的設定檔到 /wikiroot/LocalSettings.php 。
- DefaultSettings.php 不能改，否則未來 upgrade 時，會被覆蓋掉。
  - LocalSettings.php 幾個常見設定

$wgLogo = "/wiki/wiki.png";  // 調整 logo path

$wgEnableUploads  = true;   // 開放圖片上傳，/wikiroot/images資料夾需具備寫入權限(chmod a+w images)
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' ,'zip' ,'rar' ,'doc' ,'xls' ,'ppt' ,'vsd' );  // 允許上傳的副檔名

// Implicit group for all visitors
$wgGroupPermissions['*']['createaccount']   = false;  // visitor 是否可以申請帳號
$wgGroupPermissions['*']['read']            = true;   // visitor 是否可以讀取
$wgGroupPermissions['*']['edit']            = false;  // visitor 是否可以編輯
$wgGroupPermissions['*']['createpage']      = false;  // visitor 是否可以建立新的頁面
$wgGroupPermissions['*']['createtalk']      = false;  // visitor 是否可以加入討論

上傳檔案

在LocalSettings.php 設定 $wgEnableUploads=true; 後，到路徑 http://wiki fullurl/index.php/Special:Upload 頁，就可上傳

一些特殊頁修改

首頁 : http://wiki fullurl/index.php/MediaWiki:Mainpage
修改左測導覽列 : http://wiki fullurl/index.php/MediaWiki:Sidebar
網頁標題 : http://wiki fullurl/index.php/MediaWiki:pagetitle
關於本站 : http://wiki fullurl/index.php/MediaWiki:Aboutpage
隱私政策 : http://wiki fullurl/index.php/MediaWiki:Privacy
免責聲明 : http://wiki fullurl/index.php/MediaWiki:Disclaimers

增加Google Adsense(廣告置入)

選擇不同面版，將會載入不同的面版程式，所以設定廣告前，建議先去選擇自己要的版本，1.12.x版裝起來預設為「MonoBook」
- 面版設定位置：Special:Preferences=>面板
假設選擇的面版為MonoBook，則打開 /wikiroot/skins/MonoBook.php程式。
隨便找一頁（如首頁），檢示網頁的原始碼，用對映字眼找到要插入的版位，然後再將 GoogleAdsense的程式碼插入即可。
可用相同方式，在左邊側邊列加入「友站連結」^_^
插入Adsense範例:

上圖區塊一的程式碼位置為

 <?php if($this->data['sitenotice']) { ?><div id="siteNotice"><?php $this->html('sitenotice') ?></div><?php } ?>
 <h1 class="firstHeading"><?php $this->data['displaytitle']!=""?$this->html('title'):$this->text('title') ?></h1>
 這裡放入 Google Adsense Code 
 <div id="bodyContent">
         <h3 id="siteSub"><?php $this->msg('tagline') ?></h3>

上圖區塊二的程式碼位置為

         wfRunHooks( 'MonoBookTemplateToolboxEnd', array( &$this ) );
 ?>
             </ul>
         </div>
         這裡放入 Google Adsense Code 
     </div>
 <?php
         if( $this->data['language_urls'] ) { ?>

上圖區塊三的程式碼位置為

        <div class="visualClear"></div>
        <div id="footer">
        這裡放入 Google Adsense Code 
 <?php
     if($this->data['poweredbyico']) { ?>

搜尋引擎套用

Mediawiki可以套用Lucene當搜尋引擎，相關細部說明請見：Mediawiki套用Lucene-search

自訂Tag及自訂函式

Mediawiki允許管理者設定自訂的Tag及自訂函式(Mediawiki稱為Parser function)。自訂Tag使用上就像是一個xml tag 的使用，不支援wiki語法輸出，且變更內容需重啟web server。至於自訂函式，則使用{{#....}的語法，支援wiki語法輸出，且不需重啟web server 。不管自訂Tag或自訂函式都需要在LocalSetting.php給予Include。

Parser function 的官網說明: http://www.mediawiki.org/wiki/Manual:Parser_functions