doc-kit.config.mjs

import web from '@node-core/doc-kit/src/generators/web/index.mjs';
import { join } from 'node:path';
import { populateI18n, createGroupings } from './utils/index.mjs';
import sidebarGroups from './navigation.json' with { type: 'json' };

/** @type {import('@node-core/doc-kit/src/utils/configuration/types.d.ts').Configuration} */
export default {
  global: {
    output: 'out/learn',
    input: ['pages/**/*.md'],
  },
  web: {
    // Important Configuration
    project: 'Node.js',
    title: '{project} Learn',
    pageURL: 'https://nodejs.org/learn{path}.html',
    editURL: 'https://github.com/nodejs/learn/edit/main/pages{path}.md',

    // Imports
    imports: {
      ...web.defaultConfiguration.imports,
      '#theme/Layout': join(import.meta.dirname, 'components/Layout/index.jsx'),
    },
    virtualImports: {
      '#site/navigation.json': JSON.stringify(
        populateI18n(
          await fetch(
            'https://raw.githubusercontent.com/nodejs/nodejs.org/refs/heads/main/apps/site/navigation.json'
          ).then(r => r.json())
        )
      ),
      '#learn/navigation.json': JSON.stringify(
        await createGroupings(sidebarGroups)
      ),
    },
  },
};