Files
FocusBuddy/GITHUB_PAGES_SETUP.md
2025-11-24 18:36:55 +08:00

110 lines
2.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# GitHub Pages 部署指南
## 📝 已创建的文件
`docs/` 文件夹中已经创建了以下文件:
-`index.html` - 首页
-`privacy-policy.html` - 隐私政策
-`terms-of-service.html` - 服务条款
-`README.md` - 文档说明
## 🚀 部署步骤
### 1. 更新个人信息(重要!)
在发布前,你需要检查以下信息是否已更新:
**在所有 HTML 文件中**
- ✅ 邮箱已更新为 `focusbuddy.app@outlook.com`
**在 `terms-of-service.html` 中**
- ✅ 国家/地区已更新为 `the People's Republic of China`
- ✅ 法律管辖区已更新为 `the People's Republic of China`
所有占位符都已替换完成!
### 2. 推送到 GitHub
```bash
# 添加所有文件
git add docs/
# 提交
git commit -m "Add GitHub Pages documentation"
# 推送到 GitHub
git push origin main
```
### 3. 在 GitHub 上启用 GitHub Pages
1. 打开你的 GitHub 仓库页面
2. 点击 **Settings**(设置)
3. 在左侧菜单找到 **Pages**
4. 在 "Source" 下:
- Branch: 选择 `main`
- Folder: 选择 `/docs`
5. 点击 **Save**
6. 等待 1-2 分钟,页面会显示部署状态
### 4. 获取 URL
部署成功后,你会看到类似这样的 URL
```
https://yourusername.github.io/focusbuddy/
```
你的文档链接将是:
- 隐私政策: `https://yourusername.github.io/focusbuddy/privacy-policy.html`
- 服务条款: `https://yourusername.github.io/focusbuddy/terms-of-service.html`
## 📱 在应用商店使用这些 URL
当你提交应用到 Google Play 或 App Store 时:
### Google Play Console:
1. 进入 "Store presence" → "App content"
2. 找到 "Privacy policy"
3. 粘贴你的隐私政策 URL
### App Store Connect:
1. 在 "App Information" 部分
2. 找到 "Privacy Policy URL"
3. 粘贴你的隐私政策 URL
## ✅ 测试
部署后,在浏览器中打开以下 URL 测试:
- `https://yourusername.github.io/focusbuddy/`
- `https://yourusername.github.io/focusbuddy/privacy-policy.html`
- `https://yourusername.github.io/focusbuddy/terms-of-service.html`
确保所有页面都能正常访问,且内容显示正确。
## 🔄 更新文档
如果你需要更新隐私政策或服务条款:
1. 编辑 `docs/` 中的相应 HTML 文件
2. 更新 "Last Updated" 日期
3. 提交并推送到 GitHub
4. 等待几分钟,更改会自动生效
## 💡 提示
- GitHub Pages 是完全免费的
- 支持 HTTPS自动启用
- 无需域名(使用 github.io 子域名)
- 可以绑定自定义域名(可选)
## ❓ 问题排查
如果页面无法访问:
1. 确认 GitHub Pages 已在设置中启用
2. 检查文件是否在 `docs/` 文件夹中
3. 确认分支是 `main`
4. 等待 5-10 分钟(首次部署可能需要更长时间)
5. 清除浏览器缓存后重试