"use strict";
const fs = require("fs");
const path = require("path");
const express = require("express");
const compress = require("compression");
const Metalsmith = require("metalsmith");
const inPlace = require("@metalsmith/in-place");
const layouts = require("@metalsmith/layouts");
const markdown = require("@metalsmith/markdown");
const permalinks = require("./plugins/permalinks");
const collections = require("@metalsmith/collections");
const pagination = require("metalsmith-pagination");
const define = require("metalsmith-define");
const sitemap = require("metalsmith-sitemap");
const Handlebars = require("handlebars");
const moment = require("moment");
const striptags = require("striptags");
const { marked } = require("marked");
const RSS = require("rss");
const sass = require("sass");
const port = process.env.PORT || 8000;
const app = express();
app.disable("x-powered-by");
app.use(compress());
app.use(express.static(__dirname + "/build"));
// Lets try and slow down some of those exploit crawlers
app.use("/", require("./filterRoutes"));
// Redirects
app.use("/", require("./redirects"));
// Handle some iOS icon 404s
app.get("/apple-touch-icon*", function (req, res) {
res.sendFile(__dirname + "/build/images/favico/" + req.url, () => {
res.sendFile(__dirname + "/build/images/favico/apple-touch-icon.png");
});
});
app.get("/images/favico/*.png", function (req, res) {
res.sendFile(__dirname + "/build/images/favico/apple-touch-icon.png");
});
app.get("/favicon.png", function (req, res) {
res.sendFile(__dirname + "/build/images/favico/apple-touch-icon.png");
});
app.get("/robots.txt", function (req, res) {
res.send("User-agent: * Disallow: ");
});
app.get(
/\/(feeds?|rss|atom)\/?|feed\.xml|rss\.xml|index\.rss|feed\.rss$/,
function (req, res) {
res.redirect(301, "/feed.xml");
}
);
app.get(/.+\/manifest\.json$/, function (req, res) {
res.redirect(301, "/manifest.json");
});
app.get("/healthz", function (req, res) {
res.sendStatus(200);
});
// --- Markdown renderer setup ---
marked.setOptions({
gfm: true,
breaks: true,
});
const renderer = new marked.Renderer();
// Custom table renderer to add role="grid" (matches original behavior)
const originalTable = renderer.table.bind(renderer);
renderer.table = function (e) {
let result = originalTable(e);
return result.replace("
", '');
};
const customRenderer = (source, _opts, _context) => {
return marked.parse(source, { renderer });
};
// --- Handlebars helpers ---
Handlebars.registerHelper("markdown", function (text) {
if (!text) return;
return customRenderer(text, {}, {});
});
Handlebars.registerHelper("moment", function (date, format) {
return new moment(date).format(format);
});
Handlebars.registerHelper("striptags", function (text) {
return striptags(text);
});
Handlebars.registerHelper("buildTitle", function (title, siteTitle) {
if (title.indexOf(siteTitle) < 0) {
title = "'" + title + "' by " + siteTitle;
}
return title;
});
Handlebars.registerHelper("jointags", function (tags) {
return (tags || "").split(" ").join(",");
});
Handlebars.registerHelper("encodetitle", function (str) {
return (str || "").replaceAll(" ", "%2B");
});
// --- Pre-build: Compile SCSS to CSS ---
function compileSass(sourceDir, outputDir) {
const cssDir = path.join(sourceDir, "src", "css");
const outputCssDir = path.join(outputDir, "css");
if (!fs.existsSync(cssDir)) {
console.warn("No CSS source directory found, skipping SCSS compilation");
return;
}
// Ensure output directory exists
if (!fs.existsSync(outputCssDir)) {
fs.mkdirSync(outputCssDir, { recursive: true });
}
const files = fs.readdirSync(cssDir);
fs.mkdirSync(outputCssDir, { recursive: true });
for (const file of files) {
if (!file.endsWith(".scss") || file.startsWith("_")) continue; // Skip partials
const inputPath = path.join(cssDir, file);
const outputFileName = file.replace(/\.scss$/, ".css");
const outputPath = path.join(outputCssDir, outputFileName);
console.log(`Compiling SCSS: ${file} -> ${outputFileName}`);
try {
const result = sass.compile(inputPath, {
style: "compressed",
});
fs.writeFileSync(outputPath, result.css);
} catch (err) {
console.error(`Failed to compile ${file}:`, err.message);
throw err;
}
}
}
// --- Feed generation plugin ---
function feedPlugin() {
return function (files, metalsmith, done) {
const posts = metalsmith.metadata().collections.posts || [];
const feed = new RSS({
title: "Marcus Noble",
description:
"The blog of Marcus Noble, self-described tinkerer, platform engineer and all round average guy!",
site_url: "https://marcusnoble.co.uk",
feed_url: "https://marcusnoble.co.uk/feed.xml",
image_url: "https://marcusnoble.co.uk/images/marcus.jpg",
language: "en",
});
posts.forEach((post) => {
feed.item({
title: post.title,
url: `https://marcusnoble.co.uk/${post.path}/`,
date: post.date.toISOString(),
description: post.summary || "",
categories: (post.tags || "").split(" ").filter(Boolean),
});
});
files["feed.xml"] = {
contents: Buffer.from(feed.xml({ indent: true })),
modified: new Date(),
};
done();
};
}
// --- Handlebars partials preprocessor ---
// Processes {{> partial }} calls in markdown files before markdown rendering
function handlebarsPreprocessor() {
return function (files, metalsmith, done) {
const templateDir = path.join(metalsmith.directory(), "templates");
const partialsDir = path.join(templateDir, "partials");
// Load all partials
const hbs = Handlebars.create();
hbs.registerHelper("markdown", function (text) {
if (!text) return "";
return customRenderer(text, {}, {});
});
hbs.registerHelper("moment", function (date, format) {
return new moment(date).format(format);
});
hbs.registerHelper("striptags", striptags);
hbs.registerHelper("buildTitle", function (title, siteTitle) {
if (title.indexOf(siteTitle) < 0) {
title = "'" + title + "' by " + siteTitle;
}
return title;
});
hbs.registerHelper("jointags", function (tags) {
return (tags || "").split(" ").join(",");
});
hbs.registerHelper("encodetitle", function (str) {
return (str || "").replaceAll(" ", "%2B");
});
// Register all partials
if (fs.existsSync(partialsDir)) {
const partialFiles = fs.readdirSync(partialsDir);
for (const file of partialFiles) {
const name = path.parse(file).name;
const content = fs.readFileSync(path.join(partialsDir, file), "utf8");
hbs.registerPartial(name, content);
}
}
// Find markdown files with partial references and process them
const filesToProcess = Object.keys(files).filter((file) =>
file.endsWith(".md") || file.endsWith(".markdown")
);
for (const file of filesToProcess) {
const content = files[file].contents.toString();
const handlebarsRegex = /\{\{\s*>\s*(\w+)\s+([^}]*)\s*\}\}/g;
const matches = [...content.matchAll(handlebarsRegex)];
if (matches.length > 0) {
let processed = content;
for (const match of matches) {
const partialName = match[1];
const argsStr = match[2];
// Parse arguments: name="value" name="value" ...
const args = {};
const argRegex = /(\w+)=["']([^"']*)["']/g;
let argMatch;
while ((argMatch = argRegex.exec(argsStr)) !== null) {
args[argMatch[1]] = argMatch[2];
}
try {
const partial = hbs.partials[partialName];
if (partial) {
const rendered = hbs.compile(partial)(args);
processed = processed.replace(match[0], rendered);
}
} catch (e) {
console.warn(
`Warning: Could not render partial ${partialName} in ${file}`
);
}
}
files[file].contents = Buffer.from(processed);
}
}
// Extract date and title from filename for permalinks compatibility
// Also set default values for files without them
const postPattern = /^posts\/(\d{4}-\d{2}-\d{2})-(.+)\.(md|markdown)$/;
for (const file of Object.keys(files)) {
const match = file.match(postPattern);
if (match) {
const [, dateStr, titleSlug] = match;
// Only set if not already set in front matter
if (!files[file].date) {
files[file].date = new Date(dateStr);
}
if (!files[file].title) {
// Convert slug to title: "some-title-slug" -> "Some Title Slug"
files[file].title = titleSlug
.split("-")
.map((word) => word.charAt(0).toUpperCase() + word.slice(1))
.join(" ");
}
}
// Set default date for files without one (e.g., pages)
if (!files[file].date) {
files[file].date = new Date();
}
}
done();
};
}
// --- Metalsmith build pipeline ---
// Pre-build: Compile SCSS to CSS and write to build directory
compileSass(__dirname, path.join(__dirname, "build"));
const ms = Metalsmith(__dirname)
.ignore(['css']) // Don't copy CSS source files to build
.clean(false) // Don't clean build directory (pre-build SCSS compilation outputs preserved)
.source("src")
.use(
define({
site: {
title: "Marcus Noble",
description:
"The blog of Marcus Noble, self-described tinkerer, platform engineer and all round average guy!",
url: "https://marcusnoble.co.uk",
},
})
)
.use(function (files, metalsmith, done) {
const now = new Date();
const meta = metalsmith.metadata();
meta.buildDate = now;
meta.buildTimestamp = now.toISOString();
done();
})
.use(
collections({
posts: {
pattern: "posts/*",
sortBy: "date",
reverse: true,
},
drafts: {
pattern: "drafts/*",
sortBy: "date",
reverse: true,
},
projects: {
pattern: "projects/*",
},
pages: {
pattern: "pages/*",
},
})
)
.use(handlebarsPreprocessor())
.use(
markdown({
render: customRenderer,
})
)
.use(
inPlace({
transform: "handlebars",
pattern: "**/*.html",
})
)
.use(
layouts({
transform: "handlebars",
directory: "templates",
pattern: "**/*.html",
extname: ".html",
})
)
.use(
permalinks({
pattern: ":date-:title",
date: "YYYY-MM-DD",
linksets: [
{
match: { collection: "pages" },
pattern: ":title"
},
{
match: { collection: "drafts" },
pattern: "drafts/:title"
}
]
})
)
.use(
sitemap({
hostname: "https://marcusnoble.co.uk",
})
)
.use(
pagination({
"collections.posts": {
perPage: 5,
layout: "index.html",
first: "index.html",
noPageOne: true,
path: "page:num/index.html",
pageMetadata: {
title: "Posts",
},
},
})
)
.use(feedPlugin());
// Run the build
ms.build(function (err) {
if (err) {
console.error("Build failed:", err);
throw err;
}
console.log("Build complete. Starting server...");
app.listen(port, function () {
console.log(`App listening at http://localhost:${port}`);
});
});