From ced852012a58c88aee093032eca38063a1007fc1 Mon Sep 17 00:00:00 2001
From: dongrentianyu <3465645884@qq.com>
Date: Sun, 4 Feb 2024 15:15:59 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=8F=92=E4=BB=B6=E5=BA=93?=
 =?UTF-8?q?=E9=83=A8=E5=88=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

2024年02月04日 15时15分58秒
---
 docs/guide/learn-wiki/tiddlywiki.mdx  |  2 +-
 docs/plugins/_meta.json               |  5 +++++
 docs/plugins/kookma/_meta.json        |  9 ++++++++-
 docs/plugins/kookma/commander.mdx     | 11 ++++++++++-
 docs/plugins/kookma/favorites.mdx     |  9 ++++++++-
 docs/plugins/kookma/gatha.mdx         |  8 ++++++++
 docs/plugins/kookma/hsl.mdx           |  6 ++++++
 docs/plugins/kookma/index.mdx         |  3 +++
 docs/plugins/kookma/refnotes.mdx      |  6 ++++++
 docs/plugins/kookma/section.mdx       |  6 ++++++
 docs/plugins/kookma/shiraz.mdx        |  9 ++++++++-
 docs/plugins/kookma/tamasha.mdx       |  8 ++++++++
 docs/plugins/kookma/trashbin.mdx      |  6 ++++++
 docs/plugins/kookma/utility.mdx       |  7 ++++++-
 docs/plugins/official/_meta.json      |  8 +++++++-
 docs/plugins/official/code-mirror.mdx | 17 +++++++++++++++++
 docs/plugins/official/dd.mdx          |  1 -
 docs/plugins/official/dynannotate.mdx |  3 +++
 docs/plugins/official/highlight.mdx   |  3 +++
 docs/plugins/official/index.mdx       |  7 +++++++
 docs/plugins/official/katex.mdx       |  3 +++
 docs/plugins/official/markdown.mdx    |  3 +++
 docs/plugins/official/qrcode.mdx      |  3 +++
 docs/plugins/others/_meta.json        |  4 ++++
 docs/plugins/others/index.mdx         |  3 +++
 docs/plugins/others/relink.mdx        |  7 +++++++
 26 files changed, 149 insertions(+), 8 deletions(-)
 create mode 100644 docs/plugins/kookma/gatha.mdx
 create mode 100644 docs/plugins/kookma/hsl.mdx
 create mode 100644 docs/plugins/kookma/index.mdx
 create mode 100644 docs/plugins/kookma/refnotes.mdx
 create mode 100644 docs/plugins/kookma/section.mdx
 create mode 100644 docs/plugins/kookma/tamasha.mdx
 create mode 100644 docs/plugins/kookma/trashbin.mdx
 create mode 100644 docs/plugins/official/code-mirror.mdx
 delete mode 100644 docs/plugins/official/dd.mdx
 create mode 100644 docs/plugins/official/dynannotate.mdx
 create mode 100644 docs/plugins/official/highlight.mdx
 create mode 100644 docs/plugins/official/index.mdx
 create mode 100644 docs/plugins/official/katex.mdx
 create mode 100644 docs/plugins/official/markdown.mdx
 create mode 100644 docs/plugins/official/qrcode.mdx
 create mode 100644 docs/plugins/others/_meta.json
 create mode 100644 docs/plugins/others/index.mdx
 create mode 100644 docs/plugins/others/relink.mdx

diff --git a/docs/guide/learn-wiki/tiddlywiki.mdx b/docs/guide/learn-wiki/tiddlywiki.mdx
index a59d8c0..ab73f6b 100644
--- a/docs/guide/learn-wiki/tiddlywiki.mdx
+++ b/docs/guide/learn-wiki/tiddlywiki.mdx
@@ -1,6 +1,6 @@
 # 太微
 
-## 使用 tiddlywiki 最重要的事情是什么？
+## 使用 TiddlyWiki 最重要的事情是什么？
 
 <div style={{ fontSize: 50, fontWeight: "bold", color: "red" }}>备份！！！</div>
 
diff --git a/docs/plugins/_meta.json b/docs/plugins/_meta.json
index fff3344..d55bb1d 100644
--- a/docs/plugins/_meta.json
+++ b/docs/plugins/_meta.json
@@ -30,6 +30,11 @@
         "name": "feature",
         "label": "功能类插件"
     },
+    {
+        "type": "dir",
+        "name": "others",
+        "label": "其他插件"
+    },
     {
         "type": "dir",
         "name": "themes",
diff --git a/docs/plugins/kookma/_meta.json b/docs/plugins/kookma/_meta.json
index 150766c..4dd76cd 100644
--- a/docs/plugins/kookma/_meta.json
+++ b/docs/plugins/kookma/_meta.json
@@ -1,6 +1,13 @@
 [
+    "index",
     "commander",
     "shiraz",
     "utility",
-    "favorites"
+    "favorites",
+    "trashbin",
+    "tamasha",
+    "section",
+    "refnotes",
+    "hsl",
+    "gatha"
 ]
\ No newline at end of file
diff --git a/docs/plugins/kookma/commander.mdx b/docs/plugins/kookma/commander.mdx
index 20947da..8827ccb 100644
--- a/docs/plugins/kookma/commander.mdx
+++ b/docs/plugins/kookma/commander.mdx
@@ -1 +1,10 @@
-# Tiddler Commander
+# Commander
+
+- Demo: https://kookma.github.io/TW-Commander
+- Code: https://github.com/kookma/TW-Commander
+
+批量修改器。你可以用这个插件来批量修改任何条目。使用这个插件，你需要会使用筛选器，把你要修改的条目筛选出来。然后你可以批量添加标签，或者删除标签。
+
+如果你是使用单文件版本，请注意备份。因为批量修改后是很难修复的。如果你使用太记版本，也请注意在修改前，进行一次备份。
+
+虽然你可以自己写代码来实现批量修改，但有了插件不比自己写的代码要方便吗？所以强烈推荐安装。
diff --git a/docs/plugins/kookma/favorites.mdx b/docs/plugins/kookma/favorites.mdx
index 20947da..43171e8 100644
--- a/docs/plugins/kookma/favorites.mdx
+++ b/docs/plugins/kookma/favorites.mdx
@@ -1 +1,8 @@
-# Tiddler Commander
+# Favorites
+
+- Demo: https://kookma.github.io/TW-Favorites
+- Code: https://github.com/kookma/TW-Favorites
+
+会在页面上多出一个按钮，这样你就可以添加这个按钮，收藏一个条目。然后你也可以打开侧边栏，会看到有一个`Favorites`的选项，点击会展示你收藏的条目。
+
+收藏的条目还可以分类。算是挺方便的一个插件了。
diff --git a/docs/plugins/kookma/gatha.mdx b/docs/plugins/kookma/gatha.mdx
new file mode 100644
index 0000000..0aefe8b
--- /dev/null
+++ b/docs/plugins/kookma/gatha.mdx
@@ -0,0 +1,8 @@
+# Gatha
+
+- Demo: https://kookma.github.io/TW-Gatha
+- Code: https://github.com/kookma/TW-Gatha
+
+这个插件怎么说呢？还是很推荐了解学习的。因为这个插件几乎不需要任何开发知识，只要会使用太微，就能封装一些条目来包装成插件。
+
+同时你也可以用这个插件来分发一些内容。
diff --git a/docs/plugins/kookma/hsl.mdx b/docs/plugins/kookma/hsl.mdx
new file mode 100644
index 0000000..20f732a
--- /dev/null
+++ b/docs/plugins/kookma/hsl.mdx
@@ -0,0 +1,6 @@
+# Highlight Selected Lines
+
+- Demo: https://kookma.github.io/TW-Hsl
+- Code: https://github.com/kookma/TW-Hsl
+
+用来高亮代码的。你也可以用来截取展示某一条目的某几行内容。
diff --git a/docs/plugins/kookma/index.mdx b/docs/plugins/kookma/index.mdx
new file mode 100644
index 0000000..544b4b7
--- /dev/null
+++ b/docs/plugins/kookma/index.mdx
@@ -0,0 +1,3 @@
+# 库克马插件库
+
+为什么介绍完了官方插件库，紧接着就是介绍库克马插件库。因为他开发了很多非常实用的插件。而且他也写了很详细的文档。如果你对这些插件有什么疑问，也可以去论坛找他。
diff --git a/docs/plugins/kookma/refnotes.mdx b/docs/plugins/kookma/refnotes.mdx
new file mode 100644
index 0000000..33a4076
--- /dev/null
+++ b/docs/plugins/kookma/refnotes.mdx
@@ -0,0 +1,6 @@
+# Refnotes
+
+- Demo: https://kookma.github.io/TW-Refnotes
+- Code: https://github.com/kookma/TW-Refnotes
+
+这是一个用来写注释，引用相关的插件。可能对学术写作会有帮助。
diff --git a/docs/plugins/kookma/section.mdx b/docs/plugins/kookma/section.mdx
new file mode 100644
index 0000000..d9c0c5d
--- /dev/null
+++ b/docs/plugins/kookma/section.mdx
@@ -0,0 +1,6 @@
+# Section Editor
+
+- Demo: https://kookma.github.io/TW-Section
+- Code: https://github.com/kookma/TW-Section
+
+章节编辑器。这个插件对于编辑一些长条目来说，还挺有帮助的。
diff --git a/docs/plugins/kookma/shiraz.mdx b/docs/plugins/kookma/shiraz.mdx
index 20947da..34135bd 100644
--- a/docs/plugins/kookma/shiraz.mdx
+++ b/docs/plugins/kookma/shiraz.mdx
@@ -1 +1,8 @@
-# Tiddler Commander
+# Shiraz
+
+- Demo: https://kookma.github.io/TW-Shiraz
+- Code: https://github.com/kookma/TW-Shiraz
+
+我一般称这个插件为设拉子插件。因为插件名称翻译过来就是设拉子。而这也是一个城市的名称好像。
+
+这个插件也非常厉害，里面封装了`bootstrap`前端库，你可以做各种前端上的页面优化。同时这里面还封装了一个动态表格插件。不知道为什么库克马没有单独分出来，可能是为了让表格也一同使用这个前端库吧。
diff --git a/docs/plugins/kookma/tamasha.mdx b/docs/plugins/kookma/tamasha.mdx
new file mode 100644
index 0000000..2dc7037
--- /dev/null
+++ b/docs/plugins/kookma/tamasha.mdx
@@ -0,0 +1,8 @@
+# Tamasha
+
+- Demo: https://kookma.github.io/TW-Tamasha
+- Code: https://github.com/kookma/TW-Tamasha
+
+这是一个 ppt 插件。但不太好的地方是，当你使用条目作为 ppt 的内容，ppt 并不能把条目所有内容都展示出来。
+
+我去仓库里提问过，库克马认为用户应该合理控制条目的内容，而不是扩展 ppt 的空间。因为 ppt 的空间也就相当于一个屏幕的空间。
diff --git a/docs/plugins/kookma/trashbin.mdx b/docs/plugins/kookma/trashbin.mdx
new file mode 100644
index 0000000..9c4ed34
--- /dev/null
+++ b/docs/plugins/kookma/trashbin.mdx
@@ -0,0 +1,6 @@
+# Trashbin
+
+- Demo: https://kookma.github.io/TW-Trashbin
+- Code: https://github.com/kookma/TW-Trashbin
+
+垃圾桶插件，这样你删除条目的时候，如果是用垃圾桶插件删除的，就会进入到侧边栏的垃圾桶里，因此你还可以用垃圾桶来恢复。如果你不想要恢复，你可以进一步点击彻底删除。
diff --git a/docs/plugins/kookma/utility.mdx b/docs/plugins/kookma/utility.mdx
index 20947da..97a13f0 100644
--- a/docs/plugins/kookma/utility.mdx
+++ b/docs/plugins/kookma/utility.mdx
@@ -1 +1,6 @@
-# Tiddler Commander
+# Utility
+
+- Demo: https://kookma.github.io/TW-Utility
+- Code: https://github.com/kookma/TW-Utility
+
+这个插件也十分推荐安装。里面封装了很多太微原生的宏，你可以进一步发挥太微的功能。
diff --git a/docs/plugins/official/_meta.json b/docs/plugins/official/_meta.json
index 52c8a54..b797a91 100644
--- a/docs/plugins/official/_meta.json
+++ b/docs/plugins/official/_meta.json
@@ -1,3 +1,9 @@
 [
-    "dd"
+    "index",
+    "code-mirror",
+    "highlight",
+    "katex",
+    "markdown",
+    "qrcode",
+    "dynannotate"
 ]
\ No newline at end of file
diff --git a/docs/plugins/official/code-mirror.mdx b/docs/plugins/official/code-mirror.mdx
new file mode 100644
index 0000000..80d1556
--- /dev/null
+++ b/docs/plugins/official/code-mirror.mdx
@@ -0,0 +1,17 @@
+# Code Mirror 系列
+
+`$:/plugins/tiddlywiki/codemirror`有一系列插件，里面还包含了各种子插件。
+
+## 设置
+
+code mirror 可以在`控制台`--`设置`--`CodeMirror`中找到。
+
+这里推荐两个设置。一个是 Enable line numbers，建议勾选。这样在编辑的时候就可以看到行号了。另一个是 Highlight active line，也建议勾选，这样在编辑的时候，就会高亮编辑的那一行。可以很明显区分出其他的行数。
+
+## 子插件
+
+十分推荐安装这一系列插件。来改进太微原本的编辑功能。下面是推荐安装的子插件功能介绍。
+
+- CodeMirror Autocomplete: Autocompletion for CodeMirror
+  - 自动完成，是对于像 html 中的`<div>`标签能够自动完成闭标签`</div>`。
+  - `$:/plugins/tiddlywiki/codemirror-autocomplete`
diff --git a/docs/plugins/official/dd.mdx b/docs/plugins/official/dd.mdx
deleted file mode 100644
index 93391e6..0000000
--- a/docs/plugins/official/dd.mdx
+++ /dev/null
@@ -1 +0,0 @@
-## 00
diff --git a/docs/plugins/official/dynannotate.mdx b/docs/plugins/official/dynannotate.mdx
new file mode 100644
index 0000000..e4a8814
--- /dev/null
+++ b/docs/plugins/official/dynannotate.mdx
@@ -0,0 +1,3 @@
+# Dynannotate
+
+是一些插件的依赖插件。建议安装。
diff --git a/docs/plugins/official/highlight.mdx b/docs/plugins/official/highlight.mdx
new file mode 100644
index 0000000..82ec6f6
--- /dev/null
+++ b/docs/plugins/official/highlight.mdx
@@ -0,0 +1,3 @@
+# Highlight
+
+高亮代码。
diff --git a/docs/plugins/official/index.mdx b/docs/plugins/official/index.mdx
new file mode 100644
index 0000000..da94560
--- /dev/null
+++ b/docs/plugins/official/index.mdx
@@ -0,0 +1,7 @@
+# 官方插件库
+
+官方插件库是任何一个太微都会有的插件库。里面除了语言插件外，大多数插件都是面向开发者的插件，通常是封装某个库来帮助开发者开发功能插件时，避免重复包装插件。
+
+只有少数插件是面向最终使用用户的。
+
+官方插件库里的插件与太微当前版本号保持一致。
diff --git a/docs/plugins/official/katex.mdx b/docs/plugins/official/katex.mdx
new file mode 100644
index 0000000..f7d9d19
--- /dev/null
+++ b/docs/plugins/official/katex.mdx
@@ -0,0 +1,3 @@
+# KaTeX
+
+支持数学代码编辑。
diff --git a/docs/plugins/official/markdown.mdx b/docs/plugins/official/markdown.mdx
new file mode 100644
index 0000000..9b31192
--- /dev/null
+++ b/docs/plugins/official/markdown.mdx
@@ -0,0 +1,3 @@
+# Markdown
+
+在太微中，你也可以继续保持 markdown 编辑的习惯。但要注意的是，如果条目是以 markdown 形式保存的话，会有很多微件和其他功能无法使用。将大大限制太微的功能。因而不建议在太微中使用 markdown，更建议用专门的 markdown 编辑器，如 obsidian 或者 vscode 等工具。
diff --git a/docs/plugins/official/qrcode.mdx b/docs/plugins/official/qrcode.mdx
new file mode 100644
index 0000000..a2d8c17
--- /dev/null
+++ b/docs/plugins/official/qrcode.mdx
@@ -0,0 +1,3 @@
+# QR Code
+
+用来生成二维码，特别是发布网址时，可以让别人通过二维码来查看条目。
diff --git a/docs/plugins/others/_meta.json b/docs/plugins/others/_meta.json
new file mode 100644
index 0000000..37a0302
--- /dev/null
+++ b/docs/plugins/others/_meta.json
@@ -0,0 +1,4 @@
+[
+    "index",
+    "relink"
+]
\ No newline at end of file
diff --git a/docs/plugins/others/index.mdx b/docs/plugins/others/index.mdx
new file mode 100644
index 0000000..7216c19
--- /dev/null
+++ b/docs/plugins/others/index.mdx
@@ -0,0 +1,3 @@
+# 其他类插件
+
+暂时还不知道咋分类的插件。但有的也很重要。
diff --git a/docs/plugins/others/relink.mdx b/docs/plugins/others/relink.mdx
new file mode 100644
index 0000000..b0d9cb4
--- /dev/null
+++ b/docs/plugins/others/relink.mdx
@@ -0,0 +1,7 @@
+# Relink 系列
+
+这个系列可以说是每个太微都必须安装的一个插件了。因为有了这个插件后，你批量修改条目的话，就不用再担心原来的链接失效了。
+
+说实话，我觉得这个插件应该由官方团队来负责。因为这个插件实在太重要了。可以说，后面这个插件在什么时候不维护了，不能继续使用了。那面向最终用户使用的太微很可能就只停留在那个版本上了。
+
+往后的太微再怎么发展，使用起来也很有风险。因为你不知道自己之前在某个 条目设置的链接，后面是否还保留着。