太微中文论坛

@机杼 #8 是的，官方中文文档的维护者我一直都很敬佩，一个人负责了两种中文版本至今。

我个人认为新手不适合学习新版本的语法，像是proc/function。一是因为基础知识已经够多够杂了，没必要增加负担。二是更多的旧插件和资源都是用旧语法。

是的，tiddlywiki的优点就是小巧和稳定。但过高的学习难度成为了缺点，阻碍了推广。

#9 搜索的学习方法不适合我。一来是没有头绪要问什么。二来英文发帖交流是个门槛。

#10 是的，写教程特别累人，要考虑受众读者，还要注重文笔和内容组织、循序渐进。写了还不一定有多少人看，看了不一定懂。所以随缘了，没必要花太多精力在这上面。我现在想写的就是系统性的学习路线，与其说教程不如说是分享个人的学习笔记，帮助新手少走弯路。

更新时间：250607

---

• [1] 界面 (ui/page/layout/主页面)
  • storyriver/story/故事河
    • view/条目显示/查看
      • （infopanel/信息面板,toolbar/工具栏,title/subtitle/tags/body,...)
    • editor/编辑器
  • sidebar/侧边栏
    • pagecontrol/页面工具栏
    • search/搜索栏
    • tabs/页签
      • （open/已开启条目/故事河列表、recent/最近修改条目、tools/页面工具栏、more/其他）
  • controlpanel/控制面板
  • advancedsearch/高级搜索
  • plugins/插件
  • （常见组件）
• [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
  • （模板式编程）

感谢楼上的建议。我发帖的初衷是我学的时候发现教程太少，官方文档自学起来又很混乱，所以现在分享个人经验，希望能帮到其他初入门的新手。

比如说，tiddlywiki 特有的简洁无边框的样式风格，当初就让我很难懂。还有官方中文文档维护人手不足，缺乏校对和润色，用词不一致，看得我一头雾水。指出这些坑和弯路，能降低新手入门的难度。

发帖不能编辑有点不方便，后续更新我就以回帖的形式更新了。

细节

• 语法组合

---

[8] 其他（文档自学术语表 (glossary)、自定义 (custom)、开发 (dev)）

• 设置配置(config)、自定义(custom)、开发(dev)
• （如何从编程的角度理解）
  • 编程模型：数据操作、语法语句、框架逻辑

• [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)
• [2] 使用 (use)
• [3] 条目 (tiddlers)
• [4] 设置 (controlpanel/控制面板)
• [5] 语法 (syntax)
• [6] 插件 (plugins)
• [7] 系统 (core/system)

---

• [8] 其他（文档自学术语表 (glossary)、自定义 (custom)、开发 (dev)）

---

理解了 tiddlywiki 的基本概念，就可以按着这个目录，去官方文档里按图索骥了，不至于一头雾水举步维艰。

声明：水平不高，不一定对，分享一些个人的学习路线和见解。

250606 未完待续。随缘更新。