docusaurus.config.js - main - spirzen/it-knowledge-base

docusaurus.config.js
430 строк17 KB
Spirzen
Fixes epilepsion
13 июн 2026, 18:59
13 июн 2026, 18:59232c0aa
// docusaurus.config.js

/** @type {Record<string, string[]>} */
let docLegacyRedirects = {};
try {
  docLegacyRedirects = require('./src/data/docLegacyRedirects.json');
} catch {
  // npm run docs:redirects — перед start/build
}

/** Old slug segment -> new folder name (encyclopedia subsection). */
const ENCYCLOPEDIA_FOLDER_RENAMES = [
  ['encyclopedia/3-data-markup/3.01. Продвинутые операции с данными', 'encyclopedia/3-data-markup/3-01-prodvinutye-operatsii-s-dannymi'],
  ['encyclopedia/3-data-markup/3.02. Структуры данных', 'encyclopedia/3-data-markup/3-02-struktury-dannyh'],
  ['encyclopedia/3-data-markup/3.03. Мыслительная база', 'encyclopedia/3-data-markup/3-03-myslitelnaya-baza'],
  ['encyclopedia/3-data-markup/3.04. Конфигурации и данные', 'encyclopedia/3-data-markup/3-04-konfiguratsii-i-dannye'],
  ['encyclopedia/3-data-markup/3.05. Основы баз данных', 'encyclopedia/3-data-markup/3-05-osnovy-baz-dannyh'],
  ['encyclopedia/3-data-markup/3.06. NoSQL', 'encyclopedia/3-data-markup/3-06-nosql'],
  ['encyclopedia/3-data-markup/3.07. SQL', 'encyclopedia/3-data-markup/3-07-sql'],
  ['encyclopedia/3-data-markup/3.08. Управление реляционными СУБД', 'encyclopedia/3-data-markup/3-08-upravlenie-rsubd'],
  ['encyclopedia/3-data-markup/3.09. HTML', 'encyclopedia/3-data-markup/3-09-html'],
  ['encyclopedia/3-data-markup/3.10. CSS', 'encyclopedia/3-data-markup/3-10-css'],
  ['encyclopedia/3-data-markup/3.11. Анализ данных', 'encyclopedia/3-data-markup/3-11-analiz-dannyh'],
  ['encyclopedia/5-languages/5.16. Старые языки/Visual Basic', 'encyclopedia/5-languages/5.16. Старые языки/visual-basic'],
  ['encyclopedia/5-languages/5.01. JavaScript', 'encyclopedia/5-languages/5-01-javascript'],
  ['encyclopedia/5-languages/5.02. Python', 'encyclopedia/5-languages/5-02-python'],
  ['encyclopedia/5-languages/5.03. Java', 'encyclopedia/5-languages/5-03-java'],
  ['encyclopedia/5-languages/5.04. Platforma .NET', 'encyclopedia/5-languages/5-04-platforma-dotnet'],
  ['encyclopedia/5-languages/5.05. CSharp', 'encyclopedia/5-languages/5-05-csharp'],
  ['encyclopedia/5-languages/5.06. C++', 'encyclopedia/5-languages/5-06-cpp'],
  ['encyclopedia/5-languages/5.07. PHP', 'encyclopedia/5-languages/5-07-php'],
  ['encyclopedia/5-languages/5.08. Smalltalk', 'encyclopedia/5-languages/5-08-smalltalk'],
  ['encyclopedia/5-languages/5.09. Kotlin', 'encyclopedia/5-languages/5-09-kotlin'],
  ['encyclopedia/5-languages/5.10. Go', 'encyclopedia/5-languages/5-10-go'],
  ['encyclopedia/5-languages/5.11. Ruby', 'encyclopedia/5-languages/5-11-ruby'],
  ['encyclopedia/5-languages/5.12. Groovy', 'encyclopedia/5-languages/5-12-groovy'],
  ['encyclopedia/5-languages/5.13. Rust', 'encyclopedia/5-languages/5-13-rust'],
  ['encyclopedia/5-languages/5.14. Swift', 'encyclopedia/5-languages/5-14-swift'],
  ['encyclopedia/5-languages/5.15. Lua и Luau', 'encyclopedia/5-languages/5-15-lua-i-luau'],
  ['encyclopedia/5-languages/5.16. Старые языки', 'encyclopedia/5-languages/5-16-starye-yazyki'],
  ['encyclopedia/5-languages/5.17. Haskell', 'encyclopedia/5-languages/5-17-haskell'],
  ['encyclopedia/5-languages/5.18. Scala', 'encyclopedia/5-languages/5-18-scala'],
  ['encyclopedia/5-languages/5.19. Elixir', 'encyclopedia/5-languages/5-19-elixir'],
  ['encyclopedia/5-languages/5.20. Zig', 'encyclopedia/5-languages/5-20-zig'],
  ['encyclopedia/5-languages/5.21. Nim', 'encyclopedia/5-languages/5-21-nim'],
  ['encyclopedia/5-languages/5.22. Dart', 'encyclopedia/5-languages/5-22-dart'],
  ['encyclopedia/5-languages/5.23. R', 'encyclopedia/5-languages/5-23-r'],
  ['encyclopedia/5-languages/5.24. Julia', 'encyclopedia/5-languages/5-24-julia'],
  ['encyclopedia/5-languages/5.25. Bash', 'encyclopedia/5-languages/5-25-bash'],
  ['encyclopedia/5-languages/5.26. PowerShell', 'encyclopedia/5-languages/5-26-powershell'],
  ['encyclopedia/5-languages/5.27. 1С', 'encyclopedia/5-languages/5-27-1s'],
  ['encyclopedia/8-infra-security/8.01. Облачные технологии', 'encyclopedia/8-infra-security/8-01-oblachnye-tehnologii'],
  ['encyclopedia/8-infra-security/8.02. Low-code, No-code', 'encyclopedia/8-infra-security/8-02-low-code-no-code'],
  ['encyclopedia/8-infra-security/8.03. Забота о коде и данных', 'encyclopedia/8-infra-security/8-03-zabota-o-kode-i-dannyh'],
  ['encyclopedia/8-infra-security/8.04. DevOps, CI-CD', 'encyclopedia/8-infra-security/8-04-devops-ci-cd'],
  ['encyclopedia/8-infra-security/8.05. Микросервисы и интеграция', 'encyclopedia/8-infra-security/8-05-mikroservisy-i-integratsiya'],
  ['encyclopedia/8-infra-security/8.06. Контейнеризация и оркестрация', 'encyclopedia/8-infra-security/8-06-konteynerizatsiya-i-orkestratsiya'],
  ['encyclopedia/8-infra-security/8.07. Информационная безопасность', 'encyclopedia/8-infra-security/8-07-informatsionnaya-bezopasnost'],
];

function createEncyclopediaFolderRedirects(existingPath) {
  const redirects = [];
  for (const [oldSegment, newSegment] of ENCYCLOPEDIA_FOLDER_RENAMES) {
    const newPrefix = `/encyclopedia/${newSegment}/`;
    const newExact = `/encyclopedia/${newSegment}`;
    if (existingPath.includes(newPrefix)) {
      redirects.push(
        existingPath.replace(`/encyclopedia/${newSegment}/`, `/encyclopedia/${oldSegment}/`),
      );
    } else if (existingPath === newExact || existingPath.endsWith(newExact)) {
      redirects.push(existingPath.replace(newExact, `/encyclopedia/${oldSegment}`));
    }
  }
  return redirects.length > 0 ? redirects : undefined;
}

const isWindowsDev = process.platform === 'win32' && process.env.NODE_ENV !== 'production';
/** На Windows dev по умолчанию без Rspack faster (EMFILE). Включить: IT_DOCUSAURUS_FASTER=1 */
const useFasterBundler =
  process.env.IT_DOCUSAURUS_FASTER === '1' || !isWindowsDev;

/**
 * Embed code/play.
 * Dev: localhost (с click-to-load iframe грузятся только по клику — без ws://4322 на старте).
 * Prod: канонические домены. Переопределение: IT_CODE_EXAMPLES_URL / IT_PLAY_URL.
 */
const isProdBuild = process.env.NODE_ENV === 'production';

const codeExamplesUrl =
  process.env.IT_CODE_EXAMPLES_URL ??
  (isProdBuild ? 'https://code.spirzen.ru' : 'http://localhost:4321');

const playExamplesUrl =
  process.env.IT_PLAY_URL ?? (isProdBuild ? 'https://play.spirzen.ru' : 'http://localhost:4322');

module.exports = {
  title: 'Вселенная IT',
  tagline: 'Единый и ультимативный гайд по IT',
  favicon: 'img/favicon.ico',

  url: 'https://spirzen.ru',
  baseUrl: '/',

  organizationName: 'Spirzen',
  projectName: 'it-knowledge-base',
  trailingSlash: false,

  onBrokenLinks: 'warn',

  customFields: {
    codeExamplesUrl,
    playExamplesUrl,
  },

  clientModules: [
    require.resolve('./src/clientModules/itThemeStorageGuard.js'),
    require.resolve('./src/clientModules/itDesignThemeInit.js'),
    require.resolve('./src/clientModules/limitRoutePrefetch.js'),
  ],

  i18n: {
    defaultLocale: 'ru',
    locales: ['ru'],
    localeConfigs: {
      ru: {
        label: 'Русский',
        direction: 'ltr',
      },
    },
  },

  presets: [
    [
      'classic',
      {
        docs: {
          sidebarPath: './sidebars.js',
          editUrl: undefined,
          showLastUpdateAuthor: false,
          showLastUpdateTime: true,
          routeBasePath: '/',
          numberPrefixParser: false,
          remarkPlugins: [
            require('./src/remark/wikiLink.js'),
            require('./src/remark/lazyMdxDemoImports.js'),
          ],
        },
        blog: false,
        theme: {
          customCss: [
            './src/css/custom.css',
            './src/css/it-design-code-overrides.css',
          ],
        },
        gtag: undefined,
      },
    ],
  ],

  plugins: [
    [
      '@docusaurus/plugin-client-redirects',
      {
        createRedirects(existingPath) {
          const fromEncyclopedia = createEncyclopediaFolderRedirects(existingPath);
          const slugRedirects = {
            '/encyclopedia/1-basics/basics': ['/encyclopedia/Основы/Основы'],
            '/encyclopedia/2-system-network/system-network': [
              '/encyclopedia/Система и сеть/Система-Сеть',
            ],
            '/encyclopedia/4-code-dev/code-dev': [
              '/encyclopedia/Код и разработка/code-dev',
            ],
            '/encyclopedia/5-languages/intro': ['/encyclopedia/5-languages/languages'],
            '/encyclopedia/3-data-markup/data-markup': [
              '/encyclopedia/3-data-markup/Данные-markup',
            ],
            '/section/data-markup': ['/section/Данные-markup'],
            '/section/basics': ['/section/Основы'],
            '/section/system-network': ['/section/Система-Сеть'],
            '/section/infra-security': ['/section/infra-Безопасность'],
          };
          const cLanguageRedirects = {};
          for (let n = 1; n <= 8; n += 1) {
            cLanguageRedirects[`/encyclopedia/5-languages/5-16-starye-yazyki/c-language/${n}`] = [
              `/encyclopedia/5-languages/5-16-starye-yazyki/С/${n}`,
            ];
          }
          for (const id of [
            '211', '212', '213', '311', '411', '711', '712',
          ]) {
            cLanguageRedirects[
              `/encyclopedia/5-languages/5-16-starye-yazyki/c-language/${id}`
            ] = [`/encyclopedia/5-languages/5-16-starye-yazyki/С/${id}`];
          }
          const designPatternRedirects = {};
          for (const id of ['1', '111', '112', '113', '114', '115', '116']) {
            designPatternRedirects[
              `/encyclopedia/7-project/7-06-proektirovanie-i-arhitektura/design-patterns/${id}`
            ] = [
              `/encyclopedia/Проект/7.06. Проектирование и архитектура/паттерны проектирования/${id}`,
            ];
          }
          Object.assign(slugRedirects, cLanguageRedirects, designPatternRedirects);

          slugRedirects['/encyclopedia/8-infra-security/8-05-mikroservisy-i-integratsiya/1121'] = [
            '/encyclopedia/2-system-network/2-09-osnovy-integratsionnogo-vzaimodeystviya/1121',
          ];
          slugRedirects['/encyclopedia/8-infra-security/8-05-mikroservisy-i-integratsiya/134'] = [
            '/encyclopedia/8-infra-security/8-07-informatsionnaya-bezopasnost/134',
          ];

          const fromGenerated = docLegacyRedirects[existingPath] ?? [];
          const fromManual = slugRedirects[existingPath] ?? [];
          const fromEncFolders = fromEncyclopedia ?? [];
          const merged = [...fromGenerated, ...fromManual, ...fromEncFolders];
          if (merged.length > 0) {
            return [...new Set(merged)];
          }
          return undefined;
        },
      },
    ],
    () => ({
      name: 'it-konva-canvas-fallback',
      configureWebpack() {
        return {
          resolve: {
            fallback: {
              canvas: false,
            },
          },
        };
      },
    }),
    () => ({
      name: 'it-design-theme-inject',
      injectHtmlTags() {
        return {
          headTags: [
            {
              tagName: 'script',
              innerHTML: `(function(){try{var k='it-universe-design';var id=localStorage.getItem(k)||'design-universe-original';document.documentElement.setAttribute('data-design',id);}catch(e){document.documentElement.setAttribute('data-design','design-universe-original');}})();`,
            },
            {tagName: 'link', attributes: {rel: 'dns-prefetch', href: 'https://play.spirzen.ru'}},
            {tagName: 'link', attributes: {rel: 'dns-prefetch', href: 'https://code.spirzen.ru'}},
            {tagName: 'link', attributes: {rel: 'preconnect', href: 'https://play.spirzen.ru', crossorigin: 'anonymous'}},
            {tagName: 'link', attributes: {rel: 'preconnect', href: 'https://code.spirzen.ru', crossorigin: 'anonymous'}},
          ],
        };
      },
    }),
    () => ({
      name: 'it-async-chunks',
      configureWebpack(_config, isServer) {
        if (isServer) {
          return {};
        }
        return {
          optimization: {
            runtimeChunk: 'single',
            splitChunks: {
              maxInitialRequests: 8,
              maxAsyncRequests: 12,
              cacheGroups: {
                itReact: {
                  test: /[\\/]node_modules[\\/](react|react-dom|scheduler|use-sync-external-store)[\\/]/,
                  name: 'vendor-react',
                  chunks: 'all',
                  priority: 40,
                  reuseExistingChunk: true,
                },
                itDocusaurus: {
                  test: /[\\/]node_modules[\\/]@docusaurus[\\/]/,
                  name: 'vendor-docusaurus',
                  chunks: 'all',
                  priority: 35,
                  maxSize: 450000,
                  reuseExistingChunk: true,
                },
                itPrism: {
                  test: /[\\/]node_modules[\\/](prismjs|prism-react-renderer|refractor)[\\/]/,
                  name: 'vendor-prism',
                  chunks: 'all',
                  priority: 32,
                  reuseExistingChunk: true,
                },
                itEmbed: {
                  test: /[\\/]src[\\/]components[\\/](ExternalPlayEmbed|ExternalCodeEmbed)/,
                  chunks: 'async',
                  minSize: 0,
                  priority: 22,
                  reuseExistingChunk: true,
                },
                itDemoAsync: {
                  test: /[\\/]src[\\/]components[\\/]/,
                  chunks: 'async',
                  minSize: 32000,
                  maxSize: 200000,
                  priority: 15,
                  reuseExistingChunk: true,
                },
                itMermaid: {
                  test: /[\\/]node_modules[\\/](mermaid|@mermaid-js|dagre-d3|khroma)/,
                  chunks: 'async',
                  priority: 20,
                  reuseExistingChunk: true,
                },
              },
            },
          },
        };
      },
    }),
  ],

  themeConfig: {
    colorMode: {
      defaultMode: 'light',
      disableSwitch: false,
      respectPrefersColorScheme: false,
    },
    docs: {
      sidebar: {
        hideable: true,
      },
    },
    prism: {
      additionalLanguages: [
        'bash',
        'c',
        'cpp',
        'csharp',
        'docker',
        'go',
        'java',
        'kotlin',
        'php',
        'powershell',
        'python',
        'rust',
        'sql',
        'yaml',
      ],
    },
    // Настройки поиска (требует настройки Algolia, но увы - она недоступна в моей стране!)
    // algolia: {
    //   appId: 'YOUR_APP_ID',
    //   apiKey: 'YOUR_SEARCH_API_KEY',
    //   indexName: 'it-knowledge-base',
    //   contextualSearch: true,
    //   searchParameters: {},
    //   searchPagePath: 'search',
    // },

    navbar: {
      title: 'Вселенная IT',
      logo: {
        alt: 'IT Logo',
        src: 'img/docusaurus.png',
      },
      items: [
        {
          type: 'docSidebar',
          sidebarId: 'docsSidebar',
          position: 'left',
          label: 'Энциклопедия',
        },
        {
          to: '/encyclopedia/1-basics/1-03-dorozhnaya-karta-izucheniya/101',
          label: 'Указатель',
          position: 'left',
        },
        {type: 'custom-docSearch', position: 'right'},
      ],
    },
    footer: {
      style: 'dark',
      links: [
        {
          title: 'Энциклопедия',
          items: [
            { label: 'Основы', to: '/section/basics' },
            { label: 'Система и сеть', to: '/section/system-network' },
            { label: 'Данные и разметка', to: '/section/data-markup' },
          ],
        },
        {
          title: 'Инструменты и практика',
          items: [
            { label: 'Код и разработка', to: '/section/code-dev' },
            { label: 'Инфраструктура и безопасность', to: '/section/infra-security' },
            { label: 'Лаборатория', to: '/lab/intro' },
          ],
        },
        {
          title: 'Контекст и рефлексия',
          items: [
            { label: 'Контекст', to: '/context/intro' },
            { label: 'Философия', to: '/philosophy/intro' },
            { label: 'Глоссарий', to: '/glossary/intro' },
          ],
        },
        {
          title: 'О проекте',
          items: [
            {label: 'О проекте', to: '/about/project'},
            {label: 'Тематические подборки', to: '/about/collections'},
            {label: 'Манифест и правила', to: '/about/manifest'},
            {label: 'Поддержать проект', to: '/about/author#support'},
            {label: 'Об авторе', to: '/about/author'},
            {label: 'GitHub', href: 'https://github.com/spirzen/it-knowledge-base'},
          ],
        },
      ],
      copyright: `Copyright © ${new Date().getFullYear()} Тагиров Тимур Владиславович. Все права защищены.`,
    },
  },

  markdown: {
    mermaid: true,
  },
  themes: ['@docusaurus/theme-mermaid'],

  staticDirectories: ['static'],
  future: {
    v4: true,
    faster: useFasterBundler,
  },
};