Repository navigation
References and indexes ZH
同文件:[[#^thm-composition]]
跨文件:[[第一章#^thm-composition]]
手写文字:[[第一章#^thm-composition|复合映射定理]]
Markdown 链接:[复合映射定理](第一章.md#^thm-composition)块 ID 只使用英文字母、数字、连字符,一篇笔记内必须唯一。块结束后空一行,再单独写 ^id。嵌套块建议使用命令自动添加,避免引用层级放错。
在命令面板(Windows:Ctrl+P)搜索 Academic Notes:
- 为光标所在公式、定理或图表添加块 ID:为当前块写入唯一 ID。
- 插入定理、公式或图表引用:选择已有 ID 的目标并插入链接。
- 重建定理公式索引并刷新引用:手动刷新。
- 插入或编辑交换图(Beta):打开点阵编辑器,或重新编辑光标所在的交换图代码块。
输入 \ref、\tref 或 \eqref 可触发引用建议,后两种分别筛选数学框和公式。阅读模式和实时预览替换链接显示;源码模式保留写法,实时预览中光标进入链接时也恢复源码。默认保留手写链接别名。
| 设置 | 说明 |
|---|---|
| 按 H2 分节重置(默认) | 每遇源码中的 ## 重置计数器;H3–H6 不参与 |
| 编号前加入 H2 节号 | 开启为 2.1;关闭为 1,但仍按 H2 重置 |
| H2 节号来源 | 按出现顺序,或优先取 ## 3.2 标题 开头的数字 |
| 整篇连续编号 | 不按 H2 重置,不添加 H2 节号 |
| 不同定理类型共享计数器 | 开启后定义、定理等共同计数;公式、图、表仍独立 |
| 编号前缀 | 手动指定;不会从日期或文件名猜测 |
| 排除索引的路径 | 相对库根目录的文件或目录,每行一个 |
有 H2 时,首个 H2 前属于第 0 节;完全没有 H2 时省略节号。代码块、公式、注释中的标题不计入分节。
公式引用格式默认 eq:{number};数学框默认 {type} {number}。{type} 受缩写开关控制,{abbr} 始终缩写,{name} 始终全称;还支持 {title}、{file}。图表默认 fig {number} / tab {number}。
在命令面板运行 Academic Notes:检查学术引用,选择当前笔记、所在文件夹及子文件夹、全库,或当前 phb-book 清单。检查内容包括目标笔记/块标签缺失、重复或歧义标签、同一计数范围中的手动编号冲突,以及合订本引用了未选入的笔记。普通 Obsidian 块引用也能识别;被排除的目标会标记为“无法检查”,不会直接判定为失效。筛选结果后点“定位”或“另一处”即可打开相应源码行。检查不会改写笔记。
生成学术索引笔记 会创建普通 .md 文件,里面是可以在 Obsidian 内点击的链接,不需要导出 PDF,停用插件后也能使用:
- 选择范围、输出路径、环境类型,以及按类型或来源笔记分组;也能选择自定义环境。
- 点“预览索引”,确认后“生成或更新”。可以选择是否包含未编号环境。
- 以后打开该索引,运行 更新当前学术索引笔记。它是按需更新的列表,不会在每次编辑时自动重写文件。
有唯一块标签的条目直接链接到相应环境;没有标签或标签重复时,明确标记为跳转到所在章节或笔记。可以使用原有添加块 ID 命令补标签,再更新索引。插件不会为此批量改写原文。索引采用库内显示编号,即使选择合订本范围也不采用 PDF 中的章号重排。
更新只替换 academic-notes:index:start 与 academic-notes:index:end 注释之间的区域,你可以在区域外添加说明或心得。普通笔记、标记损坏或包含多个生成区域的文件会拒绝覆盖。插件运行期间,来源笔记/文件夹的改名和移动会同步到索引配置;文件夹索引不会因其中某一篇笔记移出而改换范围。停用插件期间发生的改名无法事后追溯,必要时请重新生成。列表里的普通链接由 Obsidian 按其链接更新设置维护。生成的索引链接不会让原本未被引用的公式额外获得编号。
引用选择器及 \ref / \tref / \eqref 建议现在也列出没有块 ID 的环境。选择 添加标签并引用 后,只为该对象生成唯一的原生 ^an-… 标签,再插入普通双链;已有标签直接复用,不会批量给整库补标签。打开的未保存内容会被保留。目标发生变化或无法唯一匹配时拒绝操作;若跨文件写入期间原笔记发生修改,保留已准备的目标标签,提示重新插入引用,不覆盖新编辑内容。
索引记录上次生成时间;阅读视图显示列表是否与当前索引内容一致,并提供更新按钮。列表仍只在手动操作时更新。
“编号与引用默认值”中的“改名时维护学术引用”默认开启。Markdown 笔记或文件夹改名后,插件更新 LaTeX 路径和 phb-book.files;移动来源笔记时,也会调整其中的相对引用。普通笔记链接仍由 Obsidian 自身的设置管理。YAML 注释、章节标题和其他属性会保留;不需要自动维护时可关闭该选项。
在命令面板执行“重命名学术标签”,或从引用预览选择“重命名标签”。选择目标、填写新标签,再点击“预览修改”,查看受影响笔记及前后内容。“应用修改”会同时更新定义、双链、Markdown 链接和 LaTeX 引用,代码示例和注释不参与替换。原生块 ID 只支持字母、数字和连字符;LaTeX 专用标签还支持中文等 Unicode 字母、冒号、点和下划线,重名会被拒绝。同一窗口内可“撤销改名”,前提是相关内容未被再次修改;重命名另一个目标请重新打开命令。
维护操作检查全库 Markdown,包括被普通编号索引排除的笔记。未保存的编辑内容优先使用;预览后笔记有变化会要求重新预览。中途发生冲突时会撤销仍与本次写入一致的已完成修改;同时被编辑、不能安全撤销的笔记会明确列出。
开启“引用内容预览”后,桌面悬停或键盘聚焦引用即可查看目标摘要,按 Esc 或关闭按钮退出。移动端点按引用先预览,再选择“打开目标”或“新标签页打开”;桌面点击及 Ctrl/Cmd 点击仍可直接跳转。预览中的引用来源来自当前索引,最多显示 50 处。定理摘要有长度上限,较长公式和图片、交换图可打开笔记查看。关闭此选项可恢复移动端直接点按跳转。预览不会改写 Markdown。
输入 \ref、\eqref 或 \tref 显示候选。\ref 搜索所有学术对象,\eqref 只显示公式,\tref 只显示定理类环境。继续输入标题或标签可直接搜索;也可选择“本文件”、文件夹或笔记,打开引用浏览窗口。当前范围内有本笔记的匹配对象时,才会显示“本文件”。
浏览窗口有独立的搜索框和路径。点击、点按或按 Enter 进入文件夹和笔记,使用“返回上级”或“全部笔记”切换范围。文件名保留 .md,因此同名文件和文件夹不会混淆。按 Escape 或关闭窗口即可取消,正文和撤销记录不会因浏览而改变。只有选定最终目标时,才替换原来的引用输入。浏览期间原笔记发生变化或编辑窗口切换到其他笔记时,会在修改目标之前拒绝插入。
同一笔记内默认按正文顺序排列。在“编号与引用”中开启“引用候选优先显示手动编号”后,手动编号对象优先;精确标签匹配始终优先于仅在内容中出现的匹配。命令面板中的引用选择器仍保持原来的平铺搜索。
在 $...$ 和 $$...$$ 内,选择公式插入 \eqref{...},选择其他环境插入 \ref{...};正文中仍使用普通双链。保留现有逐行标签和环境标题行中的块 ID,对歧义标签继续进行严格检查。
嵌套环境中的标签现在指向实际所属环境,支持标题行的块 ID。桌面实时预览中,如果原生页面预览要求 Ctrl/Cmd,普通悬停仍会显示插件卡片;按住 Ctrl/Cmd 悬停可交给原生预览。嵌套定理类环境的预览会重建相应框样式。移动端继续支持点按预览。
引用预览设置新增“多行公式预览仅显示所引用行”,默认开启。引用多行公式中的某个已标记行时只预览该行;关闭后预览完整公式块,没有对应行标签时也显示整个公式块。
Academic Notes · English · 简体中文 · Issues · MIT license
Academic Notes
English
- Getting started
- Mathematical environments
- References and academic indexes
- Appearance and customization
- Algorithms and pseudocode
- Figures, tables and subfigures
- Commutative diagrams and TikZ
- Paragraph typography
- Contents and export
- Troubleshooting and compatibility
- Privacy and permissions
- Development and releases