From 80268937eef3119a4e8451e09fe4bd34612505eb Mon Sep 17 00:00:00 2001 From: cqh963852 Date: Wed, 19 Aug 2026 14:20:50 +0800 Subject: [PATCH] =?UTF-8?q?refactor:=20=E5=B7=A5=E5=85=B7=E4=BD=BF?= =?UTF-8?q?=E7=94=A8=E6=94=B9=E4=B8=BA=E7=8B=AC=E7=AB=8B=20docs=20?= =?UTF-8?q?=E5=AE=9E=E4=BE=8B=EF=BC=8C=E8=B7=AF=E7=94=B1=E4=BB=8E=20/docs/?= =?UTF-8?q?tools=20=E8=BF=81=E7=A7=BB=E5=88=B0=20/tools?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docs/tools 移至 packages/stack-idealjs/tools - 新增 @docusaurus/plugin-content-docs tools 实例与 sidebarsTools.ts - 导航栏"工具使用"指向独立侧边栏 toolsSidebar - 修复 prisma 文档中的旧路径链接 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- packages/stack-idealjs/docusaurus.config.ts | 19 ++++++++++++++++-- packages/stack-idealjs/sidebarsTools.ts | 8 ++++++++ .../{docs => }/tools/_category_.json | 0 .../{docs => }/tools/docker/1.png | Bin .../{docs => }/tools/docker/2.png | Bin .../{docs => }/tools/docker/5.png | Bin .../{docs => }/tools/docker/6.png | Bin .../{docs => }/tools/docker/7.png | Bin .../{docs => }/tools/docker/8.png | Bin .../{docs => }/tools/docker/_category_.json | 0 .../{docs => }/tools/docker/install.md | 0 .../{docs => }/tools/docker/start.md | 0 .../{docs => }/tools/git/_category_.json | 0 .../{docs => }/tools/git/index.mdx | 0 .../{docs => }/tools/git/post-1-1.png | Bin .../{docs => }/tools/git/post-1-2.png | Bin .../stack-idealjs/{docs => }/tools/index.md | 0 .../{docs => }/tools/install/_category_.json | 0 .../{docs => }/tools/install/nodejs.md | 0 .../{docs => }/tools/install/vscode.md | 0 .../{docs => }/tools/linux/_category_.json | 0 .../{docs => }/tools/linux/alias.md | 0 .../{docs => }/tools/nvm/_category_.json | 0 .../{docs => }/tools/nvm/install_nvm.md | 0 .../{docs => }/tools/nvm/nvm.png | Bin .../{docs => }/tools/prisma/_category_.json | 0 .../{docs => }/tools/prisma/prisma.md | 2 +- .../{docs => }/tools/prisma/verify1.png | Bin .../{docs => }/tools/prisma/verify2.png | Bin .../{docs => }/tools/vscode/_category_.json | 0 .../{docs => }/tools/vscode/code.png | Bin .../{docs => }/tools/vscode/exception.md | 0 .../{docs => }/tools/vscode/json.png | Bin .../{docs => }/tools/vscode/marketplace.png | Bin .../{docs => }/tools/vscode/setting.png | Bin 35 files changed, 26 insertions(+), 3 deletions(-) create mode 100644 packages/stack-idealjs/sidebarsTools.ts rename packages/stack-idealjs/{docs => }/tools/_category_.json (100%) rename packages/stack-idealjs/{docs => }/tools/docker/1.png (100%) rename packages/stack-idealjs/{docs => }/tools/docker/2.png (100%) rename packages/stack-idealjs/{docs => }/tools/docker/5.png (100%) rename packages/stack-idealjs/{docs => }/tools/docker/6.png (100%) rename packages/stack-idealjs/{docs => }/tools/docker/7.png (100%) rename packages/stack-idealjs/{docs => }/tools/docker/8.png (100%) rename packages/stack-idealjs/{docs => }/tools/docker/_category_.json (100%) rename packages/stack-idealjs/{docs => }/tools/docker/install.md (100%) rename packages/stack-idealjs/{docs => }/tools/docker/start.md (100%) rename packages/stack-idealjs/{docs => }/tools/git/_category_.json (100%) rename packages/stack-idealjs/{docs => }/tools/git/index.mdx (100%) rename packages/stack-idealjs/{docs => }/tools/git/post-1-1.png (100%) rename packages/stack-idealjs/{docs => }/tools/git/post-1-2.png (100%) rename packages/stack-idealjs/{docs => }/tools/index.md (100%) rename packages/stack-idealjs/{docs => }/tools/install/_category_.json (100%) rename packages/stack-idealjs/{docs => }/tools/install/nodejs.md (100%) rename packages/stack-idealjs/{docs => }/tools/install/vscode.md (100%) rename packages/stack-idealjs/{docs => }/tools/linux/_category_.json (100%) rename packages/stack-idealjs/{docs => }/tools/linux/alias.md (100%) rename packages/stack-idealjs/{docs => }/tools/nvm/_category_.json (100%) rename packages/stack-idealjs/{docs => }/tools/nvm/install_nvm.md (100%) rename packages/stack-idealjs/{docs => }/tools/nvm/nvm.png (100%) rename packages/stack-idealjs/{docs => }/tools/prisma/_category_.json (100%) rename packages/stack-idealjs/{docs => }/tools/prisma/prisma.md (97%) rename packages/stack-idealjs/{docs => }/tools/prisma/verify1.png (100%) rename packages/stack-idealjs/{docs => }/tools/prisma/verify2.png (100%) rename packages/stack-idealjs/{docs => }/tools/vscode/_category_.json (100%) rename packages/stack-idealjs/{docs => }/tools/vscode/code.png (100%) rename packages/stack-idealjs/{docs => }/tools/vscode/exception.md (100%) rename packages/stack-idealjs/{docs => }/tools/vscode/json.png (100%) rename packages/stack-idealjs/{docs => }/tools/vscode/marketplace.png (100%) rename packages/stack-idealjs/{docs => }/tools/vscode/setting.png (100%) diff --git a/packages/stack-idealjs/docusaurus.config.ts b/packages/stack-idealjs/docusaurus.config.ts index 6696d83..5216853 100644 --- a/packages/stack-idealjs/docusaurus.config.ts +++ b/packages/stack-idealjs/docusaurus.config.ts @@ -69,6 +69,20 @@ const config: Config = { ], ], + plugins: [ + [ + "@docusaurus/plugin-content-docs", + { + id: "tools", + path: "tools", + routeBasePath: "tools", + sidebarPath: "./sidebarsTools.ts", + editUrl: + "https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/", + }, + ], + ], + themeConfig: { // Replace with your project's social card image: "img/docusaurus-social-card.jpg", @@ -86,8 +100,9 @@ const config: Config = { label: "全栈教程", }, { - type: "doc", - docId: "tools/index", + type: "docSidebar", + sidebarId: "toolsSidebar", + docsPluginId: "tools", position: "left", label: "工具使用", }, diff --git a/packages/stack-idealjs/sidebarsTools.ts b/packages/stack-idealjs/sidebarsTools.ts new file mode 100644 index 0000000..617289f --- /dev/null +++ b/packages/stack-idealjs/sidebarsTools.ts @@ -0,0 +1,8 @@ +import type {SidebarsConfig} from '@docusaurus/plugin-content-docs'; + +// 工具使用（本地工具）侧边栏，独立于全栈教程 +const sidebars: SidebarsConfig = { + toolsSidebar: [{type: 'autogenerated', dirName: '.'}], +}; + +export default sidebars; diff --git a/packages/stack-idealjs/docs/tools/_category_.json b/packages/stack-idealjs/tools/_category_.json similarity index 100% rename from packages/stack-idealjs/docs/tools/_category_.json rename to packages/stack-idealjs/tools/_category_.json diff --git a/packages/stack-idealjs/docs/tools/docker/1.png b/packages/stack-idealjs/tools/docker/1.png similarity index 100% rename from packages/stack-idealjs/docs/tools/docker/1.png rename to packages/stack-idealjs/tools/docker/1.png diff --git a/packages/stack-idealjs/docs/tools/docker/2.png b/packages/stack-idealjs/tools/docker/2.png similarity index 100% rename from packages/stack-idealjs/docs/tools/docker/2.png rename to packages/stack-idealjs/tools/docker/2.png diff --git a/packages/stack-idealjs/docs/tools/docker/5.png b/packages/stack-idealjs/tools/docker/5.png similarity index 100% rename from packages/stack-idealjs/docs/tools/docker/5.png rename to packages/stack-idealjs/tools/docker/5.png diff --git a/packages/stack-idealjs/docs/tools/docker/6.png b/packages/stack-idealjs/tools/docker/6.png similarity index 100% rename from packages/stack-idealjs/docs/tools/docker/6.png rename to packages/stack-idealjs/tools/docker/6.png diff --git a/packages/stack-idealjs/docs/tools/docker/7.png b/packages/stack-idealjs/tools/docker/7.png similarity index 100% rename from packages/stack-idealjs/docs/tools/docker/7.png rename to packages/stack-idealjs/tools/docker/7.png diff --git a/packages/stack-idealjs/docs/tools/docker/8.png b/packages/stack-idealjs/tools/docker/8.png similarity index 100% rename from packages/stack-idealjs/docs/tools/docker/8.png rename to packages/stack-idealjs/tools/docker/8.png diff --git a/packages/stack-idealjs/docs/tools/docker/_category_.json b/packages/stack-idealjs/tools/docker/_category_.json similarity index 100% rename from packages/stack-idealjs/docs/tools/docker/_category_.json rename to packages/stack-idealjs/tools/docker/_category_.json diff --git a/packages/stack-idealjs/docs/tools/docker/install.md b/packages/stack-idealjs/tools/docker/install.md similarity index 100% rename from packages/stack-idealjs/docs/tools/docker/install.md rename to packages/stack-idealjs/tools/docker/install.md diff --git a/packages/stack-idealjs/docs/tools/docker/start.md b/packages/stack-idealjs/tools/docker/start.md similarity index 100% rename from packages/stack-idealjs/docs/tools/docker/start.md rename to packages/stack-idealjs/tools/docker/start.md diff --git a/packages/stack-idealjs/docs/tools/git/_category_.json b/packages/stack-idealjs/tools/git/_category_.json similarity index 100% rename from packages/stack-idealjs/docs/tools/git/_category_.json rename to packages/stack-idealjs/tools/git/_category_.json diff --git a/packages/stack-idealjs/docs/tools/git/index.mdx b/packages/stack-idealjs/tools/git/index.mdx similarity index 100% rename from packages/stack-idealjs/docs/tools/git/index.mdx rename to packages/stack-idealjs/tools/git/index.mdx diff --git a/packages/stack-idealjs/docs/tools/git/post-1-1.png b/packages/stack-idealjs/tools/git/post-1-1.png similarity index 100% rename from packages/stack-idealjs/docs/tools/git/post-1-1.png rename to packages/stack-idealjs/tools/git/post-1-1.png diff --git a/packages/stack-idealjs/docs/tools/git/post-1-2.png b/packages/stack-idealjs/tools/git/post-1-2.png similarity index 100% rename from packages/stack-idealjs/docs/tools/git/post-1-2.png rename to packages/stack-idealjs/tools/git/post-1-2.png diff --git a/packages/stack-idealjs/docs/tools/index.md b/packages/stack-idealjs/tools/index.md similarity index 100% rename from packages/stack-idealjs/docs/tools/index.md rename to packages/stack-idealjs/tools/index.md diff --git a/packages/stack-idealjs/docs/tools/install/_category_.json b/packages/stack-idealjs/tools/install/_category_.json similarity index 100% rename from packages/stack-idealjs/docs/tools/install/_category_.json rename to packages/stack-idealjs/tools/install/_category_.json diff --git a/packages/stack-idealjs/docs/tools/install/nodejs.md b/packages/stack-idealjs/tools/install/nodejs.md similarity index 100% rename from packages/stack-idealjs/docs/tools/install/nodejs.md rename to packages/stack-idealjs/tools/install/nodejs.md diff --git a/packages/stack-idealjs/docs/tools/install/vscode.md b/packages/stack-idealjs/tools/install/vscode.md similarity index 100% rename from packages/stack-idealjs/docs/tools/install/vscode.md rename to packages/stack-idealjs/tools/install/vscode.md diff --git a/packages/stack-idealjs/docs/tools/linux/_category_.json b/packages/stack-idealjs/tools/linux/_category_.json similarity index 100% rename from packages/stack-idealjs/docs/tools/linux/_category_.json rename to packages/stack-idealjs/tools/linux/_category_.json diff --git a/packages/stack-idealjs/docs/tools/linux/alias.md b/packages/stack-idealjs/tools/linux/alias.md similarity index 100% rename from packages/stack-idealjs/docs/tools/linux/alias.md rename to packages/stack-idealjs/tools/linux/alias.md diff --git a/packages/stack-idealjs/docs/tools/nvm/_category_.json b/packages/stack-idealjs/tools/nvm/_category_.json similarity index 100% rename from packages/stack-idealjs/docs/tools/nvm/_category_.json rename to packages/stack-idealjs/tools/nvm/_category_.json diff --git a/packages/stack-idealjs/docs/tools/nvm/install_nvm.md b/packages/stack-idealjs/tools/nvm/install_nvm.md similarity index 100% rename from packages/stack-idealjs/docs/tools/nvm/install_nvm.md rename to packages/stack-idealjs/tools/nvm/install_nvm.md diff --git a/packages/stack-idealjs/docs/tools/nvm/nvm.png b/packages/stack-idealjs/tools/nvm/nvm.png similarity index 100% rename from packages/stack-idealjs/docs/tools/nvm/nvm.png rename to packages/stack-idealjs/tools/nvm/nvm.png diff --git a/packages/stack-idealjs/docs/tools/prisma/_category_.json b/packages/stack-idealjs/tools/prisma/_category_.json similarity index 100% rename from packages/stack-idealjs/docs/tools/prisma/_category_.json rename to packages/stack-idealjs/tools/prisma/_category_.json diff --git a/packages/stack-idealjs/docs/tools/prisma/prisma.md b/packages/stack-idealjs/tools/prisma/prisma.md similarity index 97% rename from packages/stack-idealjs/docs/tools/prisma/prisma.md rename to packages/stack-idealjs/tools/prisma/prisma.md index 308c0f4..deef634 100644 --- a/packages/stack-idealjs/docs/tools/prisma/prisma.md +++ b/packages/stack-idealjs/tools/prisma/prisma.md @@ -13,7 +13,7 @@ sidebar_position: 1 5. 确认已启动数据库 >**提示** -如果不知道怎么启动数据库，可以参考使用 [Docker启动数据库](/docs/tools/docker/start)文档 +如果不知道怎么启动数据库，可以参考使用 [Docker启动数据库](/tools/docker/start)文档 ## 项目初始化 - 打开Next.js项目 diff --git a/packages/stack-idealjs/docs/tools/prisma/verify1.png b/packages/stack-idealjs/tools/prisma/verify1.png similarity index 100% rename from packages/stack-idealjs/docs/tools/prisma/verify1.png rename to packages/stack-idealjs/tools/prisma/verify1.png diff --git a/packages/stack-idealjs/docs/tools/prisma/verify2.png b/packages/stack-idealjs/tools/prisma/verify2.png similarity index 100% rename from packages/stack-idealjs/docs/tools/prisma/verify2.png rename to packages/stack-idealjs/tools/prisma/verify2.png diff --git a/packages/stack-idealjs/docs/tools/vscode/_category_.json b/packages/stack-idealjs/tools/vscode/_category_.json similarity index 100% rename from packages/stack-idealjs/docs/tools/vscode/_category_.json rename to packages/stack-idealjs/tools/vscode/_category_.json diff --git a/packages/stack-idealjs/docs/tools/vscode/code.png b/packages/stack-idealjs/tools/vscode/code.png similarity index 100% rename from packages/stack-idealjs/docs/tools/vscode/code.png rename to packages/stack-idealjs/tools/vscode/code.png diff --git a/packages/stack-idealjs/docs/tools/vscode/exception.md b/packages/stack-idealjs/tools/vscode/exception.md similarity index 100% rename from packages/stack-idealjs/docs/tools/vscode/exception.md rename to packages/stack-idealjs/tools/vscode/exception.md diff --git a/packages/stack-idealjs/docs/tools/vscode/json.png b/packages/stack-idealjs/tools/vscode/json.png similarity index 100% rename from packages/stack-idealjs/docs/tools/vscode/json.png rename to packages/stack-idealjs/tools/vscode/json.png diff --git a/packages/stack-idealjs/docs/tools/vscode/marketplace.png b/packages/stack-idealjs/tools/vscode/marketplace.png similarity index 100% rename from packages/stack-idealjs/docs/tools/vscode/marketplace.png rename to packages/stack-idealjs/tools/vscode/marketplace.png diff --git a/packages/stack-idealjs/docs/tools/vscode/setting.png b/packages/stack-idealjs/tools/vscode/setting.png similarity index 100% rename from packages/stack-idealjs/docs/tools/vscode/setting.png rename to packages/stack-idealjs/tools/vscode/setting.png