Meme of LinOnetwo

动机

目前要维护我发布的 TiddlyWiki 模板不是很方便，因为我经常在自己的 wiki 上做出修改，把它们同步到模板项目去很麻烦。

我打算把我做的修改发布为主题包和插件包，这样他人就可以在插件管理里面一键更新了。

将大部分我对Wiki的改动打包为插件

我在 plugins 文件夹下仿照其他插件创建了几个我的插件，然后将我以前放在自改TW里的内容都迁移了过去，并配置加载这些插件。我还将我的样式修改做成了主题，载入后与之前直接将它们放在 Wiki 里没有任何区别。

但是上传到 Vercel 之后好像有点问题，ItonNote 插件里的内容比本地少了很多。

制作插件仓库

我一开始通过mklauber/tw5-plugins-template这个模板，创建了我的插件Wiki的Github仓库。 但是我很快注意到，它其实就只是提供了一个额外的 build target library，我将这个 build target 复制到我自己的 wiki 的 tiddlywiki.info 里之后，就可以直接在部署我的 wiki 时，顺便生成插件仓库所需的文件并同时部署它们了。

因此可以直接将我自己的 Wiki 变成类似kookma PluginLibrary的插件Wiki，里面会有一个能拖的Tiddler$:/config/KookmaPluginLibrary。 在我的 Wiki 里，它就是 $:/config/ItonNotePluginLibrary ，直接将这个链接拖到别的 wiki 里就能装好了。

这个 Tiddler 之所以拖到我们自己的 Wiki 里就能添加一个新的插件库，是因为它带有$:/tags/PluginLibrary这个 Tag 和 url:https://xxx.html 这个字段，它指向一个插件库描述文件。而 library 这个 build target 可以创建出这个 html 文件。这个置于 public/library/index.html 的 HTML 文件还会依赖 public/library/recipes/library/tiddlers/xxx插件名.json 这些具体的打包好的插件。

总之，最后我的能用的 build target 大概长这样：

    "library": [
      "--makelibrary",
      "$:/UpgradeLibrary",
      "--savelibrarytiddlers",
      "$:/UpgradeLibrary",
      "[prefix[$:/]] -[prefix[$:/plugins/tiddlywiki/]] -[prefix[$:/themes/tiddlywiki/]] -[prefix[$:/languages/]] -[[$:/plugins/tiddlywiki/upgrade]] -[[$:/plugins/tiddlywiki/translators]] -[tag[$:/tags/PluginLibrary]] -[prefix[$:/plugins/kookma]]",
      "recipes/library/tiddlers/",
      "$:/UpgradeLibrary/List",
      "--savetiddler",
      "$:/UpgradeLibrary/List",
      "recipes/library/tiddlers.json",
      "--rendertiddler",
      "$:/plugins/tiddlywiki/pluginlibrary/library.template.html",
      "index.html",
      "text/plain"
    ]

找不到插件

虽然平时直接将插件文件夹放在 plugins 文件夹里，启动 NodeJS wiki 之后就能用这个插件了，但是在生成插件仓库时，这会导致第一步 "--makelibrary", "$:/UpgradeLibrary" 就找不到该插件。

这是因为它默认 plugins 文件夹里放的还是文件夹，再往里面一层才是具体的插件，也就是说要符合 Meme-of-LinOnetwo/plugins/linonetwo/itonnote 这样的摆放方式才行，不然生成的 HTML 文件里，assetList 就有可能是空的，因为没找到你的插件。

Themes 也类似，得用 Meme-of-LinOnetwo/themes/linonetwo/itonnote 这样的路径才能被找到。

部署

部署后有可能访问路径还会有问题，导致安装插件时在开发者工具里可以看到访问 404 了，总之我最终用了这样的重写规则解决问题：

  "rewrites": [
    { "source": "/recipes/(.*)", "destination": "/library/recipes/$1" }
  ]

其他参考资料

在inmysocks.tiddlyspot.com也有制作 Plugin Library 的教程，但我觉得之前的那个仓库模板就够用了。

还有sistan.tiddlyspot.com是创建单个插件的教程，不过我没有参考它。