Hugo Automation 与 Travis-ci 和 Github 页面

我正在使用 github 来托管我的博客，并使用静态站点生成器 HUGO 来实现这一点，但使其脱机并编译然后将公共文件夹上传到 gh-pages 或使其在 docs 文件夹中可用太繁琐了。

所以我想自动化这个过程，所以每当我在内容中创建一个新的 .md 文件时，它应该生成静态站点并将公共文件夹复制到 gh-pages 或以下组合 -

• “源”分支中的源文件和发布到主目录的“公共”内容[用于用户和组织页面]
• master 中的源文件并将“public”文件夹内容发布到“gh-pages”
• 您想提出的任何其他方法

Note：我主要想使用 Travis-ci 但任何其他自动化平台也很酷

为 GitHub Pages 设置 Hugo 博客的一种好方法是使用两个单独的存储库：

• 第一个存储库包含博客源，
• 第二个存储库包含生成的内容。

命名第二个存储库username.github.io（使用您的 GitHub 用户名）。 GitHub Pages 会自动将其部署到https://用户名.github.io/ https://username.github.io/.

然后将第二个存储库作为 git 子模块添加到第一个存储库。子模块需要位于./public，这是 Hugo 生成静态内容的地方。这使您可以轻松地将生成的内容推送到 GitHub。

git submodule add \
    https://github.com/username/username.github.io.git \
    public

这个过程在 Hugo 官方教程中有更详细的解释在 GitHub 上托管 https://gohugo.io/hosting-and-deployment/hosting-on-github/.

持续集成

如果您想要完全自动化，您可以为第一个存储库设置 Travis CI。我在这里写了一篇关于此设置的详细文章：

使用 Travis CI 在 Github Pages 上托管 Hugo 博客 https://cjolowicz.github.io/posts/hosting-a-hugo-blog-on-github-pages-with-travis-ci/

Travis CI 调用 Hugo 并将生成的内容推送回 GitHub，并由 GitHub Pages 部署。为此，您需要一个.travis.yml文件和一个小的部署脚本：

.travis.yml

---
install:
  - curl -LO https://github.com/gohugoio/hugo/releases/download/v0.55.4/hugo_0.55.4_Linux-64bit.deb
  - sudo dpkg -i hugo_0.55.4_Linux-64bit.deb

script:
  - hugo

deploy:
  - provider: script
    script: ./deploy.sh
    skip_cleanup: true
    on:
      branch: master

部署.sh

#!/bin/bash

echo -e "\033[0;32mDeploying updates to GitHub...\033[0m"

cd public

if [ -n "$GITHUB_AUTH_SECRET" ]
then
    touch ~/.git-credentials
    chmod 0600 ~/.git-credentials
    echo $GITHUB_AUTH_SECRET > ~/.git-credentials

    git config credential.helper store
    git config user.email "[email protected] /cdn-cgi/l/email-protection"
    git config user.name "username"
fi

git add .
git commit -m "Rebuild site"
git push --force origin HEAD:master

最后设置环境变量GITHUB_AUTH_SECRET在 Travis CI 上提供对username.github.io存储库。该博客文章还解释了如何为此使用单独的机器人帐户，限制 CI 访问username.github.io存储库。