owncloudci/hugo

hugo镜像文档

镜像概述和主要用途

hugo镜像是一个集成Hugo静态网站生成器的Docker镜像，旨在提供容器化环境以运行Hugo命令，实现静态网站的快速构建、生成与预览。Hugo作为高性能静态网站生成工具，适用于构建博客、文档站点、个人网站等各类静态内容。

核心功能和特性

• 内置Hugo静态网站生成器，支持直接执行hugo命令
• 支持通过构建参数（BUILD_VERSION）指定Hugo版本
• 容器化运行，有效隔离开发环境，避免依赖冲突
• 轻量级设计，便于集成到本地开发或CI/CD流水线

使用场景和适用范围

• 本地开发环境中快速构建和预览静态网站
• CI/CD流程中自动化生成和部署静态内容
• 需要隔离Hugo依赖的开发或构建场景
• 博客、技术文档、个人主页等静态网站的生成需求

使用方法和配置说明

构建镜像

通过以下命令构建hugo镜像，可通过BUILD_VERSION参数指定Hugo版本：

bash
docker build --build-arg BUILD_VERSION=0.69.2 -f Dockerfile -t hugo:latest .

运行容器示例

查看Hugo版本

bash
docker run --rm hugo:latest hugo version

构建静态网站

将当前目录作为网站源文件目录，执行hugo build生成静态文件：

bash
docker run --rm -v $(pwd):/site -w /site hugo:latest hugo build

本地预览网站

启动Hugo开发服务器，在本地端口1313预览网站：

bash
docker run --rm -v $(pwd):/site -w /site -p 1313:1313 hugo:latest hugo server --bind 0.0.0.0

许可证

本项目采用Apache 2.0许可证 - 详见https://github.com/owncloud-ci/hugo/blob/master/LICENSE%E6%96%87%E4%BB%B6%E3%80%82