Skip to content

♻️ refactor: 重构侧栏结构,通用知识库拆分至 Java/Bedrock 双上下文,优化阅读顺序与文本编辑器 - #139

Merged
Dreeam-qwq merged 1 commit into
Cubic-Project:mainfrom
wling-art:refactor/sidebar-topics
Jul 29, 2026
Merged

♻️ refactor: 重构侧栏结构,通用知识库拆分至 Java/Bedrock 双上下文,优化阅读顺序与文本编辑器#139
Dreeam-qwq merged 1 commit into
Cubic-Project:mainfrom
wling-art:refactor/sidebar-topics

Conversation

@wling-art

@wling-art wling-art commented Jul 28, 2026

Copy link
Copy Markdown
Member

改动概述(以下为 AI 概述)

将"基础"主题的通用知识库拆分到 Java / Bedrock 双上下文,用户在任何一侧阅读侧栏都不会跳转。同时按服主开服流程重排阅读顺序,精简文本编辑器,统一 Bedrock 目录结构。


引导(原"基础")精简

graph LR
    通用知识库 --> 安装Java --> J[Java / Bedrock 各侧栏]
    通用知识库 --> 文本编辑器 --> J
    通用知识库 --> 经营管理 --> J

    classDef old fill:#e06c75,color:#fff
    classDef new fill:#98c379,color:#fff
    class 通用知识库 old
    class J new
Loading

引导只保留"快速开始"和"阅读指南",其余分发到 Java / Bedrock 各侧栏。


Java 版

# 原版 新版
1 快速开始 快速开始
2 准备工作(安装Java、文本编辑器) 准备工作(基础知识←移入、安装Java、文本编辑器)
3 开始阶段(基础知识、选核心、部署) 搭建服务器(选核心、部署)
4 建设与运营(插件、跨服端、手机玩家) 插件与玩法(插件、生电、地图)
5 进阶知识(Linux、数据库、优化、经营管理←后部 进阶知识(经营管理→首位跨服端←移入手机玩家←移入、Linux、数据库...)

核心变化

graph LR
    subgraph 移动
        M1[基础知识] -.->|准备| P[准备工作]
        M2[经营管理] -.->|进阶首位| A[进阶知识]
        M3[跨服端] -.->|从建设与运营| A
        M4[手机玩家支持] -.->|从建设与运营| A
    end

    classDef moved fill:#e5c07b,color:#1a1a2e
    class M1,M2,M3,M4 moved
Loading

Bedrock 版

# 原版 新版
1 快速开始 快速开始
2 超级基础知识 基础知识(改名)
3 准备工作(文本编辑器) 准备工作(文本编辑器,提前到基础知识之后)
4 BDS 核心 BDS 核心(准备→搭建→进阶,命名统一)
5 Nukkit 核心 Nukkit 核心
6 PocketMine 核心 PocketMine 核心
7 其他基岩版服务器核心 其他核心(改名)
8 WaterdogePE 跨服 WaterdogePE 跨服(加准备分组)
9 服务器管理(经营管理)

核心变化

graph LR
    快速开始 --> 基础知识 --> 准备工作 --> C[各核心介绍] --> M[服务器管理]

    classDef flow fill:#98c379,color:#fff
    class 基础知识,准备工作,M flow
Loading

文本编辑器精简

操作 详情
删除 geany, hbuilderx, kate
合并 notepad++.md + notepad3.md + notepad--.md → notepad.md
保留 intro, vscode, sublime-text, vim, nano
排序 按推荐:概述(1) → VS Code(2) → Notepad(3) → Sublime(4) → Vim(5) → Nano(6)

技术实现

  • Bug 修复content.config.tstopic 从嵌套 topicSchema.topic 修正为顶层
  • MDX 包装页(36 个):import 原内容 + topic: java/bedrock,同源文件双上下文
  • options.topics:按目录 glob 批量指定 topic

@Dreeam-qwq Dreeam-qwq added the type: documentation Pull request for improvements or additions to docs contents label Jul 29, 2026

@Dreeam-qwq Dreeam-qwq left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

晚上吃深墨

@Dreeam-qwq
Dreeam-qwq merged commit 38c848d into Cubic-Project:main Jul 29, 2026
1 check passed
@wling-art
wling-art deleted the refactor/sidebar-topics branch July 29, 2026 10:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type: documentation Pull request for improvements or additions to docs contents

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants