• Stars
    star
    185
  • Rank 208,271 (Top 5 %)
  • Language
    CSS
  • Created over 9 years ago
  • Updated over 7 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

一个可以放在各种网盘,各种空间的,Markdown 语法支持的 Wiki 系统,可以用来方便的管理自己的知识碎片。欢迎各种支持

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

请支持一下

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

本人支付宝账号:[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 生成页内标题目录的工具,自定义性很好,只是默认设置对中文……很不友好。不过改个设置就好。

More Repositories

1

Obsidian-Templates

我在 Obsidian 中用的各种模板(Dataview,Templater,QuickAdd)
JavaScript
126
star
2

WinSize

AHK 的快速设定窗口尺寸的小工具
116
star
3

Link-cleaner

一个用来清理冗长网址的小书签
HTML
65
star
4

Simple-FullScreen-Clock

一个简单的全屏网页时钟,可以用在各种旧的电子设备上。
HTML
39
star
5

pages

我的一些静态工具页
JavaScript
17
star
6

code-book-for-web-designer

一本写给网页设计师的代码书
12
star
7

easy-web-code-book

代码能有多难?——简单的网页代码书
12
star
8

bilibili-fans-show-page

用旧设备显示 B 站粉丝数,然后摆在桌面上,大概如此吧
HTML
7
star
9

simple-tool-pages

一个显示当前各种时间进度的小页面
HTML
6
star
10

shortLink

HTML
4
star
11

Obsidian-Widgets

Obsidian 的侧边栏小挂件,其实就是用 Dataview 插件写的一些功能组件(自定义视图),可以放在一篇笔记内,然后把这篇笔记拖到侧边栏,这样就有侧边栏小挂件啦~
JavaScript
4
star
12

mhop

一个静态的文件销售网站以及一个 PHP 的网站生成程序
PHP
3
star
13

Dashboard-on-desk

桌面上的信息面板
JavaScript
3
star
14

wave-line

用 Javascript 和 Canvas 写的一根波浪线,会根据鼠标的位置产生一个带有跟随效果的向上箭头。
HTML
1
star
15

Word-Writer

这是一款打字效果的 JQuery 插件
JavaScript
1
star
16

2020_dmnydn

《代码能有多难?》(2020 版)
JavaScript
1
star
17

Typora_Themes_Paper

一个简单的 Typora 编辑器主题,基于自带 Github 主题,低度修改。满足自用为主。
CSS
1
star