如何自学/简单理解 tiddlywiki 主要基本功能？如何用官方文档自学？
-
关键是掌握筛选器语法，不会筛选器语法就很难写自己的组件。其次是掌握基本的微件或者小工具的用法。
比如尝试写一个按钮，点击会新建标题为当前日期的条目。
再或者尝试写一个
$list，展示筛选条目中的caption字段，如果没有则显示标题。进一步掌握条件快捷语法。上面那个就需要用到条件快捷语法。
再之后就是使用
$let进行自定义变量了。或者使用宏或者是进程。学会使用宏和进程后就可以实现，一处打包，随处可用了。
再之后就是级联了。级联相当于模板。比如可以对
[tag[123]]的标签条目正文只展示caption内容，如果没有caption则展示为标题。大概过了这些，基本功能就掌握得差不多了。不管是看别人写的wikitext还是官方写的，都比较容易了。
最最重要的一点是，经常在论坛里提问。可以去英文论坛那边提问，通常都会有人解答的。当然现在也可以问一下deepwiki，这个还算是比较智能的。
-
-
更新时间：250607
- [1] 界面 (ui/page/layout/主页面)
- storyriver/story/故事河
- view/条目显示/查看
- （infopanel/信息面板,toolbar/工具栏,title/subtitle/tags/body,...)
- editor/编辑器
- view/条目显示/查看
- sidebar/侧边栏
- pagecontrol/页面工具栏
- search/搜索栏
- tabs/页签
- （open/已开启条目/故事河列表、recent/最近修改条目、tools/页面工具栏、more/其他）
- controlpanel/控制面板
- advancedsearch/高级搜索
- plugins/插件
- （常见组件）
- storyriver/story/故事河
- [2] 使用 (use)
- 保存/同步/备份、导出/导入、升级版本/更新
- 首页/永久链接
- 条目查看/编辑/组织分类、条目搜索/管理、条目分享、条目语法
- 设置、插件
- 加密
- 用户/登入/登出/权限
- [3] 条目 (tiddlers)
- 格式、命名空间、条目种类、条目关系、条目哲学
- [4] 设置 (controlpanel/控制面板)
- 语言/主题/插件
- 信息、外观、设置、保存、插件、快捷键
- （隐藏设置）
- [5] 语法 (syntax)
- 富文本语法、嵌入、宏/变量、控件、文本引用、筛选器、编译指令
- （语法组合/混用）
- （新语法）
- [6] 插件 (plugins)
- 安装/卸载/更新/禁用、插件库、开发/格式/打包
- （插件类型：普通、语言、主题）
- [7] 系统 (core/system)
- （机制、ui树/级联、系统目录树、api）
细节
- 语法组合
- 内置库 (core/builtins)
- 筛选器操作符
- 分类：简要3大类（filter/sort/convert）、主要5类/基本7类
- 宏/变量
- 控件（内核小工具）
- 分类：normal（普通）、action-api（动作api）
- ui/input/output（界面/输入控件/输出控件）
- input/trigger/form（输入/触发/表单控件）
- flow/vars/wikitext（控制流/变量操作/语法调用）
- action/trigger/catcher（动作控件/触发控件/捕捉控件）
- misc（其他）
- 筛选器操作符
[8] 其他（文档自学术语表 (glossary)、自定义 (custom)、开发 (dev)）
- 文档自学术语表
- theme 主题/布景主题/布局主题
- storyview 查看模式/视图模式
- widget 控件/小工具/小部件/微件
- storylist 已开启条目/故事河条目/故事列表
- 首页/启动条目
- 参数/操作数
- explore 系统目录树查看器
- 操作符/运算符
- page 主页面/页面
- clone 副本/克隆/条目复制/复制
- navigate 导航/导览
- community 社区/社群/第三方
- 设置配置(config)、自定义(custom)、开发(dev)
- （自定义ui/界面）
- 自定义（查找/理解、调整/修改、改写、创建）
[9] 如何从编程的角度理解？
- 编程模型：数据操作、语法语句、框架逻辑
- 语法语句（语法/syntax、内置库/builtins）
- 直接语法/语句（嵌入、宏/变量、控件）
- 嵌入（语法/textref/filter、内置筛选器操作符/模板条目）
- 宏/变量（语法/call/args/define、内置宏/变量/组件/函数、导入/全局/陷阱）
- 控件（语法/call/attrs、内置控件）
- 间接语法/表达式（文本引用/textref、筛选器/filter）
- （语法组合、内置库）
- 直接语法/语句（嵌入、宏/变量、控件）
- 数据操作（变量、条目、读写/作用域）
- 变量：读/宏调用、写/宏定义/控件
- 条目：读/嵌入、写/控件
- 框架逻辑
- 框架api：action（动作控件）、tm（内核消息）
- action-*（条目操作、界面交互、消息）
- tm-*（条目操作、界面交互、wiki/系统）
- 消息模型：trigger/action/message/catcher
- （模板式编程）
- 框架api：action（动作控件）、tm（内核消息）
- [1] 界面 (ui/page/layout/主页面)
-
@w6iyes 官方中文文档可能确实有一些不足。但目前并没有专门的团队去维护，而是一位台湾网友维护的，从2012年还是什么时候就开始了，维护了十年。我也看过一些其他版本的翻译，比如我记得之前有一个鱼无言的翻译，但好像止步于5.2.X版本了。之后再没有更新。
其实TiddlyWiki基本上没有删除过去的功能，绝大多数时候都是向后兼容的。
5.0.X版本是测试阶段，5.1.X版本是正式阶段，升级到5.2.X版本号是因为改变了数据存储结构。以前的数据存储结构好像是HTML格式，5.2.X之后换成了json格式。更新到5.3.X版本是，因为不再推荐使用marco形式，更推荐使用procedure等现代形式。能够保障代码的健壮性，具体解决了什么问题只能看论坛上的讨论了。
接下来要引入到5.4.X版本，从这个版本上来说，才会引入一些不兼容的更新。但绝大多数的功能都可以得到保留。
换言之，TiddlyWiki确实足够稳定，稳定到只使用某一个特定版本都可以一直用下去，直到浏览器被淘汰。但目前想象不出浏览器被淘汰的时代，想象不出有什么可以代替浏览器，感觉AI也无法代替浏览器。即使浏览器被淘汰了，也仍然有nodejs的版本可以使用。
因而如果能接受TiddlyWiki的话，那笔记确实是可以持续一辈子。
-
把TiddlyWiki玩一遍之后，最重要的就是组装，像搭积木一样，创建无限的可能。
但新手确实很难一下子学习这么多内容，特别是对于没有技术背景的用户来说。我自己也花了两三年的时间才觉得真正掌握了TiddlyWiki。
现在一般是两个方向推荐，推荐他把TiddlyWiki当成玩具去尝试，类似编程工具那样。另一个方向是让他把TiddlyWiki看成一个记事本，先写一些内容，再考虑之后的。比如写一些标签，字段，然后再考虑引用。
我也一直想写一个系统性的教程，但实在是不好写，难以下笔。因而一些阶段性的成果，要么放在论坛上，要么放在太微中文教程社区里。有时候会录一个视频分享，但现在很少了。
-
@机杼 #8 是的，官方中文文档的维护者我一直都很敬佩，一个人负责了两种中文版本至今。
我个人认为新手不适合学习新版本的语法，像是proc/function。一是因为基础知识已经够多够杂了，没必要增加负担。二是更多的旧插件和资源都是用旧语法。
是的，tiddlywiki的优点就是小巧和稳定。但过高的学习难度成为了缺点，阻碍了推广。
#9 搜索的学习方法不适合我。一来是没有头绪要问什么。二来英文发帖交流是个门槛。
#10 是的，写教程特别累人，要考虑受众读者，还要注重文笔和内容组织、循序渐进。写了还不一定有多少人看，看了不一定懂。所以随缘了，没必要花太多精力在这上面。我现在想写的就是系统性的学习路线，与其说教程不如说是分享个人的学习笔记，帮助新手少走弯路。
-
@w6iyes 没有头绪肯定也不用去问。但对比一下Obsidian即可发现，关于Obsidian的内容，互联网上有太多太多了，不管是国内的还是国外的，还有很多人自发录制视频讲解，还有数不清的付费社区。但TiddlyWiki就没有这么幸运了。目前关于TiddlyWiki最丰富的信息来源就是英文论坛。
而且因为直接用浏览器访问，可以用沉浸式翻译插件知道在说什么。而TiddlyWiki的其他平台讨论都很少，discord比较丰富，但因为不能用浏览器翻译就没咋关注了。我用的discord客户端。
当然，我觉得TiddlyWiki论坛应该出一个精华帖子分类，但没看到有人这样做。不过倒是有一个技巧的分类，可以查看关于TiddlyWiki的一些使用技巧。
掌握一些技巧还是很重要的，然后就会发现，啊，原来还可以这样做，原来还可以那样做，那我改一改不就能实现另一种效果吗？大概是这样的心路历程。
notion的内容更多，使用笔记软件的用户群体，估计有60%都是notion，20%的Obsidian，其余的就给其他软件分了。
-
另一种比较丰富的TiddlyWiki资源是各种各样的TiddlyWiki网站。这一点跟Obsidian和notion都不太一样。绝大多数笔记软件发布成网址的，都是一样的模型，可能主题不一样，但整体上的观感是一样的。而TiddlyWiki则不同，有些TiddlyWiki网站自定义程度非常高，几乎看不出来是由TiddlyWiki构建的，有很多组件，有些来自于别人的插件，有些是自己写的插件。我自己对TiddlyWiki的入门，更多的是从这些网站开始的。我看到了TiddlyWiki更多丰富的示例和可能性。以及我可以把这些示例很简单地拖放导入到自己的TiddlyWiki中。别人怎么写的，我几乎只要copy就可以了。而且也没有风险，至少我现在还没有看到要求付费使用的TiddlyWiki组件。
