Skip to content

3.0.0

Choose a tag to compare

@github-actions github-actions released this 19 Nov 16:27
· 11 commits to main since this release

把代码块里的 参数[一堆选项] 折叠成标签,需要的时候再展开——写 Shader 指令、引擎配置、命令行开关、枚举值这类“名字 + 一长串可选值”的内容时,能让笔记干净很多。

两种显示方式

  • 普通折叠:Cull 选项[back/Front/Off] 只显示蓝色下划线的 Cull 选项,[内容] 收起来,点一下展开。
  • 选项悬浮弹窗:折叠成药丸状的 Cull 选项 ▾,悬停浮出选项列表,再移到某个选项上浮出它的注释。

3.0.0:选项格式改了

选项之间不再用 _ 分隔,改成一行一个:

混合模式[
  Normal//正常混合
  Add//相加,越高越亮
]

好处是 _ 彻底解放了——_MainTex、UNITY_OBJECT_TO_WORLD、_Time.y 这些名字可以直接写进参数名、选项名和注释,不用再躲避。// 仍然是注释起点,[ ] 仍然是结构字符。

升级说明:这是破坏性变更,2.x 用「插入参数选项」面板生成过的内容需要转换一次:

node scripts/migrate-legacy-format.mjs --vault "<你的库>" --apply

不带 --apply 时只预演、不写盘;写入前会给笔记和 data.json 各留一份 .bak-<时间戳> 备份。手写的单行 A[a/b/c] 不受影响,不会被改写。

怎么用

  1. 在一个代码块里选中完整的 参数[内容](支持多行、支持嵌套方括号),右键 → 折叠选中参数。
  2. 想批量录入选项:右键 → 插入参数选项…,填名称、逐个加「选项 + 注释」,保存即可生成上面的格式。
  3. 在标签上右键可以切换显示方式、编辑选项、展开或取消折叠。
  4. 命令面板里也有「折叠选中的参数内容」「取消光标处的参数折叠」。

折叠位置会记在插件数据里,重开笔记自动恢复;笔记重命名时记录跟着迁移。

安装

  1. 下载下面的 manifest.json、main.js、styles.css(或 code-block-context-fold-3.0.0.zip 解压)。
  2. 放到 <你的库>/.obsidian/plugins/code-block-context-fold/,三个文件平铺,不要多套一层文件夹。
  3. 设置 → 第三方插件 → 关闭安全模式 → 刷新 → 启用「代码块参数折叠」。

插件不绑定任何库,每个库各自保存自己的折叠记录。

已知限制

  • 阅读视图里的展开状态只影响当前渲染,不会写回编辑视图。
  • 阅读视图按记录里保存的原文精确匹配;如果笔记内容改过、编辑视图还没重新打开同步记录,那一段会保持原样。
  • 方括号 [ ] 不能出现在参数名、选项名或注释里。
  • 笔记改动后靠锚点重新定位;同一段文本出现多次且锚点无法区分时,会放弃恢复而不是猜位置。

许可证

GPL-3.0-or-later。