TiddlyWiki 入门指南

前言

我一直想搭建一个 Wiki,存放,分享一些不好写成文章的资料。而市面上这么多选项,该用什么软件就成了个问题。我希望一个良好的笔记软件至少有:

  • 开放平台
  • 便于分享
  • 自动化部署
  • 简洁的版本管理
  • 支持 LaTeX 公式
  • 内容与表现分离,可以自定义模版
  • 词条能灵活的的创建链接,实体关系 ……

当然,尽可能轻量级,且配置简单……

折腾了很久,用过 GitHub Wiki,DokuWiki、Zim……最后找到了 TiddlyWiki。

刚上手时我就被惊叹到了,它最别致的地方在于,本体和数据全在一个 .html 文件中,这意味着,所有数据都能在一个页面里管理,而且单个静态网页部署极其方便,也可以通过 Git 版本管理。同时,TiddlyWiki 还有着非常强大的条目管理功能和插件系统,可扩展性和可定制性都很强。

基础配置

  1. 下载一个空白副本,可在 TiddlyWiki 舞 中找到;
  2. 安装 Markdown 插件;
  3. 安装 KaTeX 插件;
  4. 配置 Material Design 主题 ;
  5. ……

Netlify 托管

PS:GitHub、Netlify 的使用可参考之前教程。

先在 GitHub 中新建一个名为 Wiki 的私有仓库,并在 Setting 中给 Netlify 读取权限。之后把本地的 XXXX.html 重命名为 index.html 放在仓库根目录并上传。

新建私有仓库

之后,在 Netlify 中新建 site from Git,选择刚刚你在 GitHub 中创建的那个仓库。之后就能在 Domains 里找到 Netlify 分配给你的 URL 了类似:XXXXXXXXXXXX.netlify.com

新建 Netlify 托管

从 GitHub 创建 Netlify

选择仓库

然后,决定你要使用的二级域名,假设你的域名是 www.bob.com。Wiki 可以是 wiki.bob.com。在 Cloudflare 里新建一个 CNAME。注意 Proxy status 得是 DNS only 而不是 Proxied。

PS:此处默认你已在 Cloudflare 配置好 Nameserver 了。

之后回到 Netlify 后台把 HTTPS 加密配置一下就好啦 🎉🎉

之后每次更新这个 Wiki,只需要用 Git Push 到 GitHub,等待 Netlify 部署就行。一般为了保证性能 Wiki 中以纯文本为主,多媒体资源可以托管在别的服务器上。

Tiddywiki 的最佳实践

Reference

ChangeLog

  • 201228 update practice
  • 200309 init