项目使用文档管理:MediaWiki安装及使用入门
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安装及使用入门的更多相关文章
- 接口文档管理神器RAP2安装和部署
目录 一 RAP2 二 RAP2 安装需要的环境 2. 1 Node.js 安装: 2. 2 Mysql 5.7+ 安装 2 .3 Redis 安装见文章 2. 4 后端 rap2-delos 安装 ...
- [课程分享]IT软件项目管理(企业项目甘特如是评价、维护管理、文档管理、风险管理、人力资源管理)
[课程分享]IT件项目管理(企业项目甘特图案例评价.维护管理.文档管理.风险管理.人力资源管理) 对这个课程有兴趣的朋友能够加我的QQ2059055336和我联系 课程讲师:丁冬博士 课程分类:Jav ...
- showDoc项目文档管理工具
1:下载showdoc代码文件 https://github.com/star7th/showdoc https://www.showdoc.cc/help?page_id=14 官方帮助文档 2:安 ...
- Winform开发框架中的内容及文档管理模块功能介绍
在开发项目的时候,我们有一些场景需要编辑一些HTML文档,作为内容发布系统的一部分,有时候也需要对一些文档如WORD文档进行编辑管理,这样需要我们对这些内容及文档进行合适的管理.本文主要介绍在WInf ...
- API文档管理平台
一.应用场景 在公司中,有很多开发,每个人维护的api接口是不一样的.如果有一个统一的api文档管理平台,每个开发,把自己维护的接口录入进去. 之后再开发别的功能时,不需要重复造轮子,直接调用就可以了 ...
- Api接口文档管理工具,你知道哪些呢?
上周看到有人在我的Github开源项目中提了个issue,说是否考虑接入swagger.那今天我就用swagger与其他接口文档工具做对比,同时说说Api接口文档工具的那点事.如今,在前后端分离开发的 ...
- ShowDoc 软件开发团队接口文档管理利器
ShowDoc是一个非常适合IT团队的在线API文档.技术文档工具.你可以使用Showdoc来编写在线API文档.技术文档.数据字典.在线手册. 这里介绍 Showdoc 这款开源(免费)文档管理系统 ...
- 细说RESTful API之文档管理
目录 API文档格式 文档管理方式 基于注解实现,代码和文档在一起 Swagger Api2Doc 基于API测试工具生成 Postman rest-client 独立编写文档 RAP DOCleve ...
- Jenkins构建项目帮助文档
Jenkins构建项目帮助文档 主要步骤 一.配置jdk 1.1. 下载jdk,安装到自己电脑磁盘的Java目录下(比如:D:\Java\jdk). 1.2. Jdk环境变量的配置: 1. 鼠 ...
随机推荐
- table添加横向滚动条
<div style="width:1000px; height:200px; overflow:scroll;"> <table border=" r ...
- 基于Flume+Kafka+ Elasticsearch+Storm的海量日志实时分析平台(转)
0背景介绍 随着机器个数的增加.各种服务.各种组件的扩容.开发人员的递增,日志的运维问题是日渐尖锐.通常,日志都是存储在服务运行的本地机器上,使用脚本来管理,一般非压缩日志保留最近三天,压缩保留最近1 ...
- su 与 su - 区别
su与su -都是用来切换用户的命令,简单说它们之间的区别就是:su -切换的干净彻底,而su 切换用户却拖泥带水. su su username,切换到指定用户,但是当前目录不会变化,环境变量还是上 ...
- AngularJS 笔记系列(三)模块和作用域
模块: 在 AngularJS 中,将函数代码全部都定义在全局命名空间中绝对不是什么好主意,全局变量污染会使冲突几率变大,调试困难,降低开发效率.上次写计时器的 controller 时,我们把 co ...
- HDU 1950 Bridging signals(LIS)
最长上升子序列(LIS)的典型变形,O(n^2)的动归会超时.LIS问题可以优化为nlogn的算法. 定义d[k]:长度为k的上升子序列的最末元素,若有多个长度为k的上升子序列,则记录最小的那个最末元 ...
- unity手势插件《FingerGestures 》使用入门
什么是FingerGestures? FingerGestures是Unity上,非常热门的一款用于处理用户输入的插件 为什么要使用FingerGestures? 1:它统一了鼠标点击和用户触摸的输入 ...
- linux meta 18.0.1 系统安装nodejs
前置条件是:需要准备sudo apt-get 命令 第一步: 执行命令sudo apt-get install nodejs 即可安装, 之后可使用node -v 查看版本node 版本号 第二步: ...
- JQuery归纳总结(增加中...)
一.this与$(this)的区别 this指向标签本身对象,而$(this)会将其封装成JQuery对象 如: $(" img").mousemove( function(e){ ...
- 【Linux学习】2.Linux常见命令行
记录学习Linux 系统的相关知识点,欢迎大家拍砖交流,一起成长:QQ:2712192471 作者背景:前端开发工程师 | Python | web安全爱好者 Linux命令行: 系统关机重启 s ...
- tomcat源码调试
三.tomcat目录结构 tomcat的下载安装有很多教程,不再赘述. 现在的tomcat已经到9了,当tomcat下载安装完成后,其目录大致如下: 除了上面的文件夹,还有四个文件: ...