快乐的碎片

切换主题

Hux博客部署到GitHub Pages全流程 ​

字数
411 字
阅读时间
2 分钟

演示博客：黄玄的博客 | Hux Blog ​

第一步：Fork Hux博客仓库 ​

  1. 访问模板仓库
    进入KL-Hash/huxpro.github.io 项目

  2. 点击右上角Fork按钮复制到你的GitHub账号下。

    • 若无GitHub账号需先注册，建议使用常用邮箱以便接收通知。

  3. 重命名仓库（关键步骤）

    • 进入你Fork后的仓库 → Settings设置 → General常规 → 将仓库名改为你的用户名.github.io（如zhangsan.github.io）。
    • 此命名规则是GitHub Pages的硬性要求，否则无法通过根域名访问。

第二步：启用GitHub Pages与构建配置 ​

  1. 设置Pages服务

    • 在仓库的Settings设置 → 左侧 Pages页面 → Build and deployment构建和部署部分：
      • Source：选择GitHub Actions（推荐）或Deploy from a branch（传统方式）。
      • Branch：若选择分支部署，需指定为main或master（根据仓库默认分支）。

  2. 配置Jekyll构建（自动化）

    • 若选择GitHub Actions，系统会自动生成.github/workflows/jekyll.yml文件，无需手动配置。
    • Hux博客基于Jekyll，GitHub原生支持自动构建，推送代码后会触发流程。

最终效果验证 ​

访问https://你的用户名.github.io，若页面正常加载且样式完整即部署成功。如需进一步优化（如SEO、多语言），可参考Hux模板的文档或社区讨论。

贡献者 ​

The avatar of contributor named as Qiu"一叶知秋"Ye Qiu"一叶知秋"Ye

文件历史 ​