Skip to content

Latest commit

 

History

History
102 lines (71 loc) · 3.04 KB

README.md

File metadata and controls

102 lines (71 loc) · 3.04 KB
Raw

Hugo FixIt 博客模板（Git）

👉 中文 | English

这是一个用于 Hugo 主题 FixIt 的快速入门模板。它使用 Git 子模块 功能来加载主题。

它提供了基本的主题结构和配置。已经设置了 GitHub Actions，可以自动部署博客到 GitHub Pages。此外，还有一个定时任务，每天自动更新主题。

目录结构

▸ .github/       # GitHub configuration
▸ archetypes/    # page archetypes (like scaffolds of archetypes)
▸ assets/        # css, js, third-party libraries etc.
▸ config/        # configuration files
▸ content/       # markdown files for hugo project
▸ data/          # blog data (allow: yaml, json, toml), e.g. friends.yml
▸ public/        # build directory
▸ static/        # static files, e.g. favicon.ico
▸ themes/        # theme submodules

快速入门

完整的快速入门请参阅此 页面。

准备

Hugo: >= 0.132.0 (extended version)

使用此模板

  1. 点击 Use this template，在 GitHub 上创建你的仓库。

    image

  2. 仓库创建后，只需克隆并开始使用！

    # 使用你自己的仓库 URL 进行克隆
git clone --recursive https://github.com/<your_name>/<your_blog_repo>.git

启动站点

# 开发环境
hugo server
# 生产环境
hugo server -e production

构建站点

当你的站点准备部署时，运行以下命令：

hugo

部署到 GitHub Pages

  1. 转到 Setting => Actions => General => Workflow permissions => 选中 "Read and write permissions"。
  2. 手动运行 Workflow: Actions => Hugo build and deploy => 点击 Run workflow 按钮。
  3. GitHub Pages 设置：Setting => Pages => Source: Deploy from a branch => Branch: gh-pages => Save。

只有第一次部署时需要手动运行 Workflow，之后每次推送到 main 分支都会自动部署。

更新主题

之后，你可以使用以下命令升级主题：

# 手动更新主题
git submodule update --remote --merge themes/FixIt
通过 NPM 脚本启动 
npm install
# 构建博客
npm run build
# 运行带有监视的本地调试服务器
npm run server
# 在生产环境中运行本地调试服务器
npm run server:production
# 更新主题子模块
npm run update:theme

故障排除

remote: Permission to git denied to github-actions[bot]. 转到 Setting => Actions => General => Workflow permissions => 选中 "Read and write permissions"。