hdoc-tools 0.61.0 → 0.62.0

package/hdoc-validate.js

@@ -1,1231 +1,1231 @@
-(() => {
-	const cheerio = require("cheerio");
-	const dns = require("node:dns");
-	const fs = require("node:fs");
-	const path = require("node:path");
-	const hdoc = require(path.join(__dirname, "hdoc-module.js"));
-	const interbook = require(path.join(__dirname, "hdoc-validate-interbook.js"));
-	const translator = require("american-british-english-translator");
-
-	const spellcheck_options = {
-		british: true,
-		spelling: true,
-	};
-	const regex_nav_paths = /[a-z0-9-\/]+[a-z0-9]+#{0,1}[a-z0-9-\/]+/;
-
-	const errors = {};
-	const messages = {};
-	const warnings = {};
-	const html_to_validate = [];
-	const md_to_validate = [];
-	const exclude_links = {};
-	const exclude_spellcheck = {};
-	let private_repo = false;
-	let redirects = {};
-	let skip_link_file = '';
-	let _on_int_net_cached = null; // null = not yet checked; cached after first DNS lookup
-	const exclude_h1_count = {};
-	const exclude_spellcheck_output = [];
-	let global_spellcheck = [];
-
-	const excludeLink = (url) => {
-		if (exclude_links[url]) return true;
-		for (let key in exclude_links) {
-			if (Object.hasOwn(exclude_links, key)) {
-				if (key.endsWith("*")) {
-					key = key.substring(0, key.length - 1);
-					if (url.startsWith(key)) return true;
-				}
-			}
-		}
-		return false;
-	};
-
-	const loadSkipLinkValidation = (source_path) => {
-		skip_link_file = path.join(source_path, "validated-links.txt");
-		if (fs.existsSync(skip_link_file)) {
-			console.log(`Loading skip link validation file from: ${skip_link_file}`);
-			const skip_links = fs.readFileSync(skip_link_file, "utf8").split("\n");
-			for (let i = 0; i < skip_links.length; i++) {
-				if (skip_links[i].trim() !== "") {
-					exclude_links[skip_links[i].trim()] = true;
-				}
-			}
-		} else {
-			//Create the file if it doesn't exist
-			console.log(`Creating skip link validation file: ${skip_link_file}`);
-			fs.writeFileSync(skip_link_file, "", "utf8");
-		}
-	};
-
-	const spellcheckContent = async (sourceFile, excludes) => {
-		const spelling_errors = {};
-		const words = [];
-		const text = fs.readFileSync(sourceFile.path, "utf8");
-		const source_path = sourceFile.relativePath.replace(
-			`.${sourceFile.extension}`,
-			"",
-		);
-
-		const markdown_paths = getMDPathFromHtmlPath(sourceFile);
-
-		const translate_output = translator.translate(text, spellcheck_options);
-		if (Object.keys(translate_output).length) {
-			for (const key in translate_output) {
-				if (Object.hasOwn(translate_output, key)) {
-					// key is the line of text 
-					let error_message = `British spelling:`;
-					for (let i = 0; i < translate_output[key].length; i++) {
-						for (const spelling in translate_output[key][i]) {
-							if (
-								Object.hasOwn(translate_output[key][i], spelling) &&
-								typeof translate_output[key][i][spelling].details === "string"
-							) {
-								const link_location = hdoc.find_string_in_string(text.split('\n')[key - 1], spelling);
-								if (link_location !== null)
-									error_message = `${markdown_paths.relativePath}:${key}:${link_location.column} - ${error_message}`;
-								else
-									error_message = `${markdown_paths.relativePath}:${key} - ${error_message}`;
-								if (!excludes[source_path] && !global_spellcheck.includes(spelling.toLowerCase())) {
-									errors[sourceFile.relativePath].push(
-										`${error_message} ${spelling} should be ${translate_output[key][i][spelling].details}`,
-									);
-									spelling_errors[spelling] = true;
-								} else if (
-									!excludes[source_path].includes(spelling.toLowerCase()) && !global_spellcheck.includes(spelling.toLowerCase())
-								) {
-									errors[sourceFile.relativePath].push(
-										`${error_message} ${spelling} should be ${translate_output[key][i][spelling].details}`,
-									);
-									spelling_errors[spelling] = true;
-								}
-							}
-						}
-					}
-				}
-			}
-		}
-		if (Object.keys(spelling_errors).length) {
-			const exclude_output = {
-				document_path: sourceFile.relativePath.replace(
-					path.extname(sourceFile.relativePath),
-					"",
-				),
-				words: [],
-			};
-			for (const word in spelling_errors) {
-				if (Object.hasOwn(spelling_errors, word)) {
-					words.push(word);
-					exclude_output.words.push(word);
-				}
-			}
-			exclude_spellcheck_output.push(exclude_output);
-		}
-		return words;
-	};
-
-	const checkInline = async (source_path, inline, excludes) => {
-		const inline_errors = [];
-		for (let i = 0; i < inline.length; i++) {
-			const title = inline[i].title;
-			const link = inline[i].link;
-
-			// Validate link segment spellings
-			const paths = link.split("/");
-			for (let i = 0; i < paths.length; i++) {
-				const path_words = paths[i].split("-");
-				for (let j = 0; j < path_words.length; j++) {
-					const translate_output = translator.translate(
-						path_words[j],
-						spellcheck_options,
-					);
-					if (Object.keys(translate_output).length) {
-						for (const spell_val in translate_output) {
-							if (Object.hasOwn(translate_output, spell_val)) {
-								for (const spelling in translate_output[spell_val][0]) {
-									if (Object.hasOwn(translate_output[spell_val][0], spelling)) {
-										if (!excludes[link]) {
-											inline_errors.push(
-												`Inline Link [${link}] contains a British English spelling: ${spelling} should be ${translate_output[spell_val][0][spelling].details}`,
-											);
-										} else if (
-											!excludes[link].includes(spelling.toLowerCase())
-										) {
-											inline_errors.push(
-												`Inline Link [${link}] contains a British English spelling: ${spelling} should be ${translate_output[spell_val][0][spelling].details}`,
-											);
-										}
-									}
-								}
-							}
-						}
-					}
-				}
-			}
-
-			// Validate display names
-			const translate_output = translator.translate(title, spellcheck_options);
-			if (Object.keys(translate_output).length) {
-				for (const spell_val in translate_output) {
-					if (Object.hasOwn(translate_output, spell_val)) {
-						for (let j = 0; j < translate_output[spell_val].length; j++) {
-							for (const spelling in translate_output[spell_val][j]) {
-								if (Object.hasOwn(translate_output[spell_val][j], spelling)) {
-									if (!excludes[link]) {
-										inline_errors.push(
-											`Inline title for link [${link}] contains a British English spelling: ${spelling} should be ${translate_output[spell_val][j][spelling].details}`,
-										);
-									} else if (!excludes[link].includes(spelling.toLowerCase())) {
-										inline_errors.push(
-											`Inline title for link [${link}] contains a British English spelling: ${spelling} should be ${translate_output[spell_val][j][spelling].details}`,
-										);
-									}
-								}
-							}
-						}
-					}
-				}
-			}
-
-			// Validate path exists - link should be a html file at this point as its after the content has been built
-			let file_exists = true;
-			let file_name = path.join(source_path, `${link}.html`);
-			if (!fs.existsSync(file_name)) {
-				file_name = path.join(source_path, `${link}.htm`);
-				if (!fs.existsSync(file_name)) {
-					file_name = path.join(source_path, link, "index.html");
-					if (!fs.existsSync(file_name)) {
-						file_name = path.join(source_path, link, "index.htm");
-						if (!fs.existsSync(file_name)) {
-							file_exists = false;
-							inline_errors.push(`Inline link [${link}] file does not exist.`);
-						}
-					}
-				}
-			}
-		}
-
-		return inline_errors;
-	};
-
-	const checkNavigation = async (source_path, flat_nav, excludes, draft_links) => {
-		const nav_errors = [];
-		for (const key in flat_nav) {
-			if (Object.hasOwn(flat_nav, key)) {
-				// doc paths should only contain a-z - characters
-				const invalid_chars = key.replace(regex_nav_paths, "");
-				if (invalid_chars !== "") {
-					nav_errors.push(
-						`Navigation path [${key}] contains the following invalid characters: [${[...invalid_chars].join("] [")}]`,
-					);
-				}
-				const key_split = key.split("#");
-				const key_no_hash = key_split[0];
-
-				// See if there's a redirect in place
-				let redirected = false;
-				let redirect_errored = false;
-				const redir = checkRedirect(source_path, key_no_hash);
-
-				if (redir.exists && redir.error !== null) {
-					nav_errors.push(redir.error);
-					redirect_errored = true;
-				} else if (redir.exists && redir.error === null) {
-					redirected = true;
-				}
-
-				// Validate path exists - key should be a html file at this point
-				let file_exists = true;
-				let file_name = path.join(source_path, `${key_no_hash}.html`);
-				if (!fs.existsSync(file_name)) {
-					file_name = path.join(source_path, `${key_no_hash}.htm`);
-					if (!fs.existsSync(file_name)) {
-						file_name = path.join(source_path, key_no_hash, "index.html");
-						if (!fs.existsSync(file_name)) {
-							file_name = path.join(source_path, key_no_hash, "index.htm");
-							if (!fs.existsSync(file_name)) {
-								file_exists = false;
-								if (!redirected && !redirect_errored && draft_links.indexOf(key_no_hash) === -1)
-									nav_errors.push(
-										`Navigation path [${key_no_hash}] file does not exist.`,
-									);
-							}
-						}
-					}
-				}
-
-				if (file_exists) {
-					// File exists - but is there a redirect? If so, we want to flag this as an error
-					if (redirected)
-						nav_errors.push(
-							`Navigation path [${key_no_hash}] is redirected, but path still exists.`,
-						);
-
-					// Check file path case match
-					const true_file = hdoc.true_case_path_sync(file_name)
-						.replace(source_path, "")
-						.replaceAll("\\", "/");
-					const relative_file = file_name
-						.replace(source_path, "")
-						.replaceAll("\\", "/");
-					if (true_file !== relative_file) {
-						nav_errors.push(
-							`Navigation path [${key}] for filename [${relative_file}] does not match filename case [${true_file}].`,
-						);
-					}
-				}
-
-				// Validate path spellings
-				const paths = key.split("/");
-				for (let i = 0; i < paths.length; i++) {
-					const path_words = paths[i].split("-");
-					for (let j = 0; j < path_words.length; j++) {
-						const translate_output = translator.translate(
-							path_words[j],
-							spellcheck_options,
-						);
-						if (Object.keys(translate_output).length) {
-							for (const spell_val in translate_output) {
-								if (Object.hasOwn(translate_output, spell_val)) {
-									for (const spelling in translate_output[spell_val][0]) {
-										if (
-											Object.hasOwn(translate_output[spell_val][0], spelling)
-										) {
-											if (!excludes[key]) {
-												nav_errors.push(
-													`Navigation path [${key}] key contains a British English spelling: ${spelling} should be ${translate_output[spell_val][0][spelling].details}`,
-												);
-											} else if (
-												!excludes[key].includes(spelling.toLowerCase())
-											) {
-												nav_errors.push(
-													`Navigation path [${key}] key contains a British English spelling: ${spelling} should be ${translate_output[spell_val][0][spelling].details}`,
-												);
-											}
-										}
-									}
-								}
-							}
-						}
-					}
-				}
-
-				// Validate display names/bookmarks
-				for (let i = 0; i < flat_nav[key].length; i++) {
-					if (flat_nav[key][i].link === key) {
-						const translate_output = translator.translate(
-							flat_nav[key][i].text,
-							spellcheck_options,
-						);
-						if (Object.keys(translate_output).length) {
-							for (const spell_val in translate_output) {
-								if (Object.hasOwn(translate_output, spell_val)) {
-									for (let j = 0; j < translate_output[spell_val].length; j++) {
-										for (const spelling in translate_output[spell_val][j]) {
-											if (
-												Object.hasOwn(translate_output[spell_val][j], spelling)
-											) {
-												if (!excludes[key]) {
-													nav_errors.push(
-														`Navigation path [${key}] display text contains a British English spelling: ${spelling} should be ${translate_output[spell_val][j][spelling].details}`,
-													);
-												} else if (
-													!excludes[key].includes(spelling.toLowerCase())
-												) {
-													nav_errors.push(
-														`Navigation path [${key}] display text contains a British English spelling: ${spelling} should be ${translate_output[spell_val][j][spelling].details}`,
-													);
-												}
-											}
-										}
-									}
-								}
-							}
-						}
-					}
-				}
-			}
-		}
-		return nav_errors;
-	};
-
-	const checkRedirects = async (source_path) => {
-		const redir_errors = [];
-		for (const key in redirects) {
-			if (Object.hasOwn(redirects, key)) {
-				if (
-					redirects[key].code !== 301 &&
-					redirects[key].code !== 308 &&
-					redirects[key].code !== 410
-				)
-					redir_errors.push(`Invalid redirect code: ${redirects[key].code}`);
-
-				if (redirects[key].location && !redirects[key].skip_location_validation) {
-					const redir_locations = [
-						path.join(source_path, `${redirects[key].location}.md`),
-						path.join(source_path, redirects[key].location, "index.md"),
-						path.join(source_path, `${redirects[key].location}.html`),
-						path.join(source_path, `${redirects[key].location}.htm`),
-						path.join(source_path, redirects[key].location, "index.html"),
-						path.join(source_path, redirects[key].location, "index.htm"),
-					];
-					let redir_location_ok = false;
-					for (let i = 0; i < redir_locations.length; i++) {
-						if (fs.existsSync(redir_locations[i])) {
-							redir_location_ok = true;
-							break;
-						}
-					}
-					if (!redir_location_ok)
-						redir_errors.push(
-							`Redirect location does not exist: ${redirects[key].location}`,
-						);
-				}
-			}
-		}
-		return redir_errors;
-	};
-
-	const checkRedirect = (source_path, nav_path) => {
-		const response = {
-			exists: false,
-			error: null,
-		};
-		if (redirects[nav_path]) {
-			response.exists = true;
-			if (redirects[nav_path].location) {
-
-				if (redirects[nav_path].skip_location_validation) return response;
-
-				// We have a redirect, check if it's a valid location
-				let file_path = path.join(
-					source_path,
-					`${redirects[nav_path].location}.html`,
-				);
-				if (!fs.existsSync(file_path)) {
-					file_path = path.join(
-						source_path,
-						`${redirects[nav_path].location}.htm`,
-					);
-					if (!fs.existsSync(file_path)) {
-						file_path = path.join(
-							source_path,
-							redirects[nav_path].location,
-							"index.html",
-						);
-						if (!fs.existsSync(file_path)) {
-							file_path = path.join(
-								source_path,
-								redirects[nav_path].location,
-								"index.htm",
-							);
-							if (!fs.existsSync(file_path)) {
-								response.error = `Redirect path for [${nav_path}] does not exist: ${redirects[nav_path].location}`;
-							}
-						}
-					}
-				}
-			}
-		}
-		return response;
-	};
-
-	const isHashAnchor = (html_file, hash_anchor, full_hash_anchor_link = "") => {
-		const markdown_paths = getMDPathFromHtmlPath(html_file);
-		const markdown_content = fs.readFileSync(markdown_paths.markdownPath, 'utf8');
-
-		try {
-			const file_content = fs.readFileSync(html_file.path, {
-				encoding: "utf-8",
-			});
-			const clean_hash_anchor = hash_anchor.startsWith("/")
-				? hash_anchor.substring(2, hash_anchor.length)
-				: hash_anchor.substring(1, hash_anchor.length);
-			if (
-				!file_content.includes(`<div id="hb-doc-anchor-${clean_hash_anchor}"`)
-			) {
-				const error_message = processErrorMessage(`Target hash anchor is not present in page content: ${full_hash_anchor_link !== "" ? full_hash_anchor_link : hash_anchor}`, markdown_paths.relativePath, markdown_content, full_hash_anchor_link);
-				errors[html_file.relativePath].push( error_message );
-			}
-		} catch (e) {
-			errors[html_file.relativePath].push(e);
-		}
-	};
-
-	const getMDPathFromHtmlPath = (htmlFile) => {
-		const returnPaths = {
-			markdownPath: htmlFile.path.replace(`.${htmlFile.extension}`, '.md'),
-			relativePath: htmlFile.relativePath.replace(`.${htmlFile.extension}`, '.md')
-		};
-		if (!fs.existsSync(returnPaths.markdownPath)) {
-			// No matching markdown
-			returnPaths.markdownPath = htmlFile.path;
-		}
-		return returnPaths;
-	}
-
-	// Headers that mimic a real Chrome browser request — sites doing bot detection
-	// check far more than just User-Agent (Accept, Sec-Fetch-*, client hints, etc.).
-	const _fetch_headers = {
-		'User-Agent':      'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36',
-		'Accept':          'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8',
-		'Accept-Language': 'en-US,en;q=0.9',
-		'Accept-Encoding': 'gzip, deflate, br',
-		'Cache-Control':   'no-cache',
-		'Pragma':          'no-cache',
-		'Sec-Fetch-Dest':  'document',
-		'Sec-Fetch-Mode':  'navigate',
-		'Sec-Fetch-Site':  'none',
-		'Sec-Fetch-User':  '?1',
-		'Sec-Ch-Ua':       '"Google Chrome";v="131", "Chromium";v="131", "Not_A Brand";v="24"',
-		'Sec-Ch-Ua-Mobile':   '?0',
-		'Sec-Ch-Ua-Platform': '"Windows"',
-		'Upgrade-Insecure-Requests': '1',
-	};
-
-	// Checks a single external URL by sending a HEAD request, falling back to GET
-	// if the server returns 405 (Method Not Allowed) or 404 (some servers, e.g.
-	// marketplace.visualstudio.com, return 404 for HEAD even when the page exists).
-	// Retries up to 5 times on transient errors (5xx, 429, network failures).
-	// Returns the HTTP status code.
-	const fetchExternalLinkStatus = async (url) => {
-		const opts = { method: 'HEAD', headers: _fetch_headers, timeoutMs: 10000, redirect: 'follow' };
-		const resp = await hdoc.fetchWithRetry(url, opts);
-		if (resp.status === 404 || resp.status === 405) {
-			const getResp = await hdoc.fetchWithRetry(url, { ...opts, method: 'GET' });
-			return getResp.status;
-		}
-		return resp.status;
-	};
-
-	// Map an inter-book check result onto errors/warnings/messages and the
-	// validated-links cache. 'ok' and 'skip' outcomes are stable, so they are
-	// appended to validated-links.txt like any other passing link.
-	const handleInterbookResult = (result, link, htmlFile, markdown_paths, markdown_content) => {
-		if (result.level === "error") {
-			errors[htmlFile.relativePath].push(
-				processErrorMessage(result.message, markdown_paths.relativePath, markdown_content, link),
-			);
-		} else if (result.level === "warning") {
-			warnings[htmlFile.relativePath].push(
-				processErrorMessage(result.message, markdown_paths.relativePath, markdown_content, link),
-			);
-		} else {
-			messages[htmlFile.relativePath].push(result.message);
-			fs.appendFileSync(skip_link_file, `${link}\n`);
-		}
-	};
-
-	const checkLinks = async (source_path, htmlFile, links, hdocbook_config, hdocbook_project, global_links_checked, output_links) => {
-		const markdown_paths = getMDPathFromHtmlPath(htmlFile);
-		const markdown_content = fs.readFileSync(markdown_paths.markdownPath, 'utf8');
-
-		// Resolve the "are we on the internal network?" question once per process
-		// rather than once per internal.hornbill.com link.
-		const ensureIntNetCached = async () => {
-			if (_on_int_net_cached === null) {
-				try {
-					_on_int_net_cached = await checkHostExistsInDNS('docs-internal.hornbill.com');
-				} catch (_e) {
-					_on_int_net_cached = false;
-				}
-			}
-			return _on_int_net_cached;
-		};
-
-		// Collect external links that need an HTTP check so they can be run
-		// concurrently rather than one-at-a-time.
-		const externalChecks = [];
-
-		for (let i = 0; i < links.length; i++) {
-			if (output_links) console.log(` - ${links[i]}`);
-			if (exclude_links[links[i]]) continue;
-			if (global_links_checked.includes(links[i])) continue;
-			global_links_checked.push(links[i]);
-
-			const valid_url = hdoc.valid_url(links[i]);
-			if (!valid_url) {
-				// Could be a relative path, check
-				if (links[i].startsWith("#") || links[i].startsWith("/#")) {
-					//Flat Anchor - validate we have a same-file hit
-					isHashAnchor(htmlFile, links[i]);
-				} else if (links[i].startsWith("/") && !links[i].startsWith("/#")) {
-					let link_segments = links[i].split("/");
-					if (link_segments[0] === "") link_segments.shift();
-					const link_root = link_segments[0] === "_books" ? link_segments[1] : link_segments[0];
-
-					// Check for links with a _books path that have no specific file target
-					// We do need to exclude those with an extension though, for pages that link downloadable resources
-					if (link_segments[0] === "_books" && path.extname(links[i]) === '') {
-						const error_message = processErrorMessage(`Root relative page links should not include _books in the path: ${links[i]}`, markdown_paths.relativePath, markdown_content, links[i]);
-						errors[htmlFile.relativePath].push(error_message);
-					}
-
-					// Links into other books: verified against GitHub when a token
-					// was supplied, otherwise skipped (can't validate locally).
-					if ((link_segments.length > 1 && link_root !== hdocbook_config.docId) || (link_segments.length === 1 && link_root !== hdocbook_config.docId && link_root !== "index")) {
-						if (interbook.enabled() && path.extname(links[i].split("#")[0]) === "") {
-							const link = links[i];
-							externalChecks.push(async () =>
-								handleInterbookResult(
-									await interbook.check_link(link),
-									link,
-									htmlFile,
-									markdown_paths,
-									markdown_content,
-								),
-							);
-						} else {
-							fs.appendFileSync(skip_link_file, `${links[i]}\n`);
-						}
-						continue;
-					}
-					isRelativePath(source_path, htmlFile, links[i]);
-				} else {
-					const error_message = processErrorMessage(`Root relative links should start with a forward-slash: ${links[i]}`, markdown_paths.relativePath, markdown_content, links[i]);
-					errors[htmlFile.relativePath].push(error_message);
-				}
-			} else {
-				messages[htmlFile.relativePath].push(
-					`Link is a properly formatted external URL: ${links[i]}`,
-				);
-
-				// Skip if it's the auto-generated edit url, as these could be part of a private repo which would return a 404
-				// publicSource must be truthy, not just defined - an empty string makes
-				// get_github_api_path return "" which has no edit_path
-				if (
-					hdocbook_config.publicSource &&
-					links[i] ===
-					hdoc
-					.get_github_api_path(
-						hdocbook_config.publicSource,
-						htmlFile.relativePath,
-					)
-					.edit_path.replace(path.extname(htmlFile.relativePath), ".md")
-				) {
-					fs.appendFileSync(skip_link_file, `${links[i]}\n`);
-					continue;
-				}
-
-				if (valid_url.protocol === "mailto:") {
-					fs.appendFileSync(skip_link_file, `${links[i]}\n`);
-					continue;
-				}
-
-				// Skip if the link is excluded in the project config
-				if (excludeLink(links[i])) {
-					messages[htmlFile.relativePath].push(
-						`Skipping link validation for: ${links[i]}`,
-					);
-					continue;
-				}
-
-				if (
-					(links[i].toLowerCase().includes("docs.hornbill.com") ||
-					links[i].toLowerCase().includes("docs-internal.hornbill.com")) &&
-					!markdown_paths.relativePath.includes('/_inline/')
-				) {
-					const error_message = processErrorMessage(`Hornbill Docs links should not be fully-qualified: ${links[i]}`, markdown_paths.relativePath, markdown_content, links[i]);
-					errors[htmlFile.relativePath].push(error_message);
-					continue;
-				}
-
-				if (
-					links[i].toLowerCase().includes("docs-internal.hornbill.com") &&
-					markdown_paths.relativePath.includes('/_inline/') &&
-					!private_repo
-				) {
-					// Is the parent book in a public repo? If so, flag this as an error.
-					const error_message = processErrorMessage(`Hornbill docs-internal links should not be used in public book inline content: ${links[i]}`, markdown_paths.relativePath, markdown_content, links[i]);
-					errors[htmlFile.relativePath].push(error_message);
-					continue;
-				}
-
-				// Fully-qualified Hornbill Docs links (only permitted in _inline
-				// content — anything else errored above): with a GitHub token,
-				// validate book/article/anchor instead of a plain HTTP check.
-				const link_host = valid_url.hostname ? valid_url.hostname.toLowerCase() : "";
-				if (
-					interbook.enabled() &&
-					(link_host === "docs.hornbill.com" || link_host === "docs-internal.hornbill.com") &&
-					path.extname(valid_url.pathname) === ""
-				) {
-					const link = links[i];
-					const book_link = valid_url.pathname + valid_url.hash;
-					externalChecks.push(async () =>
-						handleInterbookResult(
-							await interbook.check_link(book_link),
-							link,
-							htmlFile,
-							markdown_paths,
-							markdown_content,
-						),
-					);
-					continue;
-				}
-
-				// Capture url in closure for the async check below
-				const url = links[i];
-				const isInternal = url.toLowerCase().includes("internal.hornbill.com");
-
-				externalChecks.push(async () => {
-					// For internal.hornbill.com links, check network reachability first (result cached)
-					if (isInternal) {
-						const on_int_net = await ensureIntNetCached();
-						if (!on_int_net) {
-							messages[htmlFile.relativePath].push(
-								`Outside of Hornbill network - skipping internal link validation for: ${url}`,
-							);
-							fs.appendFileSync(skip_link_file, `${url}\n`);
-							return;
-						}
-						messages[htmlFile.relativePath].push(
-							`Inside of Hornbill network - performing internal link validation for: ${url}`,
-						);
-					}
-
-					try {
-						const status = await fetchExternalLinkStatus(url);
-						if ((status < 200 || status > 299) && status !== 304) {
-							if (process.env.GITHUB_ACTIONS === 'true' && status === 403 && url.includes(".hornbill.com")) {
-								// Always returns 403 for Hornbill sites through GitHub Actions — not a real error
-							} else {
-								throw `Unexpected Status Returned: ${status}`;
-							}
-						} else {
-							fs.appendFileSync(skip_link_file, `${url}\n`);
-						}
-					} catch (e) {
-						let error_message;
-						if (e instanceof AggregateError) {
-							error_message = processErrorMessage(`Issue with external link [${url}]: ${e.message} - ${JSON.stringify(e.errors)}`, markdown_paths.relativePath, markdown_content, url);
-						} else {
-							error_message = processErrorMessage(`Issue with external link [${url}]: ${e}`, markdown_paths.relativePath, markdown_content, url);
-						}
-						if (hdocbook_project.validation.external_link_warnings || process.env.GITHUB_ACTIONS === 'true')
-							warnings[htmlFile.relativePath].push(error_message);
-						else
-							errors[htmlFile.relativePath].push(error_message);
-					}
-				});
-			}
-		}
-
-		// Run all external HTTP checks concurrently — fetch is lightweight enough
-		// that uncapped concurrency is fine for the link counts seen in practice.
-		await Promise.all(externalChecks.map(fn => fn()));
-	};
-
-	const checkHostExistsInDNS = async (hostname) => {
-		return new Promise((resolve, reject) => {
-			dns.lookup(hostname, { all:true }, (err, addresses) => {
-				if (err) {
-					reject(err);
-				} else {
-					resolve(addresses !== undefined);
-				}
-			});
-		});
-	}
-
-	const checkImages = async (source_path, htmlFile, links) => {
-		const markdown_paths = getMDPathFromHtmlPath(htmlFile);
-		const markdown_content = fs.readFileSync(markdown_paths.markdownPath, 'utf8');
-		for (let i = 0; i < links.length; i++) {
-			// Validate that image is a valid URL first
-			if (!hdoc.valid_url(links[i])) {
-
-				if (!links[i].startsWith("/") && !markdown_paths.relativePath.includes('/_inline/')) {
-					const error_message = processErrorMessage(`Root relative image links should start with a forward-slash: ${links[i]}`, markdown_paths.relativePath, markdown_content, links[i]);
-					errors[htmlFile.relativePath].push(error_message);
-				}
-
-				// Could be a relative path, check image exists
-				doesFileExist(source_path, htmlFile, links[i], markdown_paths.relativePath, markdown_content);
-			} else {
-				messages[htmlFile.relativePath].push(
-					`Image link is a properly formatted external URL: ${links[i]}`,
-				);
-				// Do a Get to the URL to see if it exists
-				try {
-					const img_response = await fetch(links[i]);
-					if (!img_response.ok) throw new Error(`HTTP ${img_response.status}`);
-					messages[htmlFile.relativePath].push(
-						`Image link is a valid external URL: ${links[i]}`,
-					);
-				} catch (e) {
-					// Handle errors
-					const error_message = processErrorMessage(`External image link error: ${links[i]} - ${e.message}`, markdown_paths.relativePath, markdown_content, links[i]);
-					errors[htmlFile.relativePath].push(error_message);
-				}
-			}
-		}
-	};
-
-	const checkTags = async (htmlFile) => {
-		const markdown_paths = getMDPathFromHtmlPath(htmlFile);
-		// Check if file  is excluded from tag check
-		const file_no_ext = htmlFile.relativePath.replace(
-			path.extname(htmlFile.relativePath),
-			"",
-		);
-		if (exclude_h1_count[file_no_ext]) return;
-
-		// Check tags
-		const htmlBody = fs.readFileSync(htmlFile.path, "utf8");
-		const $ = cheerio.load(htmlBody);
-
-		const h1_tags = $("h1")
-			.map(function () {
-				return $(this);
-			})
-			.get();
-		if (h1_tags.length && h1_tags.length > 1) {
-			let error_msg = `${h1_tags.length} <h1> tags found in content: `;
-			for (let i = 0; i < h1_tags.length; i++) {
-				error_msg += h1_tags[i].text();
-				if (i < h1_tags.length - 1) error_msg += "; ";
-			}
-			errors[htmlFile.relativePath].push(`${markdown_paths.relativePath} - ${error_msg}`);
-		}
-	};
-
-	const dreeOptions = {
-		descendants: true,
-		excludeEmptyDirectories: true,
-		extensions: ["htm", "html", "md"],
-		hash: false,
-		normalize: true,
-		size: false,
-		sizeInBytes: false,
-		stat: false,
-		symbolicLinks: false,
-	};
-
-	// File scan callback for content type files
-	const fileContentCallback = (element) => {
-		if (element.extension.toLowerCase() === "md") {
-			md_to_validate.push(element);
-		} else {
-			html_to_validate.push(element);
-		}
-	};
-
-	const isRelativePath = (source_path, html_path, relative_path) => {
-		const markdown_paths = getMDPathFromHtmlPath(html_path);
-		const markdown_content = fs.readFileSync(markdown_paths.markdownPath, 'utf8');
-
-		const rel_path_ext = path.extname(relative_path);
-		const response = {
-			is_rel_path: false,
-			has_md_extension: rel_path_ext === ".md",
-			has_html_extension: rel_path_ext === ".htm" || rel_path_ext === ".html",
-		};
-		const supported_relpaths = [
-			`${path.sep}index.htm`,
-			`${path.sep}index.html`,
-			".htm",
-			".html",
-			".md",
-		];
-
-		// Remove explicit anchor links and _books prefix
-		const clean_relative_path = relative_path
-			.split("#")[0]
-			.replace("_books/", "");
-
-		let hash_anchor = null;
-		if (relative_path.split("#")[1])
-			hash_anchor = `#${relative_path.split("#")[1]}`;
-
-		// Make full file path
-		const file_path = path.join(source_path, clean_relative_path);
-
-		// Does path exist?
-		if (fs.existsSync(file_path)) {
-			response.is_rel_path = true;
-		} else {
-			// Path
-			for (let i = 0; i < supported_relpaths.length; i++) {
-				const html_file_path = `${file_path}${supported_relpaths[i]}`;
-				if (fs.existsSync(html_file_path)) {
-					response.is_rel_path = true;
-
-					// Check for hash anchor
-					if (hash_anchor !== null) {
-						isHashAnchor(
-							{ path: html_file_path, relativePath: html_path.relativePath, extension: html_path.extension },
-							hash_anchor,
-							relative_path,
-						);
-					}
-					break;
-				}
-			}
-		}
-		if (response.has_md_extension || response.has_html_extension) {
-			const error_message = processErrorMessage(`Relative link has ${rel_path_ext} extension, but should not: ${relative_path}`, markdown_paths.relativePath, markdown_content, relative_path);
-			errors[html_path.relativePath].push(error_message);
-			return;
-		}
-		if (response.is_rel_path) {
-			messages[html_path.relativePath].push(
-				`Relative path exists: ${clean_relative_path}`,
-			);
-			return;
-		}
-
-		// See if there's a redirect in place
-		const relpath =
-			clean_relative_path.indexOf("/") === 0
-				? clean_relative_path.substring(1)
-				: clean_relative_path;
-		const redir = checkRedirect(source_path, relpath);
-		if (redir.exists) {
-			if (redir.error !== null) {
-				const error_message = processErrorMessage(`${redir.error}: ${relative_path}`, markdown_paths.relativePath, markdown_content, clean_relative_path);
-				errors[html_path.relativePath].push(error_message);
-			}
-		} else {
-			const error_message = processErrorMessage(`Link path does not exist: ${relative_path}`, markdown_paths.relativePath, markdown_content, clean_relative_path);
-			errors[html_path.relativePath].push(error_message);
-		}
-	};
-
-	const processErrorMessage = (message, md_path, content, search) => {
-		// whole_link — a link that is a substring of a longer link elsewhere in
-		// the file must not be located at the longer link's position
-		const link_location = hdoc.find_string_in_string(content, search, true);
-		let error_message = message;
-		if (link_location !== null)
-			error_message = `${md_path}:${link_location.line}:${link_location.column} - ${error_message}`;
-		else
-			error_message = `${md_path} - ${error_message}`;
-		return error_message;
-	};
-	
-	const doesFileExist = (source_path, html_path, relative_path, markdown_path, markdown_content) => {
-		// Remove explicit anchor links and _books prefix
-		const clean_relative_path = relative_path
-			.split("#")[0]
-			.replace("_books/", "");
-		const file_path = path.join(source_path, clean_relative_path);
-		if (
-			!fs.existsSync(file_path) &&
-			!fs.existsSync(`${file_path + path.sep}index.htm`) &&
-			!fs.existsSync(`${file_path}index.html`) &&
-			!fs.existsSync(`${file_path}.htm`) &&
-			!fs.existsSync(`${file_path}.html`)
-		) {
-			const error_message = processErrorMessage(`Book resource does not exist: ${clean_relative_path}`, markdown_path, markdown_content, relative_path);
-			errors[html_path.relativePath].push(error_message);
-			return false;
-		}
-		messages[html_path.relativePath].push(
-			`Book resource exists: ${clean_relative_path}`,
-		);
-		return true;
-	};
-
-	// Takes a dree element, returns an object with a pair of arrays
-	const getLinks = (file) => {
-		messages[file.relativePath].push("Parsing HTML file");
-		const htmlBody = fs.readFileSync(file.path, "utf8");
-		const links = {
-			href: [],
-			img: [],
-		};
-		const $ = cheerio.load(htmlBody);
-		const hrefs = $("a")
-			.map(function (i) {
-				return $(this).attr("href");
-			})
-			.get();
-		const srcs = $("img")
-			.map(function (i) {
-				if ($(this).attr("alt") === undefined || $(this).attr("alt").trim() === "") {
-					errors[file.relativePath].push(`Image tag with src [${$(this).attr("src")}] is missing alt attribute.`);
-				}
-				return $(this).attr("src");
-			})
-			.get();
-		links.href.push(...hrefs);
-		links.img.push(...srcs);
-		return links;
-	};
-
-	exports.run = async (
-		source_path,
-		doc_id,
-		verbose,
-		hdocbook_config,
-		hdocbook_project,
-		nav_items,
-		prod_families,
-		prods_supported,
-		gen_exclude,
-		gen_redirects,
-		draft_links,
-		is_private,
-		browser,
-		source_root_path,
-		output_links = true,
-		git_token = "",
-	) => {
-		console.log("Performing Validation and Building SEO Link List...");
-		redirects = gen_redirects;
-		private_repo = is_private;
-		interbook.init(git_token);
-		if (interbook.enabled())
-			console.log(
-				"GitHub token supplied - inter-book links will be validated against GitHub",
-			);
-
-		// Load the skip link validation file if it exists
-		loadSkipLinkValidation(source_root_path);
-
-		// Get a list of HTML files in source_path
-		hdoc.scan_dir(source_path, dreeOptions, fileContentCallback);
-
-		// Check product family
-		let valid_product = false;
-		const meta_errors = [];
-		for (let i = 0; i < prod_families.products.length; i++) {
-			if (prod_families.products[i].id === hdocbook_config.productFamily) {
-				valid_product = true;
-			}
-		}
-		if (!valid_product) {
-			let val_prod_error = `Incorrect productFamily: ${hdocbook_config.productFamily}. Supported values:`;
-			for (let i = 0; i < prods_supported.length; i++) {
-				val_prod_error += `\n  - ${prods_supported[i]}`;
-			}
-			meta_errors.push(val_prod_error);
-		}
-
-		if (hdocbook_config.publicSource && hdocbook_config.publicSource !== "") {
-			// Validate publicSource
-			if (hdocbook_config.publicSource.toLowerCase() === "--publicsource--") {
-				meta_errors.push(
-					"Value for publicSource in book metadata is set to its default template value",
-				);
-			} else {
-				// Check URL exists
-				if (
-					!hdocbook_config.publicSource.startsWith("https://github.com") &&
-					!hdocbook_config.publicSource.startsWith("https://api.github.com")
-				) {
-					meta_errors.push(
-						`Value for publicSource in book metadata is not a recognised GitHub URL: ${hdocbook_config.publicSource}`,
-					);
-				}
-			}
-		}
-
-		if (
-			!hdocbook_config.audience ||
-			!Array.isArray(hdocbook_config.audience) ||
-			hdocbook_config.audience.length === 0
-		) {
-			meta_errors.push(
-				"Property audience of type array in book metadata is mandatory.",
-			);
-		}
-		if (hdocbook_project.validation) {
-			if (
-				hdocbook_project.validation.exclude_links &&
-				Array.isArray(hdocbook_project.validation.exclude_links)
-			) {
-				for (const excl_link of hdocbook_project.validation.exclude_links) {
-					exclude_links[excl_link] = true;
-				}
-			}
-			if (
-				hdocbook_project.validation.exclude_spellcheck &&
-				Array.isArray(hdocbook_project.validation.exclude_spellcheck)
-			) {
-				for (const excl_sc of hdocbook_project.validation.exclude_spellcheck) {
-
-					if (exclude_spellcheck[excl_sc.document_path] !== undefined) {
-						meta_errors.push(
-							"Document path is duplicated in exclude_spellcheck validation array: " + excl_sc.document_path,
-						);
-					}
-					exclude_spellcheck[excl_sc.document_path] = excl_sc.words;
-				}
-			}
-			if (
-				hdocbook_project.validation.exclude_h1_count &&
-				Array.isArray(hdocbook_project.validation.exclude_h1_count)
-			) {
-				for (const excl_h1 of hdocbook_project.validation.exclude_h1_count) {
-					exclude_h1_count[excl_h1] = true;
-				}
-			}
-		}
-
-		if (hdocbook_project.validation && Array.isArray(hdocbook_project.validation.spellcheckDictionary)) global_spellcheck = hdocbook_project.validation.spellcheckDictionary.map((w) => String(w).toLowerCase());
-
-		// Check navigation spellings & paths exist
-		const nav_errors = await checkNavigation(
-			source_path,
-			nav_items,
-			exclude_spellcheck,
-			draft_links,
-		);
-		if (nav_errors.length > 0) meta_errors.push(...nav_errors);
-
-		// Check inline content spellings & paths exist
-		if (hdocbook_config.inline && hdocbook_config.inline.length > 0) {
-			const inline_errors = await checkInline(
-				source_path,
-				hdocbook_config.inline,
-				exclude_spellcheck,
-			);
-			if (inline_errors.length > 0) meta_errors.push(...inline_errors);
-		}
-
-		// Check redirects
-		const redirect_errors = await checkRedirects(source_path);
-		if (redirect_errors.length > 0) meta_errors.push(...redirect_errors);
-
-		if (meta_errors.length > 0) {
-			console.log("\r\n-----------------------");
-			console.log("   Validation Output   ");
-			console.log("-----------------------");
-			for (let i = 0; i < meta_errors.length; i++) {
-				console.error(`- ${meta_errors[i]}`);
-			}
-			console.error(`\r\n${meta_errors.length} Validation Errors Found`);
-			return false;
-		}
-
-		const excl_output = [];
-
-		// Do spellchecking on markdown files
-		const md_files_spellchecked = {};
-		const mdPromiseArray = [];
-		for (let i = 0; i < md_to_validate.length; i++) {
-			errors[md_to_validate[i].relativePath] = [];
-			messages[md_to_validate[i].relativePath] = [];
-			warnings[md_to_validate[i].relativePath] = [];
-			mdPromiseArray.push(md_to_validate[i]);
-		}
-		await Promise.all(
-			mdPromiseArray.map(async (file) => {
-				// Initiate maps for errors and verbose messages for markdown file
-				const exclusions = await spellcheckContent(file, exclude_spellcheck);
-				if (gen_exclude && exclusions.length > 0)
-					excl_output.push({
-						document_path: file.relativePath.replace(`.${file.extension}`, ""),
-						words: exclusions,
-					});
-				md_files_spellchecked[
-					file.relativePath.replace(`.${file.extension}`, "")
-				] = true;
-			}),
-		);
-
-		// Perform rest of validation against HTML files
-		const htmlPromiseArray = [];
-		for (let i = 0; i < html_to_validate.length; i++) {
-			errors[html_to_validate[i].relativePath] = [];
-			messages[html_to_validate[i].relativePath] = [];
-			warnings[html_to_validate[i].relativePath] = [];
-			htmlPromiseArray.push(html_to_validate[i]);
-		}
-
-		
-		const global_links_checked = [];
-
-		for (const key in html_to_validate) {
-			const file = html_to_validate[key];
-			// Check for British spellings in static HTML content
-			if (
-				!md_files_spellchecked[
-					file.relativePath.replace(`.${file.extension}`, "")
-				]
-			) {
-				const exclusions = await spellcheckContent(file, exclude_spellcheck);
-				if (gen_exclude && exclusions.length > 0)
-					excl_output.push({
-						document_path: file.relativePath.replace(
-							`.${file.extension}`,
-							"",
-						),
-						words: exclusions,
-					});
-			}
-
-			const links = getLinks(file);
-			if (links.href.length === 0) {
-				messages[file.relativePath].push("No links found in file");
-			} else {
-				console.log(`\r\nChecking ${links.href.length} Links in ${file.relativePath}`);
-				await checkLinks(source_path, file, links.href, hdocbook_config, hdocbook_project, global_links_checked, output_links);
-			}
-			if (links.img.length === 0) {
-				messages[file.relativePath].push("No images found in file");
-			} else {
-				await checkImages(source_path, file, links.img);
-			}
-
-			// Check for multiple H1 tags
-			await checkTags(file);
-		}
-
-		if (gen_exclude) console.log(JSON.stringify(excl_output, null, 2));
-
-		if (verbose) {
-			console.log("\r\n-------------");
-			console.log("   Verbose   ");
-			console.log("-------------");
-			for (const key in messages) {
-				if (Object.hasOwn(messages, key) && messages[key].length > 0) {
-					console.log(`\r\nMessage output for ${key}`);
-					for (let i = 0; i < messages[key].length; i++) {
-						console.log(` - ${messages[key][i]}`);
-					}
-				}
-			}
-		}
-
-		console.log("\r\n-----------------------");
-		console.log("   Validation Output   ");
-		console.log("-----------------------");
-		let warning_count = 0;
-		for (const key in warnings) {
-			if (Object.hasOwn(warnings, key) && warnings[key].length > 0) {
-				for (let i = 0; i < warnings[key].length; i++) {
-					console.info(`[WARNING] ${key} - ${warnings[key][i]}`);
-					warning_count++;
-				}
-			}
-		}
-		if (warning_count > 0) {
-			console.info(`\r\n${warning_count} Validation Warnings Found (non-fatal)\r\n`);
-		}
-		if (Object.keys(errors).length > 0) {
-			let error_count = 0;
-			for (const key in errors) {
-				if (Object.hasOwn(errors, key) && errors[key].length > 0) {
-					for (let i = 0; i < errors[key].length; i++) {
-						console.error(`${key} - ${errors[key][i]}`);
-						error_count++;
-					}
-				}
-			}
-			if (error_count > 0) {
-				console.error(`\r\n${error_count} Validation Errors Found`);
-				if (verbose) {
-					console.log("\n");
-					console.error(JSON.stringify(exclude_spellcheck_output, null, 2));
-				}
-				return false;
-			}
-		}
-
-		console.log("\r\nNo Validation Errors Found!\n");
-		return true;
-	};
-})();
+(() => {
+	const cheerio = require("cheerio");
+	const dns = require("node:dns");
+	const fs = require("node:fs");
+	const path = require("node:path");
+	const hdoc = require(path.join(__dirname, "hdoc-module.js"));
+	const interbook = require(path.join(__dirname, "hdoc-validate-interbook.js"));
+	const translator = require("american-british-english-translator");
+
+	const spellcheck_options = {
+		british: true,
+		spelling: true,
+	};
+	const regex_nav_paths = /[a-z0-9-\/]+[a-z0-9]+#{0,1}[a-z0-9-\/]+/;
+
+	const errors = {};
+	const messages = {};
+	const warnings = {};
+	const html_to_validate = [];
+	const md_to_validate = [];
+	const exclude_links = {};
+	const exclude_spellcheck = {};
+	let private_repo = false;
+	let redirects = {};
+	let skip_link_file = '';
+	let _on_int_net_cached = null; // null = not yet checked; cached after first DNS lookup
+	const exclude_h1_count = {};
+	const exclude_spellcheck_output = [];
+	let global_spellcheck = [];
+
+	const excludeLink = (url) => {
+		if (exclude_links[url]) return true;
+		for (let key in exclude_links) {
+			if (Object.hasOwn(exclude_links, key)) {
+				if (key.endsWith("*")) {
+					key = key.substring(0, key.length - 1);
+					if (url.startsWith(key)) return true;
+				}
+			}
+		}
+		return false;
+	};
+
+	const loadSkipLinkValidation = (source_path) => {
+		skip_link_file = path.join(source_path, "validated-links.txt");
+		if (fs.existsSync(skip_link_file)) {
+			console.log(`Loading skip link validation file from: ${skip_link_file}`);
+			const skip_links = fs.readFileSync(skip_link_file, "utf8").split("\n");
+			for (let i = 0; i < skip_links.length; i++) {
+				if (skip_links[i].trim() !== "") {
+					exclude_links[skip_links[i].trim()] = true;
+				}
+			}
+		} else {
+			//Create the file if it doesn't exist
+			console.log(`Creating skip link validation file: ${skip_link_file}`);
+			fs.writeFileSync(skip_link_file, "", "utf8");
+		}
+	};
+
+	const spellcheckContent = async (sourceFile, excludes) => {
+		const spelling_errors = {};
+		const words = [];
+		const text = fs.readFileSync(sourceFile.path, "utf8");
+		const source_path = sourceFile.relativePath.replace(
+			`.${sourceFile.extension}`,
+			"",
+		);
+
+		const markdown_paths = getMDPathFromHtmlPath(sourceFile);
+
+		const translate_output = translator.translate(text, spellcheck_options);
+		if (Object.keys(translate_output).length) {
+			for (const key in translate_output) {
+				if (Object.hasOwn(translate_output, key)) {
+					// key is the line of text 
+					let error_message = `British spelling:`;
+					for (let i = 0; i < translate_output[key].length; i++) {
+						for (const spelling in translate_output[key][i]) {
+							if (
+								Object.hasOwn(translate_output[key][i], spelling) &&
+								typeof translate_output[key][i][spelling].details === "string"
+							) {
+								const link_location = hdoc.find_string_in_string(text.split('\n')[key - 1], spelling);
+								if (link_location !== null)
+									error_message = `${markdown_paths.relativePath}:${key}:${link_location.column} - ${error_message}`;
+								else
+									error_message = `${markdown_paths.relativePath}:${key} - ${error_message}`;
+								if (!excludes[source_path] && !global_spellcheck.includes(spelling.toLowerCase())) {
+									errors[sourceFile.relativePath].push(
+										`${error_message} ${spelling} should be ${translate_output[key][i][spelling].details}`,
+									);
+									spelling_errors[spelling] = true;
+								} else if (
+									!excludes[source_path].includes(spelling.toLowerCase()) && !global_spellcheck.includes(spelling.toLowerCase())
+								) {
+									errors[sourceFile.relativePath].push(
+										`${error_message} ${spelling} should be ${translate_output[key][i][spelling].details}`,
+									);
+									spelling_errors[spelling] = true;
+								}
+							}
+						}
+					}
+				}
+			}
+		}
+		if (Object.keys(spelling_errors).length) {
+			const exclude_output = {
+				document_path: sourceFile.relativePath.replace(
+					path.extname(sourceFile.relativePath),
+					"",
+				),
+				words: [],
+			};
+			for (const word in spelling_errors) {
+				if (Object.hasOwn(spelling_errors, word)) {
+					words.push(word);
+					exclude_output.words.push(word);
+				}
+			}
+			exclude_spellcheck_output.push(exclude_output);
+		}
+		return words;
+	};
+
+	const checkInline = async (source_path, inline, excludes) => {
+		const inline_errors = [];
+		for (let i = 0; i < inline.length; i++) {
+			const title = inline[i].title;
+			const link = inline[i].link;
+
+			// Validate link segment spellings
+			const paths = link.split("/");
+			for (let i = 0; i < paths.length; i++) {
+				const path_words = paths[i].split("-");
+				for (let j = 0; j < path_words.length; j++) {
+					const translate_output = translator.translate(
+						path_words[j],
+						spellcheck_options,
+					);
+					if (Object.keys(translate_output).length) {
+						for (const spell_val in translate_output) {
+							if (Object.hasOwn(translate_output, spell_val)) {
+								for (const spelling in translate_output[spell_val][0]) {
+									if (Object.hasOwn(translate_output[spell_val][0], spelling)) {
+										if (!excludes[link]) {
+											inline_errors.push(
+												`Inline Link [${link}] contains a British English spelling: ${spelling} should be ${translate_output[spell_val][0][spelling].details}`,
+											);
+										} else if (
+											!excludes[link].includes(spelling.toLowerCase())
+										) {
+											inline_errors.push(
+												`Inline Link [${link}] contains a British English spelling: ${spelling} should be ${translate_output[spell_val][0][spelling].details}`,
+											);
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+
+			// Validate display names
+			const translate_output = translator.translate(title, spellcheck_options);
+			if (Object.keys(translate_output).length) {
+				for (const spell_val in translate_output) {
+					if (Object.hasOwn(translate_output, spell_val)) {
+						for (let j = 0; j < translate_output[spell_val].length; j++) {
+							for (const spelling in translate_output[spell_val][j]) {
+								if (Object.hasOwn(translate_output[spell_val][j], spelling)) {
+									if (!excludes[link]) {
+										inline_errors.push(
+											`Inline title for link [${link}] contains a British English spelling: ${spelling} should be ${translate_output[spell_val][j][spelling].details}`,
+										);
+									} else if (!excludes[link].includes(spelling.toLowerCase())) {
+										inline_errors.push(
+											`Inline title for link [${link}] contains a British English spelling: ${spelling} should be ${translate_output[spell_val][j][spelling].details}`,
+										);
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+
+			// Validate path exists - link should be a html file at this point as its after the content has been built
+			let file_exists = true;
+			let file_name = path.join(source_path, `${link}.html`);
+			if (!fs.existsSync(file_name)) {
+				file_name = path.join(source_path, `${link}.htm`);
+				if (!fs.existsSync(file_name)) {
+					file_name = path.join(source_path, link, "index.html");
+					if (!fs.existsSync(file_name)) {
+						file_name = path.join(source_path, link, "index.htm");
+						if (!fs.existsSync(file_name)) {
+							file_exists = false;
+							inline_errors.push(`Inline link [${link}] file does not exist.`);
+						}
+					}
+				}
+			}
+		}
+
+		return inline_errors;
+	};
+
+	const checkNavigation = async (source_path, flat_nav, excludes, draft_links) => {
+		const nav_errors = [];
+		for (const key in flat_nav) {
+			if (Object.hasOwn(flat_nav, key)) {
+				// doc paths should only contain a-z - characters
+				const invalid_chars = key.replace(regex_nav_paths, "");
+				if (invalid_chars !== "") {
+					nav_errors.push(
+						`Navigation path [${key}] contains the following invalid characters: [${[...invalid_chars].join("] [")}]`,
+					);
+				}
+				const key_split = key.split("#");
+				const key_no_hash = key_split[0];
+
+				// See if there's a redirect in place
+				let redirected = false;
+				let redirect_errored = false;
+				const redir = checkRedirect(source_path, key_no_hash);
+
+				if (redir.exists && redir.error !== null) {
+					nav_errors.push(redir.error);
+					redirect_errored = true;
+				} else if (redir.exists && redir.error === null) {
+					redirected = true;
+				}
+
+				// Validate path exists - key should be a html file at this point
+				let file_exists = true;
+				let file_name = path.join(source_path, `${key_no_hash}.html`);
+				if (!fs.existsSync(file_name)) {
+					file_name = path.join(source_path, `${key_no_hash}.htm`);
+					if (!fs.existsSync(file_name)) {
+						file_name = path.join(source_path, key_no_hash, "index.html");
+						if (!fs.existsSync(file_name)) {
+							file_name = path.join(source_path, key_no_hash, "index.htm");
+							if (!fs.existsSync(file_name)) {
+								file_exists = false;
+								if (!redirected && !redirect_errored && draft_links.indexOf(key_no_hash) === -1)
+									nav_errors.push(
+										`Navigation path [${key_no_hash}] file does not exist.`,
+									);
+							}
+						}
+					}
+				}
+
+				if (file_exists) {
+					// File exists - but is there a redirect? If so, we want to flag this as an error
+					if (redirected)
+						nav_errors.push(
+							`Navigation path [${key_no_hash}] is redirected, but path still exists.`,
+						);
+
+					// Check file path case match
+					const true_file = hdoc.true_case_path_sync(file_name)
+						.replace(source_path, "")
+						.replaceAll("\\", "/");
+					const relative_file = file_name
+						.replace(source_path, "")
+						.replaceAll("\\", "/");
+					if (true_file !== relative_file) {
+						nav_errors.push(
+							`Navigation path [${key}] for filename [${relative_file}] does not match filename case [${true_file}].`,
+						);
+					}
+				}
+
+				// Validate path spellings
+				const paths = key.split("/");
+				for (let i = 0; i < paths.length; i++) {
+					const path_words = paths[i].split("-");
+					for (let j = 0; j < path_words.length; j++) {
+						const translate_output = translator.translate(
+							path_words[j],
+							spellcheck_options,
+						);
+						if (Object.keys(translate_output).length) {
+							for (const spell_val in translate_output) {
+								if (Object.hasOwn(translate_output, spell_val)) {
+									for (const spelling in translate_output[spell_val][0]) {
+										if (
+											Object.hasOwn(translate_output[spell_val][0], spelling)
+										) {
+											if (!excludes[key]) {
+												nav_errors.push(
+													`Navigation path [${key}] key contains a British English spelling: ${spelling} should be ${translate_output[spell_val][0][spelling].details}`,
+												);
+											} else if (
+												!excludes[key].includes(spelling.toLowerCase())
+											) {
+												nav_errors.push(
+													`Navigation path [${key}] key contains a British English spelling: ${spelling} should be ${translate_output[spell_val][0][spelling].details}`,
+												);
+											}
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+
+				// Validate display names/bookmarks
+				for (let i = 0; i < flat_nav[key].length; i++) {
+					if (flat_nav[key][i].link === key) {
+						const translate_output = translator.translate(
+							flat_nav[key][i].text,
+							spellcheck_options,
+						);
+						if (Object.keys(translate_output).length) {
+							for (const spell_val in translate_output) {
+								if (Object.hasOwn(translate_output, spell_val)) {
+									for (let j = 0; j < translate_output[spell_val].length; j++) {
+										for (const spelling in translate_output[spell_val][j]) {
+											if (
+												Object.hasOwn(translate_output[spell_val][j], spelling)
+											) {
+												if (!excludes[key]) {
+													nav_errors.push(
+														`Navigation path [${key}] display text contains a British English spelling: ${spelling} should be ${translate_output[spell_val][j][spelling].details}`,
+													);
+												} else if (
+													!excludes[key].includes(spelling.toLowerCase())
+												) {
+													nav_errors.push(
+														`Navigation path [${key}] display text contains a British English spelling: ${spelling} should be ${translate_output[spell_val][j][spelling].details}`,
+													);
+												}
+											}
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		}
+		return nav_errors;
+	};
+
+	const checkRedirects = async (source_path) => {
+		const redir_errors = [];
+		for (const key in redirects) {
+			if (Object.hasOwn(redirects, key)) {
+				if (
+					redirects[key].code !== 301 &&
+					redirects[key].code !== 308 &&
+					redirects[key].code !== 410
+				)
+					redir_errors.push(`Invalid redirect code: ${redirects[key].code}`);
+
+				if (redirects[key].location && !redirects[key].skip_location_validation) {
+					const redir_locations = [
+						path.join(source_path, `${redirects[key].location}.md`),
+						path.join(source_path, redirects[key].location, "index.md"),
+						path.join(source_path, `${redirects[key].location}.html`),
+						path.join(source_path, `${redirects[key].location}.htm`),
+						path.join(source_path, redirects[key].location, "index.html"),
+						path.join(source_path, redirects[key].location, "index.htm"),
+					];
+					let redir_location_ok = false;
+					for (let i = 0; i < redir_locations.length; i++) {
+						if (fs.existsSync(redir_locations[i])) {
+							redir_location_ok = true;
+							break;
+						}
+					}
+					if (!redir_location_ok)
+						redir_errors.push(
+							`Redirect location does not exist: ${redirects[key].location}`,
+						);
+				}
+			}
+		}
+		return redir_errors;
+	};
+
+	const checkRedirect = (source_path, nav_path) => {
+		const response = {
+			exists: false,
+			error: null,
+		};
+		if (redirects[nav_path]) {
+			response.exists = true;
+			if (redirects[nav_path].location) {
+
+				if (redirects[nav_path].skip_location_validation) return response;
+
+				// We have a redirect, check if it's a valid location
+				let file_path = path.join(
+					source_path,
+					`${redirects[nav_path].location}.html`,
+				);
+				if (!fs.existsSync(file_path)) {
+					file_path = path.join(
+						source_path,
+						`${redirects[nav_path].location}.htm`,
+					);
+					if (!fs.existsSync(file_path)) {
+						file_path = path.join(
+							source_path,
+							redirects[nav_path].location,
+							"index.html",
+						);
+						if (!fs.existsSync(file_path)) {
+							file_path = path.join(
+								source_path,
+								redirects[nav_path].location,
+								"index.htm",
+							);
+							if (!fs.existsSync(file_path)) {
+								response.error = `Redirect path for [${nav_path}] does not exist: ${redirects[nav_path].location}`;
+							}
+						}
+					}
+				}
+			}
+		}
+		return response;
+	};
+
+	const isHashAnchor = (html_file, hash_anchor, full_hash_anchor_link = "") => {
+		const markdown_paths = getMDPathFromHtmlPath(html_file);
+		const markdown_content = fs.readFileSync(markdown_paths.markdownPath, 'utf8');
+
+		try {
+			const file_content = fs.readFileSync(html_file.path, {
+				encoding: "utf-8",
+			});
+			const clean_hash_anchor = hash_anchor.startsWith("/")
+				? hash_anchor.substring(2, hash_anchor.length)
+				: hash_anchor.substring(1, hash_anchor.length);
+			if (
+				!file_content.includes(`<div id="hb-doc-anchor-${clean_hash_anchor}"`)
+			) {
+				const error_message = processErrorMessage(`Target hash anchor is not present in page content: ${full_hash_anchor_link !== "" ? full_hash_anchor_link : hash_anchor}`, markdown_paths.relativePath, markdown_content, full_hash_anchor_link);
+				errors[html_file.relativePath].push( error_message );
+			}
+		} catch (e) {
+			errors[html_file.relativePath].push(e);
+		}
+	};
+
+	const getMDPathFromHtmlPath = (htmlFile) => {
+		const returnPaths = {
+			markdownPath: htmlFile.path.replace(`.${htmlFile.extension}`, '.md'),
+			relativePath: htmlFile.relativePath.replace(`.${htmlFile.extension}`, '.md')
+		};
+		if (!fs.existsSync(returnPaths.markdownPath)) {
+			// No matching markdown
+			returnPaths.markdownPath = htmlFile.path;
+		}
+		return returnPaths;
+	}
+
+	// Headers that mimic a real Chrome browser request — sites doing bot detection
+	// check far more than just User-Agent (Accept, Sec-Fetch-*, client hints, etc.).
+	const _fetch_headers = {
+		'User-Agent':      'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36',
+		'Accept':          'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8',
+		'Accept-Language': 'en-US,en;q=0.9',
+		'Accept-Encoding': 'gzip, deflate, br',
+		'Cache-Control':   'no-cache',
+		'Pragma':          'no-cache',
+		'Sec-Fetch-Dest':  'document',
+		'Sec-Fetch-Mode':  'navigate',
+		'Sec-Fetch-Site':  'none',
+		'Sec-Fetch-User':  '?1',
+		'Sec-Ch-Ua':       '"Google Chrome";v="131", "Chromium";v="131", "Not_A Brand";v="24"',
+		'Sec-Ch-Ua-Mobile':   '?0',
+		'Sec-Ch-Ua-Platform': '"Windows"',
+		'Upgrade-Insecure-Requests': '1',
+	};
+
+	// Checks a single external URL by sending a HEAD request, falling back to GET
+	// if the server returns 405 (Method Not Allowed) or 404 (some servers, e.g.
+	// marketplace.visualstudio.com, return 404 for HEAD even when the page exists).
+	// Retries up to 5 times on transient errors (5xx, 429, network failures).
+	// Returns the HTTP status code.
+	const fetchExternalLinkStatus = async (url) => {
+		const opts = { method: 'HEAD', headers: _fetch_headers, timeoutMs: 10000, redirect: 'follow' };
+		const resp = await hdoc.fetchWithRetry(url, opts);
+		if (resp.status === 404 || resp.status === 405) {
+			const getResp = await hdoc.fetchWithRetry(url, { ...opts, method: 'GET' });
+			return getResp.status;
+		}
+		return resp.status;
+	};
+
+	// Map an inter-book check result onto errors/warnings/messages and the
+	// validated-links cache. 'ok' and 'skip' outcomes are stable, so they are
+	// appended to validated-links.txt like any other passing link.
+	const handleInterbookResult = (result, link, htmlFile, markdown_paths, markdown_content) => {
+		if (result.level === "error") {
+			errors[htmlFile.relativePath].push(
+				processErrorMessage(result.message, markdown_paths.relativePath, markdown_content, link),
+			);
+		} else if (result.level === "warning") {
+			warnings[htmlFile.relativePath].push(
+				processErrorMessage(result.message, markdown_paths.relativePath, markdown_content, link),
+			);
+		} else {
+			messages[htmlFile.relativePath].push(result.message);
+			fs.appendFileSync(skip_link_file, `${link}\n`);
+		}
+	};
+
+	const checkLinks = async (source_path, htmlFile, links, hdocbook_config, hdocbook_project, global_links_checked, output_links) => {
+		const markdown_paths = getMDPathFromHtmlPath(htmlFile);
+		const markdown_content = fs.readFileSync(markdown_paths.markdownPath, 'utf8');
+
+		// Resolve the "are we on the internal network?" question once per process
+		// rather than once per internal.hornbill.com link.
+		const ensureIntNetCached = async () => {
+			if (_on_int_net_cached === null) {
+				try {
+					_on_int_net_cached = await checkHostExistsInDNS('docs-internal.hornbill.com');
+				} catch (_e) {
+					_on_int_net_cached = false;
+				}
+			}
+			return _on_int_net_cached;
+		};
+
+		// Collect external links that need an HTTP check so they can be run
+		// concurrently rather than one-at-a-time.
+		const externalChecks = [];
+
+		for (let i = 0; i < links.length; i++) {
+			if (output_links) console.log(` - ${links[i]}`);
+			if (exclude_links[links[i]]) continue;
+			if (global_links_checked.includes(links[i])) continue;
+			global_links_checked.push(links[i]);
+
+			const valid_url = hdoc.valid_url(links[i]);
+			if (!valid_url) {
+				// Could be a relative path, check
+				if (links[i].startsWith("#") || links[i].startsWith("/#")) {
+					//Flat Anchor - validate we have a same-file hit
+					isHashAnchor(htmlFile, links[i]);
+				} else if (links[i].startsWith("/") && !links[i].startsWith("/#")) {
+					let link_segments = links[i].split("/");
+					if (link_segments[0] === "") link_segments.shift();
+					const link_root = link_segments[0] === "_books" ? link_segments[1] : link_segments[0];
+
+					// Check for links with a _books path that have no specific file target
+					// We do need to exclude those with an extension though, for pages that link downloadable resources
+					if (link_segments[0] === "_books" && path.extname(links[i]) === '') {
+						const error_message = processErrorMessage(`Root relative page links should not include _books in the path: ${links[i]}`, markdown_paths.relativePath, markdown_content, links[i]);
+						errors[htmlFile.relativePath].push(error_message);
+					}
+
+					// Links into other books: verified against GitHub when a token
+					// was supplied, otherwise skipped (can't validate locally).
+					if ((link_segments.length > 1 && link_root !== hdocbook_config.docId) || (link_segments.length === 1 && link_root !== hdocbook_config.docId && link_root !== "index")) {
+						if (interbook.enabled() && path.extname(links[i].split("#")[0]) === "") {
+							const link = links[i];
+							externalChecks.push(async () =>
+								handleInterbookResult(
+									await interbook.check_link(link),
+									link,
+									htmlFile,
+									markdown_paths,
+									markdown_content,
+								),
+							);
+						} else {
+							fs.appendFileSync(skip_link_file, `${links[i]}\n`);
+						}
+						continue;
+					}
+					isRelativePath(source_path, htmlFile, links[i]);
+				} else {
+					const error_message = processErrorMessage(`Root relative links should start with a forward-slash: ${links[i]}`, markdown_paths.relativePath, markdown_content, links[i]);
+					errors[htmlFile.relativePath].push(error_message);
+				}
+			} else {
+				messages[htmlFile.relativePath].push(
+					`Link is a properly formatted external URL: ${links[i]}`,
+				);
+
+				// Skip if it's the auto-generated edit url, as these could be part of a private repo which would return a 404
+				// publicSource must be truthy, not just defined - an empty string makes
+				// get_github_api_path return "" which has no edit_path
+				if (
+					hdocbook_config.publicSource &&
+					links[i] ===
+					hdoc
+					.get_github_api_path(
+						hdocbook_config.publicSource,
+						htmlFile.relativePath,
+					)
+					.edit_path.replace(path.extname(htmlFile.relativePath), ".md")
+				) {
+					fs.appendFileSync(skip_link_file, `${links[i]}\n`);
+					continue;
+				}
+
+				if (valid_url.protocol === "mailto:") {
+					fs.appendFileSync(skip_link_file, `${links[i]}\n`);
+					continue;
+				}
+
+				// Skip if the link is excluded in the project config
+				if (excludeLink(links[i])) {
+					messages[htmlFile.relativePath].push(
+						`Skipping link validation for: ${links[i]}`,
+					);
+					continue;
+				}
+
+				if (
+					(links[i].toLowerCase().includes("docs.hornbill.com") ||
+					links[i].toLowerCase().includes("docs-internal.hornbill.com")) &&
+					!markdown_paths.relativePath.includes('/_inline/')
+				) {
+					const error_message = processErrorMessage(`Hornbill Docs links should not be fully-qualified: ${links[i]}`, markdown_paths.relativePath, markdown_content, links[i]);
+					errors[htmlFile.relativePath].push(error_message);
+					continue;
+				}
+
+				if (
+					links[i].toLowerCase().includes("docs-internal.hornbill.com") &&
+					markdown_paths.relativePath.includes('/_inline/') &&
+					!private_repo
+				) {
+					// Is the parent book in a public repo? If so, flag this as an error.
+					const error_message = processErrorMessage(`Hornbill docs-internal links should not be used in public book inline content: ${links[i]}`, markdown_paths.relativePath, markdown_content, links[i]);
+					errors[htmlFile.relativePath].push(error_message);
+					continue;
+				}
+
+				// Fully-qualified Hornbill Docs links (only permitted in _inline
+				// content — anything else errored above): with a GitHub token,
+				// validate book/article/anchor instead of a plain HTTP check.
+				const link_host = valid_url.hostname ? valid_url.hostname.toLowerCase() : "";
+				if (
+					interbook.enabled() &&
+					(link_host === "docs.hornbill.com" || link_host === "docs-internal.hornbill.com") &&
+					path.extname(valid_url.pathname) === ""
+				) {
+					const link = links[i];
+					const book_link = valid_url.pathname + valid_url.hash;
+					externalChecks.push(async () =>
+						handleInterbookResult(
+							await interbook.check_link(book_link),
+							link,
+							htmlFile,
+							markdown_paths,
+							markdown_content,
+						),
+					);
+					continue;
+				}
+
+				// Capture url in closure for the async check below
+				const url = links[i];
+				const isInternal = url.toLowerCase().includes("internal.hornbill.com");
+
+				externalChecks.push(async () => {
+					// For internal.hornbill.com links, check network reachability first (result cached)
+					if (isInternal) {
+						const on_int_net = await ensureIntNetCached();
+						if (!on_int_net) {
+							messages[htmlFile.relativePath].push(
+								`Outside of Hornbill network - skipping internal link validation for: ${url}`,
+							);
+							fs.appendFileSync(skip_link_file, `${url}\n`);
+							return;
+						}
+						messages[htmlFile.relativePath].push(
+							`Inside of Hornbill network - performing internal link validation for: ${url}`,
+						);
+					}
+
+					try {
+						const status = await fetchExternalLinkStatus(url);
+						if ((status < 200 || status > 299) && status !== 304) {
+							if (process.env.GITHUB_ACTIONS === 'true' && status === 403 && url.includes(".hornbill.com")) {
+								// Always returns 403 for Hornbill sites through GitHub Actions — not a real error
+							} else {
+								throw `Unexpected Status Returned: ${status}`;
+							}
+						} else {
+							fs.appendFileSync(skip_link_file, `${url}\n`);
+						}
+					} catch (e) {
+						let error_message;
+						if (e instanceof AggregateError) {
+							error_message = processErrorMessage(`Issue with external link [${url}]: ${e.message} - ${JSON.stringify(e.errors)}`, markdown_paths.relativePath, markdown_content, url);
+						} else {
+							error_message = processErrorMessage(`Issue with external link [${url}]: ${e}`, markdown_paths.relativePath, markdown_content, url);
+						}
+						if (hdocbook_project.validation.external_link_warnings || process.env.GITHUB_ACTIONS === 'true')
+							warnings[htmlFile.relativePath].push(error_message);
+						else
+							errors[htmlFile.relativePath].push(error_message);
+					}
+				});
+			}
+		}
+
+		// Run all external HTTP checks concurrently — fetch is lightweight enough
+		// that uncapped concurrency is fine for the link counts seen in practice.
+		await Promise.all(externalChecks.map(fn => fn()));
+	};
+
+	const checkHostExistsInDNS = async (hostname) => {
+		return new Promise((resolve, reject) => {
+			dns.lookup(hostname, { all:true }, (err, addresses) => {
+				if (err) {
+					reject(err);
+				} else {
+					resolve(addresses !== undefined);
+				}
+			});
+		});
+	}
+
+	const checkImages = async (source_path, htmlFile, links) => {
+		const markdown_paths = getMDPathFromHtmlPath(htmlFile);
+		const markdown_content = fs.readFileSync(markdown_paths.markdownPath, 'utf8');
+		for (let i = 0; i < links.length; i++) {
+			// Validate that image is a valid URL first
+			if (!hdoc.valid_url(links[i])) {
+
+				if (!links[i].startsWith("/") && !markdown_paths.relativePath.includes('/_inline/')) {
+					const error_message = processErrorMessage(`Root relative image links should start with a forward-slash: ${links[i]}`, markdown_paths.relativePath, markdown_content, links[i]);
+					errors[htmlFile.relativePath].push(error_message);
+				}
+
+				// Could be a relative path, check image exists
+				doesFileExist(source_path, htmlFile, links[i], markdown_paths.relativePath, markdown_content);
+			} else {
+				messages[htmlFile.relativePath].push(
+					`Image link is a properly formatted external URL: ${links[i]}`,
+				);
+				// Do a Get to the URL to see if it exists
+				try {
+					const img_response = await fetch(links[i]);
+					if (!img_response.ok) throw new Error(`HTTP ${img_response.status}`);
+					messages[htmlFile.relativePath].push(
+						`Image link is a valid external URL: ${links[i]}`,
+					);
+				} catch (e) {
+					// Handle errors
+					const error_message = processErrorMessage(`External image link error: ${links[i]} - ${e.message}`, markdown_paths.relativePath, markdown_content, links[i]);
+					errors[htmlFile.relativePath].push(error_message);
+				}
+			}
+		}
+	};
+
+	const checkTags = async (htmlFile) => {
+		const markdown_paths = getMDPathFromHtmlPath(htmlFile);
+		// Check if file  is excluded from tag check
+		const file_no_ext = htmlFile.relativePath.replace(
+			path.extname(htmlFile.relativePath),
+			"",
+		);
+		if (exclude_h1_count[file_no_ext]) return;
+
+		// Check tags
+		const htmlBody = fs.readFileSync(htmlFile.path, "utf8");
+		const $ = cheerio.load(htmlBody);
+
+		const h1_tags = $("h1")
+			.map(function () {
+				return $(this);
+			})
+			.get();
+		if (h1_tags.length && h1_tags.length > 1) {
+			let error_msg = `${h1_tags.length} <h1> tags found in content: `;
+			for (let i = 0; i < h1_tags.length; i++) {
+				error_msg += h1_tags[i].text();
+				if (i < h1_tags.length - 1) error_msg += "; ";
+			}
+			errors[htmlFile.relativePath].push(`${markdown_paths.relativePath} - ${error_msg}`);
+		}
+	};
+
+	const dreeOptions = {
+		descendants: true,
+		excludeEmptyDirectories: true,
+		extensions: ["htm", "html", "md"],
+		hash: false,
+		normalize: true,
+		size: false,
+		sizeInBytes: false,
+		stat: false,
+		symbolicLinks: false,
+	};
+
+	// File scan callback for content type files
+	const fileContentCallback = (element) => {
+		if (element.extension.toLowerCase() === "md") {
+			md_to_validate.push(element);
+		} else {
+			html_to_validate.push(element);
+		}
+	};
+
+	const isRelativePath = (source_path, html_path, relative_path) => {
+		const markdown_paths = getMDPathFromHtmlPath(html_path);
+		const markdown_content = fs.readFileSync(markdown_paths.markdownPath, 'utf8');
+
+		const rel_path_ext = path.extname(relative_path);
+		const response = {
+			is_rel_path: false,
+			has_md_extension: rel_path_ext === ".md",
+			has_html_extension: rel_path_ext === ".htm" || rel_path_ext === ".html",
+		};
+		const supported_relpaths = [
+			`${path.sep}index.htm`,
+			`${path.sep}index.html`,
+			".htm",
+			".html",
+			".md",
+		];
+
+		// Remove explicit anchor links and _books prefix
+		const clean_relative_path = relative_path
+			.split("#")[0]
+			.replace("_books/", "");
+
+		let hash_anchor = null;
+		if (relative_path.split("#")[1])
+			hash_anchor = `#${relative_path.split("#")[1]}`;
+
+		// Make full file path
+		const file_path = path.join(source_path, clean_relative_path);
+
+		// Does path exist?
+		if (fs.existsSync(file_path)) {
+			response.is_rel_path = true;
+		} else {
+			// Path
+			for (let i = 0; i < supported_relpaths.length; i++) {
+				const html_file_path = `${file_path}${supported_relpaths[i]}`;
+				if (fs.existsSync(html_file_path)) {
+					response.is_rel_path = true;
+
+					// Check for hash anchor
+					if (hash_anchor !== null) {
+						isHashAnchor(
+							{ path: html_file_path, relativePath: html_path.relativePath, extension: html_path.extension },
+							hash_anchor,
+							relative_path,
+						);
+					}
+					break;
+				}
+			}
+		}
+		if (response.has_md_extension || response.has_html_extension) {
+			const error_message = processErrorMessage(`Relative link has ${rel_path_ext} extension, but should not: ${relative_path}`, markdown_paths.relativePath, markdown_content, relative_path);
+			errors[html_path.relativePath].push(error_message);
+			return;
+		}
+		if (response.is_rel_path) {
+			messages[html_path.relativePath].push(
+				`Relative path exists: ${clean_relative_path}`,
+			);
+			return;
+		}
+
+		// See if there's a redirect in place
+		const relpath =
+			clean_relative_path.indexOf("/") === 0
+				? clean_relative_path.substring(1)
+				: clean_relative_path;
+		const redir = checkRedirect(source_path, relpath);
+		if (redir.exists) {
+			if (redir.error !== null) {
+				const error_message = processErrorMessage(`${redir.error}: ${relative_path}`, markdown_paths.relativePath, markdown_content, clean_relative_path);
+				errors[html_path.relativePath].push(error_message);
+			}
+		} else {
+			const error_message = processErrorMessage(`Link path does not exist: ${relative_path}`, markdown_paths.relativePath, markdown_content, clean_relative_path);
+			errors[html_path.relativePath].push(error_message);
+		}
+	};
+
+	const processErrorMessage = (message, md_path, content, search) => {
+		// whole_link — a link that is a substring of a longer link elsewhere in
+		// the file must not be located at the longer link's position
+		const link_location = hdoc.find_string_in_string(content, search, true);
+		let error_message = message;
+		if (link_location !== null)
+			error_message = `${md_path}:${link_location.line}:${link_location.column} - ${error_message}`;
+		else
+			error_message = `${md_path} - ${error_message}`;
+		return error_message;
+	};
+	
+	const doesFileExist = (source_path, html_path, relative_path, markdown_path, markdown_content) => {
+		// Remove explicit anchor links and _books prefix
+		const clean_relative_path = relative_path
+			.split("#")[0]
+			.replace("_books/", "");
+		const file_path = path.join(source_path, clean_relative_path);
+		if (
+			!fs.existsSync(file_path) &&
+			!fs.existsSync(`${file_path + path.sep}index.htm`) &&
+			!fs.existsSync(`${file_path}index.html`) &&
+			!fs.existsSync(`${file_path}.htm`) &&
+			!fs.existsSync(`${file_path}.html`)
+		) {
+			const error_message = processErrorMessage(`Book resource does not exist: ${clean_relative_path}`, markdown_path, markdown_content, relative_path);
+			errors[html_path.relativePath].push(error_message);
+			return false;
+		}
+		messages[html_path.relativePath].push(
+			`Book resource exists: ${clean_relative_path}`,
+		);
+		return true;
+	};
+
+	// Takes a dree element, returns an object with a pair of arrays
+	const getLinks = (file) => {
+		messages[file.relativePath].push("Parsing HTML file");
+		const htmlBody = fs.readFileSync(file.path, "utf8");
+		const links = {
+			href: [],
+			img: [],
+		};
+		const $ = cheerio.load(htmlBody);
+		const hrefs = $("a")
+			.map(function (i) {
+				return $(this).attr("href");
+			})
+			.get();
+		const srcs = $("img")
+			.map(function (i) {
+				if ($(this).attr("alt") === undefined || $(this).attr("alt").trim() === "") {
+					errors[file.relativePath].push(`Image tag with src [${$(this).attr("src")}] is missing alt attribute.`);
+				}
+				return $(this).attr("src");
+			})
+			.get();
+		links.href.push(...hrefs);
+		links.img.push(...srcs);
+		return links;
+	};
+
+	exports.run = async (
+		source_path,
+		doc_id,
+		verbose,
+		hdocbook_config,
+		hdocbook_project,
+		nav_items,
+		prod_families,
+		prods_supported,
+		gen_exclude,
+		gen_redirects,
+		draft_links,
+		is_private,
+		browser,
+		source_root_path,
+		output_links = true,
+		git_token = "",
+	) => {
+		console.log("Performing Validation and Building SEO Link List...");
+		redirects = gen_redirects;
+		private_repo = is_private;
+		interbook.init(git_token);
+		if (interbook.enabled())
+			console.log(
+				"GitHub token supplied - inter-book links will be validated against GitHub",
+			);
+
+		// Load the skip link validation file if it exists
+		loadSkipLinkValidation(source_root_path);
+
+		// Get a list of HTML files in source_path
+		hdoc.scan_dir(source_path, dreeOptions, fileContentCallback);
+
+		// Check product family
+		let valid_product = false;
+		const meta_errors = [];
+		for (let i = 0; i < prod_families.products.length; i++) {
+			if (prod_families.products[i].id === hdocbook_config.productFamily) {
+				valid_product = true;
+			}
+		}
+		if (!valid_product) {
+			let val_prod_error = `Incorrect productFamily: ${hdocbook_config.productFamily}. Supported values:`;
+			for (let i = 0; i < prods_supported.length; i++) {
+				val_prod_error += `\n  - ${prods_supported[i]}`;
+			}
+			meta_errors.push(val_prod_error);
+		}
+
+		if (hdocbook_config.publicSource && hdocbook_config.publicSource !== "") {
+			// Validate publicSource
+			if (hdocbook_config.publicSource.toLowerCase() === "--publicsource--") {
+				meta_errors.push(
+					"Value for publicSource in book metadata is set to its default template value",
+				);
+			} else {
+				// Check URL exists
+				if (
+					!hdocbook_config.publicSource.startsWith("https://github.com") &&
+					!hdocbook_config.publicSource.startsWith("https://api.github.com")
+				) {
+					meta_errors.push(
+						`Value for publicSource in book metadata is not a recognised GitHub URL: ${hdocbook_config.publicSource}`,
+					);
+				}
+			}
+		}
+
+		if (
+			!hdocbook_config.audience ||
+			!Array.isArray(hdocbook_config.audience) ||
+			hdocbook_config.audience.length === 0
+		) {
+			meta_errors.push(
+				"Property audience of type array in book metadata is mandatory.",
+			);
+		}
+		if (hdocbook_project.validation) {
+			if (
+				hdocbook_project.validation.exclude_links &&
+				Array.isArray(hdocbook_project.validation.exclude_links)
+			) {
+				for (const excl_link of hdocbook_project.validation.exclude_links) {
+					exclude_links[excl_link] = true;
+				}
+			}
+			if (
+				hdocbook_project.validation.exclude_spellcheck &&
+				Array.isArray(hdocbook_project.validation.exclude_spellcheck)
+			) {
+				for (const excl_sc of hdocbook_project.validation.exclude_spellcheck) {
+
+					if (exclude_spellcheck[excl_sc.document_path] !== undefined) {
+						meta_errors.push(
+							"Document path is duplicated in exclude_spellcheck validation array: " + excl_sc.document_path,
+						);
+					}
+					exclude_spellcheck[excl_sc.document_path] = excl_sc.words;
+				}
+			}
+			if (
+				hdocbook_project.validation.exclude_h1_count &&
+				Array.isArray(hdocbook_project.validation.exclude_h1_count)
+			) {
+				for (const excl_h1 of hdocbook_project.validation.exclude_h1_count) {
+					exclude_h1_count[excl_h1] = true;
+				}
+			}
+		}
+
+		if (hdocbook_project.validation && Array.isArray(hdocbook_project.validation.spellcheckDictionary)) global_spellcheck = hdocbook_project.validation.spellcheckDictionary.map((w) => String(w).toLowerCase());
+
+		// Check navigation spellings & paths exist
+		const nav_errors = await checkNavigation(
+			source_path,
+			nav_items,
+			exclude_spellcheck,
+			draft_links,
+		);
+		if (nav_errors.length > 0) meta_errors.push(...nav_errors);
+
+		// Check inline content spellings & paths exist
+		if (hdocbook_config.inline && hdocbook_config.inline.length > 0) {
+			const inline_errors = await checkInline(
+				source_path,
+				hdocbook_config.inline,
+				exclude_spellcheck,
+			);
+			if (inline_errors.length > 0) meta_errors.push(...inline_errors);
+		}
+
+		// Check redirects
+		const redirect_errors = await checkRedirects(source_path);
+		if (redirect_errors.length > 0) meta_errors.push(...redirect_errors);
+
+		if (meta_errors.length > 0) {
+			console.log("\r\n-----------------------");
+			console.log("   Validation Output   ");
+			console.log("-----------------------");
+			for (let i = 0; i < meta_errors.length; i++) {
+				console.error(`- ${meta_errors[i]}`);
+			}
+			console.error(`\r\n${meta_errors.length} Validation Errors Found`);
+			return false;
+		}
+
+		const excl_output = [];
+
+		// Do spellchecking on markdown files
+		const md_files_spellchecked = {};
+		const mdPromiseArray = [];
+		for (let i = 0; i < md_to_validate.length; i++) {
+			errors[md_to_validate[i].relativePath] = [];
+			messages[md_to_validate[i].relativePath] = [];
+			warnings[md_to_validate[i].relativePath] = [];
+			mdPromiseArray.push(md_to_validate[i]);
+		}
+		await Promise.all(
+			mdPromiseArray.map(async (file) => {
+				// Initiate maps for errors and verbose messages for markdown file
+				const exclusions = await spellcheckContent(file, exclude_spellcheck);
+				if (gen_exclude && exclusions.length > 0)
+					excl_output.push({
+						document_path: file.relativePath.replace(`.${file.extension}`, ""),
+						words: exclusions,
+					});
+				md_files_spellchecked[
+					file.relativePath.replace(`.${file.extension}`, "")
+				] = true;
+			}),
+		);
+
+		// Perform rest of validation against HTML files
+		const htmlPromiseArray = [];
+		for (let i = 0; i < html_to_validate.length; i++) {
+			errors[html_to_validate[i].relativePath] = [];
+			messages[html_to_validate[i].relativePath] = [];
+			warnings[html_to_validate[i].relativePath] = [];
+			htmlPromiseArray.push(html_to_validate[i]);
+		}
+
+		
+		const global_links_checked = [];
+
+		for (const key in html_to_validate) {
+			const file = html_to_validate[key];
+			// Check for British spellings in static HTML content
+			if (
+				!md_files_spellchecked[
+					file.relativePath.replace(`.${file.extension}`, "")
+				]
+			) {
+				const exclusions = await spellcheckContent(file, exclude_spellcheck);
+				if (gen_exclude && exclusions.length > 0)
+					excl_output.push({
+						document_path: file.relativePath.replace(
+							`.${file.extension}`,
+							"",
+						),
+						words: exclusions,
+					});
+			}
+
+			const links = getLinks(file);
+			if (links.href.length === 0) {
+				messages[file.relativePath].push("No links found in file");
+			} else {
+				console.log(`\r\nChecking ${links.href.length} Links in ${file.relativePath}`);
+				await checkLinks(source_path, file, links.href, hdocbook_config, hdocbook_project, global_links_checked, output_links);
+			}
+			if (links.img.length === 0) {
+				messages[file.relativePath].push("No images found in file");
+			} else {
+				await checkImages(source_path, file, links.img);
+			}
+
+			// Check for multiple H1 tags
+			await checkTags(file);
+		}
+
+		if (gen_exclude) console.log(JSON.stringify(excl_output, null, 2));
+
+		if (verbose) {
+			console.log("\r\n-------------");
+			console.log("   Verbose   ");
+			console.log("-------------");
+			for (const key in messages) {
+				if (Object.hasOwn(messages, key) && messages[key].length > 0) {
+					console.log(`\r\nMessage output for ${key}`);
+					for (let i = 0; i < messages[key].length; i++) {
+						console.log(` - ${messages[key][i]}`);
+					}
+				}
+			}
+		}
+
+		console.log("\r\n-----------------------");
+		console.log("   Validation Output   ");
+		console.log("-----------------------");
+		let warning_count = 0;
+		for (const key in warnings) {
+			if (Object.hasOwn(warnings, key) && warnings[key].length > 0) {
+				for (let i = 0; i < warnings[key].length; i++) {
+					console.info(`[WARNING] ${key} - ${warnings[key][i]}`);
+					warning_count++;
+				}
+			}
+		}
+		if (warning_count > 0) {
+			console.info(`\r\n${warning_count} Validation Warnings Found (non-fatal)\r\n`);
+		}
+		if (Object.keys(errors).length > 0) {
+			let error_count = 0;
+			for (const key in errors) {
+				if (Object.hasOwn(errors, key) && errors[key].length > 0) {
+					for (let i = 0; i < errors[key].length; i++) {
+						console.error(`${key} - ${errors[key][i]}`);
+						error_count++;
+					}
+				}
+			}
+			if (error_count > 0) {
+				console.error(`\r\n${error_count} Validation Errors Found`);
+				if (verbose) {
+					console.log("\n");
+					console.error(JSON.stringify(exclude_spellcheck_output, null, 2));
+				}
+				return false;
+			}
+		}
+
+		console.log("\r\nNo Validation Errors Found!\n");
+		return true;
+	};
+})();