插件说明

什么是插件

在 TiddlyWiki 中,插件(Plugins)是用于扩展 TiddlyWiki 核心功能的用户自定义脚本。它们允许用户根据自己的需求定制 TiddlyWiki 的行为,添加新的功能,或者修改现有的功能。插件可以是简单的脚本来实现特定的小功能,也可以是复杂的系统,提供一整套新的用户界面元素和功能。

TiddlyWiki 的核心也是一个插件。通常而言,用户不需要主动编写插件,只需要安装别人写好的插件即可。插件实际上是打包了很多条目进去。但插件机制能展示更多复杂内容。

如何安装 TiddlyWiki 插件

有两种安装方式,一种是直接把插件拖入你的 wiki 中,然后点击导入即可。另一种则是通过插件库的形式安装插件。

推荐使用插件库安装插件,因为插件库可以帮助维护插件更新,这样就不需要自己去关注插件是否更新了没有。也不需要自己再重新拖入一遍插件到你的 tiddlywiki 里。其次是有些插件需要依赖其他插件,如果只是把一个插件拖进去了,仍然会存在问题。所以掌握插件库安装插件是十分有必要的。

前者通常在于特殊情况下安装。比如插件库没有收录该插件,或者断网情况下从其他本地 wiki 安装插件,也是可以的。

什么是插件库

插件库即插件的集合,相当于直接下载插件到 wiki 里。但不是说安装了插件库,所有插件库里插件都会安装到 wiki 里。安装插件库只是提供了一个链接。

可以安装插件,升级更新插件。

插件库的类型

按照由谁来维护,可以将插件库分为下面三种类型。

官方维护的插件库

由官方维护的插件库。这个不管是单文件版本,还是 nodejs 版本,都会随核心而一同安装上。尽管 tiddlywiki 的开发工作并没有明确的团队协作,目前主要还是通过 github 工作流程来提交代码审核并发布,但仍然可以认为这个插件库是由一个团队来维护的。

官方维护的插件,每一个插件的最新版本都是和最新的 tiddlywiki 版本号相一致的。

社区维护的插件库

由社区维护的插件库,这个以 CPL 为代表。不断收集散落在互联网上各种 tiddlywiki 的插件,并尽可能保持更新。

个人维护的插件库

由个人维护的插件库,这个以库克马的插件库为代表。库克马开发了众多功能强大的 tiddlywiki 插件,使用他的插件库安装插件是非常方便。也方便后续升级。

如何安装插件库

安装插件库,一般是直接把插件库条目拖入到你的 wiki 里。同时插件库条目都是带有$:/tags/PluginLibrary系统标签的。有一些插件会附带插件库条目,比如 itonnote 插件就会带 CPL 的插件库条目。另一种特殊方式是直接以插件形式安装。新版 CPL 就是通过插件来作为插件库安装插件的。

如何使用插件库安装插件

使用插件库安装插件需要在联网的情况下进行,断网是无法通过插件库安装插件的。

打开$:/ControlPanel条目,在插件,点击获取更多插件按钮。接着会弹出一个窗口。你可以选择一个插件库。然后在下面点击打开插件库。

打开后会发现分成四个部分。如果是需要更新,就在第一个更新的栏目里,点击更新插件。可以选择在每个插件旁边更新,或者直接全部更新。如果是需要安装插件,则可在旁边搜索插件条目,或一直下滑找到想要安装的插件,点击安装即可。主题插件和语言插件也是类似安装方式。

部分插件安装完之后,会弹出重启 wiki 的窗口。tiddlywiki 需要重新加载 wiki 让插件生效。这个时候如果没有保存备份的话,一定要先备份一下。

注意事项

插件非常强大,强大到可能会影响和删除你的 wiki。所以安装插件前,一定一定要备份。

其次,插件并不是安装越多越好,也不是什么都不安装,而使用原版 tiddlywiki。相反,安装一些插件来提供帮助,对自己合适的才是最好的。插件过多,也可能会影响性能,导致卡顿。