MediaWiki建立與使用指南
- 一、搭建MediaWiki(可直接跳至第三點)
-
- (一)Wiki系統簡介
-
- 1. 什麼是wiki系統?
- 2. 如何選擇wiki系統?
- (二) HDwiki系統——基于中文的維基引擎
- (三)MediaWiki簡介及搭建
-
- 1. 安裝環境
- 2. 安裝和配置MediaWiki
- 二、個性化設定自己的wiki
-
- (O)說明文檔:
- (一)配置自己的logo
- (二)wiki的側邊欄設定
- (三)wiki的使用者權限設定
- (四)wiki擴充
-
- 1. 添加WikiEditor編輯器擴充
- 2. 添加Math數學擴充
一、搭建MediaWiki(可直接跳至第三點)
最近又戳戳戳地跳到了自建wiki的摸索中了,沒辦法,先生實驗室建設需要一個維基系統來管理工作所需知識以及帶領團隊,需要什麼學習什麼。
聲明:本文中超連結中所有的軟體下載下傳連結均來自官網或者github!
(一)Wiki系統簡介
1. 什麼是wiki系統?
wiki是一種特别的内容管理系統,多人協作模式、内容逐漸積累、網狀知識連結是其鮮明特色。根據這些特點,wiki在很多應用方面都能發揮作用。wiki的知識關聯特性也很适合個人筆記的資料整理。
在内容協作上,wiki非常适合做百科、專題知識庫等,例如軟體使用手冊、旅遊參考、網際網路技術等。另外,wiki在企業中建立背景知識庫是很好的方案,用于項目開發的共識溝通也很常見。
以上内容引自部落格http://pythonic.zoomquiet.top/data/20070308144722/index.html
2. 如何選擇wiki系統?
目前熱門的wiki系統有哪些?它們分别實作什麼功能?以及需要怎樣的搭建環境?有興趣的可轉到sharky77的部落格國内外常用wiki程式彙總,進行詳細了解和選擇。
(二) HDwiki系統——基于中文的維基引擎
HDwiki,一個基于中文開發的維基引擎,具體見維基百科HDwiki介紹,但是該系統後來因維護的公司不再更新,因而沒有了支援。隻是因為我機關的維基系統便是基于HDwiki建的,自己做過幾年維護,會更熟悉一些,是以第一步我是使用該系統搭建的。
然而先生喜歡更簡潔的界面,他的心理預期是像維基百科那樣的維基系統,因而該系統被無情地抛棄了。如果對HDwiki感興趣的盆友可移至此處檢視安裝過程,以及此處HDwiki架構介紹。
我個人搭建該系統使用的是:phpstudy+HDwiki。
(點選藍色字型下載下傳,phpstudy省去安裝mysql+apache+phpmyadmin過程)
不過必須注意的是:phpstudy不能下載下傳最新版,最好下載下傳2014年的版本,否則版本過高,不能支援HDwiki。
附一個基于HDwiki搭建的維基系統:光明百科
(三)MediaWiki簡介及搭建
網絡上目前熱門的wiki引擎——比如說最著名的維基百科便是基于MediaWiki開發的,其界面如下:
很熟悉的畫風,是吧!
下面我們就開始基于MediaWiki搭建自己的維基系統了。
1. 安裝環境
MediaWiki的工作手冊上詳細介紹了其安裝指南,該系統使用php語言開發,我個人為了省事,依然直接使用phpstudy+MediaWiki安裝的。
我的環境及下載下傳連結:Windows server 2012 + phpstudy V8.1 + MediaWiki 1.34。
另附上phpstudy官網:
https://www.xp.cn/
,可以選擇基于Linux系統或Windows系統。
第一步:安裝phpstudy:解壓壓縮包,根據提示一步步安裝就好。如有更多問題可通路其官網教程https://www.xp.cn/wenda/392.html。
第二步:檢查phpstudy各功能配置的版本,若有需要修改的,可以更改版本。
第三步:配置phpstudy:首頁啟動apache和mysql,并設定自啟動。其中,apache預設端口為80,mysql預設端口為3306,若發生端口沖突,請進行進一步修改,在設定中進行端口檢測,看是否沖突。
第四步:檢查網站項,安裝好的情況下,網站項中隻有一個apache所對應的原始實體路徑,即phpstudy所在的www檔案夾。(圖檔中的2是我自建的wiki網站配置,後面會講到)。
至此,phpstudy的各項配置就結束了,若要了解更多該系統各功能子產品詳細介紹,見其官網教程。
2. 安裝和配置MediaWiki
第一步:解壓下載下傳的MediaWiki檔案到phpstudy的www目錄下,我的目錄是:
C:\phpstudy_pro\WWW\mediawiki-1.34.1
第二步:用浏覽器通路
http://localhost/mediawiki-1.34.1/index.php
,即跳轉到安裝頁面,根據安裝提示,一步步安裝。另附參考MediaWiki初探:安裝及使用入門。
注意:安裝時一定要記錄下來自己的管理賬戶和密碼
第三步:配置完成後會生成LocalSettings.php檔案,根據提示下載下傳并儲存至mediawiki的根目錄(index.php的同級目錄)。
第四步:phpstudy配置:在網站項中點選建立網站,輸入域名(即你要通路的網址,比如此處我可以通過localhost/orderwiki通路到網頁,而不需要通過端口方式localhost:8000通路。)、設定端口等内容。當然還可以進行一些進階配置,比如錯誤日志、緩存等,此處不做展開,留待以後慢慢探索。
第五步:至此,基本配置完成,就可以通過localhost/orderwiki通路到我們搭建的wiki了。
【我的網站搭在阿裡雲的ecs伺服器上,在執行個體管理的安全組配置中配置規則,開放8000端口可通路,就可以在外網通路該wiki了。】
二、個性化設定自己的wiki
(O)說明文檔:
頁面導航:https://www.mediawiki.org/wiki/Help:Navigation/zh
編輯頁面:https://www.mediawiki.org/wiki/Help:Editing_pages/zh
可視化編輯器:https://www.mediawiki.org/wiki/Help:VisualEditor/User_guide/zh
(一)配置自己的logo
打開
LocalSettings.php
檔案,找到以下代碼:
mediawiki的logo大小為135*135的png格式,因vector視圖中,側邊欄底色是灰色的,logo底色最好是透明的,否則會很突兀。
原始的logo位置在
$YourWikiPath\resources\assets
檔案夾下,名稱為wiki.png,
配置自己的logo最好将自己的logo.png放在同樣的檔案夾下,不要覆寫掉原來的Logo,起個屬于自己的名字,我自己的logo名為order,然後在配置檔案中修改logo位址就好了。
OK!
(二)wiki的側邊欄設定
登陸管理者賬戶,在該賬戶下網頁導航欄輸入:
MediaWiki:Sidebar
即可導航至側邊欄編輯位置。或者輸入全部網址:
http://localhost/OrderWiki/index.php?title=MediaWiki:Sidebar
:
點選編輯即可進入編輯頁面:
MediaWiki編輯器的文法中,以
*
作為标題級别。
一級标題不進行導航,二級标題起,可以進入導航模式。
|
前後的内容分别為導航詞條名和側邊欄顯示内容。
點選側邊欄内容,将進入詞條頁,如下圖所示,該詞條目前還沒被建立,至此,就可以點選開始建立我們的詞條了。
(三)wiki的使用者權限設定
MediaWiki對使用者權限做了非常詳細的設定,具體設定方式可參見MediaWiki使用者手冊:使用者權限管理。
(四)wiki擴充
MediaWiki提供了很多擴充,其所有的擴充都放在該頁面:https://www.mediawiki.org/wiki/Category:All_extensions
1. 添加WikiEditor編輯器擴充
MediaWiki中對WikiEditor的介紹:
https://www.mediawiki.org/wiki/Extension:WikiEditor
下載下傳連結:
https://github.com/wikimedia/mediawiki-extensions-WikiEditor/archive/master.tar.gz
安裝:
- 下載下傳檔案,并将其放置在您extensions/檔案夾中的WikiEditor目錄内。
- 将下列代碼放置在您的LocalSettings.php的底部:
。wfLoadExtension( 'WikiEditor' )
- 完成,在自己的wiki上導航至Special:Version,以驗證擴充已成功安裝。
添加好該擴充後,編輯器就可以直接使用了。
2. 添加Math數學擴充
MediaWiki中對Math的介紹:
https://www.mediawiki.org/wiki/Extension:Math/zh
下載下傳連結:
https://extdist.wmflabs.org/dist/extensions/Math-REL1_34-b1a022f.tar.gz
安裝:
- 下載下傳檔案,并将其放置在您extensions/檔案夾中的Math目錄内。
- 将下列代碼放置在您的LocalSettings.php的底部:
。wfLoadExtension( 'Math' )
- 完成,在自己的wiki上導航至Special:Version,以驗證擴充已成功安裝。
使用:
正在探索中…