README_CN.md

中文 | English

Hugo Template

一个由bep、spf13和其好友基于Go构建的快速灵活的静态站点生成器框架。 这是它的模板。

---

演示 | 官网 | 文档 | 社区

---

快速开始

修改域名

修改 config.yml 或者 config.toml 中的 baseURL 值

baseURL: "https://lopins.github.io/hugo-template"

配置主题

1. 拉取主题并进入 themes/ 并更新相关信息

   git submodule add [email protected]:zhaohuabing/hugo-theme-cleanwhite.git themes/cleanwhite && git submodule update --init --recursive

   cp -r exampleSite/* ../

2. 在 config.yml 或者 config.toml 修改 theme 属性值为 "cleanwhite"`

3. 在 config.yml 或者 config.toml 修改 editPost: "https://github.com/lopins/hugo-template/tree/main/content"

应用配置

git add . && git commit -m ':wrench:docs(themes): Add or update configuration files' && git push origin main

发布文章

1. 启用站点

   点击 "Use this template" -> "Create a new repository"

2. 配置站点

   设置并且启用 GitHub Pages 服务

3. 发布文章

   发布文章在 hugo 分支。

特别注意

使用 Submodule 切换主题

# Add Submodule - Upadte Submodule
git submodule add [email protected]:zhaohuabing/hugo-theme-cleanwhite.git themes/cleanwhite
git submodule update --init --recursive

# Delete Submodule
git submodule deinit -f themes/cleanwhite
rm -rf .git/modules/themes/cleanwhite
rm -rf themes/cleanwhite
git config --remove-section submodule.themes/cleanwhite
git config -f .gitmodules --remove-section submodule.themes/cleanwhite
git rm --cached themes/cleanwhite
git add . && git commit -m 'Update .gitmodules before removing submodule'


# Display Submodule - Pull Submodule - Sync Submodule
git submodule status
git submodule foreach git pull origin main
git submodule sync

权限问题

如果你遇到类似 remote: Permission to xxx denied to github-actions[bot].

当你推送更改时，你需要设置仓库的 github-actions[bot] 权限.

设置步骤: Settings -> Actions -> General -> Workflow permissions -> Read and write permissions -> Save.

开源协议

MIT License.