Core pandoc 镜像

这些镜像包含pandoc（通用文档转换器）和一个最小化操作系统，以及常见转换任务所需的所有工具。

例如，镜像还包含用于转换SVG图形的程序（svg-convert），以及pandoc-crossref过滤器，该过滤器常用于为图表、公式、表格编号并进行交叉引用。

快速参考

• 获取帮助：pandoc-discuss 邮件列表

• 问题反馈：[***]

• 源码仓库：GitHub上的pandoc/dockerfiles

• 维护者：Albert Krewinkel、Caleb Maclennan和Damien Clochard。

支持的标签

• edge
• 3.7.0.2、3.7.0、3.7、3、latest
• 3.6.4.0、3.6.4、3.6
• 3.5.0.0、3.5.0、3.5
• 3.2.1.0、3.2.1、3.2

每个项目符号中列出的标签均指向同一个镜像。数字标签是滚动更新的，即版本标签始终指向具有给定版本前缀的最新镜像。像a.b.这样的前缀版本是指定可接受版本范围的简便方式。使用a.b.c.d这样的完整四部分版本可将镜像固定到特定版本。

latest标签指向最新发布的版本；pandoc版本发布与新镜像发布之间可能存在轻微延迟。

edge标签提供最新的开发版本。

所有标签都可以添加堆栈标识符作为后缀。

关于pandoc版本控制的说明

pandoc不仅是一个可执行文件，还是一个哈斯克尔（Haskell）库，因此它使用哈斯克尔包版本控制策略进行版本控制。即使是次要版本，在API不变的情况下有时也可能引入新行为，但这种情况很少见。

支持的堆栈

所有标签都可以添加堆栈标识符作为后缀，例如latest-ubuntu。这允许选择特定的操作系统。可用的堆栈包括：

• alpine：Alpine Linux。
• ubuntu：Ubuntu Linux。

pandoc/core的默认堆栈是alpine。

运行pandoc Docker容器

镜像的常见用法如下（为可读性添加换行）：

sh
docker run --rm \
       --volume "$(pwd):/data" \
       --user $(id -u):$(id -g) \
       pandoc/core README.md -o outfile.epub

这会将当前工作目录中的README.md文件转换为outfile.epub。注意，Docker选项位于镜像名称（此处为pandoc/core）之前，而pandoc选项位于镜像名称之后。

--volume标志将本地目录（冒号左侧）映射到容器中的目录（冒号右侧），以便pandoc可以访问源文件进行转换。$(pwd)被引用以避免文件名中的空格问题。

容器中执行pandoc的用户决定输出文件的所有权。该用户通常与本地用户不同，因此最好通过--user标志为docker指定要使用的用户和组ID。

对于频繁的命令行使用，建议使用以下shell别名：

sh
alias pandock=\
'docker run --rm -v "$(pwd):/data" -u $(id -u):$(id -g) pandoc/core'

其他镜像

以下pandoc镜像可用：

• pandoc/minimal：包含pandoc可执行文件的小型镜像。
• pandoc/core：基于minimal镜像，包含转换过程中常用的其他程序。
• pandoc/latex：适用于通过LaTeX转换为PDF。
• pandoc/extra：基于pandoc/latex的大型镜像，包含更多辅助工具、Tectonic引擎和Eisvogel模板。
• pandoc/typst：包含Typst排版系统。