内容作者本地预览

在推送更改之前，在本地预览您的文档。您只需要 Docker 和一个 docs/ 目录。

前提条件

在内容仓库的根目录下运行：

docker run --rm -it \
  -v "$(pwd)/docs:/content/docs" \
  -p 4321:4321 \
  -e MODE=dev \
  ghcr.io/f5-sales-demo/docs-builder:latest

服务器启动后，打开 **http://localhost:4321**。

将图片放在子目录中，例如 docs/images/。容器会自动检测这些文件——无需额外的卷挂载。

在 MDX 中使用根相对路径引用它们：

![Architecture diagram](/images/architecture.png)

端口已被占用 — 映射到不同的主机端口：-p 8080:4321，然后打开 http://localhost:8080。

内容未显示 — 确认 docs/index.mdx 文件存在。检查容器输出中是否有 ERROR: No content found 消息。

镜像过期 — 拉取最新版本：

docker pull ghcr.io/f5-sales-demo/docs-builder:latest