Wiki in box
我觉得管理知识碎片的最好形式就是 Wiki,因为很多时候知识总是逃不出一个相互定义的圈子,因为这是知识的本质,这也是不懂英语的人拿到了一本英英词典却无法学会英文的原因。而 Wiki 中知识的相互链接恰好十分形象的表现了这一点。
扯远了哈,所以在经历过许多次的“查询 --> 忘记”的过程之后,我终于决定开始构建自己的知识体系了,那么如上所述, Wiki 便成了我的不二选择。
但是,自己搭建 Wiki 总是需要各种环境支持,这倒是不难,但是琢磨起备份的方法来总是觉得头晕。因为本人手残,在服务器上误删网站的事情也屡有发生,所以就希望一个简简单单,放在 Dropbox 里的 Wiki 系统。当然,其实这个已经有很多人在做了,但是也许是我笨,一个都没能试验成功,索性自己操刀了……
Append: 我想我是被 Chrome 给坑了,他喵的不允许 Javascript 操作本地文件。所以如果你用的是 Chrome 浏览器,那么你必须搭建一个服务器。
不过好消息是:在 Windows 下搭建静态服务器的软件实在是多的一塌糊涂,且十分小巧方便,比打开一个记事本可能都要省资源,那么网盘里放一个也不算什么。
Linux 下可能更简单一些,大部分系统都自带了 Python, 那么到 Wiki 根目录下运行 python -m SimpleHTTPServer 4000
然后访问 http://localhost:4000
即可。
Mac 系统我不了解,求赞助一个供我研究……
如果你使用 Sublime Text 作为编辑器,那么,只需要安装 SublimeServer 插件便可以轻松 High 翻天。本人目前的测试工作都是在这上面进行。
当前版本:
V2.0 - 2015年11月30日
重新整理增强。
使用说明:
- 页面内容文件存放在 data 目录下,后缀为 md,因为本系统支持的是 Markdown 语法(Markdown教程);
- data 目录下支持子目录;
- 内部链接只需要链接到页面命名,比如:
[链接到一个页面](linux:software:vim)
; - 命名空间深度无限,详细规则如下:
linux:software:vim
对应读取文件为:
/data/linux/software/vim.md
- imgs 文件夹可用来储存文章图片,也可自行安排使用其他位置;
本地使用
- 站点文件可以存放在任意喜欢的位置,就如同您期望的,存放在网盘中是一个十分不错的选择。你唯一需要注意的只是保持这些文件的相对位置不变而已;
- 如果你使用的是 Firefox 浏览器,那么直接访问
index.html
文件即可,十分方便; - 如果你使用的是 Chrome 浏览器,你需要准备一个 Http 服务器,请不要找那些大型套件,一个很小很小的 Http 服务器即可,把服务器的根目录设置到
index.html
文件所在目录即可,在本地使用一样爽歪; - 如果你使用 Sublime Text 作为编辑器,那么,只需要安装 SublimeServer 插件便可以轻松 High 翻天;
在线使用
- 如果你有需要,也可以以上传到您的网站空间上进行展示,这不需要做任何修改,但是由于是异步读取文件内容,境外主机请慎选,否则可能页面加载时间过长;
添加页内目录
因为 Wiki 单页面很容易有大量的内容,这时候就需要有页内导航,本系统支持页内目录功能。使用方法:
在文档内任意位置的单独一个段落使用标签
[TOC]
即可,每页只可使用一次,如下:
[TOC]
关于语法
较基本语法略有增强,额外支持表格和注释。其他需求请自行使用 HTML 代码解决。
文件结构:
- /
- |- files 全部引用文件
- |- css 全部样式文件,包括 Bootscrap、Hightlight、自定义
- |- fonts 全部字体文件,目前主要是 Bootscrap
- |- js 全部脚本文件,包括 Bootscrap、Marked、Hightlight、toc、自定义
- |- imgs 全部文章图片
- |- data 全部文章源码
- |- index.md 默认显示文档,建议用作索引
- |- index.html 唯一的页面文件,负责解读一切内容
- |- latex.html 新增的页面文件,用于解读带LaTeX公式的内容
- |- files 全部引用文件
请支持一下
如果您觉得这个小程序对你有所帮助,希望您请我喝杯咖啡,让我在这寒冷的冬日里感受到一份温暖,谢谢~
本人支付宝账号:[email protected]
技术支持:
- marked.js by Christopher Jeffrey (JJ) 这是一个很不错的 Markdown 转化 Html 的工具,JavaScript 书写, Node.js 和本地都可以使用.
- highlight.js by Ivan Sagalaev 一个真心好用的代码高亮工具,支持 118 种代码高亮。爽得一塌糊涂,记得去他的官网下载,我就是傻乎乎的在 Github 下载的,然后被坑的好爽……
- TOC.js by Greg Allen 生成页内标题目录的工具,自定义性很好,只是默认设置对中文……很不友好。不过改个设置就好。