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 與元數據插件在建置過程中運作正常。