# 简介

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 到该文件夹下,其中应当包含 xpMyPluginStore 两个文件夹。

通过 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 的入口。

更新于 阅读次数

请我喝[茶]~( ̄▽ ̄)~*

Linn 微信支付

微信支付

Linn 支付宝

支付宝