一个可以放在各种网盘,各种空间的,Markdown 语法支持的 Wiki 系统,可以用来方便的管理自己的知识碎片。欢迎各种支持
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
data
files
imgs
README.md
index.html

README.md

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公式的内容

请支持一下

如果您觉得这个小程序对你有所帮助,希望您请我喝杯咖啡,让我在这寒冷的冬日里感受到一份温暖,谢谢~

本人支付宝账号:alay9999@163.com

技术支持:

  • marked.js by Christopher Jeffrey (JJ) 这是一个很不错的 Markdown 转化 Html 的工具,JavaScript 书写, Node.js 和本地都可以使用.
  • highlight.js by Ivan Sagalaev 一个真心好用的代码高亮工具,支持 118 种代码高亮。爽得一塌糊涂,记得去他的官网下载,我就是傻乎乎的在 Github 下载的,然后被坑的好爽……
  • TOC.js by Greg Allen 生成页内标题目录的工具,自定义性很好,只是默认设置对中文……很不友好。不过改个设置就好。