如何使用Docusaurus创建指向多个动态文件的索引页面

1. 目录访问404的可选解决方式 #

直接访问directory_2路径返回404是因为绝大多数静态文件服务、Markdown静态站点生成工具默认关闭了目录自动索引功能，不会自动生成目录内文件的列表页面，你可以根据自己的使用场景二选一：

• 如果你自行控制部署的Web服务器（如Nginx、Apache），可以直接开启服务器的目录浏览功能，开启后访问directory_2/路径就会自动展示目录下所有文件的链接列表，不需要额外创建文件。
• 如果你使用第三方静态托管平台、静态站点生成器（如Hugo、VitePress、Jekyll等），这类场景大多不支持自定义服务器配置，必须在directory_2下创建索引页面，通常命名为index.md或README.md（具体规则参考你使用的工具文档），之后从directory_1/file_1.md添加指向../directory_2/的链接即可正常访问。

2. 动态更新索引页面的实现方案 #

可以实现索引页面随directory_2内的文件变化自动更新，常见实现方式如下：

• 静态站点生成器场景：所有主流静态站点生成器都支持模板遍历功能，你可以在索引页中编写遍历当前目录文件的模板代码，比如Hugo的readDir函数、VitePress的动态路由配置，每次站点构建时会自动扫描directory_2下的最新文件，自动生成链接列表，无需手动修改索引页。
• 纯手写Markdown/静态页场景：可以写一个简单的本地脚本（Python、Shell均可），每次调整directory_2内的文件时执行脚本，自动扫描目录下的文件并重写索引页的链接列表；也可以将脚本配置为Git的pre-commit钩子，提交代码时自动执行更新。
• 支持前端动态渲染的部署场景：可以在索引页中添加少量前端JS代码，页面加载时请求当前目录的文件列表，动态渲染所有文件的链接，后续调整目录内文件无需修改索引页。

内容的提问来源于stack exchange，提问作者Pierre Delecto