Function normalizeConfig

src/config.ts:249–343

(spec: ConfigSpec = {}, defaultRoot?: string, watchPath?: string)

const configCache = new WeakMap<ConfigSpec, Config>();

export function normalizeConfig(spec: ConfigSpec = {}, defaultRoot?: string, watchPath?: string): Config {
  const cachedConfig = configCache.get(spec);
  if (cachedConfig) return cachedConfig;
  const root = spec.root === undefined ? findDefaultRoot(defaultRoot) : String(spec.root);
  const output = spec.output === undefined ? "dist" : String(spec.output);
  const base = spec.base === undefined ? "/" : normalizeBase(spec.base);
  const style =
    spec.style === null
      ? null
      : spec.style !== undefined
      ? {path: String(spec.style)}
      : {theme: normalizeTheme(spec.theme === undefined ? "default" : spec.theme)};
  const globalStylesheets =
    spec.globalStylesheets === undefined
      ? defaultGlobalStylesheets()
      : normalizeGlobalStylesheets(spec.globalStylesheets);
  const md = createMarkdownIt({
    linkify: spec.linkify === undefined ? undefined : Boolean(spec.linkify),
    typographer: spec.typographer === undefined ? undefined : Boolean(spec.typographer),
    quotes: spec.quotes === undefined ? undefined : (spec.quotes as any),
    markdownIt: spec.markdownIt as any
  });
  const title = spec.title === undefined ? undefined : String(spec.title);
  const home = spec.home === undefined ? he.escape(title ?? "Home") : String(spec.home); // eslint-disable-line import/no-named-as-default-member
  const pages = spec.pages === undefined ? undefined : normalizePages(spec.pages);
  const pager = spec.pager === undefined ? true : Boolean(spec.pager);
  const dynamicPaths = normalizeDynamicPaths(spec.dynamicPaths);
  const toc = normalizeToc(spec.toc as any);
  const sidebar = spec.sidebar === undefined ? undefined : Boolean(spec.sidebar);
  const scripts = spec.scripts === undefined ? [] : normalizeScripts(spec.scripts);
  const head = pageFragment(spec.head === undefined ? "" : spec.head);
  const header = pageFragment(spec.header === undefined ? "" : spec.header);
  const footer = pageFragment(spec.footer === undefined ? defaultFooter() : spec.footer);
  const search = spec.search == null || spec.search === false ? null : normalizeSearch(spec.search as any);
  const interpreters = normalizeInterpreters(spec.interpreters as any);
  const normalizePath = getPathNormalizer(spec);
  const duckdb = normalizeDuckDB(spec.duckdb);

  // If this path ends with a slash, then add an implicit /index to the
  // end of the path. Otherwise, remove the .html extension (we use clean
  // paths as the internal canonical representation; see normalizePage).
  function normalizePagePath(pathname: string): string {
    ({pathname} = parseRelativeUrl(pathname)); // ignore query & anchor
    pathname = normalizePath(pathname);
    if (pathname.endsWith("/")) pathname = join(pathname, "index");
    else pathname = pathname.replace(/\.html$/, "");
    return pathname;
  }

  const config: Config = {
    root,
    output,
    base,
    home,
    title,
    sidebar: sidebar!, // see below
    pages: pages!, // see below
    pager,