其实有些内容不是很适合放在blog上发,比如说一两句话就能解决的问题,所以大D一直在寻找一个合适的系统来搭建。

用过Mediawiki,也用过各类笔记软件,都不怎么尽如人意,相反还是最简单的纯静态页面符合要求。

经过一段时间的寻找,找到了simiki,试用了一下,感觉还是很不错,于是写一篇文儿出来,记录一下搭建和使用中遇到的一些问题和解决办法。

P.S 这篇文涉及的内容比较多,所以还是放在blog上了,wiki更多的是完成一些很简单的笔记工作,比如某个Linux命令的用法等等。

大D的wiki欢迎访问:wiki.dadclab.com


simiki是由Tanky Woo开发的,从作者的博客得知,该程序开发自2014年,采用Python开发,可将本地使用Markdown编辑的文件转换成html,同时还带有一个http服务,可以进行预览。部署十分方便,无论是使用Github还是用自己的服务器或者虚拟主机,都可以轻松办到。

在此对程序开发者表示感谢~:)

不过只是对Windows的支持不太友好,不过大D有在Windows上安装Babun,所以使用起来也是很方便的~

安装

十分方便,只需要你的电脑上安装了python和pip,直接就可以通过pip进行安装了。

安装完成之后,使用

来进行初始化

安装中可能遇到的问题

1.提示 pkg_resources.DistributionNotFound: pytz==2015.7 的错误

大D在安装有CentOS 6的虚拟机内安装测试存在这一问题。

20161112194657

粗一看是pytz这个模块的问题,在simiki的安装中,各类需要的模块都会直接安装好,可以通过 pip list 来查看是否安装好了,如果pytz模块已经安装好,那么可能是distribution版本过低的问题,升一下级就可以解决。

2. address space needed by '_speedups.dll' (0x6D0000) is already occupied 问题

在Windows上透过babun安装并完成初始化后,使用 simiki g 生成页面时偶尔会遇到这个问题

qq%e6%88%aa%e5%9b%be20161111154532

搜索了一番之后在Github上找到了解决方案:https://github.com/babun/babun/issues/315

使用中遇到的问题

1.图片缩放

simiki输出的html不带有图片缩放的功能,但是这个功能还是比较有用的,想起blog上用的缩放插件比较好用,记得插件作者提供了js代码,可以直接调用。

phZoom,Github:https://github.com/phoetry/phZoom

jQuery.jsphZoom.js以及phZoom.css文件放在simiki模板目录的/static/js目录下,将phZoom的图片文件放在simiki模板目录的/static/js/css目录下。

例:/theme/simple2/static/js/jquery-3.1.1.min.js

打开base.html,在<head>标签内增加以下代码:

打开base.html,在<div id=footer-left>标签内添加以下代码:

这样就可以绑定在正文页面中带a标记的图片,用Markdown写笔记时,使用<a><img></a>来添加图片就可以了。

具体效果,可以参考:
https://wiki.dadclab.com/Windows/fat32%E6%97%A0%E6%8D%9F%E8%BD%AC%E6%8D%A2ntfs.html

2.将页面文件部署到到服务器

simiki支持通过Fabric进行部署,参见:http://simiki.org/zh-docs/deploy.html

首先安装Fabric

配置_config.yml

执行部署

3.常用元数据字段

updated 一篇wiki的最后更改时间,格式:YYYY-mm-dd HH:MM

collection 页面的集合,使用该字段,在首页生成一个集合。

tag 页面的标签,使用逗号分隔的字符串或者列表,会在wiki页面最后生成相关文章的地址。

4.基本命令

参考

http://simiki.org/zh-docs/usage.html

http://wowubuntu.com/markdown/

http://microjo.github.io/2012/markdown_ext.html

https://github.com/tankywoo/simiki

与本文相关的文章
版权声明
转载保留版权: 大D综合研究院 | 《使用simiki搭建个人wiki》
本文链接地址:https://www.dadclab.com/archives/6510.jiecao
转载须知:如果您需要转载本文,请将版权信息,版权授权方式,以及本文的链接地址注明,谢谢合作。
本文被贴上了: , 标签