爱意满满的作品展示区。
TankyWoo

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

  TankyWoo ·
tankywoo · Jun 9, 2014 · 20924 views
This topic created in 4536 days ago, the information mentioned may be changed or developed.
这是前段时间自己写的一个项目。

因为比较喜欢记录技术笔记,一直保持写技术博客有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
Supplement 1  ·  Jun 10, 2014
惭愧,作为一个运维人员,刚才不小心把VPS上/var目录给xxx了,正在修复在,期间可能网站无法访问,抱歉。
Supplement 2  ·  Jun 10, 2014
非常感谢大家的支持。

测试这块还没完善,所以还有一些Bug,这两天已经有几个朋友提交bug了,我今晚也都修复了。

感谢大家的帮忙测试,如果有问题,在Github上提交Issue后,我会尽力第一时间修复。

话说今晚给发了三个小Release...
74 replies  •  2016-06-01 23:11:24 +08:00
wangfengmadking
wangfengmadking
Jun 9, 2014❤️1
1
lz的wiki内容真心不错,很有料
orzfly
orzfly
Jun 9, 2014❤️1
2
http://wiki.tankywoo.com/other/mac-os-tools.html
> Cyderbuck FTP

应该是 Cyberduck 吧?
yangyang
yangyang
Jun 9, 2014❤️1
3
真赞!明天我也搭一个。
ChiangDi
ChiangDi
Jun 9, 2014❤️1
4
不错不错,已star.
ss098
ss098
Jun 9, 2014 via Android❤️1
5
很好的wiki!准备拿来当个人wiki

要是能早点遇到就好了,有一个项目已经自己根据环境实习了个...
heyf
heyf
Jun 9, 2014❤️1
6
已star!之前就是看楼主的笔记折腾vimwiki的
yxjxx
yxjxx
Jun 9, 2014❤️1
7
cool!
lz博客干货十足,看过算法导论系列,写的很好!
vvtommy
vvtommy
Jun 9, 2014❤️1
8
楼主棒呆。已经star,待后面尝试后再考虑fork
wogong
wogong
Jun 9, 2014❤️1
9
来回顾下个人的wiki选择历史:
1. vimwiki
折腾了不短的一段时间,因为生成html文件缓慢,不能在线编辑,语法不支持markdown,等等,最终放弃。

2. moinmoin
python的项目,可以在线编辑。适合团队。试用了很短的一段时间,因为需要搭建环境,本地查找编辑不太方便放弃。

3. gollum
Github的wiki引擎,非常不错,支持markdwon,git历史版本记录,在线编辑方便。目前的搜索不支持中文,可惜不能直接生成html文件,依赖环境。但是还是推荐,和Github协同不错,不需要分享的话直接在Github中新建一个项目,利用项目wiki就可以了。

4. Jekyll 目前正在使用的。你一定会惊讶Jekyll不是博客么,其实前段时间 Jekyll 2.0 发布之后,多了一个很赞的功能,collection。我将Gollum的markdown格式的wiki文件放进Jekyll目录,直接利用Jekyll生成html文件。最终促使我全面转移到Jekyll的原因是想将blog和wiki天然的整合在一起,之前使用Gollum时,还得利用Pandoc转成html文件放到blog中。不如现在的自然。

Jekyll目前的collection功能尚处于开发阶段,很多功能还不全面,但是基本需求都能通过自己定义来满足。非常适合Jekyll用户,将blog和wiki统一管理。最后,欢迎参观(献丑了):
http://www.wogong.net
XXOO
XXOO
Jun 9, 2014❤️1
10
请问楼主Bootstrap 下载的哪个 演示 啊.
Phariel
Phariel
Jun 9, 2014❤️1
11
楼主是干货专家,已star。
TankyWoo
TankyWoo
OP
Jun 9, 2014
12
@wangfengmadking 呵呵,谢谢支持。
TF
TF
Jun 10, 2014❤️1
13
拿來寫 blog 都不錯的感覺
TankyWoo
TankyWoo
OP
Jun 10, 2014
14
@orzfly 你的眼睛太毒了,这也能发现,已经改正,非常感谢 :)
TankyWoo
TankyWoo
OP
Jun 10, 2014
15
@yxjxx 我的老博客上写的?估计现在看不到了,刚进行了误操作,现在mysql data不小心被我删掉了,自从换了Linode忘了把备份脚本跑起来,正在悲催的恢复中。
Geeker
Geeker
Jun 10, 2014❤️1
16
看 LZ Blog 长大的
TankyWoo
TankyWoo
OP
Jun 10, 2014
18
@yangyang
@ChiangDi
@ss098
@heyf
@vvtommy
@Phariel

感谢支持 :)

希望能对大家有帮助
TankyWoo
TankyWoo
OP
Jun 10, 2014
19
@TF 呵呵,你可以试试,不过我觉得Jekyll是个更好的选择
TankyWoo
TankyWoo
OP
Jun 10, 2014
20
@Geeker 看算法方面的吗?
TankyWoo
TankyWoo
OP
Jun 10, 2014
21
@wogong 很棒,Jekyll 2.0出来后,看到一些新特性,还没有去尝试
sutar
sutar
Jun 10, 2014❤️1
22
提过一个 pull request 的来支持下
TankyWoo
TankyWoo
OP
Jun 10, 2014
23
@sutar 非常感谢,我在博客 http://blog.tankywoo.com/project/2014/05/27/simiki-v1-0.html 里提到过,感谢每一个支持我的朋友 :)
arc5ch
arc5ch
Jun 10, 2014❤️1
24
很棒,已赞
hanchengluo
hanchengluo
Jun 10, 2014
25
木有PYTHON服务器。有木有PHP版呢?
http://www.smartweb.cn
oott123
oott123
Jun 10, 2014 via Android
26
请教一下,这样的个人 wiki 和类似 Evernote 这样的笔记软件相比,优势在哪里?
或者说,我觉得笔记软件就够用了啊。
humiaozuzu
humiaozuzu
Jun 10, 2014❤️1
27
点个赞,但是从个人知识管理的角度来说,没有树级目录都不方便。。。
推荐用 VoodooPad or DEVONthink Pro,不推荐 Evernote
MaiCong
MaiCong
Jun 10, 2014❤️1
28
赞一个! 简单实用!
hustlzp
hustlzp
Jun 10, 2014❤️1
29
爱死LZ了!马上用起!
zichen0422
zichen0422
Jun 10, 2014❤️1
30
赞!非常赞!
scola
scola
Jun 10, 2014❤️1
31
赞,已star
hustlzp
hustlzp
Jun 10, 2014
32
发现 @FarBox 也可以弄成类似的效果,需要自定义一个主题。
messense
messense
Jun 10, 2014❤️1
33
关于 Markdown README long_description 发布到 PyPi 上,可以试试在发布到 PyPi 的时候自动用 pandoc 转成 reST 格式。可以参考下我这个项目里的 release.py 和 setup.py

https://github.com/messense/extender
immjun
immjun
Jun 10, 2014
34
能支持全文搜索就更好了,有时候可能只记得了内容里面零碎的一点
RangerWolf
RangerWolf
Jun 10, 2014
35
希望能添加一个搜索功能呢~
目前自己使用云笔记软件记录只是,最大的方便就是搜索。
只需要记得某个关键字就能搜到之前记录的东西,太爽了~
TankyWoo
TankyWoo
OP
Jun 10, 2014
36
@immjun
@RangerWolf

现在我考虑到的搜索功能是直接源文件grep搜索

后期我考虑下搜索这块,感谢建议 :)
JoyNeop
JoyNeop
Jun 10, 2014
37
@oott123 Evernote 的 notes 间不能方便地互相添加链接
oott123
oott123
Jun 10, 2014 via Android
38
@JoyNeop Wiz 用户表示毫无压力,难道 Evernote 这种功能都没有?
jakwings
jakwings
Jun 10, 2014
39
看来又是缺少交叉引用。
JoyNeop
JoyNeop
Jun 10, 2014
40
@oott123 yes...
FarBox
FarBox
Jun 10, 2014
41
@hustlzp FarBox是可以做到的。如果不自己写主题,用默认的doc.farbox.com/template克隆一个模板过去,按照约定规则组织文档就可以了。

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

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


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

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

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

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

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

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

https://github.com/lepture/mistune/issues/1
humiaozuzu
humiaozuzu
Jun 10, 2014
53
@TankyWoo 就是可以有无限层级的意思,Evernote 就只有2层,Wiki 可以无限层,但是浏览起来不方便
yxjxx
yxjxx
Jun 10, 2014❤️1
54
@TankyWoo
@hustlzp
无意冒犯,为什么会这么频繁的使用'呵呵'呢?

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

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

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

不过我觉得 @hustlzp 应该真的不知道吧。。还是我太天真了
hustlzp
hustlzp
Jun 10, 2014
57
@yxjxx
@TankyWoo
@wogong 好吧...我真的用习惯了,至于第一声的呵呵我知道什么意思,但蛮少用...
TankyWoo
TankyWoo
OP
Jun 10, 2014
58
@hustlzp
@wogong
@yxjxx

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

:)
TankyWoo
TankyWoo
OP
Jun 10, 2014
60
@humiaozuzu 树形结构是一个很麻烦的结构,我现在的源文件就是树形目录存储/生成,不过在模板展现这块想了很久,也没想到一个好的办法去支持,所以现在默认主题还是选择对二级目录作展示
hustlzp
hustlzp
Jun 10, 2014
61
问一下HTML页面上的条目顺序是怎么排的?好像不是按日期,也貌似不是按字母表。
TankyWoo
TankyWoo
OP
Jun 10, 2014
62
@hustlzp 恩,按目录下的存放顺序获取结构字典,然后模板遍历字典,所以也无序了。这几天我会把结构调整为unicode后的字母顺序。

这块有点坑,之前实现的代码是字母序的,前阵子改动太多,把排序那块给移除了。 :(
hustlzp
hustlzp
Jun 10, 2014
63
@TankyWoo 恩,慢慢来。
spoonwep
spoonwep
Jun 11, 2014❤️1
64
看了一下好像很简洁的样子,非常喜欢,已star
southwolf
southwolf
Jun 11, 2014
65
能问一下http://simiki.org/是linode么? 加了CDN之类的咩? 访问速度好快……
TankyWoo
TankyWoo
OP
Jun 11, 2014
66
@southwolf 是Linode Fremont机房,这个机房比较稳定;没有用CDN,因为是纯静态html输出,所以速度较快。
TankyWoo
TankyWoo
OP
Jun 11, 2014
67
@spoonwep 感谢支持!
ferock
ferock
Jun 12, 2014
68
这货支持搜索么
TankyWoo
TankyWoo
OP
Jun 13, 2014
69
@ferock grep -r 'keyword' content
iijjll
iijjll
Jan 16, 2016 via iPad
70
一直用的单机版的 eDiary 电子日记本来记录工作的事情和问题总结,简单方便。
Jaycee
Jaycee
May 31, 2016
71
楼主大牛,能求一个 yasimple_x2 的主题么?
TankyWoo
TankyWoo
OP
May 31, 2016
72
@Jaycee 你好,这个主题等过几天新版本发布后放出来。因为新增一些功能,现在放出新主题也无法使用 :)
Jaycee
Jaycee
Jun 1, 2016❤️1
73
期待大大的新版本哈✨✨
TankyWoo
TankyWoo
OP
Jun 1, 2016
74
@Jaycee 谢谢支持 :)
About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   4114 Online   Highest 6679   ·     Select Language
创意工作者们的社区
World is powered by solitude
VERSION: 3.9.8.5 · 199ms · UTC 05:48 · PVG 13:48 · LAX 21:48 · JFK 00:48
♥ Do have faith in what you're doing.