aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorhistoria <[not public]>2025-03-29 18:51:09 -0400
committerhistoria <[not public]>2025-03-29 18:51:09 -0400
commit8b8344809224b26d43269579ab221298d5dcbb49 (patch)
tree7b1a1bdaf1256312b8a4baa335a6bb3b917f27fd /README.md
parentb81022054df182715fce4111925dd8e81c1040bf (diff)
downloadssg-blog-8b8344809224b26d43269579ab221298d5dcbb49.tar.gz
feat: don't include page on index if no date frontmatter
Diffstat (limited to 'README.md')
-rw-r--r--README.md6
1 files changed, 4 insertions, 2 deletions
diff --git a/README.md b/README.md
index f394d21..1dd1461 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@ See [https://romansolotarev.com/ssg.html](https://romanzolotarev.com/ssg.html) f
3. `chmod +x /usr/bin/ssg-blog`
4. `ssg-blog src dst 'https://my-website.net'`
-ssg-blog checks for subdirectories in the src directory, each of which becomes a category heading (non-recursively). It will generate a sorted list of links to any .md file in those directory (including nested directories). Each .md file requires frontmatter including the title and a YYYY-MM-DD date like this to be included in the index page:
+ssg-blog checks for subdirectories in the src directory, each of which becomes a category heading (non-recursively). It will generate a sorted list of links to any .md file in those directory (including nested directories). Each .md file may include frontmatter with the title and a YYYY-MM-DD date like this to be included in the index page:
```markdown
---
@@ -23,7 +23,9 @@ publish: false
---
```
-If you add `publish: false` to the frontmatter, the post will not show up in the index (it will still be rendered and appear in the sitemap). This field is optional otherwise.
+If a file has no frontmatter, no `date`, or `publish: false`, the page won't be included in the index. It will still be rendered in sitemap.xml.
+
+Setting `publish: true` is optional and equivalent to not having `publish` at all.
## Example