Simiki -- 简单的个人维基框架

2014-06-09 21:29:32 +08:00
 TankyWoo
这是前段时间自己写的一个项目。

因为比较喜欢记录技术笔记,一直保持写技术博客有5、6年了。

后来考虑到博客记录的知识太零散,记录多了以后,可以考虑把总结过的知识汇总形成wiki。

之前也调研过现有的一些维基框架。MediaWiki不说了,太臃肿,不适合个人;MoinMoin用了下,搭建比较麻烦,弄了一阵子发现没有使用的欲望;VimWiki也折腾过一阵子,有些地方还是不满意,且它自己也是一套Markup语法,这玩意记多了容易混。其余的大多都是基于PHP的。

因为对Markdown和纯静态输出这两点比较喜欢,所以自己写了一个简单的个人Wiki框架,功能做个人维基足够了。如果要协作,配合Github等也是一个不错的选择。

Simiki主要以目录的形式存放源文件,生成相应目录结构的静态html文件。模板主题用的是Jinja2,所以大家也可以方便的DIY。

没有繁杂的功能,毕竟技术笔记本身就是以内容为导向。

好吧,不太会扯,直接上地址吧。想弄一个个人维基的朋友,不妨试试。有问题直接Github上发Issue就可以了。

项目地址: https://github.com/tankywoo/simiki

网站: http://simiki.org/ 也是用Simiki搭建的,CSS啥的直接Copy Bootstrap的一个Example :)

个人的Wiki: http://wiki.tankywoo.com/

最近一期的Pycoder's Weekly (Issue #118) 也推荐了 http://us4.campaign-archive2.com/?u=9735795484d2e4c204da82a29&id=cb904ae2f0
18766 次点击
所在节点    分享创造
74 条回复
FarBox
2014-06-10 15:06:00 +08:00
@hustlzp FarBox是可以做到的。如果不自己写主题,用默认的doc.farbox.com/template克隆一个模板过去,按照约定规则组织文档就可以了。

如果更加复杂一些的,就需要自己再定义模板了。全文搜索支持英文和中文两种语言。

http://help.farbox.com/read/doc-generator


@TankyWoo 如果是作为静态生成器,又想加入搜索的功能,最简单粗暴的是用Google…… :)
TankyWoo
2014-06-10 15:08:53 +08:00
@jakwings 你是指内部文章的快捷引用吗?类似Jekyll的post_url?
loryyang
2014-06-10 15:27:10 +08:00
发现一只大牛,感觉好遥远。。。
jakwings
2014-06-10 19:10:13 +08:00
@TankyWoo 不止是那样,还要能够知道有哪些文章引用过当前的文章。
TankyWoo
2014-06-10 19:41:02 +08:00
@jakwings 赞!这个挺不错的,我加到todo里后期考虑下这个功能,目前先把快捷引用其它文章的功能实现。
TankyWoo
2014-06-10 19:46:44 +08:00
@oott123 Evernote的一些功能我还没去了解,仅谈下我用过的。

我记得Evernote搜索好像是付费版的,这个不确定是不是。

另外,Evernote原生不支持Markdown,配合马克印象可以,我也用过,感觉不是很便捷,且容易造成多份copy

另外我当时写这个的原因就是因为我是终端控,对于开一些富文本的软件来编写,我更喜欢一个窗口分屏、一遍解决问题、一遍记录问题。

而且样式什么的也可以DIY,虽然我追求简洁,不过Evernote用来记录技术,实在不敢恭维,代码高亮等也没有。
TankyWoo
2014-06-10 19:47:35 +08:00
@humiaozuzu 树级目录结构是指?
TankyWoo
2014-06-10 19:48:29 +08:00
@hustlzp 呵呵,用了后可以把你的链接发出来学习一下
TankyWoo
2014-06-10 19:49:25 +08:00
@messense 非常感谢,并且看到你的Pull Request了,我这几天把这块处理下。
TankyWoo
2014-06-10 19:52:17 +08:00
@FarBox 非常感谢建议,我想到的也是添加Google站内搜索,在模板那块处理下应该就行。

其实我更喜欢的还是直接grep在源文件中搜索 :)
hustlzp
2014-06-10 19:56:15 +08:00
@TankyWoo 呵呵,学习谈不上啦~以前都记在Evernote中,相当之乱,有待整理。
messense
2014-06-10 19:57:06 +08:00
@TankyWoo 考虑考虑把 Python-Markdown 换成 misaka 或者 mistune 吧,Python-Markdown 性能有点渣。 Benchmark:

https://github.com/lepture/mistune/issues/1
humiaozuzu
2014-06-10 20:08:02 +08:00
@TankyWoo 就是可以有无限层级的意思,Evernote 就只有2层,Wiki 可以无限层,但是浏览起来不方便
yxjxx
2014-06-10 21:26:46 +08:00
@TankyWoo
@hustlzp
无意冒犯,为什么会这么频繁的使用'呵呵'呢?

借用 @clowwindy 今天在github上说的话 "你说“呵呵”的时候可能没有恶意,对方可能不会这样认为,会觉得你轻蔑和没有诚意,从而误解你的意思。" https://github.com/clowwindy/shadowsocks-nodejs/issues/101
TankyWoo
2014-06-10 21:33:02 +08:00
@yxjxx

对于“呵呵”,在正常谈话中,我的见解是:

“对于刚认识的**朋友**,交谈过程**开始**时的一种客气的语气词“
wogong
2014-06-10 21:40:10 +08:00
@TankyWoo 已笑死。。。错过了围观 issue 的机会!

不过我觉得 @hustlzp 应该真的不知道吧。。还是我太天真了
hustlzp
2014-06-10 21:51:12 +08:00
@yxjxx
@TankyWoo
@wogong 好吧...我真的用习惯了,至于第一声的呵呵我知道什么意思,但蛮少用...
TankyWoo
2014-06-10 22:48:02 +08:00
@hustlzp
@wogong
@yxjxx

看来我以后得少用“呵呵”了,貌似以前和女友QQ聊天时,我经常“呵呵”就被批评过,不过那时确实是敷衍,因为正在写代码在。。。
TankyWoo
2014-06-10 22:49:29 +08:00
@messense 赞!我最早是用的Python-Markdown,后来换了markdown2,发现问题颇多,就又换回前者了,你推荐的这两个我先调研下看看。

:)
TankyWoo
2014-06-10 22:52:57 +08:00
@humiaozuzu 树形结构是一个很麻烦的结构,我现在的源文件就是树形目录存储/生成,不过在模板展现这块想了很久,也没想到一个好的办法去支持,所以现在默认主题还是选择对二级目录作展示

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/116605

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX