文章

05.【GitHub Pages 】如何擁有免費的個人主頁

05.【GitHub Pages 】如何擁有免費的個人主頁

🚀 使用 Jekyll 和 Chirpy 搭建 GitHub Pages 博客教程

适用于 macOS 和 Windows 系统用户
最终效果:一个托管在 GitHub 上的个性化博客网站


目录

  1. 安装 Jekyll
  2. 安装 Git
  3. 登录 GitHub
  4. 创建 GitHub Pages 仓库
  5. 使用 jekyll-theme-chirpy 主题

1. 安装 Jekyll

官方网站:
👉 https://jekyllrb.com/

💻 macOS 用户

  1. 安装 Homebrew(若未安装):
    1
    
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    
  2. 安装 Ruby(Jekyll 依赖):
    1
    
    brew install ruby
    
  3. 配置环境变量(建议添加到 ~/.zshrc~/.bash_profile):
    1
    
    export PATH="/opt/homebrew/opt/ruby/bin:$PATH"
    

    然后执行:

    1
    
    source ~/.zshrc
    
  4. 安装 Jekyll 和 Bundler:
    1
    
    gem install --user-install bundler jekyll
    

🖥️ Windows 用户

  1. 安装 Ruby(包含 DevKit):
    下载地址 👉 https://rubyinstaller.org/

  2. 安装后,在终端(CMD 或 PowerShell)执行:
    1
    
    gem install bundler jekyll
    
  3. 验证安装:
    1
    
    jekyll -v
    

2. 安装 Git

官网地址:
👉 https://git-scm.com/

安装步骤:

  • macOS 用户可使用 Homebrew:
    1
    
    brew install git
    
  • Windows 用户请前往官网下载并安装。

安装完成后,可通过以下命令验证:

1
git --version

3. 登录 GitHub

  1. 注册或登录 GitHub 官网
  2. 可选:配置 Git 本地用户名和邮箱(用于提交记录):
    1
    2
    
    git config --global user.name "你的用户名"
    git config --global user.email "你的邮箱"
    

4. 创建 GitHub Pages 仓库

  1. 前往 GitHub,点击右上角 New repository
  2. 命名格式为:
    1
    
    your-username.github.io
    
  3. 建议勾选初始化仓库(Add a README file)

5. 使用 jekyll-theme-chirpy 主题

项目地址:
👉 https://github.com/cotes2020/jekyll-theme-chirpy

快速开始

  1. Fork 仓库: 点击右上角 “Fork” 到自己的 GitHub 账户下。

  2. 克隆仓库到本地
    1
    2
    
    git clone https://github.com/你的用户名/jekyll-theme-chirpy.git
    cd jekyll-theme-chirpy
    
  3. 安装依赖
    1
    
    bundle install
    
  4. 本地运行项目
    1
    
    bundle exec jekyll s
    

    打开浏览器访问:http://localhost:4000

  5. 部署到 GitHub Pages
    • 推送修改到主分支,GitHub 会自动构建并部署。
    • 访问网址:https://你的用户名.github.io/

本文章以 CC BY 4.0 授權