Pages CMS 中如何排除子文件夹内容

在 Pages CMS 项目中，用户经常需要管理包含多种内容类型的网站结构。一个典型的使用场景是：网站同时包含静态页面和博客文章，它们分别存放在不同的目录结构中。这种情况下，如何在CMS界面中清晰地分离这些内容类型就成为了一个常见的配置需求。

问题背景

假设我们有一个Hugo网站，其内容结构如下：

content/
├── static_page.md
├── index.md
└── blog/
    ├── post_a.md
    └── post_b.md

在Pages CMS的配置中，我们通常会为博客文章和静态页面分别创建两个集合(collection)：

1. 博客集合 - 指向content/blog目录
2. 页面集合 - 指向content根目录

但这样配置会导致一个问题：在"页面"集合中，不仅会显示根目录下的静态页面，还会显示blog子文件夹及其内容，这显然不符合我们的管理需求。

解决方案

Pages CMS提供了一个简单而有效的配置选项来解决这个问题：subfolders参数。通过将这个参数设置为false，可以强制集合只显示当前目录下的文件，而忽略所有子文件夹。

以下是优化后的配置示例：

content:
  - name: blog
    label: Blog
    type: collection
    path: 'content/blog'
    view:
      fields: [title, published, date]
    fields:
      - name: draft
        label: Draft
        type: boolean
        default: true
      - name: date
        label: Date
        type: date
      - name: title
        label: Title
        type: string
      - name: body
        label: Body
        type: rich-text
  - name: pages
    label: Pages
    type: collection
    path: 'content'
    subfolders: false  # 关键配置项
    view:
      fields: [title, type]
    fields:
      - name: title
        label: Title
        type: string
      - name: type
        label: Type
        type: select
        options: 
          values:
            - value: page
              label: Page
      - name: body
        label: Body
        type: rich-text

技术原理

subfolders参数控制着集合是否递归地包含子目录中的内容。默认情况下，这个参数值为true，意味着CMS会显示当前路径及其所有子目录中的内容。当设置为false时，CMS将只显示当前目录下的直接文件，而忽略任何子文件夹。

这种设计在以下场景中特别有用：

1. 当你想将不同类型的内容严格分离时
2. 当你的目录结构中有不想在CMS中显示的文件夹时
3. 当你需要简化CMS界面，避免显示不相关的内容时

最佳实践

1. 清晰的目录规划：在设计网站目录结构时，就应该考虑CMS中的管理需求，将不同类型的内容放在不同的目录中。

2. 合理使用subfolders参数：

   • 对于需要包含子内容的集合，保持默认值true或不设置
   • 对于需要排除子内容的集合，显式设置为false

3. 结合其他参数使用：subfolders可以与其他集合参数如filter、sort等配合使用，实现更精细的内容管理控制。

通过合理配置subfolders参数，可以显著提升Pages CMS的使用体验，使内容管理界面更加清晰和高效。