Mediawiki 程式說明/取段落

更新快取

• 資料夾沒有更名：編輯再儲存
• 當修改 mediawiki 所在資料夾名稱，須同步改 LocalSettings.php 中的 $wgScriptPath 。但此時 mediawiki 仍會從快取中取得包含舊資料夾名稱的許多快取頁，導致網站完全無法運作。請依畫面指示，在相關的檔案中加一行「echo __FILE__;」，使網頁內容發生變化，導致產生新的快取，問題即可逐步排除。例如在 includes/Defines.php 中加「echo __FILE__;」。

限制某些頁面只有某些群組可讀取

wiki_user_groups表

對目標帳號加群組，如 jj

LocalSettings.php

定義 $canRead['group']

1. 為一陣列
2. 各元素索引為頁名
3. 各元素值為可讀此頁之群組陣列
4. 中文頁名須以 URL 格式寫，再以 urldecode 函式解碼

includes/Title.php

1.17版

在 Title 類別 userCanRead 方法中增加

global $wgUser, $wgGroupPermissions, $canRead;	// by jj

// 依 $canRead 判斷是否可讀本頁 by jj
if(isset($canRead['group']) && count($canRead['group'])){
	$name = $this->getPrefixedText();	// 取回本頁帶名字空間的頁名
	if(isset($canRead['group'][$name]) && is_array($canRead['group'][$name])){
		if(isset($wgUser->mGroups) && is_array($wgUser->mGroups)){
			$revoke=0;
			foreach($wgUser->mGroups as $v){if(in_array($v,$canRead['group'][$name])){$revoke+=1;}}
			if($revoke==0){
				return false;
			}
		}
	}
}

1.19版

userCanRead()交給了userCan('read')； userCan(動作,帳號物件,是否全套檢查)又交給了getUserPermissionsErrorsInternal(動作,帳號,是否全套,遇錯就短路)；再交給checkReadPermissions(動作,帳號,錯陣列,是否全套,遇錯就短路)。

但上述這些函式只能增加「錯誤訊息」陣列，並不能阻擋共筆頁內容的顯示。所有要進行共筆頁讀取權限控管，必須從 /includes/SkinTemplate.php 中 SkinTemplate 類別的 outputPage 方法，在

$tpl->data['bodytext'] .= $tpl->data['debughtml'];

之後加上：

// 依 $canRead 判斷是否可讀本頁，by jj
global $wgUser, $canRead, $wgTitle, $wgServer, $wgScriptPath;
if(isset($canRead['group']) && count($canRead['group'])){
	$name = $wgTitle->getPrefixedText();	// 取回本頁帶名字空間的頁名
	if(isset($canRead['group'][$name]) && is_array($canRead['group'][$name])){
		if(isset($wgUser->mGroups) && is_array($wgUser->mGroups)){
			$revoke=0;
			foreach($wgUser->mGroups as $v){if(in_array($v,$canRead['group'][$name])){$revoke+=1;}}
			if($revoke==0){$tpl->data['bodycontent']='您無權限讀此頁。[<a href='.$wgServer.$wgScriptPath.'>回首頁</a>]';}
		}
	}
}

除錯

skins/Vector.php

VectorTemplate 類別中的 execute 方法中，找到 <!-- bodytext -->(1.19版為<!-- bodycontent -->)

在之下插入除錯資訊 全域變數 $jjj，然後在要除錯的程式段落中對 $jjj 派值。

{ {…} }內層嵌入

用{ {…} }嵌入之title，其運行中之變數傳不到上一層，所以無法在skin(最外層)查看變數(如上段的方法)，除錯，請用：

$flog=fopen('./jjj',"a+");fwrite($flog,變數."\n");fclose($flog); // by jj

然後查看 mediawiki/jjj 檔之新寫入內容。

調整中文化訊息

languages/messages/MessagesZh_tw.php

$messages 陣列中以下元素

'badaccess-groups' => '您剛才的請求只有{{PLURAL:$2|這個|這些}}使用者群組的使用者才能使用: $1',

將「群」改成「群組」

資料表

wiki_interwiki

跨 wiki 連結增加中文維基百科 zhwikipedia:http://zh.wikipedia.org/wiki/$1

嵌入本站及跨wiki段落

詳見 includes/parser/Parser.php 中 Parser類別中的braceSubstitution方法之修改。

擴充可以用HTML標籤

• 參考 英文維基百科說明
• 調整 include/Sanitizer.php 中 Sanitizer.php,$htmlsingle,$htmlsingleonly,$htmlnest,$tabletags,$htmllist,$listtags 諸陣列的內容。
  1. a 標籤是有效的。
  2. iframe不但無效，而且基於安全考量，wikimedia 連 Extension:Website in iFrame 都加以移除。

支援 SVG

• $wgSVGConverters
• Image_administration</td></tr>

由頁名/段名取段落wiki原文

步驟：

1. 拆解頁名中的名字空間及純頁名
2. $wgContLang->mNamespaceIds['名字空間']為該名字空間之id
3. Title類別建構子為空方法，但Title::makeTitle(名字空間id,純頁名)可以得回Title物件
4. new Article(Title物件)可以得回Article物件 $Article
5. $Article->getContent()可以取回wiki原文
6. 產生陣列 $Article->mParserOutput->mSections ，稱之為$sections
7. $sections為註標索引陣列，每一元素為一段，元素值為段落描述陣列
8. 查出某段名的段序號，即可代入 $wgParser->getSection($Article->getContent(),段序號)) 求該段的 wiki 原文

段落描述陣列

以「公共教育重設定」的第二段為例：

[toclevel] => 2，上一層level
[level] => 3，本段為第幾層
[line] => 時代的限制，段名
[number] => 1.1，幾之幾
[index] => 2，第幾段
[fromtitle] => 公共教育重設定，隸屬的頁名
[byteoffset] => 511，byte數
[anchor] => .E6.99.82.E4.BB.A3.E7.9A.84.E9.99.90.E5.88.B6，錨點

1. line為段名
2. index為段序號

從步驟3開始的程式說明

以「公共教育重設定」的第二段為例：

• 步驟3,4，由頁名取文章

$Article=new Article(Title::makeTitle(0,'公共教育重設定'));

• 步驟6，產生文章的段落描述，以下三行在Article類別，view()方法中

$parserOptions = $Article->getParserOptions();
$parserCache = ParserCache::singleton();
$Article->mParserOutput = $parserCache->get( $Article, $parserOptions );

不能用view()方法，不然會產生畫面中額外的bodytext輸出

• 步驟7，由段名找段序號

$sectionLine='時代的限制';
$sectionIndex=0;
foreach($Article->mParserOutput->mSections as $v){
	if($v['line']==$sectionLine){$sectionIndex=$v['index'];break;}
}

• 步驟8，傳回段落wiki原文

$wgParser->getSection($Article->getContent(),2);

相關方法屬性描述

• 取回Title物件：Title::makeTitle(名字空間編碼,純名)
• 取回Article物件：new Article(Title物件)
• 取頁的wiki全文：Article物件getContent()方法
• 產生文章的段落描述：Article物件view()方法
• 各段描述陣列：Article物件->mParserOutput->mSections
• 取段的wiki原文：$wgParser->getSection(全文,段序號)

其他說明

由請求的 URL 取段序號

$section=$wgRequest->getVal('section');

由Article透過RawPage求wiki全文

有Article其實可以直接用getContent()取回wiki原文，不必繞 RawPage 和 Revision

$rawPage=new RawPage($Article);	// 起RawPage須給入某Article
Revision::newFromTitle($rawPage->mTitle,$rawPage->mOldId)->getText();

1. 給一個Article，用 RawPage 物件即可取得其頁名(title)及版本id(oldId)
2. 用Revision類的newFromTitle方法套入版本id及頁名可以得到版本物件
3. 用版本物件的getText()方法可以得到wiki原文