# 简介

TiddlyWiki 是一款受欢迎的个人 Wiki 制作交互式工具。 TiddlyWiki 通过最小的有意义的语义块 —— tiddlers （条目）来构建自己的知识库。通过标题唯一标记 tiddlers ，以便可以使用链接、标签、列表和宏进行结构化。条目（ Tiddlers ）使用维基文本（ WikiText ）符号，能够简明扼要地表示了各种文本格式和超文本功能。具体可以参考官方网站。

虽然 TiddlyWiki 本身是个非常有用的工具，可配置程度很高，但是上手难度也较大。这里比较推荐使用 TiddlyWiki xp 上手，可以戳此链接。 TiddlyWiki xp 本身配置了较多有用的插件，省却了自己动手配置的麻烦。同时，该 Wiki 中包含了丰富的教程，可以不断阅读深入了解该工具的使用方法。

# 安装与启动

安装 TiddlyWiki 有多种方法。可以选择单一的 html 文件进行编辑，但是这样当以后内容过多时，文件体积便会较大，打开编辑时也会有不便。因此我选择了使用 Node.js 进行安装。因为安装过 Hexo ，所以 Node.js 的相关配置已经做好，只需要通过以下命令直接安装即可：

npm install -g tiddlywiki

输入 tiddlywiki --version 能够看到版本号则说明成功安装。

之后下载 TiddlyWiki xp 的压缩包并解压，然后 cd 到该文件夹下，其中应当包含 xp 和 MyPluginStore 两个文件夹。

通过 tiddlywiki xp --server 可以启动服务，在浏览器中输入 localhost:8080 即可访问网页。不过，现在看到的网页还并不完全，网页显示的内容也仅占据左边的部分，右边产生了许多的空白。这是因为 TiddlyWiki xp 配置了许多插件，输入 tiddlywiki xp --server 命令后，不出意外应该会看到许多插件无法加载的警告。

在这里，我们需要把存放了插件的文件夹 MyPluginStore 添加到环境变量中。之后，上述报错应当消除，网页也能够正常显示了。

# 和博客进行搭配

通过以上步骤我们能够成功启动 TiddlyWiki 的服务并进行编辑，但是还无法和我们的博客进行结合。当我们将需要的内容编辑完毕之后，需要使用以下指令进行构建：

tiddlywiki xp --build index

该指令会在 xp/output/ 文件夹之下产生一个 index.html 文件，将该网页文件放在博客构建完成的文件夹下即可在博客中进行访问。我个人在博客的 source 文件夹下创建了 wiki 文件夹，在其中添加了 index.md 文件以生成 index.html 文件，并在首页侧栏添加了对应的图标和入口。在博客构建完成之后，使用 tiddlywiki 指令生成的 index.html 替换即可。

通过以上方式即可在博客中添加 Wiki 的入口。