Skip to content

Commit

Permalink
更新插件库部分
Browse files Browse the repository at this point in the history
2024年02月04日 15时15分58秒
  • Loading branch information
dongrentianyu committed Feb 4, 2024
1 parent befbd24 commit ced8520
Show file tree
Hide file tree
Showing 26 changed files with 149 additions and 8 deletions.
2 changes: 1 addition & 1 deletion docs/guide/learn-wiki/tiddlywiki.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# 太微

## 使用 tiddlywiki 最重要的事情是什么?
## 使用 TiddlyWiki 最重要的事情是什么?

<div style={{ fontSize: 50, fontWeight: "bold", color: "red" }}>备份!!!</div>

Expand Down
5 changes: 5 additions & 0 deletions docs/plugins/_meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,11 @@
"name": "feature",
"label": "功能类插件"
},
{
"type": "dir",
"name": "others",
"label": "其他插件"
},
{
"type": "dir",
"name": "themes",
Expand Down
9 changes: 8 additions & 1 deletion docs/plugins/kookma/_meta.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,13 @@
[
"index",
"commander",
"shiraz",
"utility",
"favorites"
"favorites",
"trashbin",
"tamasha",
"section",
"refnotes",
"hsl",
"gatha"
]
11 changes: 10 additions & 1 deletion docs/plugins/kookma/commander.mdx
Original file line number Diff line number Diff line change
@@ -1 +1,10 @@
# Tiddler Commander
# Commander

- Demo: https://kookma.github.io/TW-Commander
- Code: https://github.com/kookma/TW-Commander

批量修改器。你可以用这个插件来批量修改任何条目。使用这个插件,你需要会使用筛选器,把你要修改的条目筛选出来。然后你可以批量添加标签,或者删除标签。

如果你是使用单文件版本,请注意备份。因为批量修改后是很难修复的。如果你使用太记版本,也请注意在修改前,进行一次备份。

虽然你可以自己写代码来实现批量修改,但有了插件不比自己写的代码要方便吗?所以强烈推荐安装。
9 changes: 8 additions & 1 deletion docs/plugins/kookma/favorites.mdx
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Tiddler Commander
# Favorites

- Demo: https://kookma.github.io/TW-Favorites
- Code: https://github.com/kookma/TW-Favorites

会在页面上多出一个按钮,这样你就可以添加这个按钮,收藏一个条目。然后你也可以打开侧边栏,会看到有一个`Favorites`的选项,点击会展示你收藏的条目。

收藏的条目还可以分类。算是挺方便的一个插件了。
8 changes: 8 additions & 0 deletions docs/plugins/kookma/gatha.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Gatha

- Demo: https://kookma.github.io/TW-Gatha
- Code: https://github.com/kookma/TW-Gatha

这个插件怎么说呢?还是很推荐了解学习的。因为这个插件几乎不需要任何开发知识,只要会使用太微,就能封装一些条目来包装成插件。

同时你也可以用这个插件来分发一些内容。
6 changes: 6 additions & 0 deletions docs/plugins/kookma/hsl.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Highlight Selected Lines

- Demo: https://kookma.github.io/TW-Hsl
- Code: https://github.com/kookma/TW-Hsl

用来高亮代码的。你也可以用来截取展示某一条目的某几行内容。
3 changes: 3 additions & 0 deletions docs/plugins/kookma/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 库克马插件库

为什么介绍完了官方插件库,紧接着就是介绍库克马插件库。因为他开发了很多非常实用的插件。而且他也写了很详细的文档。如果你对这些插件有什么疑问,也可以去论坛找他。
6 changes: 6 additions & 0 deletions docs/plugins/kookma/refnotes.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Refnotes

- Demo: https://kookma.github.io/TW-Refnotes
- Code: https://github.com/kookma/TW-Refnotes

这是一个用来写注释,引用相关的插件。可能对学术写作会有帮助。
6 changes: 6 additions & 0 deletions docs/plugins/kookma/section.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Section Editor

- Demo: https://kookma.github.io/TW-Section
- Code: https://github.com/kookma/TW-Section

章节编辑器。这个插件对于编辑一些长条目来说,还挺有帮助的。
9 changes: 8 additions & 1 deletion docs/plugins/kookma/shiraz.mdx
Original file line number Diff line number Diff line change
@@ -1 +1,8 @@
# Tiddler Commander
# Shiraz

- Demo: https://kookma.github.io/TW-Shiraz
- Code: https://github.com/kookma/TW-Shiraz

我一般称这个插件为设拉子插件。因为插件名称翻译过来就是设拉子。而这也是一个城市的名称好像。

这个插件也非常厉害,里面封装了`bootstrap`前端库,你可以做各种前端上的页面优化。同时这里面还封装了一个动态表格插件。不知道为什么库克马没有单独分出来,可能是为了让表格也一同使用这个前端库吧。
8 changes: 8 additions & 0 deletions docs/plugins/kookma/tamasha.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Tamasha

- Demo: https://kookma.github.io/TW-Tamasha
- Code: https://github.com/kookma/TW-Tamasha

这是一个 ppt 插件。但不太好的地方是,当你使用条目作为 ppt 的内容,ppt 并不能把条目所有内容都展示出来。

我去仓库里提问过,库克马认为用户应该合理控制条目的内容,而不是扩展 ppt 的空间。因为 ppt 的空间也就相当于一个屏幕的空间。
6 changes: 6 additions & 0 deletions docs/plugins/kookma/trashbin.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Trashbin

- Demo: https://kookma.github.io/TW-Trashbin
- Code: https://github.com/kookma/TW-Trashbin

垃圾桶插件,这样你删除条目的时候,如果是用垃圾桶插件删除的,就会进入到侧边栏的垃圾桶里,因此你还可以用垃圾桶来恢复。如果你不想要恢复,你可以进一步点击彻底删除。
7 changes: 6 additions & 1 deletion docs/plugins/kookma/utility.mdx
Original file line number Diff line number Diff line change
@@ -1 +1,6 @@
# Tiddler Commander
# Utility

- Demo: https://kookma.github.io/TW-Utility
- Code: https://github.com/kookma/TW-Utility

这个插件也十分推荐安装。里面封装了很多太微原生的宏,你可以进一步发挥太微的功能。
8 changes: 7 additions & 1 deletion docs/plugins/official/_meta.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
[
"dd"
"index",
"code-mirror",
"highlight",
"katex",
"markdown",
"qrcode",
"dynannotate"
]
17 changes: 17 additions & 0 deletions docs/plugins/official/code-mirror.mdx
Original file line number Diff line number Diff line change
@@ -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`
1 change: 0 additions & 1 deletion docs/plugins/official/dd.mdx

This file was deleted.

3 changes: 3 additions & 0 deletions docs/plugins/official/dynannotate.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Dynannotate

是一些插件的依赖插件。建议安装。
3 changes: 3 additions & 0 deletions docs/plugins/official/highlight.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Highlight

高亮代码。
7 changes: 7 additions & 0 deletions docs/plugins/official/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# 官方插件库

官方插件库是任何一个太微都会有的插件库。里面除了语言插件外,大多数插件都是面向开发者的插件,通常是封装某个库来帮助开发者开发功能插件时,避免重复包装插件。

只有少数插件是面向最终使用用户的。

官方插件库里的插件与太微当前版本号保持一致。
3 changes: 3 additions & 0 deletions docs/plugins/official/katex.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# KaTeX

支持数学代码编辑。
3 changes: 3 additions & 0 deletions docs/plugins/official/markdown.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Markdown

在太微中,你也可以继续保持 markdown 编辑的习惯。但要注意的是,如果条目是以 markdown 形式保存的话,会有很多微件和其他功能无法使用。将大大限制太微的功能。因而不建议在太微中使用 markdown,更建议用专门的 markdown 编辑器,如 obsidian 或者 vscode 等工具。
3 changes: 3 additions & 0 deletions docs/plugins/official/qrcode.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# QR Code

用来生成二维码,特别是发布网址时,可以让别人通过二维码来查看条目。
4 changes: 4 additions & 0 deletions docs/plugins/others/_meta.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
[
"index",
"relink"
]
3 changes: 3 additions & 0 deletions docs/plugins/others/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# 其他类插件

暂时还不知道咋分类的插件。但有的也很重要。
7 changes: 7 additions & 0 deletions docs/plugins/others/relink.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Relink 系列

这个系列可以说是每个太微都必须安装的一个插件了。因为有了这个插件后,你批量修改条目的话,就不用再担心原来的链接失效了。

说实话,我觉得这个插件应该由官方团队来负责。因为这个插件实在太重要了。可以说,后面这个插件在什么时候不维护了,不能继续使用了。那面向最终用户使用的太微很可能就只停留在那个版本上了。

往后的太微再怎么发展,使用起来也很有风险。因为你不知道自己之前在某个 条目设置的链接,后面是否还保留着。

0 comments on commit ced8520

Please sign in to comment.