Skip to content

按目录存放文档

适用场景

当在写作平台上管理文章时,需要在生成文档时按目录将文档存放在不同目录,方便部署平台按照目录渲染。 例如 Vitepress 一般是按照文件夹生成文档和目录。

如何配置

语雀/飞书

在配置文件中配置deploy.local.catalog=true,即可按照语雀/飞书目录生成文档。

Notion/FlowUs

  1. 以 Notion 举例,在Notion数据库新增catalog字段(单选/多选),设置每篇文档的所在目录信息标签。单选标签下,只能生成一层目录;多选标签下,可生成多级目录,但是需要保证标签的顺序
  2. 在Notion写作平台配置项中配置write.notion.catalog=true
  3. 在部署平台配置项中配置deploy.local.catalog=true

如果想自定义字段,不使用默认的catalog字段,则需要设置write.notion.catalog为以下格式

javascript
notion: {
  token: process.env.NOTION_TOKEN,
  databaseId: process.env.NOTION_DATABASE_ID,
  filter: true,
  sorts: true,
  catalog: {
		enable: true,
		property: "自定义属性"
	}
}

你也可以不开启按目录存放文档的相关属性,但是依然在Vitepress中按目录生成路由,可参考 Elog Docs 源码