klakegg/html-proofer

HTMLProofer

Docker镜像用于https://github.com/gjtorikian/html-proofer工具。

最新版本：3.19.2

镜像概述和主要用途

此镜像为HTMLProofer提供Docker化运行环境，HTMLProofer是一款用于验证HTML文件的工具，可检查链接有效性、HTML语法正确性等。镜像专注于保持版本最新，提供简单直接的使用方式。

核心功能和特性

• 保持与HTMLProofer官方版本同步更新，当前最新版本为3.19.2
• 支持HTMLProofer的所有标准验证功能，如链接检查、HTML语法验证等
• 无需本地安装依赖，直接通过Docker运行，简化环境配置
• 轻量级设计，专注于核心功能，不添加额外复杂特性

使用场景和适用范围

• 静态网站开发过程中验证HTML文件的正确性
• 文档站点（如使用Jekyll、Hugo等生成的站点）构建后的HTML验证
• CI/CD流程中集成HTML文件验证步骤，确保发布前内容质量
• 需要跨平台一致验证环境的开发团队

使用方法和配置说明

命令行使用

通过docker run命令直接运行，挂载本地站点目录到容器的/src目录：

shell
docker run --rm -it \
  -v $(pwd):/src \
  docker.xuanyuan.run/klakegg/html-proofer:3.19.2 \
  --allow-hash-href --check-html --empty-alt-ignore

参数说明：

• --rm：容器退出后自动删除
• -it：交互式终端
• -v $(pwd):/src：将当前目录挂载为容器内的/src工作目录
• klakegg/html-proofer:3.19.2：指定使用的镜像及版本
• --allow-hash-href --check-html --empty-alt-ignore：HTMLProofer的验证参数（根据需要调整）

docker-compose配置

在docker-compose.yml中添加服务配置：

yaml
validate:
  image: docker.xuanyuan.run/klakegg/html-proofer:3.19.2
  command: --allow-hash-href --check-html --empty-alt-ignore
  volumes:
    - .:/src

使用时执行：docker-compose run validate

配置参数

卷挂载

• /src：必须挂载的目录，作为站点文件夹和工作目录。容器将在此目录下查找HTML文件进行验证，通常挂载本地项目根目录。