diff --git a/astro.config.ts b/astro.config.ts index 331842069..2fc3ef838 100644 --- a/astro.config.ts +++ b/astro.config.ts @@ -47,62 +47,22 @@ export default defineConfig({ starlightSidebarTopics( [ { - label: "基础", + label: "引导", link: "/general/intro", icon: "seti:bazel", id: "basics", items: [ { - label: "从零开始", + label: "从这里开始", collapsed: false, - items: [{ label: "快速开始", slug: "general/intro" }, "general/reading-guide"] - }, - { - label: "通用知识库", - collapsed: true, - items: [ - { - label: "安装 Java", - collapsed: true, - items: [ - "general/java/intro", - "general/java/choose-and-download-and-install-java", - "general/java/environment", - "general/java/sdkman", - "general/java/faq" - ] - }, - { - label: "文本编辑器", - collapsed: true, - autogenerate: { directory: "general/preparation/text-editor" } - }, - { - label: "经营管理", - collapsed: true, - items: [ - "general/advance/management/intro", - { - label: "玩家管理", - autogenerate: { - directory: "general/advance/management/player-management" - } - }, - { - label: "资金管理", - autogenerate: { - directory: "general/advance/management/money-management" - } - } - ] - } - ] + items: ["general/intro", "general/reading-guide"] } ] }, { label: "Java", link: "/java/intro", + id: "java", icon: "open-book", items: [ { @@ -114,37 +74,37 @@ export default defineConfig({ label: "准备工作", items: [ "java/preparation/intro", + { + label: "基础知识", + collapsed: true, + items: [ + "java/start/basic/intro", + "java/start/basic/what-is-server", + "java/start/basic/server-management-command" + ] + }, { label: "安装 Java", collapsed: true, items: [ - "general/java/intro", - "general/java/choose-and-download-and-install-java", - "general/java/environment", - "general/java/sdkman", - "general/java/faq" + "java/preparation/java/intro", + "java/preparation/java/choose-and-download-and-install-java", + "java/preparation/java/environment", + "java/preparation/java/sdkman", + "java/preparation/java/faq" ] }, { label: "文本编辑器", collapsed: true, - autogenerate: { directory: "general/preparation/text-editor" } + autogenerate: { directory: "java/preparation/text-editor" } } ] }, { - label: "开始阶段", + label: "搭建服务器", items: [ "java/start/intro", - { - label: "基础知识", - collapsed: true, - items: [ - "java/start/basic/intro", - "java/start/basic/what-is-server", - "java/start/basic/server-management-command" - ] - }, { label: "选择服务器端", collapsed: true, @@ -174,7 +134,7 @@ export default defineConfig({ ] }, { - label: "建设与运营", + label: "插件与玩法", items: [ "java/process/intro", { @@ -533,6 +493,49 @@ export default defineConfig({ } ] }, + { + label: "生电", + collapsed: true, + items: [ + "java/process/redstone/intro", + "java/process/redstone/plugin", + "java/process/redstone/mchprs", + "java/process/redstone/mod" + ] + }, + { + label: "地图建设", + collapsed: true, + autogenerate: { directory: "general/process/map" } + }, + "general/process/create-art-assets", + "general/process/panel" + ] + }, + { + label: "进阶知识", + collapsed: false, + items: [ + "java/advance/intro", + { + label: "经营管理", + collapsed: true, + items: [ + "general/advance/management/intro", + { + label: "玩家管理", + autogenerate: { + directory: "general/advance/management/player-management" + } + }, + { + label: "资金管理", + autogenerate: { + directory: "general/advance/management/money-management" + } + } + ] + }, { label: "跨服端", collapsed: true, @@ -650,30 +653,6 @@ export default defineConfig({ } ] }, - { - label: "生电", - collapsed: true, - items: [ - "java/process/redstone/intro", - "java/process/redstone/plugin", - "java/process/redstone/mchprs", - "java/process/redstone/mod" - ] - }, - { - label: "地图建设", - collapsed: true, - autogenerate: { directory: "general/process/map" } - }, - "general/process/create-art-assets", - "general/process/panel" - ] - }, - { - label: "进阶知识", - collapsed: false, - items: [ - "java/advance/intro", { label: "Linux 开服", collapsed: true, @@ -824,6 +803,7 @@ export default defineConfig({ { label: "Bedrock", link: "/bedrock/intro", + id: "bedrock", icon: "open-book", items: [ { @@ -831,7 +811,7 @@ export default defineConfig({ items: ["bedrock/intro"] }, { - label: "超级基础知识", + label: "基础知识", items: [ "bedrock/super-basic/intro", "bedrock/super-basic/server-core-choose", @@ -840,25 +820,27 @@ export default defineConfig({ "bedrock/super-basic/version" ] }, + { + label: "准备工作", + collapsed: true, + items: [ + { label: "文本编辑器", collapsed: true, autogenerate: { directory: "bedrock/preparation/text-editor" } } + ] + }, { label: "BDS 核心", items: [ { - label: "准备工作", + label: "准备", collapsed: true, items: [ "bedrock/bds/preparation/intro", - { - label: "文本编辑器", - collapsed: true, - autogenerate: { directory: "general/preparation/text-editor" } - }, "bedrock/bds/preparation/vcruntime", "bedrock/bds/preparation/websites" ] }, { - label: "开始阶段", + label: "搭建", collapsed: true, items: [ "bedrock/bds/start/intro", @@ -872,7 +854,7 @@ export default defineConfig({ ] }, { - label: "建设阶段", + label: "进阶", collapsed: true, items: [ "bedrock/bds/process/intro", @@ -930,7 +912,7 @@ export default defineConfig({ items: [ "bedrock/nukkit/intro", { - label: "准备工作", + label: "准备", collapsed: true, items: [ "bedrock/nukkit/preparation/intro", @@ -938,23 +920,18 @@ export default defineConfig({ label: "安装 Java", collapsed: true, items: [ - "general/java/intro", - "general/java/choose-and-download-and-install-java", - "general/java/environment", - "general/java/sdkman", - "general/java/faq" + "bedrock/preparation/java/intro", + "bedrock/preparation/java/choose-and-download-and-install-java", + "bedrock/preparation/java/environment", + "bedrock/preparation/java/sdkman", + "bedrock/preparation/java/faq" ] }, - "bedrock/nukkit/preparation/websites", - { - label: "文本编辑器", - collapsed: true, - autogenerate: { directory: "general/preparation/text-editor" } - } + "bedrock/nukkit/preparation/websites" ] }, { - label: "开始阶段", + label: "搭建", collapsed: true, items: [ "bedrock/nukkit/start/intro", @@ -986,35 +963,25 @@ export default defineConfig({ items: [ "bedrock/pocketmine/intro", { - label: "准备工作", + label: "准备", collapsed: true, items: [ "bedrock/pocketmine/preparation/intro", "bedrock/pocketmine/preparation/choose-and-download-and-install-php", - "bedrock/pocketmine/preparation/websites", - { - label: "文本编辑器", - collapsed: true, - autogenerate: { directory: "general/preparation/text-editor" } - } + "bedrock/pocketmine/preparation/websites" ] } ] }, { - label: "其他基岩版服务器核心", + label: "其他核心", items: [ { - label: "准备工作", + label: "准备", collapsed: true, items: [ "bedrock/misc/preparation/intro", - "bedrock/misc/preparation/websites", - { - label: "文本编辑器", - collapsed: true, - autogenerate: { directory: "general/preparation/text-editor" } - } + "bedrock/misc/preparation/websites" ] }, "bedrock/misc/allay", @@ -1027,23 +994,44 @@ export default defineConfig({ items: [ "bedrock/waterdogepe/intro", { - label: "安装 Java", + label: "准备", collapsed: true, items: [ - "general/java/intro", - "general/java/choose-and-download-and-install-java", - "general/java/environment", - "general/java/sdkman", - "general/java/faq" + { + label: "安装 Java", + collapsed: true, + items: [ + "bedrock/preparation/java/intro", + "bedrock/preparation/java/choose-and-download-and-install-java", + "bedrock/preparation/java/environment", + "bedrock/preparation/java/sdkman", + "bedrock/preparation/java/faq" + ] + }, ] }, + "bedrock/waterdogepe/install", + "bedrock/waterdogepe/config" + ] + }, + { + label: "服务器管理", + items: [ + "bedrock/advance/management/intro", { - label: "文本编辑器", + label: "玩家管理", collapsed: true, - autogenerate: { directory: "general/preparation/text-editor" } + autogenerate: { + directory: "bedrock/advance/management/player-management" + } }, - "bedrock/waterdogepe/install", - "bedrock/waterdogepe/config" + { + label: "资金管理", + collapsed: true, + autogenerate: { + directory: "bedrock/advance/management/money-management" + } + } ] } ] @@ -1057,7 +1045,20 @@ export default defineConfig({ ], { topics: { - basics: ["/basics", "/basics/**/*"] + basics: [ + "/basics", + "/basics/**/*", + "/general/java/**", + "/general/preparation/text-editor/**" + ], + java: [ + "/general/process/**", + "/general/advance/linux/**", + "/general/advance/domain-and-dns", + "/general/advance/bot/**", + "/general/advance/maintenance/**", + "/general/more/**" + ] } } ), diff --git a/src/components/LastUpdated.astro b/src/components/LastUpdated.astro index f8febc1c4..1a7f3f93a 100644 --- a/src/components/LastUpdated.astro +++ b/src/components/LastUpdated.astro @@ -1,20 +1,5 @@ --- -/* - * Copyright (c) PaperMC - * - * This file includes code derived from the PaperMC project, - * licensed under the BSD 2-Clause License. - * - * Modified by wling - */ - -import { Image } from "astro:assets"; -import { REPO, getCommitInfo } from "../utils/git"; - const { lang, lastUpdated } = Astro.locals.starlightRoute; -const filePath = Astro.locals.starlightRoute.entry.filePath; - -const info = await getCommitInfo(filePath); --- { @@ -29,25 +14,6 @@ const info = await getCommitInfo(filePath); })} - {info && ( - - 由{" "} - - {info.committer.avatar && ( - {info.committer.name} - )} - {info.committer.name} - {" "} - 在 {info.hash.substring(0, 7)} 提交 - - )}

) } diff --git a/src/content.config.ts b/src/content.config.ts index f95bb4267..d6799f033 100644 --- a/src/content.config.ts +++ b/src/content.config.ts @@ -7,9 +7,8 @@ export const collections = { docs: defineCollection({ loader: docsLoader(), schema: docsSchema({ - extend: z.object({ - giscus: z.boolean().optional().default(true), - topicSchema: topicSchema.optional() + extend: topicSchema.extend({ + giscus: z.boolean().optional().default(true) }) }) }) diff --git a/src/content/docs/bedrock/advance/management/intro.mdx b/src/content/docs/bedrock/advance/management/intro.mdx new file mode 100644 index 000000000..5c776a57c --- /dev/null +++ b/src/content/docs/bedrock/advance/management/intro.mdx @@ -0,0 +1,8 @@ +--- +title: 经营管理 +topic: bedrock +--- + +import Doc from "../../../general/advance/management/intro.md"; + + diff --git a/src/content/docs/bedrock/advance/management/money-management/investment-psychology.mdx b/src/content/docs/bedrock/advance/management/money-management/investment-psychology.mdx new file mode 100644 index 000000000..305e44f99 --- /dev/null +++ b/src/content/docs/bedrock/advance/management/money-management/investment-psychology.mdx @@ -0,0 +1,8 @@ +--- +title: 投资心理学 +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/money-management/investment-psychology.md"; + + diff --git a/src/content/docs/bedrock/advance/management/money-management/money-management.mdx b/src/content/docs/bedrock/advance/management/money-management/money-management.mdx new file mode 100644 index 000000000..9c557901b --- /dev/null +++ b/src/content/docs/bedrock/advance/management/money-management/money-management.mdx @@ -0,0 +1,8 @@ +--- +title: 资金管理 +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/money-management/money-management.md"; + + diff --git a/src/content/docs/bedrock/advance/management/money-management/sustainable-development.mdx b/src/content/docs/bedrock/advance/management/money-management/sustainable-development.mdx new file mode 100644 index 000000000..298f73e51 --- /dev/null +++ b/src/content/docs/bedrock/advance/management/money-management/sustainable-development.mdx @@ -0,0 +1,8 @@ +--- +title: 可持续性发展 +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/money-management/sustainable-development.md"; + + diff --git a/src/content/docs/bedrock/advance/management/player-management/announcement.mdx b/src/content/docs/bedrock/advance/management/player-management/announcement.mdx new file mode 100644 index 000000000..737980933 --- /dev/null +++ b/src/content/docs/bedrock/advance/management/player-management/announcement.mdx @@ -0,0 +1,8 @@ +--- +title: 服务器公告 +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/player-management/announcement.md"; + + diff --git a/src/content/docs/bedrock/advance/management/player-management/auditing.mdx b/src/content/docs/bedrock/advance/management/player-management/auditing.mdx new file mode 100644 index 000000000..6a66ff65a --- /dev/null +++ b/src/content/docs/bedrock/advance/management/player-management/auditing.mdx @@ -0,0 +1,8 @@ +--- +title: 进服审核 +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/player-management/auditing.md"; + + diff --git a/src/content/docs/bedrock/advance/management/player-management/chunkbase.mdx b/src/content/docs/bedrock/advance/management/player-management/chunkbase.mdx new file mode 100644 index 000000000..f9dead422 --- /dev/null +++ b/src/content/docs/bedrock/advance/management/player-management/chunkbase.mdx @@ -0,0 +1,8 @@ +--- +title: Chunkbase +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/player-management/chunkbase.md"; + + diff --git a/src/content/docs/bedrock/advance/management/player-management/client-distribution.mdx b/src/content/docs/bedrock/advance/management/player-management/client-distribution.mdx new file mode 100644 index 000000000..420a4d7ce --- /dev/null +++ b/src/content/docs/bedrock/advance/management/player-management/client-distribution.mdx @@ -0,0 +1,8 @@ +--- +title: 分发客户端 +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/player-management/client-distribution.mdx"; + + diff --git a/src/content/docs/bedrock/advance/management/player-management/feedback.mdx b/src/content/docs/bedrock/advance/management/player-management/feedback.mdx new file mode 100644 index 000000000..10d6e786d --- /dev/null +++ b/src/content/docs/bedrock/advance/management/player-management/feedback.mdx @@ -0,0 +1,8 @@ +--- +title: 玩家反馈 +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/player-management/feedback.md"; + + diff --git a/src/content/docs/bedrock/advance/management/player-management/platform.mdx b/src/content/docs/bedrock/advance/management/player-management/platform.mdx new file mode 100644 index 000000000..89b0e0a7a --- /dev/null +++ b/src/content/docs/bedrock/advance/management/player-management/platform.mdx @@ -0,0 +1,8 @@ +--- +title: 玩家交流平台 +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/player-management/platform.md"; + + diff --git a/src/content/docs/bedrock/advance/management/player-management/player-management.mdx b/src/content/docs/bedrock/advance/management/player-management/player-management.mdx new file mode 100644 index 000000000..b329ad4f9 --- /dev/null +++ b/src/content/docs/bedrock/advance/management/player-management/player-management.mdx @@ -0,0 +1,8 @@ +--- +title: 玩家管理 +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/player-management/player-management.md"; + + diff --git a/src/content/docs/bedrock/advance/management/player-management/rules.mdx b/src/content/docs/bedrock/advance/management/player-management/rules.mdx new file mode 100644 index 000000000..511f66876 --- /dev/null +++ b/src/content/docs/bedrock/advance/management/player-management/rules.mdx @@ -0,0 +1,8 @@ +--- +title: 服务器规则 +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/player-management/rules.md"; + + diff --git a/src/content/docs/bedrock/advance/management/player-management/whitelist.mdx b/src/content/docs/bedrock/advance/management/player-management/whitelist.mdx new file mode 100644 index 000000000..b5862e953 --- /dev/null +++ b/src/content/docs/bedrock/advance/management/player-management/whitelist.mdx @@ -0,0 +1,8 @@ +--- +title: 白名单制度 +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/player-management/whitelist.md"; + + diff --git a/src/content/docs/bedrock/advance/management/player-management/wiki.mdx b/src/content/docs/bedrock/advance/management/player-management/wiki.mdx new file mode 100644 index 000000000..4df6fc18a --- /dev/null +++ b/src/content/docs/bedrock/advance/management/player-management/wiki.mdx @@ -0,0 +1,8 @@ +--- +title: Minecraft Wiki +topic: bedrock +--- + +import Doc from "../../../../general/advance/management/player-management/wiki.md"; + + diff --git a/src/content/docs/bedrock/preparation/java/choose-and-download-and-install-java.mdx b/src/content/docs/bedrock/preparation/java/choose-and-download-and-install-java.mdx new file mode 100644 index 000000000..e1f6ed2f8 --- /dev/null +++ b/src/content/docs/bedrock/preparation/java/choose-and-download-and-install-java.mdx @@ -0,0 +1,8 @@ +--- +title: 选择、下载和安装 Java +topic: bedrock +--- + +import Doc from "../../../general/java/choose-and-download-and-install-java.md"; + + diff --git a/src/content/docs/bedrock/preparation/java/environment.mdx b/src/content/docs/bedrock/preparation/java/environment.mdx new file mode 100644 index 000000000..25338c6f5 --- /dev/null +++ b/src/content/docs/bedrock/preparation/java/environment.mdx @@ -0,0 +1,8 @@ +--- +title: 环境变量 +topic: bedrock +--- + +import Doc from "../../../general/java/environment.mdx"; + + diff --git a/src/content/docs/bedrock/preparation/java/faq.mdx b/src/content/docs/bedrock/preparation/java/faq.mdx new file mode 100644 index 000000000..f0993d884 --- /dev/null +++ b/src/content/docs/bedrock/preparation/java/faq.mdx @@ -0,0 +1,8 @@ +--- +title: FAQ +topic: bedrock +--- + +import Doc from "../../../general/java/faq.md"; + + diff --git a/src/content/docs/bedrock/preparation/java/intro.mdx b/src/content/docs/bedrock/preparation/java/intro.mdx new file mode 100644 index 000000000..c0e6fdfe6 --- /dev/null +++ b/src/content/docs/bedrock/preparation/java/intro.mdx @@ -0,0 +1,8 @@ +--- +title: 概述 +topic: bedrock +--- + +import Doc from "../../../general/java/intro.md"; + + diff --git a/src/content/docs/bedrock/preparation/java/sdkman.mdx b/src/content/docs/bedrock/preparation/java/sdkman.mdx new file mode 100644 index 000000000..a94ee4689 --- /dev/null +++ b/src/content/docs/bedrock/preparation/java/sdkman.mdx @@ -0,0 +1,8 @@ +--- +title: SDKMAN! +topic: bedrock +--- + +import Doc from "../../../general/java/sdkman.md"; + + diff --git a/src/content/docs/bedrock/preparation/text-editor/intro.mdx b/src/content/docs/bedrock/preparation/text-editor/intro.mdx new file mode 100644 index 000000000..5c182bf29 --- /dev/null +++ b/src/content/docs/bedrock/preparation/text-editor/intro.mdx @@ -0,0 +1,9 @@ +--- +title: 概述 +topic: bedrock +sidebar: + order: 1 +--- +import Doc from "../../../general/preparation/text-editor/intro.md"; + + diff --git a/src/content/docs/bedrock/preparation/text-editor/nano.mdx b/src/content/docs/bedrock/preparation/text-editor/nano.mdx new file mode 100644 index 000000000..e54de7d55 --- /dev/null +++ b/src/content/docs/bedrock/preparation/text-editor/nano.mdx @@ -0,0 +1,9 @@ +--- +title: Nano +topic: bedrock +sidebar: + order: 6 +--- +import Doc from "../../../general/preparation/text-editor/nano.md"; + + diff --git a/src/content/docs/bedrock/preparation/text-editor/notepad.mdx b/src/content/docs/bedrock/preparation/text-editor/notepad.mdx new file mode 100644 index 000000000..8bcbdaab9 --- /dev/null +++ b/src/content/docs/bedrock/preparation/text-editor/notepad.mdx @@ -0,0 +1,9 @@ +--- +title: Notepad 系列 +topic: bedrock +sidebar: + order: 3 +--- +import Doc from "../../../general/preparation/text-editor/notepad.md"; + + diff --git a/src/content/docs/bedrock/preparation/text-editor/sublime-text.mdx b/src/content/docs/bedrock/preparation/text-editor/sublime-text.mdx new file mode 100644 index 000000000..b04a40338 --- /dev/null +++ b/src/content/docs/bedrock/preparation/text-editor/sublime-text.mdx @@ -0,0 +1,9 @@ +--- +title: Sublime Text +topic: bedrock +sidebar: + order: 4 +--- +import Doc from "../../../general/preparation/text-editor/sublime-text.md"; + + diff --git a/src/content/docs/bedrock/preparation/text-editor/vim.mdx b/src/content/docs/bedrock/preparation/text-editor/vim.mdx new file mode 100644 index 000000000..2de33fbf7 --- /dev/null +++ b/src/content/docs/bedrock/preparation/text-editor/vim.mdx @@ -0,0 +1,9 @@ +--- +title: Vim +topic: bedrock +sidebar: + order: 5 +--- +import Doc from "../../../general/preparation/text-editor/vim.md"; + + diff --git a/src/content/docs/bedrock/preparation/text-editor/vscode.mdx b/src/content/docs/bedrock/preparation/text-editor/vscode.mdx new file mode 100644 index 000000000..8e7cbbb11 --- /dev/null +++ b/src/content/docs/bedrock/preparation/text-editor/vscode.mdx @@ -0,0 +1,8 @@ +--- +title: Visual Studio Code +topic: bedrock +--- + +import Doc from "../../../general/preparation/text-editor/vscode.md"; + + diff --git a/src/content/docs/general/advance/linux/keep-running.mdx b/src/content/docs/general/advance/linux/keep-running.mdx index a0fe5c799..f37012cec 100644 --- a/src/content/docs/general/advance/linux/keep-running.mdx +++ b/src/content/docs/general/advance/linux/keep-running.mdx @@ -18,20 +18,24 @@ import { TabItem, Tabs } from "@astrojs/starlight/components"; - ```bash - apt-get install screen - ``` + ```bash + apt-get install screen + ``` + - ```bash - yum install screen - ``` - + ```bash + yum install screen + ``` + + - ```bash - pacman -Sy screen - ``` + ```bash + pacman -Sy screen + ``` + + screen 的基础指令： diff --git a/src/content/docs/general/intro.md b/src/content/docs/general/intro.md index a8d9b32f2..582729995 100644 --- a/src/content/docs/general/intro.md +++ b/src/content/docs/general/intro.md @@ -1,5 +1,5 @@ --- -title: 笨蛋开服教程 +title: 概述 --- ![](../../../assets/nitwikit-banner.png) diff --git a/src/content/docs/general/preparation/text-editor/geany.md b/src/content/docs/general/preparation/text-editor/geany.md deleted file mode 100644 index 39636cedc..000000000 --- a/src/content/docs/general/preparation/text-editor/geany.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Geany ---- - -![](https://www.geany.org/media/uploads/screenshots/homepage/.thumbnails/geany_dark_2019-05-20.png/geany_dark_2019-05-20-500x0.png) - -官网链接：https://www.geany.org/ diff --git a/src/content/docs/general/preparation/text-editor/hbuilderx.md b/src/content/docs/general/preparation/text-editor/hbuilderx.md deleted file mode 100644 index 328fdfa67..000000000 --- a/src/content/docs/general/preparation/text-editor/hbuilderx.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: HbuilderX ---- - -![HbuilderX](_assets/HbuilderX展示.png) - -官网链接：https://dcloud.io/hbuilderx.html - -一个国产的文本编辑器。 - -:::caution - -该软件存在一些问题，例如编译需要登录、命令行中夹带广告等（[来源](https://www.zhihu.com/question/47889106/answer/3189683653)）。 - -::: - -### 关联右键菜单？ - -可以在工具 → 设置 (Ctrl + Alt + ，) 打开设置，找到“常用配置”手动选中【关联右键菜单】。 diff --git a/src/content/docs/general/preparation/text-editor/intro.md b/src/content/docs/general/preparation/text-editor/intro.md index d1f001355..fb90472de 100644 --- a/src/content/docs/general/preparation/text-editor/intro.md +++ b/src/content/docs/general/preparation/text-editor/intro.md @@ -6,19 +6,17 @@ sidebar: 一个好用的文本编辑器是 **相当** 重要的。 -它能够有效提高编辑插件、核心配置时的效率，降低错误使用语法的可能性。本文将介绍几个开服常用的文本编辑器。 +它能够有效提高编辑插件、核心配置时的效率，降低错误使用语法的可能性。下面的目录按推荐程度排序，越靠前的越推荐。 :::caution[注意] 请不要再使用 Windows 自带的记事本和写字板了。这些文本编辑器通常有以下问题： -1. 可能造成文件编码发生改变。小白操作时尤其容易出现，部分情况下用记事本和写字板保存文件后文件因编码改变等问题而无法服务器读取。 -2. 无法察觉到格式错误。有时编辑文件时会因为不小心删除或添加了些符号，导致配置文件语法错误，服务器无法识别。本文介绍的文本编辑器均能识别出这些格式错误并做出提示和警告，然而记事本和写字板却不具备这些功能。 -3. 无法准确地辨认缩进等格式。这些文本编辑器由于默认不使用 [等宽字体](https://baike.baidu.com/item/%E7%AD%89%E5%AE%BD%E5%AD%97%E4%BD%93/8434037) 显示文字，导致其显示效果与原格式存在差异。 -4. 没有语法高亮功能。在编辑配置文件时，语法高亮功能可以让你高效快速地找到指定配置项和值。它让配置文件更易于阅读，整体上提高了在服务器上进行操作的效率。本文介绍的文本编辑器均能识别出这些格式错误并做出提示和警告，然而记事本和写字板却不具备这些功能。 +1. 可能造成文件编码发生改变。 +2. 无法察觉到格式错误。 +3. 无法准确地辨认缩进等格式。 +4. 没有语法高亮功能。 -::: - -出于多方面原因，不推荐使用 GitHub 官方出品的 Atom，它已在 2022 年 12 月由于安全原因宣布停止维护。 +本文介绍的文本编辑器均能解决以上问题。 -接下来介绍几个常用的文本编辑器，供大家选择。 +::: diff --git a/src/content/docs/general/preparation/text-editor/kate.md b/src/content/docs/general/preparation/text-editor/kate.md deleted file mode 100644 index 1e76a02f5..000000000 --- a/src/content/docs/general/preparation/text-editor/kate.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Kate ---- - -![Kate](https://kate-editor.org/images/konsole.png) - -官网链接：https://kate-editor.org/zh-cn/ - -开源，跨平台，也可以秒开文件。 diff --git a/src/content/docs/general/preparation/text-editor/nano.md b/src/content/docs/general/preparation/text-editor/nano.md index ac61f219a..9e22204a5 100644 --- a/src/content/docs/general/preparation/text-editor/nano.md +++ b/src/content/docs/general/preparation/text-editor/nano.md @@ -1,15 +1,13 @@ --- title: Nano +sidebar: + order: 6 --- -![](_assets/nano展示.png) +简单易用的命令行文本编辑器，非常适合 Linux 初学者。如果你不会用 Vim，可以尝试 Nano。 -官网链接：https://www.nano-editor.org/ +![Nano](_assets/nano展示.png) -Nano 是一个简单易用的命令行文本编辑器，非常适合 Linux 初学者使用。如果你不会用 Vim 可以尝试使用 Nano。 +使用 `nano 文件名` 打开文件后即可直接编辑。按 `Ctrl+O` 保存，`Ctrl+X` 退出。所有常用操作都显示在屏幕底部，无需记忆快捷键。 -使用 `nano 文件名` 打开一个已有文件或创建一个新文件，打开后即可直接开始编辑。编辑完成后，按下 `Ctrl+O` 保存文件（会提示确认文件名），然后按 `Ctrl+X` 退出编辑器。如果文件尚未保存，Nano 会提醒你是否保存。~~十分甚至九分的温馨。~~ - -Nano 的所有常用操作都显示在屏幕底部，例如 `^G` 表示 `Ctrl+G` 可获取帮助，`^X` 退出等。你还可以使用 `Ctrl+W` 搜索文本，`Ctrl+K` 剪切行，`Ctrl+U` 粘贴，~~十分甚至九分的方便。~~ - -Nano 是自由软件，遵循 GNU 通用公共许可证发布。 +- 官网：[nano-editor.org](https://www.nano-editor.org/) diff --git a/src/content/docs/general/preparation/text-editor/notepad++.md b/src/content/docs/general/preparation/text-editor/notepad++.md deleted file mode 100644 index b090590c7..000000000 --- a/src/content/docs/general/preparation/text-editor/notepad++.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Notepad++ ---- - -![NPPesu](_assets/Npp展示.png) - -可用，相关功能也较为完善。 - -:::danger - -作者政治立场可能引起众怒，但请理性看待： - -[Notepad++](http://www.notepadplus.com.cn/) 作者台独 + 多次辱 H [这里](https://cn.bing.com/search?q=notepad%2B%2B%E8%BE%B1%E5%8D%8E)。 - -2008 年奥运会 notepad++ 的主页上出现了“dizhi 奥运会”； - -2023 年发文威胁若用户不认同其政治观点，就在源代码中添加随机字符（事后辩称为“开玩笑”）[这里](https://zhuanlan.zhihu.com/p/609192758)。 - -可替代为 [Notepad--](/general/preparation/text-editor/notepad--) 等。 - -::: diff --git a/src/content/docs/general/preparation/text-editor/notepad--.md b/src/content/docs/general/preparation/text-editor/notepad--.md deleted file mode 100644 index 7a16390fc..000000000 --- a/src/content/docs/general/preparation/text-editor/notepad--.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: Notepad-- ---- - -![Notepad--](_assets/N减减展示.png) - -国内作者维护的 Notepad++ 的替代品。 - -[`Gitee`](https://gitee.com/cxasm/notepad--) -[`GitHub`](https://github.com/cxasm/notepad--) diff --git a/src/content/docs/general/preparation/text-editor/notepad.md b/src/content/docs/general/preparation/text-editor/notepad.md new file mode 100644 index 000000000..f8bac6d2d --- /dev/null +++ b/src/content/docs/general/preparation/text-editor/notepad.md @@ -0,0 +1,37 @@ +--- +title: Notepad 系列 +sidebar: + order: 3 +--- + +Notepad 系列是 Windows 平台最常用的免费文本编辑器家族。这里介绍三个主流选择：Notepad++、国产替代 Notepad--，以及轻量级的 Notepad3。 + +## Notepad++ + +![Notepad++](_assets/Npp展示.png) + +Windows 平台最知名的免费文本编辑器，功能完善，插件丰富。 + +:::danger +作者曾多次发表不当政治言论。如果你介意，可选择下方的 Notepad-- 或 Notepad3 作为替代。 +::: + +- 官网：[notepad-plus-plus.org](https://notepad-plus-plus.org/) + +## Notepad-- + +![Notepad--](_assets/N减减展示.png) + +国内作者维护的 Notepad++ 替代品，界面和操作习惯与 Notepad++ 高度一致。 + +- [Gitee](https://gitee.com/cxasm/notepad--) +- [GitHub](https://github.com/cxasm/notepad--) + +## Notepad3 + +![Notepad3](https://www.rizonesoft.com/wp-content/uploads/2023/09/notepad3-screenshot-1.jpg) + +轻量级的文本编辑器，基于 Scintilla，要求 Windows 7 及以上。 + +- 官网：[rizonesoft.com](https://rizonesoft.com/downloads/notepad3/) +- [GitHub](https://github.com/rizonesoft/Notepad3) diff --git a/src/content/docs/general/preparation/text-editor/notepad3.md b/src/content/docs/general/preparation/text-editor/notepad3.md deleted file mode 100644 index f81b923f4..000000000 --- a/src/content/docs/general/preparation/text-editor/notepad3.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Notepad3 ---- - -![Notepad3](https://www.rizonesoft.com/wp-content/uploads/2023/09/notepad3-screenshot-1.jpg) - -也是一个比较不错的文本编辑器。要求：**Windows 7 +**。 - -官网链接：https://rizonesoft.com/downloads/notepad3/ - -GitHub: https://github.com/rizonesoft/Notepad3 diff --git a/src/content/docs/general/preparation/text-editor/sublime-text.md b/src/content/docs/general/preparation/text-editor/sublime-text.md index 9ec3a6f8d..c4f29b9a3 100644 --- a/src/content/docs/general/preparation/text-editor/sublime-text.md +++ b/src/content/docs/general/preparation/text-editor/sublime-text.md @@ -1,11 +1,14 @@ --- title: Sublime Text +sidebar: + order: 4 --- -![Sublime Text](_assets/sublime展示.png) +经典轻量级文本编辑器，启动极快，界面简洁。 -我不太喜欢的一点是保存文件时，对非激活的用户有一定概率弹出个窗口，提示你去付费支持 (可以选择不支持)。但这依旧是一个非常优秀的文本编辑器。 +![Sublime Text](_assets/sublime展示.png) -官网链接：https://www.sublimetext.com/ +非常优秀的编辑器，功能强大。保存文件时偶尔会弹出付费提示（可选择跳过）。 -[如何汉化](https://cn.bing.com/search?q=sublime+text%e6%b1%89%e5%8c%96&qs=SC&pq=sublimetext&sk=HS1SC5&sc=10-11&cvid=19623440FA3646E0BEBECEED995CFCAF&FORM=QBRE&sp=7&lq=0) +- 官网：[sublimetext.com](https://www.sublimetext.com/) +- [如何汉化](https://cn.bing.com/search?q=sublime+text%e6%b1%89%e5%8c%96) diff --git a/src/content/docs/general/preparation/text-editor/vim.md b/src/content/docs/general/preparation/text-editor/vim.md index 4379be29d..7aa667567 100644 --- a/src/content/docs/general/preparation/text-editor/vim.md +++ b/src/content/docs/general/preparation/text-editor/vim.md @@ -1,13 +1,13 @@ --- title: Vim +sidebar: + order: 5 --- -![](https://www.vim.org/images/vim_header.gif) +纯命令行文本编辑器，SSH 远程管理服务器的必备工具。 -官网链接：https://www.vim.org/ +![Vim](https://www.vim.org/images/vim_header.gif) -这是一个纯命令行的编辑器，适用于在 SSH 或 Web Shell 中编辑，甚至是服务器上没有安装图形界面的场景，也具有图形化版本（GVim）和其他分支（例如 NeoVim）。 +无需图形界面，适用于终端环境。使用 `vim 文件名` 打开文件，按 `I` 进入编辑模式，编辑完成后按 `ESC` 退出编辑模式，输入 `:wq` 保存并退出。 -使用 `vim 文件名` 打开一个文件或者创建一个文件，然后按下 `I` 键开始编辑，编辑好后按下 `ESC` 退出，输入 `:wq` 命令即可保存，若不能保存，使用 `:wq!` 命令。 - -Vim 是可自由分发的开放源代码软件。 +- 官网：[vim.org](https://www.vim.org/) diff --git a/src/content/docs/general/preparation/text-editor/vscode.md b/src/content/docs/general/preparation/text-editor/vscode.md index c3716f890..8b3a3a63f 100644 --- a/src/content/docs/general/preparation/text-editor/vscode.md +++ b/src/content/docs/general/preparation/text-editor/vscode.md @@ -4,32 +4,17 @@ sidebar: order: 2 --- -![官网图片](https://code.visualstudio.com/assets/docs/getstarted/getting-started/terminal-new-file.png) +**最推荐的文本编辑器**，全能型，支持简体中文，跨平台（Windows / Linux / Mac）。 -全能型文本编辑器，**非常非常推荐**，支持简体中文 / 繁体中文 / 英文，支持 `Windows 10 +` , `Linux` 和 `Mac`。 +![VS Code](https://code.visualstudio.com/assets/docs/getstarted/getting-started/terminal-new-file.png) -缺点是启动速度可能不是很快，不过非常适合新手使用。(已经算是比较快的了。) +功能强大，插件生态丰富，对新手非常友好。启动速度可能不是最快，但完全可以接受。 -官网链接：https://code.visualstudio.com/ +:::tip[保存提示] +编辑完后记得保存文件。VS Code 会在未保存的文件标签上标记白点，提醒你尚未保存。快捷键 `Ctrl + S` 保存，也可以在菜单中开启自动保存。 +::: -你要 **记得保存文件** - -发现有人第一次用文本编辑器不知道编辑完后保存。 - -![](_assets/白点.png) - -VS Code 会在未保存的文件后标记一个白点，提示你这个文件编辑了但是没有保存 (其他文本编辑器类似)。 - -![](_assets/vscode保存和自动保存.png) - -保存按钮 (红色箭头)，也可以用快捷键来保存 `Ctrl + S`。 - -开启自动保存 (绿色箭头)。 - -~~当年 TrMenu 的自动重载治好了我的 autosave~~ - -[Windows 下载镜像](https://dl.8aka.org/plugins/VSCodeUserSetup-x64-1.94.0.exe) - -[下载龟速怎么办](https://cn.bing.com/search?q=vscode%E4%B8%8B%E8%BD%BD%E9%BE%9F%E9%80%9F%E6%80%8E%E4%B9%88%E5%8A%9E) - -[VS Code 视频安装教程](https://www.bilibili.com/video/BV1nM4m117Fv/?share_source=copy_web) +- 官网：[code.visualstudio.com](https://code.visualstudio.com/) +- [Windows 下载镜像](https://dl.8aka.org/plugins/VSCodeUserSetup-x64-1.94.0.exe) +- [下载慢怎么办](https://cn.bing.com/search?q=vscode%E4%B8%8B%E8%BD%BD%E9%BE%9F%E9%80%9F%E6%80%8E%E4%B9%88%E5%8A%9E) +- [视频安装教程](https://www.bilibili.com/video/BV1nM4m117Fv/) diff --git a/src/content/docs/java/preparation/java/choose-and-download-and-install-java.mdx b/src/content/docs/java/preparation/java/choose-and-download-and-install-java.mdx new file mode 100644 index 000000000..d0de245ce --- /dev/null +++ b/src/content/docs/java/preparation/java/choose-and-download-and-install-java.mdx @@ -0,0 +1,8 @@ +--- +title: 选择、下载和安装 Java +topic: java +--- + +import Doc from "../../../general/java/choose-and-download-and-install-java.md"; + + diff --git a/src/content/docs/java/preparation/java/environment.mdx b/src/content/docs/java/preparation/java/environment.mdx new file mode 100644 index 000000000..9061b3221 --- /dev/null +++ b/src/content/docs/java/preparation/java/environment.mdx @@ -0,0 +1,8 @@ +--- +title: 环境变量 +topic: java +--- + +import Doc from "../../../general/java/environment.mdx"; + + diff --git a/src/content/docs/java/preparation/java/faq.mdx b/src/content/docs/java/preparation/java/faq.mdx new file mode 100644 index 000000000..a886e2b44 --- /dev/null +++ b/src/content/docs/java/preparation/java/faq.mdx @@ -0,0 +1,8 @@ +--- +title: FAQ +topic: java +--- + +import Doc from "../../../general/java/faq.md"; + + diff --git a/src/content/docs/java/preparation/java/intro.mdx b/src/content/docs/java/preparation/java/intro.mdx new file mode 100644 index 000000000..db1157d12 --- /dev/null +++ b/src/content/docs/java/preparation/java/intro.mdx @@ -0,0 +1,8 @@ +--- +title: 概述 +topic: java +--- + +import Doc from "../../../general/java/intro.md"; + + diff --git a/src/content/docs/java/preparation/java/sdkman.mdx b/src/content/docs/java/preparation/java/sdkman.mdx new file mode 100644 index 000000000..b95fc286d --- /dev/null +++ b/src/content/docs/java/preparation/java/sdkman.mdx @@ -0,0 +1,8 @@ +--- +title: SDKMAN! +topic: java +--- + +import Doc from "../../../general/java/sdkman.md"; + + diff --git a/src/content/docs/java/preparation/text-editor/intro.mdx b/src/content/docs/java/preparation/text-editor/intro.mdx new file mode 100644 index 000000000..4593c7aff --- /dev/null +++ b/src/content/docs/java/preparation/text-editor/intro.mdx @@ -0,0 +1,9 @@ +--- +title: 概述 +topic: java +sidebar: + order: 1 +--- +import Doc from "../../../general/preparation/text-editor/intro.md"; + + diff --git a/src/content/docs/java/preparation/text-editor/nano.mdx b/src/content/docs/java/preparation/text-editor/nano.mdx new file mode 100644 index 000000000..21bd66f95 --- /dev/null +++ b/src/content/docs/java/preparation/text-editor/nano.mdx @@ -0,0 +1,9 @@ +--- +title: Nano +topic: java +sidebar: + order: 6 +--- +import Doc from "../../../general/preparation/text-editor/nano.md"; + + diff --git a/src/content/docs/java/preparation/text-editor/notepad.mdx b/src/content/docs/java/preparation/text-editor/notepad.mdx new file mode 100644 index 000000000..e6e7cf5ff --- /dev/null +++ b/src/content/docs/java/preparation/text-editor/notepad.mdx @@ -0,0 +1,9 @@ +--- +title: Notepad 系列 +topic: java +sidebar: + order: 3 +--- +import Doc from "../../../general/preparation/text-editor/notepad.md"; + + diff --git a/src/content/docs/java/preparation/text-editor/sublime-text.mdx b/src/content/docs/java/preparation/text-editor/sublime-text.mdx new file mode 100644 index 000000000..86085b713 --- /dev/null +++ b/src/content/docs/java/preparation/text-editor/sublime-text.mdx @@ -0,0 +1,9 @@ +--- +title: Sublime Text +topic: java +sidebar: + order: 4 +--- +import Doc from "../../../general/preparation/text-editor/sublime-text.md"; + + diff --git a/src/content/docs/java/preparation/text-editor/vim.mdx b/src/content/docs/java/preparation/text-editor/vim.mdx new file mode 100644 index 000000000..0c615c253 --- /dev/null +++ b/src/content/docs/java/preparation/text-editor/vim.mdx @@ -0,0 +1,9 @@ +--- +title: Vim +topic: java +sidebar: + order: 5 +--- +import Doc from "../../../general/preparation/text-editor/vim.md"; + + diff --git a/src/content/docs/java/preparation/text-editor/vscode.mdx b/src/content/docs/java/preparation/text-editor/vscode.mdx new file mode 100644 index 000000000..cfc34edfd --- /dev/null +++ b/src/content/docs/java/preparation/text-editor/vscode.mdx @@ -0,0 +1,9 @@ +--- +title: Visual Studio Code +topic: java +sidebar: + order: 2 +--- +import Doc from "../../../general/preparation/text-editor/vscode.md"; + + diff --git a/src/styles/global.css b/src/styles/global.css index 609cf315e..e0dcb5a0a 100644 --- a/src/styles/global.css +++ b/src/styles/global.css @@ -1,8 +1,8 @@ @layer base, starlight, theme, components, utilities; @import "@astrojs/starlight-tailwind"; -@import 'tailwindcss/theme.css' layer(theme); -@import 'tailwindcss/utilities.css' layer(utilities); +@import "tailwindcss/theme.css" layer(theme); +@import "tailwindcss/utilities.css" layer(utilities); @plugin "daisyui" { prefix: daisy-; diff --git a/src/utils/git.ts b/src/utils/git.ts deleted file mode 100644 index ac7741ea9..000000000 --- a/src/utils/git.ts +++ /dev/null @@ -1,51 +0,0 @@ -/* - * Copyright (c) PaperMC - * - * This file includes code derived from the PaperMC project, - * licensed under the BSD 2-Clause License. - */ - -import { execSync } from "child_process"; - -export interface CommitterInfo { - name: string; - href: string; - avatar?: string; -} - -export interface CommitInfo { - hash: string; - committer: CommitterInfo; -} - -export const REPO = "Cubic-Project/NitWikit"; -const cache = new Map(); - -export const getCommitInfo = async (filePath: string): Promise => { - let hash: string, email: string, name: string; - try { - [hash, email, name] = execSync(`git log -1 --format="%H,%ae,%an" -- "${filePath}"`) - .toString() - .trim() - .split(",", 3); - } catch (e) { - return null; - } - - const cached = cache.get(email); - if (cached) { - return { hash, committer: cached }; - } - - const info: CommitterInfo = { name, href: `mailto:${email}` }; - - const res = await fetch(`https://api.github.com/repos/${REPO}/commits/${hash}`); - if (res.ok) { - const commit = await res.json(); - info.href = commit.author.html_url; - info.avatar = commit.author.avatar_url; - } - - cache.set(email, info); - return { hash, committer: info }; -};