migrate to Docusaurus v3

.github/workflows/build.yml

@@ -27,7 +27,10 @@ jobs:
                 cache: 'pnpm'
 
           - name: install dependencies
-            run: pnpm install
+            run: pnpm install --frozen-lockfile
+
+          - name: typecheck
+            run: pnpm run typecheck
 
           - name: build
             run: pnpm run build

README.md

@@ -2,7 +2,7 @@
 
 目前该项目有[开放平台文档](https://docs.lgapi.cn/open/)。
 
-该网站使用 [Docusaurus 2](https://docusaurus.io/) 构建，文档内容采用 [CC BY-NC-ND 4.0 协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)进行许可。
+该网站使用 [Docusaurus 3](https://docusaurus.io/) 构建，文档内容采用 [CC BY-NC-ND 4.0 协议](http://creativecommons.org/licenses/by-nc-nd/4.0/)进行许可。
 
 [![知识共享许可协议](https://i.creativecommons.org/l/by-nc-nd/4.0/88x31.png)](http://creativecommons.org/licenses/by-nc-nd/4.0/)
 

babel.config.js

@@ -1,3 +1,3 @@
 module.exports = {
-    presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+    presets: ['@docusaurus/core/lib/babel/preset']
 };

docs/judge/pricing.md

@@ -43,4 +43,4 @@ sidebar_position: 2
 - 可以评测所有的洛谷题号为 P 或者 B 开头的题目（公共题目），约 15,000 题目。
 - 提供洛谷公共题目的题面。但不会直接提供测试数据。
 - 提供技术支持服务（QQ 群）协助接入。
-- 不提供试用服务。如果希望查看部署效果，可以前往 <https://hydro.ac/d/luogu/> 查看部署实例和尝试。
+- 不提供试用服务。如果希望查看部署效果，可以前往 [https://hydro.ac/d/luogu/](https://hydro.ac/d/luogu/) 查看部署实例和尝试。

docusaurus.config.js → docusaurus.config.ts

@@ -1,35 +1,60 @@
-// @ts-check
+import type { Config } from '@docusaurus/types';
+import type * as Preset from '@docusaurus/preset-classic';
+import type * as Redocusaurus from 'redocusaurus';
+import { themes as PrismThemes } from 'prism-react-renderer';
+import remarkMath from 'remark-math';
+import rehypeKatex from 'rehype-katex';
 
-const config = {
+export default {
     title: '洛谷开放平台文档',
     favicon: 'img/favicon.ico',
 
     url: 'https://docs.lgapi.cn/',
     baseUrl: '/open/',
 
     onBrokenLinks: 'throw',
-    onBrokenMarkdownLinks: 'warn',
 
     i18n: {
         defaultLocale: 'zh-Hans',
-        locales: ['zh-Hans'],
+        locales: ['zh-Hans']
+    },
+
+    markdown: {
+        hooks: {
+            onBrokenMarkdownLinks: 'warn'
+        },
+        mdx1Compat: {
+            comments: false,
+            admonitions: false,
+            headingIds: true /* until they provide a new syntax */
+        }
     },
 
     presets: [
         ['@docusaurus/preset-classic', {
             blog: false,
             pages: false,
             docs: {
-                routeBasePath: '/'
+                sidebarPath: './sidebars.ts',
+                routeBasePath: '/',
+                remarkPlugins: [remarkMath],
+                rehypePlugins: [rehypeKatex]
             }
-        }],
+        } satisfies Preset.Options],
         ['redocusaurus', {
             specs: [
                 { id: 'open', spec: './openapi/_api.yaml', route: '/openapi' }
             ]
-        }]
+        } satisfies Redocusaurus.PresetOptions]
     ],
 
+    stylesheets: [{
+        href: 'https://cdn.luogu.com.cn/assets/katex:0.16.7/katex.min.css',
+        type: 'text/css',
+        integrity: 'sha384-3UiQGuEI4TTMaFmGIZumfRPtfKQ3trwQE2JgosJxCnGmQpL/lJdjpcHkaaFwHlcI',
+        crossorigin: 'anonymous',
+    }],
+
     themeConfig: {
         navbar: {
             title: '洛谷开放平台',
@@ -62,10 +87,8 @@ const config = {
             `
         },
         prism: {
-            theme: require('prism-react-renderer/themes/github'),
-            darkTheme: require('prism-react-renderer/themes/dracula')
+            theme: PrismThemes.github,
+            darkTheme: PrismThemes.dracula
         }
-    },
-};
-
-module.exports = config;
+    } satisfies Preset.ThemeConfig
+} satisfies Config;

package.json

@@ -15,19 +15,23 @@
         "typecheck": "tsc"
     },
     "dependencies": {
-        "@docusaurus/core": "2.3.1",
-        "@docusaurus/preset-classic": "2.3.1",
-        "@mdx-js/react": "^1.6.22",
-        "clsx": "^1.2.1",
-        "prism-react-renderer": "^1.3.5",
-        "react": "^17.0.2",
-        "react-dom": "^17.0.2",
-        "redocusaurus": "^1.6.1"
+        "@docusaurus/core": "^3.10.2",
+        "@docusaurus/preset-classic": "^3.10.2",
+        "@mdx-js/react": "^3.1.1",
+        "clsx": "^2.1.1",
+        "prism-react-renderer": "^2.4.1",
+        "react": "^19.2.0",
+        "react-dom": "^19.2.0",
+        "redocusaurus": "^2.5.2",
+        "rehype-katex": "^7.0.1",
+        "remark-math": "^6.0.0"
     },
     "devDependencies": {
-        "@docusaurus/module-type-aliases": "2.3.1",
-        "@tsconfig/docusaurus": "^1.0.5",
-        "typescript": "^4.7.4"
+        "@docusaurus/module-type-aliases": "^3.10.2",
+        "@docusaurus/tsconfig": "^3.10.2",
+        "@docusaurus/types": "^3.10.2",
+        "@types/react": "^19.2.5",
+        "typescript": "^5.9.3"
     },
     "browserslist": {
         "production": [