日常开发中总会有许多东西需要记录,很多软件都可以做到这一点,例如有道云笔记,或者写博客。但个人偏爱于Mediawiki,因为wiki可定制性强,总给人一种高端大气的感觉。起初对wiki这种东西一无所知,受老总的影响,开始在公司推广wiki,可惜到现在没有推广成功,不过自己倒是喜欢上这东西了。废话少扯,进入正题吧。
首先大致说说wiki是什么吧。在我看来,wiki就是一种学术性的博客,但是更加严谨,相当于字典,也不完全像字典一样拘束与单词,总之,我也说不清楚,形象的说,就是一个文档系统吧。当前有很多wiki软件,例如Wikipedia使用的Mediawiki,以及MoinMoin,还有其他的很多版本;而Mediawiki应该是最广为人知的吧。
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
|
<code class = "hljs xml" >NameVirtualHost * : 80
<span class = "hljs-tag" ><span class = "hljs-tag" ><<span class = "hljs-name" ><span class = "hljs-tag" ><span class = "hljs-name" >VirtualHost<span class = "hljs-tag" > * <span class = "hljs-attr" ><span class = "hljs-tag" ><span class = "hljs-attr" >: 80 <span class = "hljs-tag" >>
DocumentRoot "D:/Work/www/mediawiki-1.21.2/"
ServerName solee.org
<span class = "hljs-tag" ><span class = "hljs-tag" >< / <span class = "hljs-name" ><span class = "hljs-tag" ><span class = "hljs-name" >virtualHost<span class = "hljs-tag" >>< / span>< / span>< / span>< / span>< / span>< / span>< / span>< / span>< / span>< / span>< / span>< / span>< / span>< / span>< / span>< / span>< / code>
|
因为是本机的缘故,我在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
|
<code class = "hljs markdown" ><span class = "hljs-section" >#个人wiki,禁止创建帐号功能,除非登陆才能访问
$wgGroupPermissions [<span class = "hljs-string" > '*' ][<span class = "hljs-symbol" > 'createaccount' ] = false;
$wgGroupPermissions [<span class = "hljs-string" > '*' ][<span class = "hljs-symbol" > 'edit' ] = false;
$wgGroupPermissions [<span class = "hljs-string" > '*' ][<span class = "hljs-symbol" > 'read' ] = false;
<span class = "hljs-section" >#启用详细异常显示.
$wgShowExceptionDetails = true;
<span class = "hljs-section" >#去除底部powered by图标
unset( $wgFooterIcons [ 'poweredby' ]);
<span class = "hljs-section" >#对于没有登录的用户,没有登录的用户移除页面顶部的讨论页链接
$wgShowIPinHeader = false;
<span class = "hljs-section" >#默认在新标签页中打开链接
$wgExternalLinkTarget = '_blank' ;</span></span></span></span></span></span></span></span></span></span></span></code>
|
其他诸如图标、主题、短链接等配置可以自行探索。
常用插件
常用的插件,主要是富文本编辑器了,当个人倾向于使用纯文本编辑器,也就是Mediawiki自己提供的编辑器。默认的工具条很丑,可以在页面右上角的设置->编辑中开启增强功能。
富文本编辑器可选用WYSIWYG,搜索合适的版本下载之后,解压到extensions目录,并在LocalSettings.php中添加一行,加载此拓展:
富文本编辑器
1
|
<code class = "hljs lisp" > require_once ( <span class = "hljs-string" > "$IP/extensions/WYSIWYG/WYSIWYG.php" )<span class = "hljs-comment" >;</span></span></code>
|
这样安装好之后,可以在设置中选择喜欢的编辑器,或者选择在文本和富文本编辑器中自由切换。
代码高亮
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
|
<code class = "hljs php" ><span class = "hljs-comment" >#pdf导出插件
<span class = "hljs-keyword" > require_once (<span class = "hljs-string" > "$IP/extensions/PdfExport/PdfExport.php" );
<span class = "hljs-comment" >#使用Mpdf作为PdfExport的后端,但必须配置支持ckj字体
$wgPdfExportMPdf = $IP . <span class = "hljs-string" > '/extensions/Mpdf/mpdf.php' ; <span class = "hljs-comment" >
|
配置字体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
|
<code class = "hljs less" ><span class = "hljs-selector-id" >#Flash插件
<span class = "hljs-selector-tag" > require_once (<span class = "hljs-string" > "$IP/extensions/oflash/orificeflash.php" );
#视频插件
<span class = "hljs-selector-tag" > require_once (<span class = "hljs-string" > "$IP/extensions/MediawikiPlayer/MediawikiPlayer.php" );
#批量导入插件
<span class = "hljs-selector-tag" > require_once (<span class = "hljs-string" > "$IP/extensions/MultiUpload/MultiUpload.php" );</span></span></span></span></span></span></span></code>
|
当然具体的插件需要自己去下载。通常谷歌Mdiawiki <插件名称>即可找到官方的下载地址。
备注:
1
2
|
<code class = "hljs less" >#禁用掉此扩展,否则可能不能正常进入<span class = "hljs-selector-tag" >wiki
<span class = "hljs-selector-id" ># require_once ( <span class = "hljs-string" > "$IP/extensions/LocalisationUpdate/LocalisationUpdate.php" );</span></span></span></code>
|
备份及优化
备份主要涉及到数据库的备份及Wiki的备份。对于这种非分布式、非云计算(哈哈——)的东西来说,备份就显得尤为重要了。
1
|
<code class= "hljs css" > <span class= "hljs-selector-tag" >D:\<span class= "hljs-selector-tag" >Prog\<span class= "hljs-selector-tag" >wamp\<span class= "hljs-selector-tag" >bin\<span class= "hljs-selector-tag" >mysql\<span class= "hljs-selector-tag" >mysql5<span class= "hljs-selector-class" >.6<span class= "hljs-selector-class" >.12\<span class= "hljs-selector-tag" >bin\<span class= "hljs-selector-tag" >mysqldump <span class= "hljs-selector-tag" >-u <span class= "hljs-selector-tag" >root <span class= "hljs-selector-tag" >-ppassword <span class= "hljs-selector-tag" >solee_wiki_db ><span class= "hljs-selector-tag" >F:\<span class= "hljs-selector-tag" >wiki<span class= "hljs-selector-class" >.sql</span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></code>
|
wiki备份直接把wiki的文件夹打个包即可。如果是采取sqlite数据库的话,数据库备份更加简单了。
在windows上一个比较烦人的问题就是,wamp的mysql内存占用甚是大,在我4G内存的机器上吃了500M,这不能忍啊,因此需要优化一下mysql:
[mysqld]
port=3306
max_connections = 100
最后来张效果图吧:
