github部署个人博客
时间: 2025-02-19 11:29:03 浏览: 47
### 如何在 GitHub 上部署个人博客
#### 使用 GitHub Pages 和 Hugo 搭建静态网站教程
为了创建并部署基于 Hugo 的静态博客到 GitHub Pages,需遵循一系列配置步骤。
#### 准备工作环境
安装 Hugo 构建工具是必要的前提条件。确保本地计算机已成功安装 Hugo 版本[^1]。
#### 初始化 Git 仓库并与 GitHub 关联
首先,在本地初始化一个新的 Git 仓库,并将其关联至远程 GitHub 仓库:
```bash
git init
git remote add origin [email protected]:<用户名>/<仓库名>.git
```
#### 配置 Hugo 网站设置
编辑 `config.toml` 文件来定义站点的基础 URL 地址,这一步骤对于正确构建和发布至关重要:
```toml
baseURL = "https://<用户名>.github.io/<仓库名>"
languageCode = "zh-cn"
title = "我的Hugo博客"
theme = "<所选主题名称>"
```
#### 设置 GitHub Actions 自动化流程
为实现自动化部署,应在 `.github/workflows/` 目录下创建名为 `deploy.yml` 的 YAML 文件,用于编写 CI/CD 流程脚本。此文件负责触发每次提交后的自动编译与推送操作:
```yaml
name: Deploy to GitHub Pages
on:
push:
branches:
- main
jobs:
build-and-deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Setup Hugo
uses: peaceiris/actions-hugo@v2
with:
hugo-version: 'latest'
- name: Build site
run: |
hugo
- name: Deploy to GitHub Pages
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: ./public
```
#### 开启 GitHub Pages 功能
进入 GitHub 项目的 Settings 页面,找到 Pages 菜单选项,选择源分支为 `gh-pages` 并保存更改。注意这里的分支名字必须严格匹配 `gh-pages`。
完成上述所有配置之后,任何推送到默认分支(通常是 `main` 或者 `master`)上的更新都会触发 GitHub Actions 来重新构建站点并将生成的内容同步到 `gh-pages` 分支上供公网访问。
阅读全文
相关推荐



















