article-list-json

发表于 2026-07-17

最后修改 2026-07-17

阅读量 —

ArticleList 组件（docs/.vitepress/theme/components/articleList/ArticleList.vue）的文章清单数据目录。

每个 JSON 文件是一份人工维护的文章清单，由页面通过 file-base-name 属性指定：

<ArticleList file-base-name="featured-articles" />

文件格式

{
  "description": "清单用途说明，仅供维护者阅读",
  "articles": ["/work-visas/employee-or-contractor"]
}

• articles：站内路径数组，约定为根路径、无 .md 后缀（与 articleListMeta.data.ts 的 key 对齐）
• 标题、描述、日期、作者等元数据不在此维护 —— 构建期 loader 会从目标页 frontmatter 自动解析

文件列表

文件	用途
featured-articles.json	精选文章页 docs/zhHans/cruise/article-list.md 的清单