欢迎来到太微!

林一二 2024年09月05日 11:41

笔记应用TGNote
双向链接支持

太微中文讨论区

点击图片放大

如何浏览此知识库

  1. 可以翻阅右边侧边栏上的文档目录标签页,或点击「最近」标签页查看最新更新的内容
  2. 查看每个条目底部的反向链接
  3. 点击右边栏上的 按钮来打开搜索框(或直接点击 !)
  4. 随意点击任何笔记上的编辑按钮 来查看源文本,可以学习到很多高级用法

如何开始使用太微

  1. 查看如何保存来下载相关应用程序,创建你自己的知识库。
  2. 浏览基础知识,进一步了解太微的独特之处
  3. 访问 可离线版本 可以让你点击侧边栏上的下载按钮把网页下载为单个HTML文件离线阅读。也可以在网页上直接修改此知识库试试,放心,你不会真正修改到我们数据库里的内容
  4. 对TiddlyWiki进行功能分级,大概可以分成四个方面:开发框架/知识管理操作系统 > 插件开发 > Wiki编程 > WikiText笔记与写作
  5. 你可以在资源链接里找到其它社区资源链接TiddlyWiki教程知识链接与正在使用的个人太微Wiki示例,还有常用的插件介绍(包括TidGi预制插件)、一份TiddlyWiki游戏TiddlyWiki的全平台软件以及工作流程。

背景介绍

查看引文:太微背景介绍

中文文档

TiddlyWiki官网和一系列社区提供了太微完善的教程,不熟悉英文的爱好者请阅读由@BramChen大佬翻译的TiddlyWiki 舞 - 官方基础文档简体中文版

但太微官网主要关心太微核心的功能,没法装下二次创作的所有生态信息,而太微最关键的是社区和插件。因此我们建设了中文文档来介绍太微千千万万的插件和开发者组成的社区内容。

幻灯片

为方便宣讲,我们在此提供几类幻灯片,对应不同的宣讲场景:

编辑内容

如果你想编辑幻灯片,或想为中文教程添砖加瓦,可以查看如何保存内容到社区仓库里以及如何保存

点击某个幻灯片的标签,打开该幻灯片的条目,添加属于该标签的子条目,即可让子条目加入新的幻灯片页面。在点击标签打开的列表里拖动条目可以排序!

他们是这样评价太微的

TiddlyWiki 旨在于铭记其用户的长期需求。因为它是开放源码的,且无需技术基础设施,我们可以确信,即使在遥远的未来,我们访问 TiddlyWiki 文件时也只需要准备一个普通的浏览器。如果在您的职业生涯开始时使用 TiddlyWiki,您可以确信它将带您直到退休。

2016 年 01 月的网络世界杂志

目前市面上的个人维基系统有很多种,但它们要么体积庞大、界面丑陋,要么搭建步骤复杂、对普通用户不友好,在一番比较后我最终选择了轻量化的 Tiddlywiki。 Tiddlywiki 的拥有丰富的功能和强大的插件,编辑时支持标签管理、条目关联、过滤器,也支持通过插件实现高亮代码、输入数学公式、标准 markdown 语法等等,还能自定义样式。

少数派评论员i9NGbgNq

TiddlyWiki ,按官方说法是一个「非线性个人 Web 笔记本」。相比其他笔记和 Wiki 系统,其最大的特点之一是程序本体和数据全部都在一个单 html 文件内,与此同时仍然有着非常强大的功能和插件系统。在我看来,管理以文字、代码和数学公式为主的个人知识库, TiddlyWiki 可谓是最好的选择之一。

使用 TiddlyWiki 的用途和心得?知乎Rrupmid_Nyche的回答

以及热爱太微的更多用户……

更多用户评论

太微

太微垣,三垣之一,按《步天歌》,太微垣為三垣的上垣。 太微垣又名天庭,是政府的意思,也是貴族及大臣們居住的地方。

「太微」是我们对 TiddlyWiki 的中文称呼,TiddlyWiki是一款极其强大又极具拓展性的个人 Wiki 系统。

为什么把 TiddlyWiki 翻译成「太微」?因为受到 @pimgeek 的启发:TiddlyWiki 可以干很多细致轻量的工作,但也从不限制用法,可以无限组合叠加。故以其首字母音译为「太微」,TiddlyWiki 可以称为「太微笔记」「太微万能抽屉」「太微卡片盒」……

TiddlyWiki 是一个由单个 HTML 文件组成的非网络应用的 Wiki 程序。使用 HTML、CSS 及 JavaScript 技术,和MediaWiki、DokuWiki等不同,完全不需要任何的数据库(如:MySQL)及动态语言(如:PHP、ASP、Java 等)。因此任何人都可以在任何地方下载该页面并立即开始编辑和使用。适合一般个人单机的使用和对个人电脑的管理工作。

维基百科

太微能做什么

太微非常强大,且不需要任何服务器和数据库知识就可以实现高度定制和私有部署,但可惜由于在国内没有活跃的社区,所以太微的爱好者们往往因此对太微“望而生畏”,这也是我们建立这个教程网站的原因:做好「太微」本土化的“指路人”、“搬运工”和交流平台,并为国内的TW开发者提供好开发思路和开发社区。

您曾感觉人类的大脑是有极限的吗?感觉它不足以容纳一切你需要记住的事?

欢迎使用 TiddlyWiki,一个独特的非线性笔记本,用于截取管理复用复杂的信息。

用它来保留您的待办清单、计划一篇散文或一部小说、或安排您的婚礼。记录每个闪过您脑中的想法,或创建一个灵活和反应迅速的网站。

tiddlywiki与obsidian的对比

对比网站链接

有不少人是从 Obsidian 转换到 TiddlyWiki 的,可能会对两款软件进行对比。通过上述网站可以看到比较详细的对比内容。不过对比内容好像是用户自发写的,有一定的主观色彩。

也可参考群友写的另一篇文章

TiddlyWiki 与 Obsidian 的简要对比:

  • TiddlyWiki 默认情况下单页面信息量(或称笔记数量)相比 Obsidian 更多,方便笔记之间跳转;Obsidian 支持笔记多窗口,自由排布
  • TiddlyWiki 可以不依赖任何软件运行(除了浏览器本身),本身就是一个简单的 HTML 文件,而 Obsidian 本质上是一个 Markdown 编辑器,可以在不打开软件的情况下增删改所有笔记
  • TiddlyWiki 的编辑器默认情况下较为局促,写作空间没有 Obsidian 敞亮,需要插件或主题调整
  • Obsidian 默认拥有标题和列表缩放功能,Tiddlywiki 缺乏这个功能(需要插件或 Macro 辅助)
  • 两者都是基本上全平台,Obsidian 新兴但是社区热闹氛围好,TiddlyWiki 历史悠久但是小众,圈子较窄
  • TiddlyWiki 完全免费开源(基于 BSD3 开源许可协议),官方不提供任何付费服务,纯粹的用爱发电项目,而 Obsidian 免费但不开源,官方提供付费同步 Sync 和付费发布 Publish 服务
  • 两者均为程序/数据分离设计(Node.js 版 TiddlyWiki),故支持各种不同的同步/备份方式,可根据自身喜好设定,不受软件本身限制
  • TiddlyWiki 基于 WikiText(方言)语法,Obsidian 基于 Markdown,默认情况下前者的表格表现形式比后者更好(例如可以很轻松地合并单元格),语法优秀功能非常丰富,后者更加易上手,但是受语言限制较大
  • Tiddlywiki 自带单个笔记加密和整个笔记本加密(单文件版)功能,Obsidian 原生不支持加密功能(本质上是管理本地文件夹),通常通过插件或者第三方应用(如 VeraCrypt)
  • Tiddlywiki 内置筛选器功能,教程较多,而且可以和任何插件协作;Obsidian 需要靠 dataview 等第三方插件,无法与其他插件轻易互通,需要学习和折腾好多次

如何把obsidian的笔记转移到tiddlywiki?

怎么最简单地使用TiddlyWiki?

核心要件:减少可能性,确定边界感。

TidGi是一款笔记类应用软件,TiddlyWiki则是一种强大的笔记框架,为用户提供了倾向于创造活动的环境。同时,TiddlyWiki也作为一个整体称呼,包括了所有基于该框架开发的软件和衍生版本。

由于TiddlyWiki本身的特性,整个流程包括开发、测试、使用、发布、到最终用户手中等等都在其中。TW不同于一般笔记应用软件,TiddlyWiki是通过用户和社区的积极参与、不断创新和无私且广泛的贡献为主要的发展方向;由杰里米·拉斯顿为TiddlyWiki的诞生和发展创造了关键的基础条件及优渥的土壤环境。

因此确立边界感,主动确认身份,选择适合的TiddlyWiki提供的功能范围,有利于自己的使用和学习方向。这就要求使用者站在自己角度看待无限的、类似平台或笔记框架的TiddlyWiki,而不是以普通软件的视角看待自己力所不及而舍去的软件功能。比如库克马(穆罕默德•拉赫马尼)就是为最终用户服务的。而最终用户就是使用他们做的插件或功能。

最后:太微给我的感觉是,我给你提供一块好的土壤,至于怎么生长和发展,只要不“长歪”、不违反开源协议,想怎样都可以。

  1. 减少应用场景的可能性和可选平台,仅使用TidGi。
  2. 尽量不自己配置太微模板、配置插件,除非他们很简单。不涉及任何关于Wiki编程的部分,如果涉及你必须要有能力接受。仅使用wikitext、筛选器和模仿示例和说明去调用相关功能进行写作。
  3. 关于在使用太记以及太记默认TiddlyWiki模板遇到的问题(指程序设计问题,比如bug,UI混乱等等)可以在GitHub提交issue,然后等待处理。最好是去看一眼issues,很多问题之前已经提出了,得等林一二有时间修复。
  4. 阅读随机tips(点击骰子图标),积累常识性认知与知识。

TidGi桌面应用反馈链:https://github.com/tiddly-gittly/TidGi-Desktop/issues

TidGi默认知识模版反馈链:https://github.com/tiddly-gittly/Tiddlywiki-NodeJS-Github-Template/issues

极客和Wiki编程

极客英文是geek。极客一般用来指追求技术的人,依赖社区,同时也非常专注,对其他事物不太感兴趣。活跃于开源软件和社区里。

太微是一款开源软件,社区也非常活跃。因而里面也有很多极客。

对TiddlyWiki进行功能分级,大概可以分成四个方面:开发框架/知识管理操作系统 > 插件开发 > Wiki编程 > WikiText笔记与写作。TiddlyWiki整体看和文学编程工具Jupyter notebook有些相似,是一种编程与写作的工具,更是一种“开发框架/知识管理操作系统”。

在太微里,有很多内容都是可以自定义的,拓展性非常高。极客们就经常根据自身能力使用WikiText提供的编程能力搞各种“骚操作”,甚至可以像emacs那样,想怎么使用就怎么使用。但对于一般人,我并不推荐像极客一样去搞各种“骚操作”。只有非常需要时,才应该去折腾,不然浪费各自的时间。

太微虽然接近操作系统的形式,但WikiText提供的编程方式与其他编程语言是不太通用的,其没有调试代码的工具。这就非常麻烦了,只能依赖筛选器测试输出、经验和文档内容去判断代码什么地方写错了。这对没有编程经验的人来说,是一个天坑。既使有编程经验也会导致后期的学习成本大幅增加。一般的思路就是用到什么再去查官方文档,或者去论坛里问,看别人的例子。如果一个用法之前都没有人摸索过,那么恭喜你,这个问题要么由你来解决,要么交给下一个人来解决。

极客思维固然有其好处,但对于以后不接触编程这方面的人来说,只需要会使用太记,掌握基本的筛选器用法和一些常用插件,就够了。其他的不用太折腾,也没必要。反正只是用来写笔记和复习而已。

对于太微不擅长的,比如大纲笔记,比如白板,如果有需求,最好还是换其他软件去实现,不要在太微上折腾太多时间。实在不行,也可以放弃太微,等过一段时间再看看这个东西有没有价值。任何工具只有对你自己用得方便,能提高你的效率才是工具,不然也没别的办法了。毕竟太微没有客服,也没有任何的售后服务。

另一方面是不太建议和极客讨论。如果不打算深入了解的话,不需要去与极客讨论什么。他们讨论的成果,过后自然会更新发布出来,也不用担心错过。反而去讨论的话,还增加各自的负担,容易产生矛盾冲突。用户不理解,但极客可能觉得很好实现,用户觉得那你为何不帮助我实现呢?极客觉得为什么要帮助你实现,这么简单的东西你看一看文档不就行了吗?你又不付费,为什么要花时间在这上面呢?一般来说,付费是解决问题最好的方式。

当然上面只是描述一个极端情况,但往往这是最后很有可能发生的情况。因而,要使用太微,最好还是自己先多了解掌握。至少把文档大致看一遍。了解什么想法可以实现,什么想法不可以实现。这样就比较好。当然实在有问题,也是可以问的,只是描述清楚问题。或者在直播时去问。

以上内容,只代表个人意见。

如何更新此文档

太微是去中心化的知识库,如果你现在是在浏览器里编辑,当点击保存按钮时,太微会自动复制一份完整知识库,并将你的编辑结果放在里面,保存到你的电脑本地(不会保存到社区的中心化的知识仓库里)。这样产生的编辑结果只有你自己能看到,你可以随便修改部署版本的知识库来玩而不会影响 Github 上真正的知识库,这防止了有人误操作修改了社区知识仓库的内容。

如果你希望贡献内容到社区 Github 知识仓库里,请点击链接跟随我们 Github 仓库里的几步操作,以获得更新权限。

直接找林一二申请通过就可以了。

快速添加

此外,你还可以先找到想作为文件夹的笔记,然后使用笔记顶部的 添加子条目 来创建新笔记。这将把新笔记放入文件夹内,文件夹系统的原理详见TW-Locator

我们的计划

查看引文:社区建设

TiddlyWiki是一个开放、强大的个人知识系统,但由于国内文档较少、学习渠道较少且原版TiddlyWiki不十分美观,所以多数人与之擦肩而过。

查看引文:社区联系方式

中文

我们致力于构建一个中文的太微社区,欢迎加入我们讨论!

  1. QQ群:946052860
  2. 论坛:talk.tidgi.fun

你也可以到知乎上发帖,加上 TiddlyWiki 或太微的标签,并邀请回答。

英文

目前主要的太微国际交流社区是 https://talk.tiddlywiki.org/ ,大家在里面使用英文交流,有很多Tiddlywiki贡献者。若不熟悉英文也可以使用谷歌翻译插件开翻译全网页阅读,开 deepl 机翻即可发帖。

使用 Google 英文搜索可以搜到在 Google Group 里沉淀的大量互助内容,由于太微有近 10 年的历史,大部分问题都曾经被问答解决过了。

待开始任务列表

共建待办列表
Jeremy来访
介绍debug-log-filter
国际社区Newsletter
如何测试性能?
搬运海外的太微视频
直播分享超级标签插件
笔记原理或知识组织

目前在持续的其它任务

TiddlyWiki 太微中文社区计划

  • 目前主要是在做B站直播
  • 收集网络上现有的中文教程、帖子;
  • 制作常用插件索引和展示;
  • 搭建社区:是基于QQ群、论坛还是某个平台的讨论板块?
  • 在知乎、V2EX、Twitter等平台进行引流;
  • 翻译TiddlyWiki高级教程和编程文档;

TiddlyWiki 开发灵感与计划

中文教程最近更新动态

Source
{{徽章列表}}
{{$:/config/oeyoews/info}}

{{Gallary}}

!! 如何浏览此知识库

# 可以翻阅右边侧边栏上的[[文档目录|用TOC宏替代Locator]]标签页,或点击「最近」标签页查看最新更新的内容
# 查看每个[[条目]]底部的[[反向链接]]
# 点击右边栏上的 {{$:/core/ui/Buttons/CommandPalette}} 按钮来打开搜索框(或直接点击 {{$:/core/ui/Buttons/CommandPalette}} !)
# 随意点击任何笔记上的编辑按钮 {{||$:/core/ui/Buttons/edit}} 来查看源文本,可以学习到很多高级用法

!! 如何开始使用太微

# 查看[[如何保存]]来下载相关应用程序,创建你自己的知识库。
# 浏览[[基础知识]],进一步了解太微的独特之处
# 访问 [ext[可离线版本|/offline.html]] 可以让你点击侧边栏上的下载按钮__把网页下载为单个HTML文件__离线阅读。也可以在网页上直接修改此知识库试试,放心,[[你不会真正修改到我们数据库里的内容|如何保存内容到社区仓库里]]。
# 对TiddlyWiki进行功能分级,大概可以分成四个方面:[[开发框架/知识管理操作系统|太微与太记的区别]] > [[插件开发]] > [[Wiki编程|Wiki编程的定义]] > [[WikiText笔记与写作|笔记原理或知识组织]]。
# 你可以在[[资源链接]]里找到''其它社区资源链接''、[[TiddlyWiki教程|教程链接]]、[[知识链接|知识链]]与正在使用的[[个人太微Wiki示例|TiddlyWiki中文网站示例]],还有常用的[[插件介绍|插件列表]](包括TidGi预制插件)、一份__TiddlyWiki游戏__和[[TiddlyWiki的全平台软件|全平台软件和存储方式]]以及工作流程。


!! 背景介绍

<<reuse-tiddler "太微背景介绍">>

!! 如何更新此文档

<<reuse-tiddler "如何保存内容到社区仓库里">>

<<reuse-tiddler "快速创建新笔记按钮">>

!! 我们的计划

<<reuse-tiddler "社区建设">>


[[中文教程最近更新动态|最近更新状态]]