@zeropress/build-pages 0.5.4 → 0.5.5

package/README.md

@@ -1,8 +1,11 @@
 # @zeropress/build-pages
 
+![npm](https://img.shields.io/npm/v/%40zeropress%2Fbuild-pages)
+![license](https://img.shields.io/npm/l/%40zeropress%2Fbuild-pages)
+
 Build ZeroPress static output for modern hosting platforms.
 
-`@zeropress/build-pages` turns a directory of Markdown files and public assets into a static ZeroPress site. It discovers Markdown pages, prepares the site data, stages public files, and runs `@zeropress/build`.
+`@zeropress/build-pages` turns a directory of Markdown files and public assets into a static ZeroPress site. It discovers Markdown pages, prepares the site data, stages public files, and runs [`@zeropress/build`](https://github.com/zeropress-app/zeropress-build).
 
 The generated output is plain static files that can be deployed to GitHub Pages, Cloudflare Pages, Netlify, Vercel, or any static hosting provider.
 
@@ -97,10 +100,52 @@ jobs:
 
 The action `zeropress-build-pages` builds the static files only. Uploading and deploying are handled by your hosting provider's deployment action or CLI.
 
+Minimal action usage:
+
+```yaml
+- name: Build ZeroPress Pages
+  uses: zeropress-app/zeropress-build-pages@v0
+```
+
+That is equivalent to:
+
+```yaml
+- name: Build ZeroPress Pages
+  uses: zeropress-app/zeropress-build-pages@v0
+  with:
+    source: ./docs
+    destination: ./_site
+    theme: docs
+    skip-untitled-markdown: false
+    skip-link-check: false
+    copy-markdown-source: true
+```
+
+Custom input example:
+
+```yaml
+- name: Build ZeroPress Pages
+  uses: zeropress-app/zeropress-build-pages@v0
+  with:
+    source: ./documents
+    destination: ./_site
+    theme-path: ./theme-docs
+    config: ./documents/.zeropress/config.json
+    site-url: https://example.com/docs
+    copy-markdown-source: false
+```
+
 In the action inputs:
 
 - `source` is the directory that contains your Markdown pages, public files, and optional `.zeropress/config.json`. The default is `./docs`.
 - `destination` is the directory where the generated static site is written. The default is `./_site`.
+- `theme` is the bundled theme name. The default is `docs`.
+- `theme-path` is a custom local ZeroPress theme directory. It takes precedence over `theme`.
+- `config` is the config file path. The default is `<source>/.zeropress/config.json`.
+- `site-url` overrides the canonical site URL from config.
+- `skip-untitled-markdown` skips Markdown files without a page title instead of failing. The default is `false`.
+- `skip-link-check` skips internal link checking after build. The default is `false`.
+- `copy-markdown-source` copies original Markdown files to the generated output and enables `View this page as Markdown` links in the bundled docs theme. The default is `true`.
 
 For GitHub Pages, the generated `destination` directory can be passed to `actions/upload-pages-artifact`. For Cloudflare Pages, Netlify, Vercel, or another static host, pass the same `destination` directory to that provider's deploy step.
 
@@ -146,23 +191,27 @@ The CLI requires explicit input and output paths. The GitHub Action keeps safe d
 | `--site-url <url>` | config `site.url` | Canonical URL override |
 | `--skip-untitled-markdown` | `false` | Skip Markdown without a page title |
 | `--skip-link-check` | `false` | Skip link checking |
+| `--no-copy-markdown-source` | `false` | Do not copy original Markdown files to output |
 
 ## Source Tree
 
-The source directory is both the Markdown source root and the public passthrough root. GitHub Action usage defaults to `./docs`; CLI usage requires `--source`.
+The source directory is the folder that Build Pages reads. It is both the Markdown source root and the public passthrough root. GitHub Action usage defaults to `./docs`; CLI usage requires `--source`.
 
-Use a dedicated content directory such as `docs/` or `documents/`. Repository root source (`--source ./`) is not supported, because Build Pages uses `.zeropress/` in the current working directory for internal working files.
+Use a dedicated content directory such as `docs/` or `documents/`. Repository root source (`--source ./`) is not supported.
 
 ```txt
-docs/
-  index.md
-  guide.md
-  assets/
-  .zeropress/
-    config.json
+my-site/
+  docs/                 # source
+    index.md
+    guide.md
+    assets/
+      logo.png
+    .zeropress/
+      config.json
+  _site/                # destination, generated
 ```
 
-Build Pages stages the source tree before calling `@zeropress/build`. Generated ZeroPress output wins over staged public files.
+Build Pages stages the source tree before calling [`@zeropress/build`](https://github.com/zeropress-app/zeropress-build). Generated ZeroPress output wins over staged public files.
 
 The source directory must not overlap the destination directory, the selected theme directory, or the internal `.zeropress/` working directory.
 
@@ -192,7 +241,8 @@ Additional Markdown discovery ignores:
 - Nested `index.md` maps to a directory route, such as `cli/index.md` -> `/cli/`.
 - Other Markdown files map to extensionless routes, such as `cli/tool.md` -> `/cli/tool`.
 - Markdown links to other discovered `.md` files are rewritten to generated public URLs.
-- Original Markdown files remain available as public passthrough files.
+- Original Markdown files remain available as public passthrough files by default.
+- Use `--no-copy-markdown-source` or Action input `copy-markdown-source: false` to keep source Markdown out of the generated output. This also hides bundled theme `View this page as Markdown` links.
 
 Optional YAML front matter is supported at the top of Markdown files:
 
@@ -227,6 +277,8 @@ Unknown front matter fields are ignored to make migration from existing Markdown
 
 Build Pages reads `<source>/.zeropress/config.json` when present. Missing config falls back to defaults.
 
+See the public config reference at [zeropress.dev/build-pages-config](https://zeropress.dev/build-pages-config/).
+
 ```json
 {
   "$schema": "https://zeropress.dev/schemas/zeropress-build-pages.config.v0.1.schema.json",
@@ -276,8 +328,7 @@ The bundled docs theme shows `Published with ZeroPress.` by default. Set `site.f
 
 Schemas:
 
-- `schemas/zeropress-build-pages.config.v0.1.schema.json`
-- `schemas/zeropress-build-pages.config.schema.json`
+- [ZeroPress Build Pages Config v0.1](https://zeropress.dev/schemas/zeropress-build-pages.config.v0.1.schema.json)
 
 ## Internal `.zeropress/` Files
 
@@ -295,18 +346,14 @@ Build Pages writes internal working files to `.zeropress/` in the current workin
 
 `preview-data.json` is an internal generated build input for the ZeroPress renderer. Most users do not need to edit or understand this file.
 
-`build-report.json` records discovered Markdown counts, skipped Markdown files, front page resolution, and custom HTML slots.
+`build-report.json` records discovered Markdown counts, skipped Markdown files, front page resolution, source Markdown copy policy, and custom HTML slots.
 
 `public-assets/` is a temporary staged public root used before the final ZeroPress render.
 
 ## Destination Output
 
-The `destination` directory contains the deployable static site. It includes generated ZeroPress HTML, copied public files, and original Markdown files unless they are excluded by the public passthrough rules.
+The `destination` directory contains the deployable static site. It includes generated ZeroPress HTML, copied public files, and original Markdown files unless Markdown source copy is disabled or files are excluded by the public passthrough rules.
 
-## Development
+## Demo
 
-```bash
-npm install
-npm run build:action
-npm test
-```
+- [zeropress.dev](https://github.com/zeropress-app/zeropress.dev) is built with `@zeropress/build-pages`.

package/action.yml

@@ -34,6 +34,10 @@ inputs:
     description: Skip internal link checking after the site is built.
     required: false
     default: "false"
+  copy-markdown-source:
+    description: Copy original Markdown files to output and expose View this page as Markdown links.
+    required: false
+    default: "true"
 runs:
   using: node24
   main: dist/action.js

package/dist/action.js

@@ -62145,6 +62145,7 @@ var STAGING_DIR = ".zeropress/public-assets";
 var DEFAULT_THEME = "docs";
 async function runBuildPages(options2) {
   const cwd = path3.resolve(options2.cwd || process.cwd());
+  const copyMarkdownSource = options2.copyMarkdownSource !== false;
   const sourceDir = path3.resolve(cwd, options2.source);
   const destinationDir = path3.resolve(cwd, options2.destination);
   const generatedDir = path3.join(cwd, ".zeropress");
@@ -62165,7 +62166,8 @@ async function runBuildPages(options2) {
     ...process.env,
     ZEROPRESS_BUILD_PAGES_SOURCE: sourceDir,
     ZEROPRESS_PUBLIC_DIR: sourceDir,
-    ZEROPRESS_SKIP_UNTITLED_MARKDOWN: String(Boolean(options2.skipUntitledMarkdown))
+    ZEROPRESS_SKIP_UNTITLED_MARKDOWN: String(Boolean(options2.skipUntitledMarkdown)),
+    ZEROPRESS_COPY_MARKDOWN_SOURCE: String(copyMarkdownSource)
   };
   if (options2.config) {
     env.ZEROPRESS_BUILD_PAGES_CONFIG = path3.resolve(cwd, options2.config);
@@ -62188,7 +62190,8 @@ async function runBuildPages(options2) {
   await fs3.rm(stagingDir, { recursive: true, force: true });
   await fs3.mkdir(stagingDir, { recursive: true });
   await copyPublicStaging(sourceDir, stagingDir, {
-    excludePaths: [destinationDir, themeDir, generatedDir]
+    excludePaths: [destinationDir, themeDir, generatedDir],
+    copyMarkdownSource
   });
   const previousPublicDir = process.env.ZEROPRESS_PUBLIC_DIR;
   process.env.ZEROPRESS_PUBLIC_DIR = stagingDir;
@@ -62277,6 +62280,9 @@ async function copyPublicStaging(sourceDir, targetDir, options2) {
     if (!entry.isFile()) {
       continue;
     }
+    if (options2.copyMarkdownSource === false && entry.name.toLowerCase().endsWith(".md")) {
+      continue;
+    }
     await fs3.mkdir(path3.dirname(targetPath), { recursive: true });
     await fs3.copyFile(sourcePath, targetPath);
   }
@@ -62315,7 +62321,8 @@ var options = {
   config: input("config"),
   siteUrl: input("site-url"),
   skipUntitledMarkdown: booleanInput("skip-untitled-markdown", false),
-  skipLinkCheck: booleanInput("skip-link-check", false)
+  skipLinkCheck: booleanInput("skip-link-check", false),
+  copyMarkdownSource: falseOnlyInput("copy-markdown-source")
 };
 try {
   await runBuildPages(options);
@@ -62334,3 +62341,6 @@ function booleanInput(name, fallback) {
   }
   return value.toLowerCase() === "true";
 }
+function falseOnlyInput(name) {
+  return input(name).toLowerCase() !== "false";
+}

package/dist/prebuild.js

@@ -3531,6 +3531,7 @@ var buildPagesConfigPath = path.join(outDir, "build-pages-config.json");
 var previewDataPath = path.join(outDir, "preview-data.json");
 var buildReportPath = path.join(outDir, "build-report.json");
 var skipUntitledMarkdown = readBooleanEnv("ZEROPRESS_SKIP_UNTITLED_MARKDOWN");
+var copyMarkdownSource = readBooleanEnv("ZEROPRESS_COPY_MARKDOWN_SOURCE", true);
 var FRONT_PAGE_TYPES = /* @__PURE__ */ new Set(["theme_index", "markdown", "html"]);
 var BUILD_PAGES_CONFIG_SCHEMA_URL = "https://zeropress.dev/schemas/zeropress-build-pages.config.v0.1.schema.json";
 var PREVIEW_DATA_SCHEMA_URL = "https://zeropress.dev/schemas/preview-data.v0.5.schema.json";
@@ -3605,7 +3606,7 @@ async function main() {
     path: route.path,
     meta: {
       ...frontMatter.meta,
-      source_markdown_url: buildSourceMarkdownUrl(sourcePath)
+      ...copyMarkdownSource ? { source_markdown_url: buildSourceMarkdownUrl(sourcePath) } : {}
     },
     content: rewriteMarkdownLinks(bodyMarkdown, sourcePath, routeBySourcePath),
     document_type: "markdown",
@@ -4161,6 +4162,7 @@ function buildPrebuildReport({
     preview_data_path: formatSourcePath(previewDataPath),
     report_path: formatSourcePath(buildReportPath),
     skip_untitled_markdown: skipUntitledMarkdown,
+    copy_markdown_source: copyMarkdownSource,
     markdown: {
       discovered: sourceFiles.length,
       generated_pages: pageInputs.length,
@@ -4588,8 +4590,12 @@ function readEnv(name, fallback) {
 function readConfigString(value, fallback) {
   return typeof value === "string" && value.trim() ? value.trim() : fallback;
 }
-function readBooleanEnv(name) {
-  return process.env[name]?.trim().toLowerCase() === "true";
+function readBooleanEnv(name, fallback = false) {
+  const value = process.env[name]?.trim();
+  if (!value) {
+    return fallback;
+  }
+  return value.toLowerCase() === "true";
 }
 function resolveEnvPath(names, fallback) {
   const rawValue = names.map((name) => process.env[name]?.trim()).find(Boolean) || fallback;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeropress/build-pages",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "ZeroPress Markdown build action and CLI for static hosting",
   "type": "module",
   "license": "MIT",

package/src/action.js

@@ -9,6 +9,7 @@ const options = {
   siteUrl: input('site-url'),
   skipUntitledMarkdown: booleanInput('skip-untitled-markdown', false),
   skipLinkCheck: booleanInput('skip-link-check', false),
+  copyMarkdownSource: falseOnlyInput('copy-markdown-source'),
 };
 
 try {
@@ -30,3 +31,7 @@ function booleanInput(name, fallback) {
   }
   return value.toLowerCase() === 'true';
 }
+
+function falseOnlyInput(name) {
+  return input(name).toLowerCase() !== 'false';
+}

package/src/index.js

@@ -37,6 +37,7 @@ export async function runCli(argv = process.argv.slice(2)) {
 
 export async function runBuildPages(options) {
   const cwd = path.resolve(options.cwd || process.cwd());
+  const copyMarkdownSource = options.copyMarkdownSource !== false;
   const sourceDir = path.resolve(cwd, options.source);
   const destinationDir = path.resolve(cwd, options.destination);
   const generatedDir = path.join(cwd, '.zeropress');
@@ -60,6 +61,7 @@ export async function runBuildPages(options) {
     ZEROPRESS_BUILD_PAGES_SOURCE: sourceDir,
     ZEROPRESS_PUBLIC_DIR: sourceDir,
     ZEROPRESS_SKIP_UNTITLED_MARKDOWN: String(Boolean(options.skipUntitledMarkdown)),
+    ZEROPRESS_COPY_MARKDOWN_SOURCE: String(copyMarkdownSource),
   };
   if (options.config) {
     env.ZEROPRESS_BUILD_PAGES_CONFIG = path.resolve(cwd, options.config);
@@ -85,6 +87,7 @@ export async function runBuildPages(options) {
   await fs.mkdir(stagingDir, { recursive: true });
   await copyPublicStaging(sourceDir, stagingDir, {
     excludePaths: [destinationDir, themeDir, generatedDir],
+    copyMarkdownSource,
   });
 
   const previousPublicDir = process.env.ZEROPRESS_PUBLIC_DIR;
@@ -127,6 +130,10 @@ export function parseArgs(argv) {
       flags.skipLinkCheck = true;
       continue;
     }
+    if (arg === '--no-copy-markdown-source') {
+      flags.copyMarkdownSource = false;
+      continue;
+    }
 
     const valueOptions = new Set([
       '--source',
@@ -167,6 +174,7 @@ export function parseArgs(argv) {
     siteUrl: flags['site-url'] || '',
     skipUntitledMarkdown: flags.skipUntitledMarkdown === true,
     skipLinkCheck: flags.skipLinkCheck === true,
+    copyMarkdownSource: flags.copyMarkdownSource !== false,
   };
 }
 
@@ -185,6 +193,7 @@ Options:
   --site-url <url>              Canonical site URL override
   --skip-untitled-markdown      Skip Markdown files without a page title
   --skip-link-check             Skip internal link checking
+  --no-copy-markdown-source     Do not copy original Markdown files to output
   --help, -h                    Show help
   --version, -v                 Show version`);
 }
@@ -264,6 +273,10 @@ async function copyPublicStaging(sourceDir, targetDir, options) {
       continue;
     }
 
+    if (options.copyMarkdownSource === false && entry.name.toLowerCase().endsWith('.md')) {
+      continue;
+    }
+
     await fs.mkdir(path.dirname(targetPath), { recursive: true });
     await fs.copyFile(sourcePath, targetPath);
   }

package/src/prebuild.js

@@ -13,6 +13,7 @@ const buildPagesConfigPath = path.join(outDir, 'build-pages-config.json');
 const previewDataPath = path.join(outDir, 'preview-data.json');
 const buildReportPath = path.join(outDir, 'build-report.json');
 const skipUntitledMarkdown = readBooleanEnv('ZEROPRESS_SKIP_UNTITLED_MARKDOWN');
+const copyMarkdownSource = readBooleanEnv('ZEROPRESS_COPY_MARKDOWN_SOURCE', true);
 const FRONT_PAGE_TYPES = new Set(['theme_index', 'markdown', 'html']);
 const BUILD_PAGES_CONFIG_SCHEMA_URL = 'https://zeropress.dev/schemas/zeropress-build-pages.config.v0.1.schema.json';
 const PREVIEW_DATA_SCHEMA_URL = 'https://zeropress.dev/schemas/preview-data.v0.5.schema.json';
@@ -96,7 +97,7 @@ async function main() {
     path: route.path,
     meta: {
       ...frontMatter.meta,
-      source_markdown_url: buildSourceMarkdownUrl(sourcePath),
+      ...(copyMarkdownSource ? { source_markdown_url: buildSourceMarkdownUrl(sourcePath) } : {}),
     },
     content: rewriteMarkdownLinks(bodyMarkdown, sourcePath, routeBySourcePath),
     document_type: 'markdown',
@@ -733,6 +734,7 @@ function buildPrebuildReport({
     preview_data_path: formatSourcePath(previewDataPath),
     report_path: formatSourcePath(buildReportPath),
     skip_untitled_markdown: skipUntitledMarkdown,
+    copy_markdown_source: copyMarkdownSource,
     markdown: {
       discovered: sourceFiles.length,
       generated_pages: pageInputs.length,
@@ -1305,8 +1307,12 @@ function readConfigInteger(value, fallback) {
   return Number.isInteger(value) && value > 0 ? value : fallback;
 }
 
-function readBooleanEnv(name) {
-  return process.env[name]?.trim().toLowerCase() === 'true';
+function readBooleanEnv(name, fallback = false) {
+  const value = process.env[name]?.trim();
+  if (!value) {
+    return fallback;
+  }
+  return value.toLowerCase() === 'true';
 }
 
 function resolveEnvPath(names, fallback) {