jguyomard/hugo-builder

Hugo Docker镜像

![Docker Automated build]([] ![Docker Build Status]([] ![Docker Pulls]([] ![Image Info]([]

Hugo是一款快速灵活的静态网站生成器，基于Go语言开发。它支持多种格式，适用于博客、文档、作品集等场景，高效的性能让网站构建变得轻松有趣。

本镜像基于Alpine系统构建，轻量高效，同时集成了rsync等工具以支持持续部署。

快速开始

打印Hugo帮助信息：

bash
docker run --rm -it jguyomard/hugo-builder hugo help

创建新的Hugo站点：

bash
docker run --rm -it -v $PWD:/src -u hugo jguyomard/hugo-builder hugo new site mysite
cd mysite

# 建议添加主题（参考https://themes.gohugo.io/）：
git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke;
echo 'theme = "ananke"' >> config.toml

添加内容：

bash
docker run --rm -it -v $PWD:/src -u hugo jguyomard/hugo-builder hugo new posts/my-first-post.md

# 编辑文章内容并移除"draft"标记：
xdg-open content/posts/my-first-post.md

构建站点：

bash
docker run --rm -it -v $PWD:/src -u hugo jguyomard/hugo-builder hugo

本地预览站点：

bash
docker run --rm -it -v $PWD:/src -p 1313:1313 -u hugo jguyomard/hugo-builder hugo server -w --bind=0.0.0.0

然后在浏览器中打开http://localhost:1313/查看。

更多信息请参考Hugo官方文档。

Bash别名设置

为方便使用，可创建Bash别名：

bash
alias hugo='docker run --rm -it -v $PWD:/src -u hugo jguyomard/hugo-builder hugo'
alias hugo-server='docker run --rm -it -v $PWD:/src -p 1313:1313 -u hugo jguyomard/hugo-builder hugo server --bind 0.0.0.0'

现在可直接使用hugo help、hugo new foo/bar.md、hugo-server -w等命令。

支持的标签

最新构建的标签包括：

• https://github.com/jguyomard/docker-hugo/blob/master/Dockerfile
• https://github.com/jguyomard/docker-hugo/blob/master/extras/Dockerfile
• https://github.com/jguyomard/docker-hugo/blob/v0.55/Dockerfile
• https://github.com/jguyomard/docker-hugo/blob/v0.55/extras/Dockerfile

完整标签列表可查看Docker Store页面。

用户权限

默认以root用户运行，便于作为基础镜像使用。同时提供非root用户hugo（UID 1000，GID 1000），可通过--user参数切换：

bash
docker run --rm -it -v $PWD:/src --user hugo jguyomard/hugo-builder hugo

也可指定其他UID/GID，例如www-data用户（UID 33，GID 33）：

bash
docker run --rm -it -v $PWD:/src -u 33:33 jguyomard/hugo-builder hugo

Extras版本

extras标签包含额外工具：

• py-pygments

使用方式：

bash
docker run --rm -it -v $PWD:/src -u hugo jguyomard/hugo-builder:extras hugo

持续部署

本镜像可用于持续部署流程，相关CI配置示例见https://github.com/jguyomard/docker-hugo/tree/master/ci-deploy%E7%9B%AE%E5%BD%95%E3%80%82%E9%95%9C%E5%83%8F%E8%BF%98%E9%9B%86%E6%88%90%E4%BA%86%EF%BC%9A

• rsync
• git
• openssh-client
• https://github.com/tdewolff/minify

问题反馈

若对镜像有疑问，请通过https://github.com/jguyomard/docker-hugo/issues%E8%81%94%E7%B3%BB%E3%80%82%E8%8B%A5%E9%97%AE%E9%A2%98%E4%B8%8EHugo%E6%9C%AC%E8%BA%AB%E7%9B%B8%E5%85%B3%EF%BC%8C%E8%AF%B7%E5%9C%A8https://github.com/spf13/hugo%E6%8F%90%E4%BA%A4Issue%E3%80%82

贡献

欢迎通过https://github.com/jguyomard/docker-hugo/pulls%E8%B4%A1%E7%8C%AE%E6%96%B0%E5%8A%9F%E8%83%BD%E6%88%96%E4%BF%AE%E5%A4%8D%E3%80%82