豫言 / 源码树浏览器 @ 0.1.0

生成可浏览的源码静态网站。

# 源码树浏览器

生成可浏览的源码静态网站。

## 包身份

所有者：豫言。包版本：0.1.0（本轮初始包版本，不代表编译器命令行版本）。

本包为可执行文件类型，不可被其他包依赖；包内模块仍可互相引用。类型典中的入口和文件名见包配置，程序产物为 `yy源码树浏览器`。

## 使用

在仓库根目录运行：

```sh
node 豫言操作系统/宿主/节点/宿主.cjs yy豫构.wasm 检查 源码树浏览器
node 豫言操作系统/宿主/节点/宿主.cjs yy豫构.wasm 构建 源码树浏览器
```

依赖及说明路径以 [包配置](源码树浏览器。包。豫) 为准。构建不会自动运行程序；有发布或服务副作用的工具应先阅读其入口源码。

## 维护

发布工具使用 `node 豫言操作系统/宿主/节点/宿主.cjs yy源码树浏览器.wasm 构建源码 源码目录 输出目录`：只扫描指定源码目录，界面资源从当前工作目录读取。基础高亮采用独立词法规则，不要求包上下文或完整语法。扫描阶段只收集目录索引和源码路径，逐页读取并生成高亮 HTML，避免把整站页面同时留在内存。每个文件生成独立页面，首页只载入默认文件；旧的首页源码锚点通过 `浏览.js` 跳转到对应文件。发布流程传入已经按包边界过滤的暂存副本，不扫描整棵依赖树。原有 `构建 [输出目录]` 命令保持兼容。

修改接口时更新本说明；修改包身份、版本或构建组成时同步更新包配置。说明文件不参与模块导入。

# 源码树浏览器

发布可用“构建源码 源码目录 输出目录”，惟览所命之根，饰文取于当前目录。循词着色，不待包籍，语未成亦可阅。先收目录与书径，逐书读取而成饰页，不尽蓄诸页于内存。一书一页，首页惟载首选之书；旧锚由 `浏览.js` 导至其页。发布者先依包界备副本，不混所依；旧“构建”之令不改。

生成可浏览的源码静态网站。

## 籍与用

所有者曰豫言，版本暂定 0.1.0。此包之版本，非编译器命令所报之版本。

此包不供他包所依，包内诸书仍可相引。程序名曰 `yy源码树浏览器`，入口依包籍所载。

在仓库之根行 `node 豫言操作系统/宿主/节点/宿主.cjs yy豫构.wasm 检查 源码树浏览器` 以验其籍。行 `node 豫言操作系统/宿主/节点/宿主.cjs yy豫构.wasm 构建 源码树浏览器` 以成其器，不自行之。

所依与说明之径皆见[包籍](源码树浏览器。包。豫)。变接口则修说明，变身份与组成则修包籍。说明不作模块。