Skip to content

URL Style

默认情况,feishu-pages 的导出,会采用层级的 URL 结构,以确保导出的文档具有较好的 URL 风格。例如:/intergration-deploy/github-actions

但这种做法,需要在编写飞书文档的时候做得比较严谨,每一篇文档都需要增加 slug 的 Page Meta。而某些项目情况可能不需要这样的 URL 结构,也想在编写文档的时候更加简化。

因此 feishu-pages 为此也提供了配置项 URL_STYLE 环境变量,来选择 URL Style。

Nested

如果你想生成更专业的 URL 结构,你可以采用 nested,这也是 feishu-pages 的默认结构,具体效果参见官网文档

这是 feishu-pages 的默认值,如选择这种,无需配置。

yaml
URL_STYLE=nested

Original

如果你期望可以简单导出文档,不需要搞太多事情,你也不需要做国际化支持,你可以采用 original

这样所有生成的 URL 将会是类似: /KMZnwe9qPiLYMOkzzeMcQQcXnkK 的结构。

yaml
URL_STYLE=original