1.2.4

.github/workflows/deploy.yml

@@ -10,8 +10,6 @@ permissions:
   contents: write
   pages: write
   id-token: write
-  issues: write
-  actions: write
 
 # 允许一个并发部署
 concurrency:
@@ -20,8 +18,6 @@ concurrency:
   
 jobs:
   build:
-    # 只在原仓库或fork的仓库中运行
-    if: github.repository == 'RZLNB/menav' || github.event.repository.fork == true
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
@@ -50,44 +46,6 @@ jobs:
         with:
           path: '.'
           
-      - name: Create deployment guide issue
-        # 只在fork的仓库中创建issue
-        if: github.event.repository.fork == true
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const issueBody = `
-            # 部署指南
-            
-            请按照以下步骤完成网站部署:
-            
-            1. 首先确保正确配置权限:
-               - 进入仓库的 Settings -> Actions -> General
-               - 在 "Workflow permissions" 部分
-               - 选择 "Read and write permissions"
-               - 勾选 "Allow GitHub Actions to create and approve pull requests"
-               - 点击 Save
-            
-            2. 然后配置 Pages:
-               - 进入仓库的 Settings -> Pages
-               - 在 "Build and deployment" 部分
-               - Source: 选择 "GitHub Actions"
-               - 点击 Save
-            
-            完成以上步骤后,工作流将自动部署您的网站。
-            部署完成后,您可以在 Settings -> Pages 中找到您的网站地址。
-            
-            如果遇到权限相关错误,请确保完成了步骤1的所有配置。
-            `;
-            
-            await github.rest.issues.create({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              title: '🚀 如何部署您的导航站点',
-              body: issueBody,
-              labels: ['documentation']
-            });
-          
   deploy:
     environment:
       name: github-pages

.gitignore

@@ -22,3 +22,6 @@ Thumbs.db
 # 日志文件
 *.log
 logs/
+
+# 用户配置文件
+config.user.yml 

README.md

@@ -57,16 +57,64 @@ npm run dev
 
 ### 快速部署到GitHub Pages
 
-1. 点击右上角的 Fork 按钮复制此仓库到您的账号
+#### 第一步：前置设置
-2. 修改 `config.yml` 中的配置信息
+
-3. 在仓库设置中启用 GitHub Pages:
+1. Fork仓库:
+   - 点击右上角的 Fork 按钮复制此仓库到您的账号
+
+2. 启用必要功能:
+   - 进入仓库的 Settings -> General
+   - 找到 Features 部分
+   - 勾选 "Issues"
+   - 点击页面底部的 Save 按钮
+
+3. 配置Actions:
+   a. 启用Actions:
+      - 进入fork后的仓库
+      - 点击顶部的 "Actions" 标签页
+      - 点击绿色按钮 "I understand my workflows, go ahead and enable them"
+   
+   b. 设置权限:
+      - 进入仓库的 Settings -> Actions -> General
+      - 在 "Actions permissions" 部分选择 "Allow all actions and reusable workflows"
+      - 在 "Workflow permissions" 部分:
+        * 选择 "Read and write permissions"
+        * 勾选 "Allow GitHub Actions to create and approve pull requests"
+      - 点击页面底部的 Save 按钮
+
+4. 配置Pages:
    - 进入仓库的 Settings -> Pages
-   - 在 "Source" 下拉菜单中选择 "GitHub Actions"
+   - 在 "Build and deployment" 部分
+   - Source: 选择 "GitHub Actions"
    - 点击 Save
 
+#### 第二步：自定义配置
+
+1. 创建个人配置文件:
+   - 复制 `config.yml` 为 `config.user.yml`
+   - 在 `config.user.yml` 中修改配置
+   - 这样在后续同步更新时,您的配置不会被覆盖
+
+2. 修改配置信息:
+   - 修改网站基本信息
+   - 添加/修改导航链接
+   - 自定义社交媒体链接
+   - 更新个人项目展示
+   - 添加友情链接等
+
 完成以上步骤后,系统会自动部署您的网站。部署完成后,您可以在 Settings -> Pages 中找到您的网站地址。
 
-> 提示：首次fork后,系统会自动创建一个部署指南issue,您可以按照指南完成部署。
+> 重要提示: 请务必使用 `config.user.yml` 进行配置,这样在同步上游更新时不会丢失您的个人设置。
+
+#### 故障排除
+
+如果遇到部署问题:
+1. 请确保完成了所有前置设置步骤
+2. 检查每个设置页面是否都点击了 Save 按钮
+3. 如果修改设置后部署仍然失败:
+   - 进入 Actions 标签页
+   - 找到失败的工作流
+   - 点击 "Re-run all jobs" 重新运行
 
 ### 高级部署选项：Cloudflare Pages
 
@@ -81,6 +129,20 @@ npm run dev
 
 ## 自定义配置
 
+### 配置文件说明
+
+本项目提供两种配置文件:
+1. `config.yml` - 默认配置模板,会随项目更新
+2. `config.user.yml` - 用户个人配置,不会被项目更新覆盖
+
+建议使用步骤:
+1. 复制 `config.yml` 为 `config.user.yml`
+2. 在 `config.user.yml` 中进行个性化配置
+3. 原始的 `config.yml` 保持不变
+4. 后续同步更新时,您的个人配置不会被覆盖
+
+> 注意: `config.user.yml` 已添加到 .gitignore 中,不会被提交到仓库
+
 ### 配置文件结构
 
 `config.yml` 包含以下主要部分：
@@ -91,6 +153,7 @@ site:
   title: 网站标题
   description: 网站描述
   author: 作者名
+  favicon: favicon.ico  # 网站图标,支持ico、png等格式
 
 # 个人信息
 profile:
@@ -108,6 +171,18 @@ navigation:
 # 更多配置...
 ```
 
+### 设置网站图标
+
+1. 准备图标文件:
+   - 支持.ico、.png等格式
+   - 建议尺寸为32x32或16x16像素
+   - 将图标文件放在仓库根目录
+
+2. 配置图标:
+   - 在`config.yml`的site部分设置favicon
+   - 例如: `favicon: favicon.ico`
+   - 也可以使用在线图标URL
+
 ### 添加新的网站链接
 
 在 `config.yml` 中相应的分类下添加新站点：

config.yml

@@ -3,6 +3,7 @@ site:
   title: 我的导航
   description: 个人网络导航站
   author: Your Name
+  favicon: favicon.ico  # 网站图标,支持ico、png等格式
 
 # 个人信息
 profile: