MediaWiki初探:安装及使用入门
來源:http://blog.csdn.net/wangnan537/article/details/37743497
MediaWiki是著名的開源wiki引擎,全球最大的wiki項目維基百科(百科詞條協作系統)是使用MediaWiki的成功范例,MediaWiki的最大作用在于對知識的歸檔,可用于構建企業/個人知識庫。MediaWiki官網地址為http://www.mediawiki.org/wiki/MediaWiki,目前最新版本是1.23.1(2014年6月25日)。
一.安裝
安裝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初探:安装及使用入门的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: CompletableFuture详解~
- 下一篇: 设计模式3—行为型模式