Skip to content

DEPLOY.md

Latest commit

 

History

History
100 lines (76 loc) · 2.78 KB

DEPLOY.md

File metadata and controls

100 lines (76 loc) · 2.78 KB

GitHub Pages 部署指南

按照以下步骤将网站发布到 GitHub Pages：

步骤 1: 在项目目录初始化 Git 仓库

  1. 打开 PowerShell 或命令提示符
  2. 切换到项目目录： 
    cd "D:\Vibe coding\Pytorch教程博客"
  3. 初始化 Git 仓库： 
    git init
  4. 添加所有文件： 
    git add .
  5. 创建初始提交： 
    git commit -m "Initial commit: PyTorch tutorial blog website"

步骤 2: 在 GitHub 上创建仓库

  1. 登录 GitHub
  2. 点击右上角的 "+" 号，选择 "New repository"
  3. 仓库名称建议：pytorch-tutorial-blog 或 pytorch-blog
  4. 重要：仓库名称必须为 你的用户名.github.io 格式才能使用 GitHub Pages
    • 例如：如果你的用户名是 yourusername，仓库名应为 yourusername.github.io
  5. 选择 Public（公开）
  6. 不要勾选 "Initialize this repository with a README"
  7. 点击 "Create repository"

步骤 3: 连接本地仓库到 GitHub

在项目目录中执行以下命令（将 YOUR_USERNAME 替换为你的 GitHub 用户名）：

git remote add origin https://github.com/YOUR_USERNAME/YOUR_USERNAME.github.io.git
git branch -M main
git push -u origin main

如果仓库名不是 用户名.github.io 格式，使用：

git remote add origin https://github.com/YOUR_USERNAME/REPO_NAME.git
git branch -M main
git push -u origin main

步骤 4: 启用 GitHub Pages

  1. 在 GitHub 仓库页面，点击 "Settings"（设置）
  2. 在左侧菜单中找到 "Pages"
  3. 在 "Source" 部分：
    • 选择分支：main
    • 选择文件夹：/ (root)
  4. 点击 "Save"（保存）

步骤 5: 访问你的网站

等待几分钟后，你的网站将在以下地址可用：

  • https://YOUR_USERNAME.github.io
  • 或 https://YOUR_USERNAME.github.io/REPO_NAME（如果仓库名不是 用户名.github.io）

后续更新

每次更新网站后，执行：

git add .
git commit -m "更新网站内容"
git push

GitHub Pages 会自动更新（通常需要几分钟）。

常见问题

如果遇到认证问题

如果推送时要求输入用户名和密码，可以使用 Personal Access Token：

  1. GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
  2. 生成新 token，勾选 repo 权限
  3. 使用 token 作为密码

如果网站无法访问

  1. 检查仓库设置中的 Pages 是否已启用
  2. 确认分支和文件夹设置正确
  3. 等待 5-10 分钟让 GitHub 完成部署
  4. 检查 Actions 标签页查看是否有构建错误

使用自定义域名（可选）

如果你想使用自己的域名：

  1. 在仓库 Settings → Pages 中添加你的域名
  2. 在你的域名 DNS 设置中添加 CNAME 记录指向 YOUR_USERNAME.github.io