mediawiki的安裝使用修改詳細教程-非常完全的入門教程

2017-02-26 19:43:00
小蜜蜂
原創
5031
作者:xiajian2010

緣起

決定投身web和互聯網。最近一段時間,借著給老師搭建一箇介紹研究成果的網站,從wordpress,到Ruby on Rails,到wiki類的網站都試瞭一遍,這次是對mediawiki的嚐試。

正文

Mediawiki目前支持多種語言,當然對中文支持也是非常不錯的。以下是Mediawiki的一些特點

1、PHP+MySQL

2、安裝簡單,mediawiki考慮到瞭各類群體,所以安裝非常簡單。隻要你認真填寫mysql數據庫配置信息,很容易就安裝上瞭。

3、全世界最大的wiki項目維基百科全書是使用mediawiki的成功範例,數據量、訪問量都超級龐大。4、程序功能豐富,可以滿足簡單到高級的wiki網站製作。

1. Mediawiki安裝

Mediawiki上官方安裝教程:www.mediawiki.org/wiki/Installation ,以下是箇人的安裝經驗:

繫統前提:Ubuntu 12.10 

前置條件:

Web服務器:apache2 server(sudo apt-get install apache2)

PHP語言:php (sudo apt-get install php php-mysql)

數據庫:mysql(sudo apt-get install mysql-client mysql-server)

備註:當然上述的除瞭php沒的選,web服務器(apahce,iis,nginx,lightttpd)和數據庫(msysqk,PostgreSQL,Sqlite3,Oracle,ms sql server)都是具有多箇選擇的。

前置條件的安裝可以詳細蔘考關於wordpress

1.1. 在Ubuntu下的安裝

下載mediawikitar(http://www.mediawiki.org/wiki/Download)

wget http://releases.wikimedia.org/mediawiki/1.22/mediawiki-1.22.6.tar.gz

解壓,修改文件名(去掉版本號)

tar xvf mediawiki-1.22.6.tar.gz

mv mediawiki-1.22.6/ mediawiki/

併將其放到apache2的服務器主目録下(/var/www

sudo mv mediawiki/ /var/www/mediawiki

在瀏覽器中輸入http://[domain]/mediawiki/,domain可以是域名或直接的ip地址,比如 http://222.42.14.9/mediawiki/

此時看到的如下的頁麵:

點擊set up the wiki,進入安裝頁麵,選擇安裝配置所有的語言,這裡都選中文簡體(zh-hans):

單擊繼續之後,看到環境配置的警告:

  • l 找不到APCXCacheWinCache,無法啟用對象緩存。
  • l 因爲尚未安裝 intl PECL 擴展以處理 Unicode 正常化,故隻能退而採用運行較慢的純 PHP 實現的方法。

備註:這裡暫時忽視這些警告,併且像對象緩存這樣php插看隻是對流量巨大的網站有用,我搭建的這箇小網站不太可能需要這些插件。

下一步是,配置數據庫,這裡使用的是mysql,需要填寫的字段如下:

然後是名稱配置:

最後,是一些選項的設置,例如版權和許可證,電子郵件設置,擴展,文件上傳之類的。由於是第一次安裝,設置瞭簡單的版權,勾選瞭一些關於擴展方麵的選項(隨後通過修改配置文件更改),啟動瞭文件上傳:

然後,就可以等待安裝。最後,配置成功後界麵如下:

此時,需要將下載的LocalSetings.php保存到mediawiki目録下(例如,/var/www/mediawiki).

備註:配置結束後,在瀏覽器中輸入http://222.42.14.9/mediawiki/,看到[185f5321] 2014-04-30 03:06:57: Fatal exception of type MWException

解決方法:

mediawiki目録下的localSettings.php 文件末添加下行代碼卽可:

$wgLocalisationUpdateDirectory = “$IP/cache”;

註意:“$IP/cache”中的引號是英文引號,不是中文引號。

安裝成功的截圖:

此時,可以使用配置過程設置的用戶登録。

在上述安裝中,註意以下內容,以便陞級時使用:

 Site name:你的wiki站點名稱。註意:這與網站本身的名字空間有關,建議使用簡短的英文(以後可修改)

 Contact e-mail:站長的聯絡郵件

 Language:語種選擇。建議選擇zh-cn簡體中文或zh-tw繁體中文;沒必要就不要選支持繁簡體自動轉換的zh中文,否則此後網站提示的本地化工作量將增加很多

 Copyright/license medadata:版權類型。其中GNU爲公開的自由版權,允許他人複製、修改;不確定該用什麽版權時選no license metadata

 Sysop account name:站長的名字。這是建立wiki後的第一箇管理員用戶,以後無法改名。可考慮使用英文名字

 password:站長的密碼

 Shared memory caching:網站緩衝機製,可以不選

 MySQL server:填寫空間服務商提供的MySQL服務器名稱,一般爲localhost

 Database name:數據庫名稱,根據與空間服務商的約定填寫

 DB username:數據庫用戶名

 DB password:數據庫密碼

 Database table prefix:數據錶前綴。在衕一數據庫中架設多箇wiki時需要。

 DB root password:數據庫root密碼。(可忽略)

2. Mediawiki使用

Mediawiki的配置文件分兩處:1.includes/DefaultSettings.php-繫統默認的配置文件 2.LocalSettings.php 用戶設置的配置。主要在LocalSettings.php中進行設置和覆蓋相應配置,而不是DefaultSettings.php。

2.1. 修改網站LOGO

想要將左上角的mediawiki圖標替換爲自己的圖標,可以在skins/common/images/目録下找

到名爲“wiki.png”的圖片文件,將牠替換爲自己的圖片卽可。

當然也可以採用編輯$wgLogo變量的方法,下麵是箇人使用的方法。

尋找logo圖片,找到的圖片(bug.jpg)如下:

將其放到/var/www/mediawiki/images/目録

編輯/var/www/mediawiki/LocalSettings.php,在文件末尾添加:

$wgLogo="/mediawiki/images/bug.jpg";

註意, images是上傳文件的圖片存放的目録,bug.jpg是通過瀏覽器遠程傳到服務器上的。在上傳的過程中齣現瞭問題:Could not create directory “mwstore://local-backend/local-public/1/11

在查看蔘考7後,找到解決方案,需要將mediawiki下的images的文件的權限修改:

sudo chown -R www-data:www-data images/

此時,就可以正確的上傳文件瞭。關於文件上傳的更仔細的介紹蔘考:http://www.mediawiki.org/wiki/Manual:Configuring_file_uploads#Prerequisites

2.2. 圖片相關

啟用Mediawiki的上傳功能

  • l 設置images文件夾爲網絡可寫:sudo chown -R www-data:www-data images/
  • l 在配置文件LocalSettings.php 中找到$wgEnableUploads將其設置爲true

$wgEnableUploads       = true;

這樣就啟用瞭MediaWiki的上傳功能,當然如果在上麵的安裝過程中設置瞭文件上傳功能,可以看到配置文件中默認將其設置爲true

MediaWiki上傳圖片

上傳頁麵的地址是: Special:Upload ,也可以先進入特殊頁麵,然後進入上傳文件頁麵。在該頁麵中上傳圖片,設置好文件名和描述,上傳成功以後就可以在文章中使用瞭。

MediaWiki使用圖片

在要插入圖片的位置輸入:[[Image:file.jpg]]

就可以顯示對應的圖片瞭。

限製上傳文件大小

默認DefaultSettings.php中上傳文件的大小爲100MB,如需設置可以在LocalSettings.php增加下麵一行

$wgMaxUploadSize = xxx; #單位爲字節。

備註:上傳文件的大小本身受到php環境的限製,卽/etc/php5/apache2/php.ini中的post_max_sizeupload_max_filesize變量的值。Mediawiki中上傳限製的大小的取值順序爲:post_max_size>=upload_max_filesize>=$wgMaxUploadSize。如果php環境中設置的值比較小,$wgMaxUploadSize設置的再大也沒有用。修改php.ini後,需要重啟apache服務器(sudo /etc/init.d/apache2 restart)。

引用外部圖片 

localsettings.php增加下麵一行卽可(可能引起安全問題):

$wgAllowExternalImages = true;

通過圖片URL進行上傳(使用可被公開訪問的圖片鏈接進行遠程圖片上傳,不過隻有操作員纔可以用,這是齣於安全性考慮)

localsettings.php增加下麵一行(可能引起安全問題,建議不要這麽做):

   $wgAllowCopyUploads = true;

2.3. 其他文件上傳

開啟其他文件上傳,比如doc,pdf,ppt,docx,pptx

打開mediawiki根目録中的includes/DefaultSettings.php,查看$wgFileExtensions ,此變量默認僅支持'png', 'gif', 'jpg', 'jpeg'四種,這意味著可以上傳的文件隻有這幾種,但是可以在LocalSettings.php中設置,添加如下行(建議不要直接修改DefaultSettings.php:

$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg','doc','ppt','pdf' );

上傳過程齣現錯誤提示 該文件包含或具有一箇不正確的擴展名。請檢查此文件併重新上傳”,比如,已經在wgFileExtensions中設置瞭允許上傳ppt類型,還是上傳不瞭。在wiki根目録中LocalSettings.php中添加如下一行:

$wgVerifyMimeType=false

當然,也可以直接修改includes/DefaultSettings.php,將$wgVerifyMimeType修改爲false;但是不建議這樣做。備註:此時,Mediawiki但會把pptxzip處理,word,ppt都是正常的。

2.4. 左側導航欄的設置

進入特殊頁麵,找到sidebar進入,編輯該頁麵設置導航欄。

備註:由於安裝的是中文版,在特殊頁麵中找瞭半天都沒有看到導航欄(sidebar)。後來試瞭直接鏈接MediaWiki:Sidebar(比如,像這樣http://222.42.14.9/mediawiki/index.php/MediaWiki:Sidebar),纔看到瞭sidebar的頁麵。

點擊頁麵進行編輯,修改格式如下:

格式:

*導航欄名稱一

**鏈接一地址|鏈接一名稱

**鏈接二地址|鏈接二名稱

*導航欄名稱二

**鏈接一地址|鏈接一名稱

**鏈接二地址|鏈接二名稱

這裡是樣例導航欄:

* navigation

** mainpage|mainpage

** http://bbs.zzbaike.com|論罎

** currentevents-url|currentevents

** recentchanges-url|recentchanges

** randompage-url|randompage

** helppage|help

 

*推薦網站

** http://www.idcspy.com|美國主機偵探

** http://www.alexacn.org|Alexa中文資訊

** http://down.zzbaike.com|站長下載

** http://site.zzbaike.com|站長網址

** http://edu.zzbaike.com|站長學院

備註:一定要嚴格按照格式,如果僅僅填寫鏈接地址不註明名稱是顯示的,我一開始就因爲這種事情鬱悶瞭老半天。

2.5. 界麵信息修改

MediaWiki的大部分界麵信息存放在Special:Allmessages裡麵,包括界麵的文字、鏈接、氣泡提示、熱鍵等。進行定製時,請找到相應信息,點擊左欄鏈接進行修改。

2.6. 皮膚的設置

Mediawiki的皮膚文件存放在mediawiki主目録下skins文件夾(/var/www/mediawiki/skins)下。一般來説,皮膚包中包含xxx.phpxxx.deps.phpxxx目録這三部分(mediawiki自帶的皮膚沒有xxx.deps.php文件,xxx錶示特定的皮膚名)。

將上述文件(xxx.phpxxx.deps.phpxxx目録)拷貝到skins目録下.然後使用創建時的用戶名登録,進入蔘數設置(Special:Preferences)頁麵,在皮膚中選擇後保存卽可。

註:非註冊用戶無法選擇皮膚,且皮膚的選擇僅僅和登録用戶相關連。

如果希望皮膚能對所有用戶都生效,那麽可以在將其設爲默認皮膚,之後匿名用戶等都將默認使用這種風格。打開LocalSettings.php,在文件末添加如下行:

$wgDefaultSkin = “monobook”;

備註:這裡使用的是繫統自帶的monobook皮膚,可以成用戶上傳的其他任何皮膚。

2.7. mediawiki的基本編輯

2.7.1. 創建新頁麵

利用搜索功能創建新頁麵,例如在左邊欄中搜索超人,搜索結果如下:

在最下方的提示中點擊超人的鏈接建立一箇關於超人頁麵。

2.7.2. 創建頁麵存在鏈接

Wiki頁麵的正文中存在棕紅色的鏈接,則錶明該條目中還沒有內容,可以點擊牠來編輯新的條目,保存後就自動創建新頁麵。比如,下圖中棕色的連接就是還沒有創建的頁麵。

如果需要自行建立新頁麵,請隨意編輯某箇頁麵併輸入“[[新條目名稱]]”,點擊顯示預覽按鈕後卽可按前麵所述進行操作。當然,這可以通過上麵的通過搜索創建新的頁麵。

2.7.3. 縮進與列錶

mediawiki中的縮進不能使用半角空格調整。有以下幾種方式控製縮進格式縮進:(舉例附後)

行首使用半角:號:允許多箇半角冒號連用,以控製不衕文本縮進深度

行首使用半角*號:行首星號是列錶控製符,産生列錶的衕時伴有不衕的文本縮進。允許多箇星號連用。

行首使用半角#號:數字序號的列錶控製符,與星號類似。註意,多箇#號行中夾有非#號起始的文本行時,數字序號會中斷。

使用;:號配閤:分號與冒號稱爲定義列錶控製符,冒號之後的部分換行縮進顯示。

行首使用全角空格:一種非正規手段,不要濫用。

'''粗體文字'''

''斜體文字''

[[鏈接標題]] 內部鏈接

[http://www.example.com 鏈接標題外部鏈接

== dfd == 二級標題字導航

==== dfd === 三級標題字 以此類推

[[Image:Example.jpg]] 嵌入文件

使編輯的時候齣現虛線框,使重要的內容顯示比較醒目,隻要在開頭加上一箇空格就可以瞭(這裡的空格必鬚是半角下的纔可以

2.7.4. 段落調整

wiki文本中,單獨迴車併不會齣現換行。強製換行可以如下手法:

1、增加空行會分開不衕的段落

2、在換行位置使用強製換行標籤“br”

如果需要段與段之間的空行,隻需在前段末尾加上"br”"br",將換爲<>

關於首行空兩格

如果遵循中文書寫習慣,需要在首行前空兩格,可以在首行前端輸入全角的空格符(一直不知道全角有什麽用處)。

2.7.5. 插入圖片

1、當圖片位於本機(沒有網址可供調用)時,需要將圖片上傳後纔能使用。(該頁麵的鏈接可在特殊頁麵中找到,標註爲上傳文件,在左側的工具箱中也可以看到)。註意:圖片文件不能使用中文名稱,應在上載時指定爲英文名稱。 

3、將圖片上傳後,在需要插入圖片的位置輸入“[[Image:Filename.jpg]]”卽可(Filename爲上傳圖片的文件名),卽可齣現如,如果需要添加方框效果,可以輸入“[[Image:Filename.jpg|thumb]]”添加圖片方框。

3、對於上傳到本站的圖片,還可以隨意指定顯示大小、左右位置、添加説明文字等,請蔘看Mediawiki中圖像的使用。

2.7.6. 目録控製

當文章中含有3箇以上標題時,mediawiki將自動在第一箇標題之前生成目録(這是默認的設置)。

如果需要隱去目録,可以在文章中加入“__NOTOC__”標記;

如果需要強製顯示目録而不管標題數量,可以加入“__TOC__”標記;

這兩箇wiki標記不限製齣現位置,但一般齣現在文章頭部或尾部且單獨成行。

2.7.7. 錶格的使用

示例如下:

{|

1行第1列 || 1行第2列 || 1行第3

|-

2行第1列 || 2行第2列 || 2行第3

|-

3行第1列 || 3行第2列 || 3行第3

|}

説明:“{|”“|}”是錶格的頭尾,“|-”代錶錶格換行,“|”引導錶格行內容併以“||”分開不衕單元格

註意:錶格控製符必鬚在行首書寫!非行首錶格代碼將不被認可

單元格內容可包含鏈接、圖片等,以及嵌套內部錶格。

mediawiki的默認錶格沒有邊框,如果需要的話需添加蔘數。(見下文介紹)

border="1" cellspacing="0" 是邊框樣式,不寫的話就不齣邊框

讓一行、一列或一整箇錶格都是衕樣的顔色

{| style="background:yellow; color:blue" border=1

|-

這行是

藍字

黃背景

|- style="background:navy; color:white"

這行是

白字

深海藍

|-

這行

| style="background:white" | 比較

不一樣

|}

2.7.8. 邊框效果

漂亮的頁麵佈局,離不開各種邊框的使用。通過不衕樣式的邊框,可以讓不衕的內容闆塊一目瞭然,有效改進頁麵的可讀性。

邊框樣式的基礎實現有兩種:

div邊框

錶格邊框

<div style="width:100px;background-color:#FF0000;border:5px solid #FFFFFF;">

測試

</div>

solid單線邊框

border:1px solid #808080

常用邊框之一,推薦

dashed虛線邊框

border:1px dashed #808080

常用邊框之一,推薦

double雙線邊框

border:3px double #808080

常用雙線邊框之一,推薦

2.7.9. 頁麵分類

分類是mediawiki中一種重要的內容關聯手段。分類將衕類文章在衕一箇頁麵上集中起來,爲讀者提供查看相關資料的方便

mediawiki的分類還有上、下級關繫,使內容關聯更有層次。在被編輯的文章中添加[[category:XXX]]保存之後這篇文章就會自動被分類爲XXX

分類説明文本一般被放在文章末尾,但實際上牠可以位於文章的任何部分。此外,分類頁麵中也可以進行編輯,以進行必要的説明。

一篇文章可以有多箇分類,順序書寫卽可。例如文章衕時在XXXYY分類中齣現:

[[category:XXX]]

[[category:YYY]]

引用分類頁麵

mediawiki文章中鏈接分類頁麵正確的寫法是[[:category:XXX]],顯示時不會顯示前導冒號

上傳圖片也可以分類

通過對上傳圖片的分類,可以讓更多人瞭解繫統中有哪些圖片,方便在文章中引用,併大量減少重覆圖片的上傳。上傳圖片之後,編輯該頁麵併輸入[[category:分類名稱]]然後保存,則訪問這箇分類頁麵時就能看見該圖片的索引瞭

2.7.10. 模闆

引用模闆 {{模闆名稱}}

創建或者編輯模闆 [[Template:模闆名稱|頁麵顯示文字]]

例如:設置針對條目的討論內容顯示的模闆

在頁麵下方增加一箇名爲{{討論}}的模闆,模闆內容你可以蔘考模闆:討論

{| style="width:100%; border:1px solid #cef2e0; background-color:#f5fffa;"

| style="background-color:#f5fffa;"|'''用戶留言:'''

|-

| style="background-color:#ffffff;"|{{#ifexist:{{TALKPAGENAME}}|:

{{ {{TALKPAGENAME}} }}|目前暫無留言}}

|-

|[{{fullurl:{{TALKPAGENAME}}|action=edit§ion=new&preload=Template:Sign&editintro=Template:SignNotice}} 新增留言] [{{fullurl:{{TALKPAGENAME}}|action=edit}} 編輯留言]

|}

<noinclude>[[Category:模闆]]</noinclude>

 

如果模闆不支持ifexist,需要安裝模闆擴展語法擴展.Extension:ParserFunctions

http://www.mediawiki.org/wiki/Extension:ParserFunctions

加姓名與日期,增加~~~~

2.8. 頁麵權限設置

2.8.1. 禁止新用戶註冊

LocalSettings.php的位置加入:

#Prevent new user registrations

$wgWhitelistAccount = array ( "user" => 0, "sysop" => 1, "developer" => 1 );

此時用戶無法自助註冊。管理員可以到登録頁麵(Special:UserLogin)裡,輸入一箇用戶名和email,然後點擊“by email”,繫統創建帳號併將隨機密碼髮送到指定email裡。

2.8.2. 禁止匿名用戶編輯

LocalSettings.php加入以下等式右側的值決定各組成員的權限。左側第一方括號內的'*'代錶包括匿名用戶在內的所有成員。登録用戶控製存放在'user'組,這些將綜閤決定user_groups數據錶中的成員權限。(適用1.5版本)

這些設置取代瞭以前的wgWhitelistAccountwgWhitelistEdit

#$wgGroupPermissions = array();

$wgGroupPermissions['*'    ]['createaccount']   = false;

$wgGroupPermissions['*'    ]['read']            = true;

$wgGroupPermissions['*'    ]['edit']            = false;

以上例子中禁止瞭匿名用戶的自行創建賬戶和進行編輯。(編輯標籤仍會顯示,但匿名用戶點擊時會被提示要求進行登録。

設定匿名用戶(未登録)可以看到的頁麵

上述設定之後,用戶連首頁和登録頁麵也看不到瞭。因此需要繼續修改在LocalSettings.php中加入:

$wgWhitelistRead = array ("Main Page", "Special:Userlogin", "Wikipedia:Help");

這樣,匿名用戶隻能看到Main Page、登録頁麵以及幫助頁麵。註意根據自己站點的情況修改上述設置,例如改爲:

$wgWhitelistRead = array ("首頁", "Special:Userlogin", "某某Wiki:Help");

對於多字節語言(例如中文),PHP parser可能不能正確解碼。這時可能要用到PHPurldecode()函數來轉換一下:

#中文的首頁編碼

$wgWhitelistRead = array( urldecode("%E9%A6%96%E9%A1%B5") ;

2.8.3. 頁麵保護

以管理員(sysop)身份登録,點擊頁麵上方的的保護(或protect)標籤。如下圖,選擇第三行的(僅允許管理員)Sysop only,然後確認卽可。

保護完成後,該頁麵隻能被sysop(管理員)修改。

文章分類
聯繫我們
聯繫人: 王先生
電話: 0760-88315075
傳真: 0760-88315075
Email: 18449932@qq.com
QQ: 18449932
微信: 13928102596
網址: www.52iot.net
地址: 廣東省中山市西苑廣場富貴閣20樓A座