code
文档content
文档
本站（就是你现在看的这个）由 Typst 编译成 HTML。Rust 侧的驱动器在 docs/ 下，负责拼出入口文件、调 Typst、处理路径。装工具链、跑编译、配编辑器这些动手的事见文档（开发栏），这一栏只讲它怎么搭起来的。- 自定义元素 —— 卡片、折叠面板、代码块、侧栏这一类东西的共同结构：
custom_element 怎么把脚本收集进 <head>、<template> + shadow root 的三层分工、以及它付的几笔代价 - 节点图 —— 文档站里画节点图的自定义元素：一个
<svg> 层、<foreignObject> 节点、以及它踩过的坑
Typst 的 bundle 特性要求有一个 main.typ 把所有页面和资源都 include 进来。这个文件不手写 —— Rust 驱动器扫描 docs/typst/，生成一份列全路径的 main.typ，再调 typst compile（带 html + bundle 特性）产出 target/debug/docs/。所以「加一页」不需要改任何清单：把 .typ 放进目录，下一次构建就会被扫到。lib/toc.typ 自己是一个页面：query(document) 拿到所有页面的 (路径, 标题)，按 / 切成嵌套字典（to_tree），再递归渲染成列表（gen）。没有单独的清单文件要维护 —— 侧栏就是页面路径本身。规则只有几条：- 目录下的
index.typ 给出这一组的名字，同目录的其它文件列在它下面。想加一节就把 xxx.typ 换成 xxx/index.typ 加若干子页 - 顺序按文件名排（
index 作为组名排在最前），不看页面里的顺序 lib/ 和 res/ 在 hides 里，不出现在侧栏
typst watch 能在已存在的文件变化时增量重编，但它不知道新增/删除的文件。驱动器补上这一环 —— 它监听目录的增删，一旦有变化就重新生成 main.typ，再让 Typst 接着编。这就是开发栏那条 --bin watch。站点发布在子路径下（/rust2genshin/），所以所有 href / src 都得带上前缀。前缀从环境变量 BASE_PATH 进来，转成 typst sys.inputs 传给编译器，在 Typst 侧存进 contents.base_path，生成 href / src 属性前手动加上。页面里写的是站内绝对路径（#link("/user/async.html")[...]）。template 把这些以 / 开头的 link 认出来、补上 base_path、渲染成 <a> —— 所以正文里不用关心自己挂在哪一层。