wiki的用处
wiki是整理知识的好工具
有哪些wiki工具可以使用
mediawiki,对硬件资源和软件配置要求高
HDwiki,模版样式不美观。
pmwiki和Dokuwiki,这两个都是直接使用文本存储的,不需要数据库。
dokuwiki界面好看些,中文文档多一些,配置相对容易些。
dokuwiki安装
windows上安装方法
1,首先,下载安装xampp
下载地址:https://www.apachefriends.org/zh_cn/index.html
下载之后,直接按照默认选项安装,唯独把安装位置修改为X:\xampp
2,接着,下载安装dokuwiki
下载地址:https://www.dokuwiki.org/dokuwiki#
下载最新版本,下载之后,将压缩包解压出来的目录放到xampp的apache的发布目录下,例如:X:\xampp\htdocs
3,启动xampp,设置apache
启动xampp。 执行E:\xampp\xampp_start.exe。 执行之后,双击右下角图标里面的xampp-control就可以进入xampp-control页面。
如果第一行的apache没有启动,则点击"start"启动即可。
启动之后,进入http://127.0.0.1/dokuwiki/install.php完成dokuwiki的初始化配置。
可以选择语言,创建管理员用户,设置开启登陆功能。
添加新页面
http://127.0.0.1/dokuwiki/doku.php?id=wiki:dokuwiki
http://127.0.0.1/dokuwiki/doku.php?id=知识页面:知识说明
创建新的页面”知识说明“
删除页面
将该页面内容清空,则删除了该页面
wiki迁移
wiki 备份
如何备份DokuWiki?
Q: 我如何备份我的 DokuWiki?我需要备份哪些部分?
A: 由于 DokuWiki 不使用数据库,备份是很简单的。您需要做的就是拷贝所有的文件。最简单的方法就是备份您的整个 DokuWiki 目录。
如果您想要节约一些空间,您至少需要备份下列目录:
data/pages - 包含所有当前在用的页面
data/meta - 包含页面的元数据信息 (如谁创建的此页面,谁订阅了此页面, …)
data/media - 多媒体內容 (如图片, PDF文档, …)
data/media_meta - 多媒体文体元数据
data/attic - 页面所有的旧版本
data/media_attic - 元数据的所有旧版本
conf - 存放配置信息的文件夹
您可以忽略以下文件夹 cache, index, locks, 和 tmp 。
参考:https://www.dokuwiki.org/zh:faq:backup
wiki 恢复
侧边导航栏
indexmenu
在dukuwki中添加侧边栏
下载:https://www.dokuwiki.org/plugin:indexmenu
下载之后解压,将解压之后的文件夹放到dokuwiki\lib\plugins下面,刷新你的wiki,进入管理/扩展器管理,即可看到,如图:
indexmenu使用
1,根目录下新建立一个sidebar.txt页面:
创建页面 http://localhost/dokuwiki/doku.php?id=sidebar
2,在sidebar.txt中输入:{{indexmenu>.#1}}或{{indexmenu>.#1|js}},以命名空间创建的导航就完成了;
3,在sidebar页面中,还可以加任何东西,比如html。
indexmenu语法
{{indexmenu>ns[#n] [ns1[#n] ns2[#n] …] | [js[#theme]] [tsort] … }}
基础语法是indexMenu的{{indexmenu> [part1] | [part 2] }
标准语法
part1部分可以由一个或多个命名空间组成,
可以是:
(代表根目录)
.(代表indexMenu语法所在页面的当前目录)
…(代表indexMenu语法所在页面的上级目录)
:wiki(代表根目录在的wiki命名空间)
[#n}(n代表数字,如果不使用#n,默认打开所有的子目录,#0或者#1表示默认打开命名空间的下一级子命名空间,#2表示下两级子命名空间,以此类推)part2是可选项,可以使用js#theme表示使用js渲染菜单树,并且使用theme标志的样式,其他参数由两部分组成一部分,一部分只能在js下生效,一部分是否使用js都可以使用,这里重点介绍msort方法:表示菜单按照indexMenu的元数据排序。
常见问题解决
问题1:Port 443
Port 443 in use by "“C:\Program Files (x86)\VMware\VMware Workstation\vmware-hostd.exe”
原因:
XAMPP与VMware同时占用443端口
解决:
修改VMware占用443端口为其他端口
问题2:indexmenu id conflict
解决方法:
安装nosidebar插件,然后,在文本中增加 NOSIDEBAR,排除sidebar页面