docusaurus v2 -> v3

luogu-dev · Nov 15, 2024 · 4a73d35 · 4a73d35
1 parent 1b4d647
commit 4a73d35
Show file tree

Hide file tree

Showing 39 changed files with 8,259 additions and 6,101 deletions.
diff --git a/.idea/git_toolbox_blame.xml b/.idea/git_toolbox_blame.xml
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # 洛谷帮助中心
 
-该网站使用 [Docusaurus 2](https://docusaurus.io/) 构建。
+该网站使用 [Docusaurus 3](https://docusaurus.io/) 构建。
 
 [![知识共享许可协议](https://i.creativecommons.org/l/by-nc-nd/4.0/88x31.png)](http://creativecommons.org/licenses/by-nc-nd/4.0/)
 
@@ -13,7 +13,7 @@ $ pnpm install
 $ pnpm run start
 ```
 
-对于 CodeSpaces 请使用
+对于 GitHub Codespaces 请使用
 ```
 $ pnpm run start -h 0.0.0.0
 ```

diff --git a/babel.config.js b/babel.config.js
@@ -1,3 +1,3 @@
 module.exports = {
-    presets: [require.resolve('@docusaurus/core/lib/babel/preset')]
+    presets: ['@docusaurus/core/lib/babel/preset']
 };
diff --git a/docs/manual/class/after-sales.md b/docs/manual/class/after-sales.md
@@ -12,7 +12,7 @@ tags:
 
 更换课程后或者退课后，之前的课程将不能再进行学习或者访问，即使是已经完成的部分。
 
-## 团体报名 {#Group}
+## 团体报名 {#group}
 
 1. 团报订单的售后需由原报名用户（团主）联系客服申请（客服不接受团员直接申请）。
 2. 退课换班期限参照具体课程的售后政策。

diff --git a/docs/manual/class/course-enroll.md b/docs/manual/class/course-enroll.md
@@ -13,13 +13,13 @@ tags:
 3. 如果您觉得订单页面显示的组合优惠金额不对请先付款后再联系客服处理，以提高效率。
 4. 如果订单**付款失败**请看[【第 14 步】](#step-14)重新付款。
 5. **开发票**请看[【第 15 步】](#step-15)
-6. 报名成功后请重新进入网校主页，点击左侧【学习】，就可以进入学习中心（<https://class.luogu.com.cn/learn>）。选择【我的课程】就能看到所有已报名的课程。
+6. 报名成功后请重新进入网校主页，点击左侧【学习】，就可以进入学习中心（[https://class.luogu.com.cn/learn](https://class.luogu.com.cn/learn)）。选择【我的课程】就能看到所有已报名的课程。
 
 ## 报名步骤
 
 ### 1.进入洛谷网校 {#step-1}
 
-<https://class.luogu.com.cn>
+[https://class.luogu.com.cn](https://class.luogu.com.cn)
 
 ### 2.点击右上角的头像进行登陆操作 {#step-2}
 
@@ -83,7 +83,7 @@ tags:
 
 ### 13.付款成功后就可以去听课了 {#step-13}
 
-<https://class.luogu.com.cn/learn>
+[https://class.luogu.com.cn/learn](https://class.luogu.com.cn/learn)
 
 如果需要开发票请跳至[【第 15 步】](#step-15)。
 

diff --git a/docs/manual/class/system-requirement.md b/docs/manual/class/system-requirement.md
@@ -16,9 +16,9 @@ tags:
 
 为了确保您得到最佳学习体验，我们强烈建议您使用新版 Chrome、Edge 或 Firefox 浏览器，可以在以下官方网站上下载：
 
-- <https://www.google.cn/chrome/>
-- <https://www.microsoft.com/zh-cn/edge/>
-- <https://www.firefox.com.cn/>
+- [https://www.google.cn/chrome/](https://www.google.cn/chrome/)
+- [https://www.microsoft.com/zh-cn/edge/](https://www.microsoft.com/zh-cn/edge/)
+- [https://www.firefox.com.cn/](https://www.firefox.com.cn/)
 
 :::tip
 

diff --git a/docs/manual/luogu/account/award-certify.md b/docs/manual/luogu/account/award-certify.md
@@ -12,7 +12,7 @@
 - NOI 奖牌，包括邀请赛（不包括初中组和小学组，不包括 online 线上赛）
 - WC / APIO / CTSC
 
-:::caution 常见不可认证情况
+:::caution[常见不可认证情况]
 
 - CCF GESP 认证
 - 仅获得 CSP-J/S 第一轮的证书
@@ -22,9 +22,9 @@
 
 :::
 
-:::info  洛谷有自己的计算规则
+:::info[洛谷有自己的计算规则]
 
-以上奖项以 **CCF 官方公布名单**（<https://www.noi.cn/hjmd/mdcx/>）为准,部分**线上比赛**洛谷仅认证奖项而不计算积分。  
+以上奖项以 **CCF 官方公布名单**（[https://www.noi.cn/hjmd/mdcx/](https://www.noi.cn/hjmd/mdcx/)）为准,部分**线上比赛**洛谷仅认证奖项而不计算积分。  
 
 积分计算仅参考 CCF 计算方法，洛谷保留获奖积分计算的最终解释权。  
 
@@ -78,7 +78,7 @@
 
 如果因为任何原因未能进行自动认证，或找不到学校、有遗漏的奖项、奖项分布在多个学校等特殊情况，请将相关证明资料和您的用户ID发送**电子邮件**至 `verify@luogu.com.cn`，我们将尽快为您处理（一般为 5个工作日内）。
 
-本邮箱**只处理奖项认证相关邮件，不接受其他咨询**。人工认证仅关联对应奖项至指定账户，并不直接干预奖项计算过程。因此不接受除了奖项遗漏之外的任何申诉( **其他账号申诉**请发送至：[申诉邮箱](/contact-us))。  也请不要在邮件内提及想认证的具体等级（因为没用）。
+本邮箱**只处理奖项认证相关邮件，不接受其他咨询**。人工认证仅关联对应奖项至指定账户，并不直接干预奖项计算过程。因此不接受除了奖项遗漏之外的任何申诉（**其他账号申诉**请发送至：[申诉邮箱](/contact-us)）。  也请不要在邮件内提及想认证的具体等级（因为没用）。
 
 请按照下面的模板发送邮件（直接写在正文内，不要放在附件）：
 
@@ -122,7 +122,7 @@ PS：除非CCF的获奖名单能增加身份证号这一字段，那确实会方
 
 1. 计算的CCF等级仅供参考。由于可参考的数据有限，目前仅支持算出3级以上的等级，且8级以上的积分计算功能暂时无法正确处理 WC 成绩。
 2. 由于缺失数据，2013 年及以前获得的 NOIP 奖项无法正确计算等级。
-3. 该评级的计算方法请参考 <http://www.noi.cn/xw/2019-08-26/715369.shtml>
+3. 该评级的计算方法请参考 [http://www.noi.cn/xw/2019-08-26/715369.shtml](http://www.noi.cn/xw/2019-08-26/715369.shtml)
 4. 由于公平原因，洛谷对于部分线上进行的比赛只认证奖项不计算积分。
 
 ## 我们将如何处理用户隐私信息

diff --git a/docs/manual/luogu/account/deletion.md b/docs/manual/luogu/account/deletion.md
@@ -25,7 +25,7 @@
 
 正文内容为：  
 
-> UID：<在个人中心可查看>  
+> UID：\<在个人中心可查看\>  
 > 我已了解账户注销须知的内容，申请注销该洛谷账户，注销账号后手机号、邮箱将无法注册新的洛谷账户。
 
 ![邮件格式示例](_image/delete-email-example.jpg)

diff --git a/docs/manual/luogu/account/elo-ranking.md b/docs/manual/luogu/account/elo-ranking.md
@@ -8,11 +8,11 @@
 
 用户的等级分会显示在用户页面中；在“练习”模块中可以看到用户的等级分认定的历史。
 
-全站等级分的排名（前 1000 名）：<https://www.luogu.com.cn/ranking/elo> 。
+全站等级分的排名（前 1000 名）：[https://www.luogu.com.cn/ranking/elo](https://www.luogu.com.cn/ranking/elo) 。
 
 ## 2. 洛谷中的比赛等级分系统
 
-洛谷采用了类似 AtCoder 的等级分计算方式，可参见 <https://www.luogu.com.cn/blog/ak-ioi/cf-at-rating> 。
+洛谷采用了类似 AtCoder 的等级分计算方式，可参见 [https://www.luogu.com.cn/blog/ak-ioi/cf-at-rating](https://www.luogu.com.cn/blog/ak-ioi/cf-at-rating) 。
 
 比赛等级分的计算涉及两个主要因素：预期胜率和实际比赛结果。预期胜率是基于选手的当前等级分差异来计算的。如果一个选手击败另一个的选手，那么前者的等级分将会上升，而后者的等级分则会下降。当一个选手参加比赛场次较少时，等级分可能无法体现选手的真实水平。当选手参加 5 次比赛以后，将会逐渐收敛到选手的真实水平。
 

diff --git a/docs/manual/luogu/account/index.md b/docs/manual/luogu/account/index.md
@@ -15,14 +15,14 @@ sidebar_position: 3
 
 动态等级是根据用户在一段时间内的刷题、社区活跃、打卡、题解、违规情况，按照一定算法得出的结果，该算法不公开。动态等级比较准确的表现了用户一段时间内在洛谷的综合行为。动态等级由 -1 到 4，用户名的颜色为分别对应为棕色、灰色、蓝色、绿色、橙色、红色。管理员的用户名颜色为紫色，不受动态等级影响。
 
-|  等级 | 颜色 | 名称    | 说明               |
-|----:|----|-------|------------------|
-|  -1 | 棕色 | 作弊者   |                  |
-|   0 | 灰色 | 见习用户  | 即咕值 <100 的用户      |
+|  等级 | 颜色 | 名称    | 说明                 |
+|----:|----|-------|--------------------|
+|  -1 | 棕色 | 作弊者   |                    |
+|   0 | 灰色 | 见习用户  | 即咕值 \<100 的用户      |
 |   1 | 蓝色 | 普通用户  | 即咕值在 [100,119] 的用户 |
 |   2 | 绿色 | 算法爱好者 | 即咕值在 [120,169] 的用户 |
 |   3 | 橙色 | 刷题健将  | 即咕值在 [170,229] 的用户 |
-|   4 | 红色 | 虐题狂魔  | 即咕值 >229 的用户      |
+|   4 | 红色 | 虐题狂魔  | 即咕值 >229 的用户       |
 
 新用户的初始动态等级为 0，也就是灰色用户名。用户在洛谷中按照洛谷社区规则使用各项功能，会增加动态等级。如果长时间不使用洛谷或者有违规行为，可能会降级。除非用户有严重违规行为或者在长时间不使用洛谷且未进行实名认证的情况下，一旦用户达到蓝名，则不会掉到灰名。你可以在打卡之后在打卡结果中看到自己用户名的颜色。**在犇犇或者讨论中询问颜色名字和咕值相关的一些问题将被和谐。**
 

diff --git a/docs/manual/luogu/article.md b/docs/manual/luogu/article.md
@@ -25,7 +25,7 @@ sidebar_label: 个人专栏文章功能
 
 其中**个人记录**、**闲话**分类无法全站推荐展示，仅能设置为*个人公开*文章。
 
-其中**题解**分类的文章将经管理员依据[《洛谷主题库题解规范》](../../rules/academic/solution-standard.mdx)审核通过后在对应题目的题解区以及 *文章广场-题解分区* 内展示。
+其中**题解**分类的文章将经管理员依据[《洛谷主题库题解规范》](../../rules/academic/solution-standard.md)审核通过后在对应题目的题解区以及 *文章广场-题解分区* 内展示。
 
 ## 文章公开度
 
@@ -45,7 +45,7 @@ sidebar_label: 个人专栏文章功能
 
 文章需审核后才能在全站范围内（包括国内站）公开展示。
 
-:::caution 注意
+:::caution[注意]
 
 请编辑完文章并保存后，再点击按钮投稿合集、提交题解或全站推荐。
 

diff --git a/docs/manual/luogu/commercial-contest.md b/docs/manual/luogu/commercial-contest.md
@@ -4,7 +4,7 @@ sidebar_position: 114514
 
 # 举办线上商业性算法比赛
 
-对于各类需要举办线上算法竞赛的企业院校，洛谷 <https://www.luogu.com.cn> 提供完善的竞赛平台，可提供线上公开或者非公开的算法竞赛的协助和便利，同时可以进行合理的商业宣传。
+对于各类需要举办线上算法竞赛的企业院校，洛谷 [https://www.luogu.com.cn](https://www.luogu.com.cn) 提供完善的竞赛平台，可提供线上公开或者非公开的算法竞赛的协助和便利，同时可以进行合理的商业宣传。
 
 对于非盈利的组织机构进行的非商业比赛，可以酌情减少或者免除合作的费用。
 
@@ -58,12 +58,12 @@ sidebar_position: 114514
 
 ![传智杯案例](_image/cc-chuanzhibei.png)  
 
-比赛官网：<http://dasai.ityxb.com/>
+比赛官网：[http://dasai.ityxb.com/](http://dasai.ityxb.com/)
 
-洛谷线上初赛：<https://www.luogu.com.cn/contest/28762>
+洛谷线上初赛：[https://www.luogu.com.cn/contest/28762](https://www.luogu.com.cn/contest/28762)
 
-洛谷线上复赛：<https://www.luogu.com.cn/contest/29004>
+洛谷线上复赛：[https://www.luogu.com.cn/contest/29004](https://www.luogu.com.cn/contest/29004)
 
 ## 联系我们
 
-如有这方面的需求，欢迎通过我们的邮箱 <mailto:k@luogu.org> 联系我们，之后会有专人负责对接。
+如有这方面的需求，欢迎通过我们的邮箱 [k@luogu.org](mailto:k@luogu.org) 联系我们，之后会有专人负责对接。
diff --git a/docs/manual/luogu/index.md b/docs/manual/luogu/index.md
@@ -4,11 +4,11 @@ sidebar_position: 1
 
 # 主站操作指南
 
-<!-- :::caution 重要提示
+{/* :::caution[重要提示]
 
 本页面以及该系列帮助内容因为长时间未更新，可能不符合当前最新情况。洛谷正在编写全新的帮助与使用指南，以下内容仅供参考，不代表准确情况。
 
-::: -->
+::: */}
 
 洛谷创建于 2013 年 6 月 15 日，至今已有数万用户，致力于为编程爱好者提供清爽、快捷的编程体验。它不仅仅是一个在线测题系统，更拥有强大的社区、在线学习功能。同时，许多教程内容都是由五湖四海的用户提供的，保证了内容的广泛性。无论是初学 OI 的蒟蒻，还是久经沙场的神犇，均可从洛谷 Online Judge 获益，也可以帮助他人，共同进步。
 

diff --git a/docs/manual/luogu/problem/index.md b/docs/manual/luogu/problem/index.md
@@ -61,7 +61,7 @@ Special Judge 程序使用输入数据和一些其他信息来判答你程序的
 
 当一道题目已经有足够多的题解时，管理员会关闭这道题目的题解提交通道，这时候用户将不能再提交新的题解。
 
-上传题解时必须按照 [题解审核规范](../../../rules/academic/solution-standard.mdx)。
+上传题解时必须按照 [题解审核规范](../../../rules/academic/solution-standard.md)。
 
 用户可以在题解页面对题解进行评论，也可以点赞或者点踩评论表示支持和不支持。
 

diff --git a/docs/manual/luogu/problem/judging.md b/docs/manual/luogu/problem/judging.md
@@ -7,7 +7,7 @@ sidebar_position: 1
 
 洛谷评测系统支持的语言请参考下面的[语言支持](#languages)部分。
 
-:::info 注意
+:::info[注意]
 
 除 C/C++/Pascal 外的语言，由于常数时间差距，不保证正确算法的执行所用时间和内存能够通过评测而不超出限制。洛谷不为此类语言提供多余的时间和内存限制。
 
@@ -71,7 +71,7 @@ gcc (GCC) 13.2.0
 Copyright (C) 2023 Free Software Foundation, Inc.
 ```
 
-:::caution 优化开关提示
+:::caution[优化开关提示]
 
 为了比赛等情况下的公平，在 C/C++ 代码的编译中，如果出现了通过 `pragma` 和 `attribute` 打开优化开关的行为是会导致编译失败的，详见[公告帖](https://www.luogu.com.cn/discuss/show/259685)。为了达成这一效果，我们对 GCC 进行了[一点小修改](https://github.com/luogu-dev/judge-env/blob/master/gcc/13_disable-pragma-and-attribute-for-optimize.patch)。
 
@@ -139,7 +139,7 @@ javac
 java -DONLINE_JUDGE
 ```
 
-:::info 注意
+:::info[注意]
 
 Java 源代码将保存为 `Main.java` 文件，因此被评测的代码应该有类似如下的格式，即类名为 `Main`：
 

diff --git a/docs/manual/luogu/problem/remote-judge.md b/docs/manual/luogu/problem/remote-judge.md
@@ -4,7 +4,7 @@
 
 **洛谷 RemoteJudge** 功能帮助用户打破不同 Online Judge 之间的壁垒，可以在洛谷里提交全网的题目，并且可以使用洛谷其他的配套功能，例如讨论、查看和提交题解、收藏题目、管理代码、团队作业等等。使用这项功能非常便利，也会有更好的体验，可以极大的提升学习效率。
 
-:::caution 不保证服务稳定性
+:::caution[不保证服务稳定性]
 
 洛谷不保证 RemoteJudge 服务的稳定性。能否正常使用取决于对方 OJ 服务器状态以及洛谷服务器与对方服务器间能否正常联通。评测时间与这些 OJ 的运行状态有关；当这些 OJ 无法正常评测（例如网站故障，被卡评测，评测量过大等原因），或在较长时间都没有返回评测结果的情况下，自然也无法反馈评测详情。
 

diff --git a/docs/manual/luogu/problem/special-judge.md b/docs/manual/luogu/problem/special-judge.md
@@ -8,9 +8,9 @@ Special Judge 程序使用输入数据和一些其他信息来判答你程序的
 
 下载地址：
 
-<https://github.com/MikeMirzayanov/testlib/releases/download/0.9.41/testlib-0.9.41.zip>
+[https://github.com/MikeMirzayanov/testlib/releases/download/0.9.41/testlib-0.9.41.zip](https://github.com/MikeMirzayanov/testlib/releases/download/0.9.41/testlib-0.9.41.zip)
 
-Testlib 库 0.9.41 版 引入了一些重大变更，具体见：<https://github.com/MikeMirzayanov/testlib/releases/tag/0.9.41>
+Testlib 库 0.9.41 版 引入了一些重大变更，具体见：[https://github.com/MikeMirzayanov/testlib/releases/tag/0.9.41](https://github.com/MikeMirzayanov/testlib/releases/tag/0.9.41)
 
 Checker 的编译参数为：`g++ -fno-asm -std=c++14 -O2`，即已经开启 C++14 以及 O2 优化。
 
@@ -147,7 +147,7 @@ int main(int argc, char* argv[]) {
 
 ## 测试
 
-使用编译器将该文件编译。在命令行中输入:
+使用编译器将该文件编译。在命令行中输入：
 
 ```
 ./checker in.txt out.txt ans.txt (Linux)
@@ -162,7 +162,7 @@ checker.exe in.txt out.txt ans.txt (Windows)
 
 直接将 checker.cpp（必须这个名字）塞入测试数据的压缩包内然后上传就行了。
 
-:::caution 重要
+:::caution[重要]
 
 必须加上“Special Judge”标签。
 

diff --git a/docs/manual/luogu/team/premium.md b/docs/manual/luogu/team/premium.md
@@ -13,7 +13,7 @@
 * 题目复制：允许从公有题库复制进团队题库，并可使用原测试数据进行评测。
 * 导出数据：导出团队比赛、团队作业的结果数据。
 
-:::note 注：
+:::note[注：]
 
 * 放宽的各项限制的内容在订阅期结束后予以永久保留，但将会因超过基础限制不可以创建或增加新的内容或成员。
 * 如需运行反作弊请在比赛后发送比赛链接到邮箱 k@luogu.org 申请查重（仅限实际付费用户）
@@ -58,7 +58,7 @@
 
 ![成员管理](_image/pt-member2.png)
 
-:::tip 如何邀请新成员
+:::tip[如何邀请新成员]
 
 请进入你的团队主页，在团队主页点击团队编号后面的蓝色【复制地址】的文字，会将该页面的地址复制到剪贴板中。然后将该地址发送给需要邀请的新成员。新成员在该页面点击【加入团队】即可完成加入申请。
 
@@ -117,7 +117,7 @@
 
 5. 完成付款，成功开通。  
 
-客服咨询暂时和洛谷网校共用，您可以在客服中心咨询所有洛谷付费业务。客服工单留言：<https://class.luogu.com.cn/service>
+客服咨询暂时和洛谷网校共用，您可以在客服中心咨询所有洛谷付费业务。客服工单留言：[https://class.luogu.com.cn/service](https://class.luogu.com.cn/service)
 
 对公转账账户信息：
 

diff --git a/docs/rules/academic/handbook/latex.md b/docs/rules/academic/handbook/latex.md
@@ -5,7 +5,7 @@
 $\LaTeX$ 是一种基于 $\TeX$ 的排版系统，能够很方便的生成数学公式。
 
 洛谷的大多数地方使用 $\KaTeX$ 进行渲染，可以参照文档：  
-<https://katex.org/docs/supported.html>。
+[https://katex.org/docs/supported.html](https://katex.org/docs/supported.html)。
 
 :::
 

diff --git a/docs/rules/academic/handbook/markdown.md b/docs/rules/academic/handbook/markdown.md
@@ -272,12 +272,12 @@ Markdown 使用一种和链接很相似的语法来标记图片。在互联网
 Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用尖括号包起来，Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样，例如：
 
 ```markdown
-<https://www.luogu.com.cn/>
+[https://www.luogu.com.cn/](https://www.luogu.com.cn/)
 ```
 
 显示效果为：
 
-<https://www.luogu.com.cn/>
+[https://www.luogu.com.cn/](https://www.luogu.com.cn/)
 
 ## 分隔线
 
@@ -330,7 +330,7 @@ _   底线
 
 ## 插入 Bilibili 视频
 
-见 <https://www.luogu.com.cn/paste/okqcziz9>。
+见 [https://www.luogu.com.cn/paste/okqcziz9](https://www.luogu.com.cn/paste/okqcziz9)。
 
 ## LaTeX 公式支持
 

diff --git a/docs/rules/academic/lgr/contest-standard.md b/docs/rules/academic/lgr/contest-standard.md
@@ -70,7 +70,7 @@ sidebar_position: 10
 - 在无特殊情况下时，任何测试点的空间限制**应为 512 MiB**。
 - 部分分的设计应当合理，测试数据的强度应当尽可能大，数据格式要求详见 [传统题数据格式要求](../../../manual/luogu/problem/testcase-format.md)。
 - 如果原定的题目因各种原因（如无法设计合理的部分分、无法保证数据强度、发现做法假了、发现撞题了等）无法使用，且无**事先报告过的备用题**，应当**立刻中止筹办过程**。**禁止临时添加未报告过的题目。**
-- 官方题解需严格遵守 [题解审核及反馈要求](../solution-standard.mdx)，**隐藏在洛谷博客中，但不应在比赛界面显示。**
+- 官方题解需严格遵守 [题解审核及反馈要求](../solution-standard.md)，**隐藏在洛谷博客中，但不应在比赛界面显示。**
 
 审核通过后，出题人若需要进行题面的增删和更换需要和审核员沟通，不可以主动撤销立项。