檢視 Mediawiki 擴展的原始碼

[[分類:Mediawiki]]
==解析器函數(ParserFunctions)==
===安裝===
在 LocalSettings.php 中加入：
#MediaWiki 1.24或更早版本：require_once "$IP/extensions/ParserFunctions/ParserFunctions.php";
#較晚近的版本：wfLoadExtension('ParserFunctions');
可用參數，如：
<pre>$wgPFEnableStringFunctions=true; // 激活the intergrated字符串函數功能
$wgPFStringLengthLimit=1500; // 設字符串函數中字符串最大允許長度，預設值為1000</pre>
===用法===
請參考：[[mw:Help:Extension:ParserFunctions/zh|官網]]

==外掛 CSS==
===安裝===
#[[mw:Special:ExtensionDistributor/CSS 下載]]檔案，並將其放在 extensions 目錄下的CSS目錄內。
#在 LocalSettings.php 中加入：
#*MediaWiki 1.29或更早版本：require_once "$IP/extensions/CSS/CSS.php";
#*較晚近的版本：wfLoadExtension('CSS');
可用參數：
<pre>$wgCSSPath = false;  # 預設值,參考到 $wgScriptPath
$wgCSSPath = '';  # 參考到伺服器的文件根目錄
$wgCSSPath = 'https://example.org/stylesheets';  # 參考到其他的 site</pre>

===用法===
在 wiki 頁中加：
*&#123;{#css:MyStyles.css}&#125; 或 &#123;{#css:/skins/MyStyles.css}&#125; ；
*或直接在解析器函數中寫入 CSS 規則，如下例所示： 
<pre>&#123;{#css:
  body {
    background: yellow;
    font-size: 20pt;
    color: red;
  }
}&#125;</pre>

更多資料請參考：[https://www.mediawiki.org/w/index.php?title=Extension:CSS/zh&variant=zh-tw 官網]

==視覺化編輯器(visual editer)==
*需要 Parsoid
*設 $wgVisualEditorParsoidPrefix = 'localhost';
*設 $wgVisualEditorParsoidURL = 'http://localhost:8000'; // Debian，port 是 8142
*設 $wgDefaultUserOptions['visualeditor-enable'] = 1;
*$wgHiddenPrefs[] = 'visualeditor-enable'; // 不許關閉，若要用 wiki 碼編，不用此行
*設 require_once "$IP/extensions/VisualEditor/VisualEditor.php";
* MediaWiki 1.23，還需要額外的 PHP Parsoid 插件，之後的版本不用。

==Math裝不起來==
版本匹配：
<table class=nicetable>
<tr><th>mw版本</th><th>math版本</th></tr>
<tr><th>1.23</th><th>1.25</th></tr>
<tr><th>1.30</th><th>1.31</th></tr>
</table>

'''三層需求'''
#伺服器上須裝有 texvc ，其編譯環境需要 OCaml 3.06，這一點目前在 DS216 上還做不到。其安裝方法在 Math/math/README 中有詳述，另請見[[Mediawiki_擴充套件#texvc]]。未裝 texvc 時的失敗範例在：
#*[[討論:Mediawiki 外掛]]
#*[http://urclass.net/mediawiki/index.php?title=user:Root urclass.net/mediawiki/index.php?title=user:Root]
#須有「前置字_math」資料表，其結構在外掛套件的 db 資料夾中的 math.mysql.sql ，先匯入資料表，再改名為 「前置字_math」。
#須進行 LocalSettings.php 設定：
#*在 mw1.24版之前用「require_once("$IP/extensions/Math/Math.php");」
#*在 mw1.25版之後用「wfLoadExtension( 'Math' );」
'''各種安裝 texvc 的方法：'''
#[http://galeki.is-programmer.com/posts/4170.html gem install genki-texvc]
#[http://www.hovercool.com/hovercool/index.php/mediawiki安装math插件 apt-get install mediawiki-math-texvc]
#丁丁所寫的外掛 mathImage.php ，需要線上 LaTex 生成，如：
#*[https://www.codecogs.com/latex/eqneditor.php?lang=zh-cn 線上LaTeX]
#*[http://latex.91maths.com/ LaTeX線上示例]


'''請參考'''
*[https://www.mediawiki.org/wiki/Extension:Math/zh#安裝 https://www.mediawiki.org/wiki/Extension:Math/zh#安裝] 頁中，右方模板形成之方框中：
*#「下載擴展」連結，進入[https://www.mediawiki.org/wiki/Special:ExtensionDistributor/Math https://www.mediawiki.org/wiki/Special:ExtensionDistributor/Math]，結果下方各種版本最低只到 1.27 版無可用之版本。
*#「瀏覽存儲庫」連結，進入[https://gerrit.wikimedia.org/g/mediawiki/extensions/Math https://gerrit.wikimedia.org/g/mediawiki/extensions/Math]，其中有更多的早期版本，可以先讀各版本的 README 及 Math.php 看其對 MW 1.23 版的反應如下：
*#*對 1.26 版以上會說須 MW 1.25+ 才能用
*#*對 1.25 會剛好，但仍出現「解析失敗 (缺少 "<code>texvc</code>" 執行程式；請參考 math/README 進行設定。)」
*#*對 1.24,1.23 會說 MathInputCheckTexvc.php 第 65 行指令檢查到「語法有缺陷」