Content filtering

General Configuration

Control which files are included in your published site using contentInclude and contentExclude in your `config.json`:

contentInclude

Array of paths to include in your published site:

{
  "contentInclude": [
    "/blog",           // Include entire blog directory
    "README.md"        // Include specific file
  ]
}

If not specified, includes all files by default (except those in contentExclude).

contentExclude

Array of paths to exclude from your published site:

{
  "contentExclude": [
    "/drafts",          // Exclude entire drafts directory
    "private.md"        // Exclude specific file
  ]
}

Page-level Control

Exclude a specific page using publish: false in frontmatter:

---
title: "Draft Post"
publish: false
---

Note: publish: false takes precedence over site-wide settings, but publish: true cannot override site-wide exclusion rules, and doesn't have any meaning in practice. You can't use it to publish only the files marked with it.

Rules

• Exclude rules take precedence over include rules
• Paths are relative to content root directory
• Directory paths include all subdirectories
• Glob patterns not supported

Example: Combined Usage

Here's how to combine contentInclude and contentExclude to publish only specific content while excluding certain subdirectories:

{
  "contentInclude": [
    "/blog",           // Include entire blog directory
    "README.md"        // Include specific file
  ],
  "contentExclude": [
    "/blog/_archive"   // Exclude archive subdirectory from blog
  ]
}

This configuration will:

1. Only publish files from the /blog directory and README.md
2. Exclude everything in /blog/_archive (since exclude rules take precedence)
3. Not publish any other files or directories