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

二.选择入门

1.改动默许logo

mediawiki站点默许logo图片路径名:$WIKI_HOME/skins/commonwiki.png,可以经过以下三种艺术修改默许logo:

(1)用图形编辑工作打开wiki.png图片,举行改动后覆盖即可;或者自己新建一个135
x
135像素,图片格式为.png的同名图片覆盖即可,指出利用透明背景,否则将严重影响视觉效果。

(2)将logo文件放在目录$WIKI_HOME/skins/common/images下,再在根目录下打开
LocalSettings.php文件,找到$wgLogo=
“$wgStylePath/commonwiki.png”,修改为$wglogo=”$wgStylePath/common
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,在产出的页面中点击”创造”,输入内容后点击”保存页面”即可,如下图所示。

图片 2

 

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的值;而不容许的文件类型在
参数$wgFile布莱克list中设定。

登录后,可以透过导航栏或特殊页面中的上传文件链接上传文件。可选用[[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");

    当然具体的插件要求自己去下载。寻常谷歌(Google)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

网站地图xml地图