Add handlebars variable to disable handlebars

When writing about ts-in-js, JSDoc blocks look unfortunately like handelbars templates. This lets you easily disable and enable them on a per page basis.

README.md

@@ -118,6 +118,7 @@ src/page-name/loose-md.md
 - `md` pages can have YAML frontmatter, with variables that are accessible to the page layout and handlebars template blocks when building.
 - You can include html in markdown files, so long as you adhere to the allowable markdown syntax around html tags.
 - `md` pages support [handlebars][hb] template placeholders.
+- You can disbale `md` page [handlebars][hb] processing by setting the `handlebars` variable to `false`.
 - `md` pages support many [github flavored markdown features](https://github.com/bcomnes/siteup/blob/6481bd01e59e5d8a4bfcb33008f44a1405bf622b/lib/build-pages/page-builders/md/get-md.js#L25-L36).
 
 An example of a `md` page:
@@ -147,6 +148,7 @@ src/page-name/page.html
 - `html` pages are the simplest page type in `top-bun`. They let you build with raw html for when you don't want that page to have access to markdown features. Some pages are better off with just raw `html`.
 - `html` page variables can only be set in a `page.vars.js` file inside the page directory.
 - `html` pages support [handlebars][hb] template placeholders.
+- You can disbale `html` page [handlebars][hb] processing by setting the `handlebars` variable to `false`.
 
 An example `html` page:
 

lib/build-pages/page-builders/html/index.js

@@ -20,8 +20,13 @@ export async function htmlBuilder ({ pageInfo }) {
   return {
     vars: {},
     pageLayout: async (vars) => {
-      const template = Handlebars.compile(fileContents)
-      return template(vars)
+      // @ts-ignore
+      if (vars?.handlebars) {
+        const template = Handlebars.compile(fileContents)
+        return template(vars)
+      } else {
+        return fileContents
+      }
     }
   }
 }

lib/build-pages/page-builders/md/get-md.js

@@ -63,9 +63,15 @@ export function getMd () {
  */
 export function renderMd (mdUnparsed, vars, md) {
   if (!md) md = getMd()
-  const template = Handlebars.compile(mdUnparsed)
-  const body = rewriteLinks(md.render(template(vars)))
-  return body
+  // @ts-ignore
+  if (vars?.handlebars) {
+    const template = Handlebars.compile(mdUnparsed)
+    const body = rewriteLinks(md.render(template(vars)))
+    return body
+  } else {
+    const body = rewriteLinks(md.render(mdUnparsed))
+    return body
+  }
 }
 
 /**

lib/build-pages/page-builders/md/index.js

@@ -35,7 +35,7 @@ export async function mdBuilder ({ pageInfo }) {
     mdUnparsed = fileContents
   }
 
-  const body = renderMd(mdUnparsed, frontMatter, md)
+  const body = renderMd(mdUnparsed, { handlebars: false, ...frontMatter }, md)
   const title = cheerio.load(body)('h1').first().text().trim()
 
   return {

lib/defaults/default.vars.js

@@ -1,4 +1,5 @@
 export default {
   layout: 'root',
-  siteName: 'top-bun website'
+  siteName: 'top-bun website',
+  handlebars: true
 }