如何自学/简单理解 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组件。