网站提交

Author: 54895y

.github/workflows/deploy.yml

@@ -0,0 +1,49 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'src/**'
+      - 'static/**'
+      - 'docusaurus.config.ts'
+      - 'sidebars.ts'
+      - 'package.json'
+      - 'package-lock.json'
+
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: https://54895y.github.io
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./build
+
+      - name: Deploy to GitHub Pages
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

DEPLOYMENT.md

@@ -0,0 +1,91 @@
+# GitHub Pages 部署指南
+
+## 配置完成情况
+
+✅ 已完成以下配置:
+
+1. **Docusaurus 配置更新** (`docusaurus.config.ts`)
+   - `url`: `https://54895y.github.io`
+   - `baseUrl`: `/`
+   - `organizationName`: `54895y`
+   - `projectName`: `54895y.github.io`
+   - GitHub 链接已更新
+
+2. **GitHub Actions 工作流** (`.github/workflows/deploy.yml`)
+   - 自动触发部署
+   - Node.js 20 环境
+   - 自动构建和部署
+
+3. **CNAME 文件** (`static/CNAME`)
+   - 设置为 `54895y.github.io`
+
+4. **README 文档** (`README.md`)
+   - 添加了部署说明
+
+## 部署步骤
+
+### 1. 提交代码到 GitHub
+
+```bash
+git add .
+git commit -m "配置 GitHub Pages 部署"
+git push origin main
+```
+
+### 2. 启用 GitHub Pages
+
+1. 访问 https://github.com/54895y/54895y.github.io/settings/pages
+2. 在 "Build and deployment" 部分:
+   - Source: **GitHub Actions**
+   - Branch: **main**
+3. 点击 "Save"
+
+### 3. 等待部署完成
+
+- 首次部署可能需要 2-5 分钟
+- 部署完成后，网站将自动在 https://54895y.github.io 上线
+
+### 4. 验证部署
+
+访问 https://54895y.github.io 查看网站是否正常显示。
+
+## 自动部署说明
+
+每次向 `main` 分支推送以下文件的更改时，都会自动触发部署:
+
+- `docs/**` - 文档内容
+- `src/**` - 源代码
+- `static/**` - 静态资源
+- `docusaurus.config.ts` - 配置文件
+- `sidebars.ts` - 侧边栏配置
+- `package.json` / `package-lock.json` - 依赖文件
+
+## 手动触发部署
+
+如果需要手动触发部署，可以:
+
+1. 在 GitHub 仓库页面点击 "Actions" 标签
+2. 选择 "Deploy to GitHub Pages" 工作流
+3. 点击 "Run workflow" → "Run workflow"
+
+## 故障排除
+
+### 网站无法访问
+
+1. 检查 GitHub Pages 设置是否正确
+2. 确认分支设置为 `main`
+3. 查看 Actions 标签页中的部署日志
+
+### 内容未更新
+
+1. 等待 1-2 分钟让 GitHub Pages 更新
+2. 清除浏览器缓存
+3. 检查 GitHub Actions 是否成功完成
+
+### 自定义域名
+
+如果要使用自定义域名:
+
+1. 在 `static/CNAME` 文件中添加你的域名
+2. 在 GitHub 仓库设置中配置自定义域名
+3. 确保 DNS 记录正确配置

DEPLOYMENT_GUIDE.md

@@ -0,0 +1,219 @@
+# 🚀 GitHub Pages 完整部署指南
+
+## 前提条件
+
+- 已安装 Git
+- 已创建 GitHub 账号
+- 已创建仓库 `https://github.com/54895y/54895y.github.io`
+
+---
+
+## 第一步：初始化 Git 仓库
+
+### 1. 打开命令行
+
+按 `Win + R`，输入 `cmd`，按回车
+
+### 2. 进入项目目录
+
+```bash
+cd "D:\我的世界\Minecraft代码\MatrixShop\matrixshop-docs"
+```
+
+### 3. 初始化 Git 仓库
+
+```bash
+git init
+```
+
+### 4. 配置 Git 用户信息
+
+```bash
+git config --global user.name "54895y"
+git config --global user.email "54895y@example.com"
+```
+
+> **注意**: 将 `54895y@example.com` 替换为你 GitHub 账号的邮箱
+
+---
+
+## 第二步：添加文件并提交
+
+### 1. 查看当前状态
+
+```bash
+git status
+```
+
+### 2. 添加所有文件
+
+```bash
+git add .
+```
+
+### 3. 提交文件
+
+```bash
+git commit -m "Initial commit: MatrixShop documentation with GitHub Pages setup"
+```
+
+---
+
+## 第三步：连接远程仓库
+
+### 1. 创建 GitHub 仓库
+
+1. 访问 https://github.com/new
+2. Repository name: `54895y.github.io`
+3. Description: `MatrixShop Documentation`
+4. 选择 **Public**
+5. **不要**勾选 "Initialize this repository with a README"
+6. 点击 "Create repository"
+
+### 2. 添加远程仓库
+
+```bash
+git remote add origin https://github.com/54895y/54895y.github.io.git
+```
+
+### 3. 推送代码到 GitHub
+
+```bash
+git branch -M main
+git push -u origin main
+```
+
+> **注意**: 如果提示输入用户名和密码，请使用 GitHub Personal Access Token
+
+---
+
+## 第四步：启用 GitHub Pages
+
+### 1. 访问仓库设置
+
+1. 打开 https://github.com/54895y/54895y.github.io
+2. 点击右上角的 **Settings** 标签
+
+### 2. 配置 Pages
+
+1. 在左侧菜单中找到 **Pages**
+2. 点击 **Pages**
+3. 在 "Build and deployment" 部分:
+   - Source: **GitHub Actions**
+   - Branch: **main**
+4. 点击 **Save**
+
+### 3. 等待部署
+
+- 首次部署需要 2-5 分钟
+- 部署完成后会显示网站 URL: `https://54895y.github.io`
+
+---
+
+## 第五步：验证部署
+
+### 1. 访问网站
+
+打开浏览器，访问: **https://54895y.github.io**
+
+### 2. 检查网站内容
+
+确认以下内容正常显示:
+- 主页 Hero 区域
+- MatrixShop 卡片
+- 更多插件卡片
+- 技术栈部分
+- 快速开始部分
+
+---
+
+## 第六步：后续更新
+
+### 自动部署
+
+每次向 `main` 分支推送以下文件的更改时，都会自动部署:
+
+```bash
+# 修改文件后
+git add .
+git commit -m "Update documentation"
+git push origin main
+```
+
+### 查看部署状态
+
+1. 访问 https://github.com/54895y/54895y.github.io/actions
+2. 查看最新的工作流运行状态
+3. 点击工作流可以查看详细日志
+
+---
+
+## 常见问题
+
+### 1. 网站无法访问
+
+**问题**: 访问 https://54895y.github.io 显示 404
+
+**解决方案**:
+- 等待 5-10 分钟让 GitHub Pages 更新
+- 清除浏览器缓存
+- 检查 GitHub Pages 设置是否正确
+
+### 2. Git Push 失败
+
+**问题**: `fatal: repository not found`
+
+**解决方案**:
+- 检查仓库 URL 是否正确
+- 确认仓库是公开的
+- 检查网络连接
+
+### 3. 权限问题
+
+**问题**: `Permission denied (publickey)`
+
+**解决方案**:
+- 配置 SSH 密钥或使用 HTTPS
+- 使用 Personal Access Token 替代密码
+
+### 4. 内容未更新
+
+**问题**: 网站内容没有显示最新更改
+
+**解决方案**:
+- 等待 1-2 分钟让 GitHub Pages 更新
+- 检查 GitHub Actions 是否成功完成
+- 清除浏览器缓存
+
+---
+
+## 快速命令参考
+
+```bash
+# 初始化
+cd "D:\我的世界\Minecraft代码\MatrixShop\matrixshop-docs"
+git init
+git config --global user.name "54895y"
+git config --global user.email "54895y@example.com"
+
+# 添加和提交
+git add .
+git commit -m "Initial commit"
+
+# 连接远程仓库
+git remote add origin https://github.com/54895y/54895y.github.io.git
+git branch -M main
+git push -u origin main
+```
+
+---
+
+## 部署成功后
+
+部署成功后，你将拥有:
+- ✅ 网站 URL: https://54895y.github.io
+- ✅ 自动部署功能
+- ✅ GitHub 仓库管理
+- ✅ 文档版本控制
+
+祝你使用愉快！🎉