MediaWiki extensions

Ψ 架設Wiki之前 --> MediaWiki安裝 --> 本地化設置 --> 介面修改 --> 功能擴充 --> 備份與管理 | 工具箱 Ψ

擴充套件的安裝

• 下載擴充套件 (或從SVN下載)
• 放置於 {mediawiki}/extensions/
• 修改LocalSettings.php
  • 注意檔首無BOM格式
  • (選擇性) 在檔尾嵌入: require_once("extensions/ExtensionFunctions.php"); ## 下載ExtensionFunctions.php
  • 在檔尾嵌入擴充套件 require_once("extensions/ExtensionName.php");

避免放在 require_once( "includes/DefaultSettings.php" ); 之前

擴充套件: 自訂新增文章的格式

用途

• 事先自訂新文章的格式，方便使用者編輯

應用例子

• Wikinews讓使用者撰寫新聞(Writing an article)時，能套用Template:New page模版。 點選網頁上方View source或Edit即可看到模版語法。
• 全球之聲GVO中文翻譯小組協作平台，讓成員翻譯文章時，能套用模板:Newarticle。
• 圍紀導航讓使用者添加新站，能套用模板 Add New Wiki。

安裝「輸入欄」和「新增文章」套件

• 下載Inputbox 「輸入欄」套件
• 下載CreateArticle 「新增文章」套件
• 將原始碼複製到{mediawiki}/extensions
• 檔案結構為

{MediaWiki}/
|- extensions/
   |- CreateArticle.php
   |- inputbox.php

• 修改LocalSettings.php，在頁尾加入

require_once("extensions/inputbox.php");
require_once("extensions/CreateArticle.php" );

Demo: 學習單範本

<center>在此輸入學習單標題</center>
<inputbox> 
type=create
default=學習單_
width=30
preload=Template:New_worksheet
buttonlabel= 新增學習單
</inputbox>

若遭遇錯誤訊息「Input box: type not defined.」

請刪除 type=create 該行結尾處的空白字元。

擴充套件: 匯入自由圖像

用途:

• 匯入Flickr中創用CC授權的相片

安裝方法

• 檢查PHP.ini的 allow_url_fopen 是On
• 下載安裝ImportFreeImages 及 phpFlickr套件
• 檔案結構為

{MediaWiki}/
|- extensions/
   |- ImportFreeImages/
      |- ImportFreeImages.php
      |- README

• 修改LocalSettings.php: 啟用ImportFreeImages套件
• 修改ImportFreeImages套件
  • 取得Flickr API Key，並填入ImportFreeImages.php中的$wgIFI_FlickrAPIKey
  • 修正phpflickr的位置(原ImportFreeImages.php 中指到 extensions/phpFlickr-2.0.0)
• 檔案結構為

{MediaWiki}/
|- extensions/
   |- phpFlickr-2.0.0/
      |- PEAR/
      |- phpFlickr.php
      |- ...

• 連結到 Special:ImportFreeImages
• 修改Template:flickrx 其中x是創用CC的授權ID

Demo

• 尋找一隻貓

擴充套件: 展示FreeMind心智圖

用途: 上載FreeMind心智圖到MediaWiki，透過支援Flash Player的瀏覽器即可展示。

安裝

• 下載FreeMind extension
  • 下載freemind/ 共11個檔案，置於{mediawiki}/extensions/freemind
  • 下載FreeMind.php，置於 {mediawiki}/extensions
• 檔案結構為

{MediaWiki}/
|- extensions/
   |- freemind/
      |- appletwindow.php ... (等共11個檔案)
   |- FreeMind.php

• 修改LocalSettings.php
  • 嵌入FreeMind套件: LocalSettings.php 檔尾加入 require_once("extensions/FreeMind.php");
  • 增加FreeMind的檔案類型(.mm)

使用

• 在文章中的編輯語法

<mm>[[Image:filename.mm]]</mm> 

擴充套件: 嵌入Flash動畫/服務

用途: 在MediaWiki嵌入flash檔，可以直接展示flash動畫/服務，如Wink的說明動畫 或 Meebo的線上聊天室(meebo me widgets, 例)。

安裝

• 複製程式碼，並儲存為gflash.php，置於{mediawiki}/extensions/
• 修改LocalSettings.php
  • 嵌入FreeMind套件: LocalSettings.php 檔尾加入 require_once("extensions/gflash.php");
  • (選擇性) 增加允許上載的Flash檔案類型(.swf)

使用

• 在文章中的編輯語法

<gflash>寬度 高度 flash檔所在的網址</gflash>
例如: <gflash>480 340 http://www.chikinramen.com/exercise/exercise43.swf</gflash> 

因為flash檔是編譯後的檔案，如果要提供良好的協同編輯互動，建議同時提供原始專案檔。

其他擴充套件

• 以註腳方式呈現參考資料
• 將「所見即所得」的線上編輯器FCKeditor整合至MediaWiki
• 自動偵測行動裝置 (例如手機) 上的瀏覽器，並切換版面為行動裝置適合閱讀的版面 Extension:MobileFrontend
• 更多擴充套件... ...

擴充套件的相關文件

• Extending wiki markup - MediaWiki

他山之石

• Extensions used on Wikimedia(Wikipedia...)
• 版本 - wiki网址导航 - a Wikia wiki