Bug 001: 标题重复的锚点导致 vitepress 构建搜索失败
如图,这里故意在别的文档项目内启动项目,仍旧可以稳定诱发故障。
报错日志
log
MiniSearch: duplicate ID /css/css-challenges/#CacheEntry
Error: MiniSearch: duplicate ID /css/css-challenges/#CacheEntry
at MiniSearch.add (file:///D:/code/github-desktop-store/gh.notes/node_modules/.pnpm/minisearch@7.1.2/node_modules/minisearch/dist/es/index.js:710:19)
at indexFile (file:///D:/code/github-desktop-store/gh.notes/node_modules/.pnpm/vitepress@1.6.4_@algolia+cl_aa5ca826ff66a7ec605722b4bf43dfbc/node_modules/vitepress/dist/node/chunk-D3CUZ4fa.js:40519:13)
at async file:///D:/code/github-desktop-store/gh.notes/node_modules/.pnpm/vitepress@1.6.4_@algolia+cl_aa5ca826ff66a7ec605722b4bf43dfbc/node_modules/vitepress/dist/node/chunk-D3CUZ4fa.js:4505:20
已处理
诱发该故障的原因是因为文档生成器使用的默认模板不合适,所以才导致生成效果不好。
阅读 jsdoc2md 内部默认使用的模板,发现来自 jsdoc-to-markdown 库的 jsdoc2md.render
函数是提供自定义模板的功能的,所以选择自定义模板。