如何自学/简单理解 tiddlywiki 主要基本功能？如何用官方文档自学？
-
- [1] 界面 (ui/page/layout)
- storyriver/story/故事河
- sidebar/侧边栏
- controlpanel/控制面板
- advancedsearch/高级搜索
- plugins/插件
- （常见界面组件）
- [2] 使用 (use)
- 保存/同步/备份、导出/导入、升级版本/更新
- 首页/永久链接
- 条目查看/编辑/组织分类、条目搜索/管理、条目分享、条目语法
- 设置、插件
- 加密
- 用户/登入/登出/权限
- [3] 条目 (tiddlers)
- 格式、命名空间、条目种类、条目关系、条目哲学
- [4] 设置 (controlpanel/控制面板)
- 语言/主题/插件
- 信息、外观、设置、保存、插件、快捷键
- （隐藏设置）
- [5] 语法 (syntax)
- 富文本语法、嵌入、宏/变量、控件、文本引用、筛选器、编译指令
- （语法组合/混用）
- [6] 插件 (plugins)
- 安装/卸载/更新/禁用、插件库、开发/格式/打包
- [7] 系统 (core/system)
- [1] 界面 (ui/page/layout)
-
关键是掌握筛选器语法，不会筛选器语法就很难写自己的组件。其次是掌握基本的微件或者小工具的用法。
比如尝试写一个按钮，点击会新建标题为当前日期的条目。
再或者尝试写一个
$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组件。
-
-
更新时间：250610
接下来暂时停更了，什么时候有灵感有空了再补充。
- [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类）
- 简要3大类（筛选/排序/转换）
- 筛选：搜索、截取/切片
- 转换：条目读取、条目关系、聚合/归一
- 数据操作（str/math/json）、条目操作（读取/关系）、列表操作（筛选/排序/修改/转换/聚合/扁平）、语法操作（filter/subfilter/if/:cascade/...）、常用操作、特殊/系统操作、……
- 宏/变量（内核宏、内核变量）
- 内置宏（组件、函数、……）
- 组件：toc, tree, tabs, list-links, timeline, tag, ...
- 内置宏（组件、函数、……）
- 控件（内核小工具）
- 分类：normal（普通）、action-api（动作api）
- ui/input/output（界面/输入控件/输出控件）
- input/trigger/form（输入/触发/表单控件）
- container（容器）：$list、$reveal、$scrollable
- flow/vars/wikitext（控制流/变量操作/语法调用）
- action/trigger/catcher（动作控件/触发控件/捕捉控件）
- misc（其他）
- 筛选器操作符（内核操作符）
[8] 其他（文档自学术语表 (glossary)、自定义 (custom)、开发 (dev)）
- 文档自学术语表
- theme 主题/布景主题/布局主题/皮肤主题
- storyview 查看模式/视图模式
- widget 控件/小工具/小部件/微件
- storylist 已开启条目/故事河条目/故事列表
- 首页/启动条目
- explore 系统目录树查看器/探索
- 操作符/运算符
- 参数/操作数
- page 主页面/页面
- clone 副本/克隆/条目复制/复制
- navigate 导航/导览
- community 社区/社群/第三方
- prefix/suffix 前缀/后缀、首码/尾码/前置码
- 标题列表/标题选择、甄选的名称/名称列表/名称选择
- 模板/范本
- 卸载/反安装
- 控制面板/控制台
- 空缺/缺失/佚失条目
- 隐藏/影子/默认条目
- 设置配置(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（内核消息）
[10] 填空题
- [1] 界面 (ui/page/layout/主页面)
-
更新时间：250616
对于内容，欢迎指正、反馈、讨论、评论、投币点赞收藏。但精力和水平有限，就不一一回复了。
（什么时候有灵感有空了再补充）
- [1] 界面 (ui/page/layout/主页面)
- [2] 使用 (use)
- [3] 条目 (tiddlers)
- （格式、命名空间、条目种类、条目关系、条目哲学）
- 格式（标题、内容、字段）
- 字段：type/条目类型/文件格式、title/条目标题、text/条目内容、caption/条目别名、tags/条目标签、……
- 标题命名空间(title)：普通条目(regular)、系统条目(system)
- 条目存储空间(all)：一般条目(tiddlers)、影子条目(shadows)
- 影子条目/隐藏/默认条目：存储在内核或插件中的条目。可被同名的一般条目覆盖。
- （默认不出现在搜索结果中，例如
[all[tiddlers]]）
- （默认不出现在搜索结果中，例如
- 覆写/覆盖条目：与影子条目同名的一般条目。
- 系统条目：标题前缀是
$:/的任何条目。- （通常不出现在搜索结果中，例如
[!is[system]]）
- （通常不出现在搜索结果中，例如
- 普通/一般条目(ordinary)：非影子条目(tiddlers)，或者非系统条目(regular)。
- 在官方翻译中，
一般条目(ordinary)指的是非影子条目(tiddlers)。
或者 一般条目(standard)指的是标准条目。
或者 普通条目(ordinary)指的是非系统条目。
- 在官方翻译中，
- 标准条目(standard)：非影子且非系统条目/一般普通条目。
- 影子条目/隐藏/默认条目：存储在内核或插件中的条目。可被同名的一般条目覆盖。
- [4] 设置 (controlpanel/控制面板)
- 快速/基本设置（语言/主题/插件、……）
- 信息、外观、设置、保存、插件、快捷键
- （隐藏设置）
- [5] 语法 (syntax/wikitext)
- [6] 插件 (plugins)
- 安装/卸载/更新/禁用/依赖
- 插件库/浏览/搜索/加载/官方插件/第三方插件
- （格式/开发/打包/发布）
- （插件类型：普通、语言、主题）
- [7] 系统 (core/system)
- （机制、ui树/级联、系统目录树、api、系统标签、标准字段、……）
- 内置资源：内置工具/组件、内置图标、内置库、内置样式/CSS类、……
- 内置工具：绘画板、条目管理器、标签管理器、高级搜索、（页面工具栏）、……
细节
- 语法组合
- 语法应用
- 内置库 (core/builtins)
- 筛选器操作符（内核操作符）
- 分类：简要3大类（filter/sort/convert）、（主要5类/基本7类）
- 简要3大类（筛选/排序/转换）
- 筛选：搜索、截取/片段
- 转换：条目读取、条目关系、聚合/归一
- 数据操作（str/math/json）、条目操作（读取/关系）、列表操作（筛选/排序/修改/转换/聚合/扁平）、语法操作（filter/subfilter/if/:cascade/...）、常用操作、特殊/系统操作、……
- 宏/变量（内核宏、内核变量）
- 内置宏（组件、函数、……）
- 组件：toc, tree, tabs, list-links, timeline, tag, ...
- 内置宏（组件、函数、……）
- 控件（内核小工具）
- 分类：normal（普通）、action-api（动作api）
- ui/input/output（界面/输入控件/输出控件）
- input/trigger/form（输入/触发/表单控件）
- container（容器）：$list、$reveal、$scrollable
- flow/vars/wikitext（控制流/变量操作/语法调用）
- action/trigger/catcher（动作控件/触发控件/捕捉控件）
- misc（其他）
- （内核消息/小工具消息）
- 筛选器操作符（内核操作符）
[8] 其他（文档自学术语表 (glossary)、自定义 (custom)、开发 (dev)）
- 文档自学术语表
- theme 主题/布景主题/布局主题/皮肤主题
- storyview 查看模式/视图模式
- widget 控件/小工具/小部件/微件
- storylist 已开启条目/故事河条目/故事列表
- default tiddlers 首页/启动条目
- explore 系统目录树查看器/探索
- operator 操作符/运算符
- parameter 参数/操作数/形参
- page 主页面/页面/默认界面/标准版面
- layout 布局/版面/版式
- clone 副本/克隆/条目复制/复制
- navigate 导航/导览/跳转
- community 社区/社群/第三方
- prefix/suffix 前缀/后缀、首码/尾码/前置码
- title-list/title-selection
标题列表/标题选择、甄选的名称/名称列表/名称选择/名称清单 - template 模板/范本
- uninstall 卸载/反安装
- controlpanel 控制面板/控制台
- missing 空缺/缺失/佚失条目/非存在条目
- shadows 隐藏/影子/默认条目
- orphan 孤立/孤儿/无反向链接的条目
- edition 版本/版、应用版本/发行版
- version 版本/版本号
- tabs 页签/选项卡/标签页
- tiddler 条目/笔记/卡片
- field 字段/栏位
- attribute 属性
- 标准字段/系统字段
- module 模块/模组
- catcher 消息处理小工具/捕捉控件
- custom 自定义/客制化/自制
- core 内核/核心、系统/内置
- ordinary tiddlers
- standard tiddlers
- filter 筛选器/过滤器、筛选
- 子条目（以当前条目作为标签的条目）
- 设置配置(config)、自定义(custom)、开发(dev)
- 设置配置（controlpanel/控制面板、plugins-install/安装插件、server-config/服务器配置）
- 自定义（宏、界面/功能按钮、外观样式、筛选器/控件、插件、快捷键、布局/主题）
- 外观与界面（外观样式/配色、界面/功能按钮、布局/主题、……）
- 界面外观：条目字段、系统标签、级联、系统条目
- 自定义条目外观（条目字段）：color icon code-body hide-body
- 界面/功能：页签/工具栏/菜单（添加/默认/排序/折叠）、功能按钮、搜索结果、导出格式、ui/界面树/布局、主题、……
- 自定义工具/应用/软件/脚本
- 界面外观：条目字段、系统标签、级联、系统条目
- 语法（宏、筛选器操作符/控件/js宏、自定义语法、……）
- 系统（快捷键、插件/插件库、js模块、性能优化、……）
- （调试、排错）
- 外观与界面（外观样式/配色、界面/功能按钮、布局/主题、……）
- 开发（plugins-dev/开发插件、js-module/js模块）
- （机制、js模块/模块种类、架构/运作、核心api/js-api、……）
- 自定义四步曲（查找/理解、调整/修改、改写、创建）
- （技巧/tips、教程/FAQ、资源与社区、帮助手册/文档与参考）
[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（内核消息）
[10] 填空题
[11] 你知道吗？
