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(视图)