aarnphm.github.io

本仓库驱动一个基于 Quartz v4 静态网站生成器框架开发的先进数字花园。它专为研究人员、开发者与知识工作者设计，提供高度可扩展的文档与知识管理平台。此系统优先考虑学术与技术笔记，支持在 Markdown 工作流中直接进行复杂的可视化渲染与排版。

该系统与 Obsidian 无缝整合，允许在 Obsidian 插件（如 heading-gh、metadata、sidenotes）的本地开发环境中工作，并将其转换为精致且高性能的网页呈现。基础设施包含支持 OFM 兼容性的定制化 remark 解析器，为互联的知识图谱提供必要的 wikilinks 与 callout 结构。使用者可透过针对 TikZ 图形与算法伪代码的专业渲染引擎，实现技术文档、数学笔记或计算机科学研究的高质量展示。

• 进阶 Markdown 扩展：支持 OFM wikilinks、callout 与增强型文本层级的定制化 remark 解析器。
• 可视化与技术渲染：原生支持 TikZ/LaTeX 图表以及具备复制功能的伪代码区块。
• 互动式元素：支持用于信息渐进式揭露的 telescopic 文本、高斯缩放目录 (TOC) 以及折叠式标题。
• 工作流自动化：使用 pnpm 与 TypeScript (tsx) 的预配置构建管线，以及链接 Obsidian 与网页输出的本地开发运行脚本。
• Obsidian 生态系统：包含管理 Obsidian 插件的内部工具，以及同步模拟线上站点行为的本地开发服务器。

使用此技能时，请确保已安装 pnpm，因为构建过程依赖于 pnpm swarm 指令来管理开发周期。输入内容主要为存储在 content/ 目录下的 Markdown 文件，并处理为静态站点。输出为具备阅读模式、目录导航与响应式排版的响应式网页界面。请注意，由于 node port 上游已知错误，TikZ 渲染可能需要特定的 alt-tag URI 设置。使用者应保持 content/ 文件夹的结构一致性，以确保内部 wikilinks 与元数据插件在构建过程中运作正常。