From 7af25f0ef050864f458cd96502a52d14a7bce375 Mon Sep 17 00:00:00 2001 From: Brenton Farmer Date: Sun, 12 Apr 2026 20:05:22 -0700 Subject: [PATCH] Move local-jekyll.md out of docs/site/ to docs/ local-jekyll.md is dev onboarding for previewing the docs site, not site content itself. Jekyll's Liquid engine tries to parse the literal '{% include %}' examples in the file (even inside backticks) and fails with 'Invalid syntax for include tag'. Jekyll 3 (used by GitHub Pages) has no per-file render_with_liquid escape. Moving the file to docs/local-jekyll.md keeps it discoverable next to the site it documents, but outside the Jekyll source tree so it's never processed. --- docs/{site => }/local-jekyll.md | 3 --- 1 file changed, 3 deletions(-) rename docs/{site => }/local-jekyll.md (99%) diff --git a/docs/site/local-jekyll.md b/docs/local-jekyll.md similarity index 99% rename from docs/site/local-jekyll.md rename to docs/local-jekyll.md index b704332..ade9f4b 100644 --- a/docs/site/local-jekyll.md +++ b/docs/local-jekyll.md @@ -1,6 +1,3 @@ ---- -render_with_liquid: false ---- # Running Jekyll Docs Locally (Docker) Reusable recipe for previewing `just-the-docs` / GitHub Pages sites locally