导言
太微和太微之书是什么？
太微是对 tiddlywiki 的中文翻译，后面的文档中会视情况使用 tiddlywiki 和太微两个名词，但指向都是一样的。
太微之书是本文档，旨在从最基础的内容开始写起，让新手以最快的速度了解 tiddlywiki，了解太微生态，并上手使用。
tiddlywiki 是什么？
tiddlywiki 是一款具有接近二十年（明年就 20 年了）发展历史的网页程序。最早是由杰里米开发，现在已经是一个不 断发展的开源项目，越来越多的人参与到这个项目进来。
在 2014 年，杰里米完成了对 tiddlywiki 的重构，并发布新版本 tiddlywiki5，目前的版本号都是在 tiddlywiki5 下进行的，最新版本是 5.3.1。
为什么你该使用 tiddlywiki？
软件本身
- 开源免费
- 本地优先
- 多种部署
- 可使用 git 记录提交
- 插件丰富，生态完善
- 近 20 年发展历史
- 功能强大、自定义程度高
tiddlywiki 本身是一个 HTML 网页文件，完整地包含了各种程序代码、样式表文件。如果安装了插件，插件也会完整地保存进去。
同时 tiddlywiki 又可通过 nodejs 进行部署，以更细粒化的方式进行保存备份。
而 tiddlywiki 本身可以直接实现当下笔记软件所具有的多个功能，比如标签、链接、模板化使用、自动化运行。
其次，tiddlywiki 及生态也在不断发展，拥有四百多个插件，选择一些插件就可以配置出属于自己的 tiddlywiki 了。
并且 tiddlywiki 本身是开源免费的，所以完全不用担心 tiddlywiki 会出现开发者跑路的问题。
tiddlywiki 这种把数据和程序几乎完全绑定在一起的方式，我以为是比 obsidian 拆分两者是要更好的。数据离不开程序运行，而程序需要数据来支撑。而硬要拆分两者，就只能选择基础通用的功能，无法在更高更复杂的情况下实现更多的需求。
更多的链接！！！
tiddlywiki 可以实现各种各样的功能，比如写关于某个项目的小册子，或者用来记日记，或者是做成商业展示网页。不过最多的还是打造成个人笔记系统和个人博客。把笔记系统写出来的内容发布公开就成了个人博客。博客也可以视作是数字花园。
最早的笔记软件一般只有标签加文件夹功能。而第二代笔记软件，大部分是在前面的基础上加上了双链和模板的功能。而不同的笔记软件还有不同之处，比如动态表格，比如大纲笔记，比如白板笔记。但这些只有动态表格 tiddlywiki 实现得比较好，大纲笔记和白板笔记还有欠缺。
而作为笔记系统，tiddlywiki 和其他笔记软件最大的不同就在于，tiddlywiki 有更多且更丰富的链接。标题和标签是最基本的链接，加上双链，再加上条目的字段内容也可以生成链接。而 tiddlywiki 推崇把单个条目上写成多个更小的片段。以保证能够重复使用一些笔记。所以这就导致了，可能在其他笔记系统里，一个 markdown 文件，可以写几千字甚至上万字，而在 tiddlywiki 里则只推荐写几百字到两千字左右。超过两千字的，我个人会重新处理，再分成几个条目。
这也就导致了 tiddlywiki 的链接非常多，数量级完全不一样。如果你不喜欢这样太碎、太多链接，那你可能不适合用 tiddlywiki 来写笔记。
不过没关系，你也可以把 tiddlywiki当成游戏来体验下，tiddlywiki 也是一个很有意思的玩具。
更多的拓展
如果你是前端程序员，那么你更能探索 tiddlywiki 了。因为 tiddlywiki 支持 html 和 javascript，你可以操作 javascript 来进行更为丰富的操作。但本文档会尽可能避免 javascript 内容，原因很简单，我也不会 javascript。后面高阶内容里，可能会简单涉及，但主要是与插件相关的。
为什么会写这份文档？
目前已经有很多 tiddlywiki 教程了。但不管是官方文档，还是太微中文教程，还是 tiddlywiki-xp，都是以 tiddlywiki 自身的形式展示的。而新手又不了解 tiddlywiki，结果就导致了新手很多时候连基本的 tiddlywiki 教程都看不完，或者看不全。
随后便遇到了很多很多，各种各样的问题，从而导致 tiddlywiki 一直推广不开，只能小众发展。
现在打算以 markdown 的形式，按照通行教程思路，一步步演示 tiddlywiki 应该如何上手使用。
资源下载
因为 tiddlywiki 很多内容都放在了 github 上，而 github 国内又访问不是很方便。所以我建了一个 QQ 群，里面用来存放资料。里面开启禁言，如果想要讨论，可以前往大群里讨论或者去太微中文论坛里讨论。
我更喜欢在论坛里讨论问题，可以保存讨论内容，帮助到后来者，也更方便管理。
当然也欢迎在本项目仓库里提 issue，issue 看到了也会回复的。
另外，技术有限，所以docusaurus能实现的功能，未必能全部实现，只能实现简单的功能，markdown 语法一旦搞复杂了，非常麻烦。
正确合理提问-更快解决问题
tiddlywiki 是一个复杂的工具，功能强大，可以用来创造和实现很多内容。
但新手在实现之前会遇到各种各样的问题。比如想实现某个需求，不知道怎么写微件或者宏。不知道有什么插件等。
而同时 tiddlywiki 又有着将近二十年的发展历史。有很多问题实际上是已经解决过的。但新手同样不知道。
而有些问题就会反复提问。提问不要紧，但反复提问就有些浪费时间了。既浪费提问者的时间，也浪费回答者的时间。要知道程序员的时薪可是很贵的。所以也欢迎更多的人加入论坛中帮助别人回答问题，共建太微 中文社区。
其次，正确的提问，有助于更快解决问题。这方面的内容请看提问的智慧。文档我也添加在下面了，随手就可以打开查看。
简单举例来说，就是尽可能清楚描述问题的需求，想要实现什么样的功能。
因为开发者或者说回答问题的人，不是客服。他们没有任何义务要回答问题，他们是出自热爱和奉献，牺牲自己的时间来回答问题。开发者大部分是程序员，时薪很贵的。
一般来说，描述需求越明确，开发者就越能明白你实际上是需要什么功能，应该如何快速实现。如果描述不清楚某个功能，说明对这个功能还不是很了解，也不知道实现了能做什么，不能做什么，所付出的成本是多少。这些无知会增加交流负担。
所以能自己解决就尽可能自己解决。多搜索一下论坛或者 QQ 群，官方文档，或者其他文档里的内容。不要把本该属于你自己的学习成本转加给其他人。
最后有一点，就是不要拍屏，电脑是有截图功能的。没有人愿意看拍屏里的内容，我是非常不愿意看的。为什么不截图呢？也不会保存到文件夹里，也不影响内存的。
当然，如果能付费，上面就当是屁话。付费解决一切问题。付费提前说明，有偿解答问题。最后留一张图说明一切。
多余的话
tiddlywiki 本身是 一个复杂的工具，而且这个复杂的工具几乎要求其使用者也具备一定的特性。从来只要人要求工具做什么，到 tiddlywiki 这里了，反而是要去适应 tiddlywiki 的一些特性。
我见过太多学会了一些 tiddlywiki 操作，但因为各种各样的原因，最终仍然没能用上 tiddlywiki 的人。
其实我们并非说是去适应，而是给 tiddlywiki 和自己一点时间，特别是没有编程基础的人。你需要给自己一点去接受 tiddlywiki 的时间。教程可能一天或者一周就能看完，但要真正用上 tiddlywiki，你可能需要一年的时间。因为背后还涉及了很多前端编程的知识，比如要了解 html，要学习 css，要了解正则是如何筛选的等等。
你可以把这些当成必学的项目，也可以当成选修的项目，甚至你不学也不会影响你使用。但是当你有一天，你需要筛选出标题里只包含某个字母的笔记时，你就需要学习了。这个学习成本只能是去承担，文档和教程只能说是减少学习过程中的痛苦和不必要的麻烦，但实质的学习内容并不能为你化解。就像人生的困难一样，该面对的还是要面对。
tiddlywiki 有些像《道德经》，虽然将其比作《道德经》有过份夸大的嫌疑，但想不出比这更好的类比了，《道德经》五千言从而奠定了中国哲学两千年的发展方向，而 tiddlywiki 不敢说两千年吧，但我预计未来二十年仍然是笔记软件里最值得研究的一款。
我从编程小白到参与文档编写，花费了一年的时间，当然我投入的时间比较多，正常来说坚持半年就会一直用下去了。而你可能只需要半年，因为现在教程丰富了，插件也丰富了。
赞助支持
欢迎打赏支持，每一次支持我都会起来继续编写，加快进度。
| 微信 | 支付宝 |
|---|---|
 |  |
<Link to="# 太微和太微之书是什么？">回到顶端</Link>
其他内容
索引看样子像是解决了，只不过会有时差，搞得我以为出现了什么差错。