fossbook 0.2.14 → 0.2.15

package/README.md

@@ -85,10 +85,17 @@ This also creates `index.ko.md` and `index.ja.md` in the same post directory. Ru
 fossbook build
 ```
 
+Posts with `draft: true` in their front matter are excluded from generated
+post pages, home pages, archives, and tags. To include them in a local build:
+
+```bash
+fossbook build --include-drafts
+```
+
 ### Preview locally
 
 ```bash
-fossbook serve
+fossbook serve --include-drafts
 ```
 
 Open http://localhost:3000 to view your site.
@@ -204,11 +211,16 @@ date: 2026-02-17
 description: "A brief summary of the post"
 image: "feature.png"
 tags: "JavaScript, Node.js, Static Site"
+draft: false
 ---
 
 Your Markdown content here...
 ```
 
+Set `draft: true` while a post is in progress. Normal builds and deployments
+exclude it. Use `fossbook serve --include-drafts` to preview drafts locally,
+then remove the field or set it to `false` before publishing.
+
 ### Directory structure
 
 ```

package/bin/fossbook.js

@@ -24,6 +24,7 @@ Options:
   --clean        Remove output directory before build (default: true)
   --github       (init) Also create a GitHub repo and push
   --lang         (new) Comma-separated translation languages, e.g. ko,ja
+  --include-drafts (build, serve) Include posts with draft: true
   -m, --message  (deploy) Custom commit message
   --no-wait      (deploy) Push without waiting for CI status
   --draft        (deploy) Commit locally without pushing
@@ -64,6 +65,7 @@ switch (command) {
     const config = loadConfig(configPath);
     const outputOverride = getOption("-o", "--output");
     if (outputOverride) config.dev.outdir = outputOverride;
+    config.includeDrafts = hasFlag("--include-drafts");
 
     const { build } = require("../lib/index");
     build(config);
@@ -74,6 +76,7 @@ switch (command) {
     const config = loadConfig(configPath);
     const outputOverride = getOption("-o", "--output");
     if (outputOverride) config.dev.outdir = outputOverride;
+    config.includeDrafts = hasFlag("--include-drafts");
     const port = getOption("-p", "--port") || 3000;
 
     const { build } = require("../lib/index");

package/lib/deploy.js

@@ -14,6 +14,7 @@ async function deploy(config, options = {}) {
 
   // 1. Build the site
   console.log("Building site...");
+  config.includeDrafts = false;
   build(config);
   console.log("Build complete.\n");
 

package/lib/index.js

@@ -38,7 +38,12 @@ function createPostTranslationIndex(languageConfigs) {
       const sourceFile = config.language === config.defaultLanguage
         ? "index.md"
         : `index.${config.language}.md`;
-      if (!fs.existsSync(path.join(postsDir, entry.name, sourceFile))) continue;
+      const sourcePath = path.join(postsDir, entry.name, sourceFile);
+      if (!fs.existsSync(sourcePath)) continue;
+
+      const post = new Page(config);
+      post.readSource(sourcePath, entry.name);
+      if (post.draft && !config.includeDrafts) continue;
 
       const prefix = config.postsPath ? `${config.postsPath}/` : "";
       translations.push({
@@ -163,6 +168,9 @@ function build(config) {
   fs.mkdirSync(config.dev.outdir, { recursive: true });
 
   const languageConfigs = config.languageConfigs || [config];
+  languageConfigs.forEach((languageConfig) => {
+    languageConfig.includeDrafts = config.includeDrafts === true;
+  });
   const postTranslationIndex = createPostTranslationIndex(languageConfigs);
   const aboutTranslations = createAboutTranslations(languageConfigs);
   const homeTranslations = createHomeTranslations(languageConfigs);

package/lib/mod/page.js

@@ -39,6 +39,7 @@ module.exports = class Page extends PageBase {
     this.url = `${this.config.blogsite}/${this.path}/`;
     this.image = content.attributes.image;
     this.description = content.attributes.description;
+    this.draft = content.attributes.draft === true;
     // default image if no imageURL is specified
     this.imageURL = this.config.image;
 

package/lib/posts.js

@@ -26,6 +26,7 @@ module.exports = class Posts {
       }
       const post = new Page(this.config);
       post.readSource(indexPath, postPath);
+      if (post.draft && !this.config.includeDrafts) return;
       // Optionally nest posts under a URL prefix (e.g. "posts" -> /posts/<slug>/).
       // post.slug stays the source folder name so image lookups remain correct.
       const prefix = this.config.postsPath ? `${this.config.postsPath}/` : "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fossbook",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "description": "A Markdown-based authoring and web-publishing tool for comics, illustrated stories, and articles",
   "main": "lib/index.js",
   "scripts": {