MediaWiki使用指南
MediaWiki使用指南
MediaWiki是著名的開源wiki引擎，全球最大的wiki項目維基百科(百科詞條協作系統)是使用MediaWiki的成功范例，MediaWiki的最大作用在于對知識的歸檔，可用于構建企業/個人知識庫。
MediaWiki官網地址為http://www.mediawiki.org/wiki/MediaWiki
?
一．安裝
安裝MediaWiki前需要搭建運行環境，我的環境是apache+php+mysql；有了運行環境，然后下載MediaWiki，壓縮包 是.tar.gz格式，在Windows上可以使用7-Zip解壓；解壓到文件夾如mediawiki下，拷貝到web服務器根目錄，然后通過瀏覽器訪問 MediaWiki所在目錄（例如：http://localhost/mediawiki/index.php），跟隨安裝提示直到完成。配置完成后會 生成LocalSettings.php文件，根據提示下載并保存至mediawiki根目錄(index.php的同級目錄)即可。
安裝成功后，點擊進入首界面，如下圖所示。
二．使用入門
1.修改默認logo
mediawiki站點默認logo圖片路徑名：$WIKI_HOME/skins/common/images/wiki.png，可以通過以下兩種方式修改默認logo:
(1)用圖片編輯工作打開wiki.png圖片，進行修改后覆蓋即可；或者自己新建一個135 x 135像素，圖片格式為.png的同名圖片覆蓋即可，建議使用透明背景，否則將嚴重影響視覺效果。
(2)將logo文件放在目錄$WIKI_HOME/skins/common/images下，再在根目錄下打開 LocalSettings.php文件，找到$wgLogo= "$wgStylePath/common/images/wiki.png"，修改為$wglogo="$wgStylePath/common /images/logo文件名"
注：可以使用默認logo圖片同目錄下的mediawiki.png替代。
?
2.去除底部powered by圖標
在配置文件LocalSettings.php中加入如下行即可，
unset($wgFooterIcons['poweredby']);
?
3.修改皮膚
MediaWiki系統的默認皮膚是Vector，使用管理員賬戶登錄后，可以通過"設置" -> "顯示" –> "皮膚"預覽所有皮膚效果，不過此處修改保存的話，只有在管理員賬戶登陸時才有效。
如要修改系統默認皮膚，要在根目錄下打開配置文件LocalSettings.php，找到$wgDefaultSkin = 'vector';一行，如希望使用Modern皮膚，則改為$wgDefaultSkin='modern';
如想增加新皮膚，可下載皮膚插件保存到skins目錄下，然后通過上述方法使用新皮膚。
?
4.新建頁面
如果搜索一個不存在的頁面，會得到一個鏈接去創建新頁面；也可以用wiki的URL創建新頁，如想新建一個名為HelloWorld的頁面，則可在地址欄輸入：http://localhost/mediawiki/index.php/HelloWorld,在出現的頁面中點擊"創建"，輸入內容后點擊"保存頁面"即可，如下圖所示。
?
5.頁面格式化
可以通過使用wiki標記來格式化文本，下文描述了部分wiki標記，更多詳情可查閱http://www.mediawiki.org/wiki/Help:Formatting
字符格式化
如，文本內容用兩對單引號括起來(''italic'')可實現斜體效果，用三對單引號括起來('''bold''')可實現粗體效果，用 strike標簽括起來(<strike>strike</strike>)實現刪除線效果；使用標簽nowiki括起來則會忽 略上述標記。
章節格式化
(1)標題
MediaWiki頁面中的標題使用等號標記，用幾對等號括起來則表示是幾級標題。
== Level 2 ==
=== Level 3 ===
==== Level 4 ====
===== Level 5 =====
====== Level 6 ======
注: #1. 不建議用一對等號，它表示頁面自身。#2. 頁面中有4級及更多標題時，會自動生成目錄。
(2)水平線
如果想在頁面內容之間插入分割線，可在要分割的地方使用"----"，如下所示：
水平線之前
----
水平線之后
(3)無序列表
文本前加"*"號可以實現無序列表效果，"*"號的個數表示列表對應的級別，如
*1
**11
**12
*2
**21
**22
(4)有序列表
文本前加"#"號可以實現有序列表效果，"#"號的個數表示列表對應的級別，如
#1
##11
##12
#2
##21
##22
分段
MediaWiki不識別換行。要另起一段，需要使用一空行；在段落中可通過HTML標簽<br/>強制換行。
HTML標簽
在MediaWiki中允許使用部分HTML標簽。如使用<u>標簽實現下劃線效果，<s>標簽實現刪除線效果等。
6.鏈接
下文僅簡要描述內部鏈接和外部鏈接的用法，更多信息可查閱http://www.mediawiki.org/wiki/Help:Links
內部鏈接
內部鏈接，即鏈接到wiki中其他頁面的鏈接。將目標頁面名使用兩對方括號括起來表示一個內部鏈接(如[[HelloWorld]])。保存后，如鏈接指向的頁面已存在，鏈接會顯示為藍色，否則顯示為紅色。
如果想將鏈接顯示為文字信息，需使用格式[[頁面名|文字]]，如[[HelloWorld|到HelloWorld頁面]]。
外部鏈接
外部鏈接，即鏈接到其他網站的鏈接。輸入網站地址并以空格結束，就可以生成一個外部鏈接。保存后，鏈接后會有一個箭頭，表示指向外部。
如果想將鏈接顯示為文字信息，需使用格式[外部網址文字]，如[http://www.baidu.com 百度]。
7.分類
在頁面中加入[[Category:分類名]]，會在頁面底部生成分類鏈接，點擊鏈接后可看到該分類下的所有頁面。
8.上傳文件設定
配置文件LocalSettings中，$wgEnableUploads就是控制上傳的參數，true允許，false不允許。
MediaWiki中允許上傳的文件類型是有限制的，默認支持'png','gif', 'jpg', 'jpeg'這幾種文件類型，對應的配置可參閱DefaultSettings.php中$wgFileExtensions的值；而不允許的文件類型在 參數$wgFileBlacklist中設定。
登錄后，可以通過導航欄或特殊頁面中的上傳文件鏈接上傳文件。可使用[[File:文件名]]在頁面中引用文件，如果引入的是圖片文件，還可以指定 圖片寬度([[File:Example.jpg|200px]])，加入圖片說明([[File:Example.jpg|圖片1]])
9.編輯器
MediaWiki自帶的編輯器比較簡單，用于頁面編輯不太方便。從1.18版開始，MediaWiki中集成了一款增強型編輯器WikiEditor，在LocalSettings.php中加入如下行可啟用WikiEditor，
$wgDefaultUserOptions['usebetatoolbar'] =1;
從1.21版本開始，MediaWiki默認集成了GeSHi(Generic Syntax Highlighter)插件，這是一款支持語法高亮顯示的插件，借助<syntaxhighlight>標簽可在頁面中顯示格式化的源碼， 還可以在此標簽中使用參數"line"以顯示代碼行號，如下面的例子所示：
<syntaxhighlight lang="php"line>
<?php
???echo "Hello, World!";
?>
</syntaxhighlight>
?
10.修改導航欄
通過wiki地址index.php/MediaWiki:Sidebar
如，http://localhost/mediawiki/index.php/MediaWiki:Sidebar，或者在搜索欄中輸入"mediawiki:sidebar"，進入頁面后點擊編輯即可。
導航欄格式如下：
*導航欄名稱一
**鏈接一地址|鏈接一名稱
**鏈接二地址|鏈接二名稱
? ?
*導航欄名稱二
**鏈接一地址|鏈接一名稱
**鏈接二地址|鏈接二名稱
11.查看MediaWiki版本
可通過選擇"特殊頁面" -> "數據與工具" -> "版本"，或者搜索"Special:Version"打開版本頁面，在這個頁面可以看到MediaWiki版本、PHP版本、Apache版本和所安裝的擴展的版本等信息。
12.用戶組
MediaWiki中有3個用戶組：機器人/管理員/行政員，每個用戶組的具體權限可通過"特殊頁面" -> "用戶組權限"查看，通過首頁中"創建用戶"注冊的用戶默認不屬于任何用戶組；從屬于行政員用戶組的用戶，可通過"特殊頁面" -> "用戶權限管理"給其他用戶分配用戶組。
13.頁面緩存
在配置文件DefaultSettings.php中，找到參數$wgCacheEpoch，將參數值置為當前時間，可以取消全部已經緩存的頁面(包括客戶端和服務器端)。
?
?日常開發中總會有許多東西需要記錄，很多軟件都可以做到這一點，例如有道云筆記，或者寫博客。但個人偏愛于Mediawiki，因為wiki可定 制性強，總給人一種高端大氣的感覺。起初對wiki這種東西一無所知，受老總的影響，開始在公司推廣wiki，可惜到現在沒有推廣成功，不過自己倒是喜歡 上這東西了。廢話少扯，進入正題吧。
????首先大致說說wiki是什么吧。在我看來，wiki就是一種學術性的博客，但是更加嚴謹，相當于字典，也不完全像字典一樣拘束與單詞，總 之，我也說不清楚，形象的說，就是一個文檔系統吧。當前有很多wiki軟件，例如Wikipedia使用的Mediawiki，以及MoinMoin，還 有其他的很多版本；而Mediawiki應該是最廣為人知的吧。
?
mediaWiki2
Wiki安裝
????Mediawiki基于php，可以選擇MySQL、Sqlite等諸多數據庫，在windows上首選wamp server來配置神一般的Php+MySQL環境。本文使用的是Mediawiki1.21.2，Wamp2.4 ，windows8 pro x64的環境。可以建一個專門放網站的目錄，例如d:/work/www，將wiki解壓到該目錄下即可。在wamp安裝目錄下的alias目錄下，新建一個配置文件，例如wiki.conf，內容如下：
| 1 2 3 4 5 | NameVirtualHost?*:80 <VirtualHost?*:80> ????DocumentRoot?"D:/Work/www/mediawiki-1.21.2/" ????ServerName?solee.org </virtualHost> |
????因為是本機的緣故，我在host中將solee.org解析到127.0.0.1，窮人買不起虛擬主機。這樣訪問localhost，將會 進入Mediawiki的初始化安裝界面。該安裝程序實際上是引導你生成LocalSettings.php，當然也可以手工設置。建議先自己選擇，這樣 會生成一個LocalSettings.php文件，并執行相應的數據庫初始化，將此php下載后放到wiki的根目錄下面，直接再訪問 localhost即可進入wiki。好了，wiki安裝就這樣簡單。
基本配置
????wiki配置很豐富，下面介紹幾種可能感興趣的配置：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | #個人wiki，禁止創建帳號功能，除非登陸才能訪問 $wgGroupPermissions['*']['createaccount']?=?false; $wgGroupPermissions['*']['edit']?=?false; $wgGroupPermissions['*']['read']?=?false; ? ? #啟用詳細異常顯示. $wgShowExceptionDetails?=?true; ? ? #去除底部powered?by圖標 unset($wgFooterIcons['poweredby']); ? ? #對于沒有登錄的用戶,沒有登錄的用戶移除頁面頂部的討論頁鏈接 $wgShowIPinHeader?=?false; ? ? #默認在新標簽頁中打開鏈接 $wgExternalLinkTarget?=?'_blank'; |
????其他諸如圖標、主題、短鏈接等配置可以自行探索。
常用插件
????常用的插件，主要是富文本編輯器了，當個人傾向于使用純文本編輯器，也就是Mediawiki自己提供的編輯器。默認的工具條很丑，可以在頁面右上角的設置->編輯中開啟增強功能。
????富文本編輯器可選用WYSIWYG,搜索合適的版本下載之后，解壓到extensions目錄，并在LocalSettings.php中添加一行，加載此拓展：
富文本編輯器
| 1 | require_once(?"$IP/extensions/WYSIWYG/WYSIWYG.php"?); |
????這樣安裝好之后，可以在設置中選擇喜歡的編輯器，或者選擇在文本和富文本編輯器中自由切換。
代碼高亮
????1.21.2的代碼高亮插件已經默認集成了，如果沒有集成，可以搜索Mediawiki Geshi安裝此插件。
pdf導出
? ?Mediawiki的?pdf導出應該說算是比較頭疼的問題了，其實支持pdf導出的插件不少，但是對中文的支持非常不好，目前可以用PdfExport插件比較完美的實現。官方的PdfExport插件已經過時（目前不知道是否更新了），需要進行部分修改：
Mediawiki1.21.2導出，可以使用PdfExport插件+Mpdf進行。當前HtmlDoc等其他后端均不能支持中文。 Mpdf需要配置支持CJK字符
配置LocalSettings.php
| 1 2 3 4 | #pdf導出插件 require_once("$IP/extensions/PdfExport/PdfExport.php"); #使用Mpdf作為PdfExport的后端，但必須配置支持ckj字體 $wgPdfExportMPdf?=??$IP?.?'/extensions/Mpdf/mpdf.php';?//?Path?to?the?main?mPDF.php?file |
配置字體config_font.php（需要將字體添加到字體文件夾中）
????????"sun-exta"?=>?array(
????????????????'R'?=>?"Sun-ExtA.ttf",
????????????????'sip-ext'?=>?'sun-extb',
????????????????),
????????"sun-extb"?=>?array(
????????????????'R'?=>?"Sun-ExtB.ttf",
????????????????),
修改config_cp.php
????????CASE?"zh":
????????????????$unifonts?=?"sun-exta,sun-extb";
????????????????break;
修改MPdfConverter.php
????????$mpdf?=?new?mPDF('zh');
????????$mpdf->SetAutoFont(AUTOFONT_ALL);
????????$mpdf->WriteHTML($html);
修改config.php
????????$this->useAdobeCJK?=?true;
另外，需要注釋掉下面的函數調用：
????????//wfLoadExtensionMessages('PdfPrint');
其他插件：
| 1 2 3 4 5 6 | #Flash插件 require_once("$IP/extensions/oflash/orificeflash.php"); #視頻插件 require_once("$IP/extensions/MediawikiPlayer/MediawikiPlayer.php"); #批量導入插件 require_once("$IP/extensions/MultiUpload/MultiUpload.php"); |
????當然具體的插件需要自己去下載。通常谷歌Mdiawiki ?<插件名稱>即可找到官方的下載地址。
備注：
| 1 2 | #禁用掉此擴展，否則可能不能正常進入wiki #require_once(?"$IP/extensions/LocalisationUpdate/LocalisationUpdate.php"?); |
備份及優化
????備份主要涉及到數據庫的備份及Wiki的備份。對于這種非分布式、非云計算（哈哈——）的東西來說，備份就顯得尤為重要了。
| 1 | ????D:\Prog\wamp\bin\mysql\mysql5.6.12\bin\mysqldump?-u?root?-ppassword?solee_wiki_db?>F:\wiki.sql |
????wiki備份直接把wiki的文件夾打個包即可。如果是采取sqlite數據庫的話，數據庫備份更加簡單了。
????在windows上一個比較煩人的問題就是，wamp的mysql內存占用甚是大，在我4G內存的機器上吃了500M，這不能忍啊，因此需要優化一下mysql：
[mysqld]
port=3306
max_connections?=?100
#加入以下內容
performance_schema_max_table_instances=600
table_definition_cache=400
table_open_cache=256
?
?
注：內容來源于網絡:http://blog.csdn.net/wangnan537/article/details/37743497
轉載于:https://www.cnblogs.com/weihanli/p/5241001.html
總結
以上是生活随笔為你收集整理的MediaWiki使用指南的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 心得体会？？？
- 下一篇： 数据库VIEW(视图)