debezium/website-builder

Debezium Website Builder 镜像文档

镜像概述和主要用途

本镜像仓库已迁移至 https://quay.io/repository/debezium/website-builder%E3%80%82Debezium%E5%AE%98%E7%BD%91(debezium.io)%E5%9F%BA%E4%BA%8EJekyll%E9%9D%99%E6%80%81%E7%BD%91%E7%AB%99%E6%A1%86%E6%9E%B6%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%9C%AC%E5%AE%B9%E5%99%A8%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8EDebezium%E7%BD%91%E7%AB%99%E7%9A%84%E5%BC%80%E5%8F%91%E5%B7%A5%E4%BD%9C%EF%BC%8C%E5%90%8C%E6%97%B6%E4%B9%9F%E5%8F%AF%E7%94%A8%E4%BA%8E%E5%85%B6%E4%BB%96%E5%9F%BA%E4%BA%8EJekyll%E7%9A%84%E9%9D%99%E6%80%81%E7%BD%91%E7%AB%99%E5%BC%80%E5%8F%91%E3%80%82

核心功能和特性

• 基于Jekyll框架构建静态HTML网站
• 集成Antora工具处理版本化文档
• 提供开发环境，支持网站实时预览
• 包含Ruby依赖管理工具(bundle)，便于管理网站所需依赖库

使用场景和适用范围

• Debezium官网开发人员日常开发与预览
• 基于Jekyll的静态网站开发与调试
• 需要集成Antora进行版本化文档构建的项目

使用方法和配置说明

步骤1：获取网站代码

使用Git克隆Debezium网站代码仓库并进入目录：

bash
$ git clone https://github.com/debezium/debezium.github.io.git
$ cd debezium.github.io

若用于开发其他网站，获取对应网站的本地代码库即可。

步骤2：运行Web服务器

启动容器以生成静态网站并运行开发Web服务器：

bash
$ docker run --privileged -it --rm -p 4000:4000 -e LC_ALL=C.UTF-8 -e LANG=C.UTF-8 -v $(pwd):/site debezium/website-builder bash

参数说明：

• --privileged：赋予容器扩展权限
• -it：提供交互式终端
• --rm：容器停止后自动删除
• -p 4000:4000：将容器的4000端口映射到主机的4000端口
• -e LC_ALL=C.UTF-8 -e LANG=C.UTF-8：设置字符编码环境变量
• -v $(pwd):/site：将当前目录挂载到容器内的/site目录

进入容器后，运行以下命令更新并安装Ruby依赖库（通常只需执行一次）：

bash
jekyll@49d06009e1fa:/site$ bundle update
jekyll@49d06009e1fa:/site$ bundle install

安装完成后，构建并预览网站：

bash
jekyll@49d06009e1fa:/site$ rake clean preview

注：集成Antora后，上述命令会自动拉取主代码库并调用Antora构建版本化文档，然后再执行Jekyll构建。有关Antora集成详情，请参阅ANTORA.md。

步骤3：查看网站

在浏览器中访问 http://localhost:4000 即可查看网站。开发过程中可能会有一定延迟，因为网站采用懒加载方式生成。

步骤4：编辑网站

使用本地开发工具编辑网站源文件。对于 minor 修改，Jekyll可能会自动检测并重新生成对应文件；建议修改后通过 CTRL-C 停止预览服务器，重新运行 rake clean preview 命令并刷新浏览器。

若修改了 Gemfile，需更新依赖库：

1. 按 CTRL-C 停止容器
2. 执行 rm -rf bundler 删除本地依赖目录
3. 重启容器，确保使用 Gemfile.lock 中指定的依赖版本

步骤5：提交更改

使用本地Git工具提交代码更改，并发布网站新版本。