跳转至内容
  • 最新
  • 版块
  • 标签
  • 热门
  • 用户
  • 群组
  • 太微中文教程
  • 新插件投票看板
皮肤
  • Light
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dark
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • 默认(不使用皮肤)
  • 不使用皮肤
折叠
太微中文论坛icon

太微中文论坛

  1. 首页信息流
  2. 版块
  3. 讨论
  4. 如何自学/简单理解 tiddlywiki 主要基本功能?如何用官方文档自学?

如何自学/简单理解 tiddlywiki 主要基本功能?如何用官方文档自学?

已定时 已固定 已锁定 已移动 讨论
教程
13 帖子 3 发布者 19 浏览
  • 从旧到新
  • 从新到旧
  • 最多赞同
登录后回复
此主题已被删除。只有拥有主题管理权限的用户可以查看。
  • W 离线
    W 离线
    w6iyes
    编写 最后由 编辑
    #2
    • [1] 界面 (ui/page/layout)
      • storyriver/story/故事河
      • sidebar/侧边栏
      • controlpanel/控制面板
      • advancedsearch/高级搜索
      • plugins/插件
      • (常见界面组件)
    • [2] 使用 (use)
      • 保存/同步/备份、导出/导入、升级版本/更新
      • 首页/永久链接
      • 条目查看/编辑/组织分类、条目搜索/管理、条目分享、条目语法
      • 设置、插件
      • 加密
      • 用户/登入/登出/权限
    • [3] 条目 (tiddlers)
      • 格式、命名空间、条目种类、条目关系、条目哲学
    • [4] 设置 (controlpanel/控制面板)
      • 语言/主题/插件
      • 信息、外观、设置、保存、插件、快捷键
      • (隐藏设置)
    • [5] 语法 (syntax)
      • 富文本语法、嵌入、宏/变量、控件、文本引用、筛选器、编译指令
      • (语法组合/混用)
    • [6] 插件 (plugins)
      • 安装/卸载/更新/禁用、插件库、开发/格式/打包
    • [7] 系统 (core/system)
    1 条回复 最后回复
    0
    • W 离线
      W 离线
      w6iyes
      编写 最后由 编辑
      #3

      细节

      • 语法组合

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

      • 设置配置(config)、自定义(custom)、开发(dev)
      • (如何从编程的角度理解)
        • 编程模型:数据操作、语法语句、框架逻辑
      1 条回复 最后回复
      0
      • 机杼机 离线
        机杼机 离线
        机杼
        编写 最后由 编辑
        #4

        关键是掌握筛选器语法,不会筛选器语法就很难写自己的组件。其次是掌握基本的微件或者小工具的用法。

        比如尝试写一个按钮,点击会新建标题为当前日期的条目。

        再或者尝试写一个$list,展示筛选条目中的caption字段,如果没有则显示标题。

        进一步掌握条件快捷语法。上面那个就需要用到条件快捷语法。

        再之后就是使用$let进行自定义变量了。或者使用宏或者是进程。

        学会使用宏和进程后就可以实现,一处打包,随处可用了。

        再之后就是级联了。级联相当于模板。比如可以对[tag[123]]的标签条目正文只展示caption内容,如果没有caption则展示为标题。

        大概过了这些,基本功能就掌握得差不多了。不管是看别人写的wikitext还是官方写的,都比较容易了。

        最最重要的一点是,经常在论坛里提问。可以去英文论坛那边提问,通常都会有人解答的。当然现在也可以问一下deepwiki,这个还算是比较智能的。

        1 条回复 最后回复
        0
        • linonetwoL 离线
          linonetwoL 离线
          linonetwo
          编写 最后由 编辑
          #5

          没那么麻烦,直接用太记现有的功能先新建笔记管理起来吧。其实太微最核心的功能就是条目增删改查和标签(字段)管理,这些就了解一下界面上按钮的位置。其他功能都是建立在你已经记了很多笔记的基础上才有得玩。

          而且其他高级功能后续太记接入AI了直接语言沟通即可,它会帮你操作的。

          1 条回复 最后回复
          0
          • W 离线
            W 离线
            w6iyes
            编写 最后由 w6iyes 编辑
            #6

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

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

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

            机杼机 1 条回复 最后回复
            0
            • W 离线
              W 离线
              w6iyes
              编写 最后由 w6iyes 编辑
              #7

              更新时间: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
                • (模板式编程)
              1 条回复 最后回复
              0
              • 机杼机 离线
                机杼机 离线
                机杼
                回复了w6iyes 最后由 编辑
                #8

                @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的话,那笔记确实是可以持续一辈子。

                W 1 条回复 最后回复
                0
                • 机杼机 离线
                  机杼机 离线
                  机杼
                  编写 最后由 编辑
                  #9

                  正因为TiddlyWiki的向后兼容性,所以你可能会发现一个问题几年前就被人回答了,并且之后一直有效。因此学习TiddlyWiki最好的办法,是根据自己的需求去论坛搜索。大概会有几种不同的解决办法,再考虑从他们的解决办法中扩展。

                  当然你重新提一个问题也可以,会有人提示你这个问题已经被解决过。

                  其实那边的论坛氛围真不错,基本上过一两天就有人回应了。而且大多数都是有经验的用户,很多都是TiddlyWiki的核心团队。

                  核心团队会有专门的卡片标识,估计在下一个版本中就能看到了。

                  1 条回复 最后回复
                  0
                  • 机杼机 离线
                    机杼机 离线
                    机杼
                    编写 最后由 编辑
                    #10

                    把TiddlyWiki玩一遍之后,最重要的就是组装,像搭积木一样,创建无限的可能。

                    但新手确实很难一下子学习这么多内容,特别是对于没有技术背景的用户来说。我自己也花了两三年的时间才觉得真正掌握了TiddlyWiki。

                    现在一般是两个方向推荐,推荐他把TiddlyWiki当成玩具去尝试,类似编程工具那样。另一个方向是让他把TiddlyWiki看成一个记事本,先写一些内容,再考虑之后的。比如写一些标签,字段,然后再考虑引用。

                    我也一直想写一个系统性的教程,但实在是不好写,难以下笔。因而一些阶段性的成果,要么放在论坛上,要么放在太微中文教程社区里。有时候会录一个视频分享,但现在很少了。

                    1 条回复 最后回复
                    0
                    • W 离线
                      W 离线
                      w6iyes
                      回复了机杼 最后由 编辑
                      #11

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

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

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

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

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

                      机杼机 1 条回复 最后回复
                      0
                      • 机杼机 离线
                        机杼机 离线
                        机杼
                        回复了w6iyes 最后由 编辑
                        #12

                        @w6iyes 没有头绪肯定也不用去问。但对比一下Obsidian即可发现,关于Obsidian的内容,互联网上有太多太多了,不管是国内的还是国外的,还有很多人自发录制视频讲解,还有数不清的付费社区。但TiddlyWiki就没有这么幸运了。目前关于TiddlyWiki最丰富的信息来源就是英文论坛。

                        而且因为直接用浏览器访问,可以用沉浸式翻译插件知道在说什么。而TiddlyWiki的其他平台讨论都很少,discord比较丰富,但因为不能用浏览器翻译就没咋关注了。我用的discord客户端。

                        当然,我觉得TiddlyWiki论坛应该出一个精华帖子分类,但没看到有人这样做。不过倒是有一个技巧的分类,可以查看关于TiddlyWiki的一些使用技巧。

                        掌握一些技巧还是很重要的,然后就会发现,啊,原来还可以这样做,原来还可以那样做,那我改一改不就能实现另一种效果吗?大概是这样的心路历程。

                        notion的内容更多,使用笔记软件的用户群体,估计有60%都是notion,20%的Obsidian,其余的就给其他软件分了。

                        1 条回复 最后回复
                        0
                        • 机杼机 离线
                          机杼机 离线
                          机杼
                          编写 最后由 编辑
                          #13

                          另一种比较丰富的TiddlyWiki资源是各种各样的TiddlyWiki网站。这一点跟Obsidian和notion都不太一样。绝大多数笔记软件发布成网址的,都是一样的模型,可能主题不一样,但整体上的观感是一样的。而TiddlyWiki则不同,有些TiddlyWiki网站自定义程度非常高,几乎看不出来是由TiddlyWiki构建的,有很多组件,有些来自于别人的插件,有些是自己写的插件。我自己对TiddlyWiki的入门,更多的是从这些网站开始的。我看到了TiddlyWiki更多丰富的示例和可能性。以及我可以把这些示例很简单地拖放导入到自己的TiddlyWiki中。别人怎么写的,我几乎只要copy就可以了。而且也没有风险,至少我现在还没有看到要求付费使用的TiddlyWiki组件。

                          1 条回复 最后回复
                          0

                          • 登录

                          • 没有帐号? 注册

                          • 登录或注册以进行搜索。
                          Powered by NodeBB Contributors
                          • 第一个帖子
                            最后一个帖子
                          0
                          • 最新
                          • 版块
                          • 标签
                          • 热门
                          • 用户
                          • 群组
                          • 太微中文教程
                          • 新插件投票看板