docker-sphinx

用于Sphinx的Docker镜像。

镜像说明

• sphinxdoc/sphinx
• sphinxdoc/sphinx-latexpdf

注意：

sphinxdoc/sphinx-latexpdf 包含TeXLive软件包，因此镜像体积较大（超过2GB）。

使用方法

创建Sphinx项目：

bash
$ docker run -it --rm -v /path/to/document:/docs sphinxdoc/sphinx sphinx-quickstart

构建HTML文档：

bash
$ docker run --rm -v /path/to/document:/docs sphinxdoc/sphinx make html

构建EPUB文档：

bash
$ docker run --rm -v /path/to/document:/docs sphinxdoc/sphinx make epub

构建PDF文档：

bash
$ docker run --rm -v /path/to/document:/docs sphinxdoc/sphinx-latexpdf make latexpdf

使用技巧

如需安装依赖包，可将sphinxdoc/sphinx作为基础镜像：

dockerfile
# 在您的Dockerfile中
FROM sphinxdoc/sphinx

WORKDIR /docs
ADD requirements.txt /docs
RUN pip3 install -r requirements.txt