pandoc/core

Core pandoc 镜像

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

例如，镜像还包含用于转换SVG图形的程序（svg-convert），以及https://lierdakil.github.io/pandoc-crossref/%E8%BF%87%E6%BB%A4%E5%99%A8%EF%BC%8C%E8%AF%A5%E8%BF%87%E6%BB%A4%E5%99%A8%E5%B8%B8%E7%94%A8%E4%BA%8E%E4%B8%BA%E5%9B%BE%E8%A1%A8%E3%80%81%E5%85%AC%E5%BC%8F%E3%80%81%E8%A1%A8%E6%A0%BC%E7%BC%96%E5%8F%B7%E5%B9%B6%E8%BF%9B%E8%A1%8C%E4%BA%A4%E5%8F%89%E5%BC%95%E7%94%A8%E3%80%82

快速参考

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

• 问题反馈：https://github.com/pandoc/dockerfiles/issues

• 源码仓库：GitHub上的https://github.com/pandoc/dockerfiles

• 维护者：https://github.com/tarleb%E3%80%81https://github.com/alerque%E5%92%8Chttps://github.com/daamien%E3%80%82

支持的标签

• 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镜像可用：

• https://hub.docker.com/r/pandoc/minimal%EF%BC%9A%E5%8C%85%E5%90%ABpandoc%E5%8F%AF%E6%89%A7%E8%A1%8C%E6%96%87%E4%BB%B6%E7%9A%84%E5%B0%8F%E5%9E%8B%E9%95%9C%E5%83%8F%E3%80%82
• https://hub.docker.com/r/pandoc/core%EF%BC%9A%E5%9F%BA%E4%BA%8Eminimal%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8C%85%E5%90%AB%E8%BD%AC%E6%8D%A2%E8%BF%87%E7%A8%8B%E4%B8%AD%E5%B8%B8%E7%94%A8%E7%9A%84%E5%85%B6%E4%BB%96%E7%A8%8B%E5%BA%8F%E3%80%82
• https://hub.docker.com/r/pandoc/latex%EF%BC%9A%E9%80%82%E7%94%A8%E4%BA%8E%E9%80%9A%E8%BF%87LaTeX%E8%BD%AC%E6%8D%A2%E4%B8%BAPDF%E3%80%82
• https://hub.docker.com/r/pandoc/extra%EF%BC%9A%E5%9F%BA%E4%BA%8Epandoc/latex%E7%9A%84%E5%A4%A7%E5%9E%8B%E9%95%9C%E5%83%8F%EF%BC%8C%E5%8C%85%E5%90%AB%E6%9B%B4%E5%A4%9A%E8%BE%85%E5%8A%A9%E5%B7%A5%E5%85%B7%E3%80%81Tectonic%E5%BC%95%E6%93%8E%E5%92%8Chttps://github.com/Wandmalfarbe/pandoc-latex-template%E3%80%82
• https://hub.docker.com/r/pandoc/typst%EF%BC%9A%E5%8C%85%E5%90%ABTypst%E6%8E%92%E7%89%88%E7%B3%BB%E7%BB%9F%E3%80%82