pdf - 如何将页面转换为 pdf 并在 markdown 中包含资产下载链接？

Question

我尝试过使用此处列出的不同插件：https ://github.com/mkdocs/mkdocs/wiki/MkDocs-Plugins#pdf--site-conversion

但是他们所有人总是给我同样的错误

AttributeError: module 'mkdocs.utils' has no attribute 'string_types'

我的 SO 是 Windows 10，所以我在获取所需的 Cairo 库时遇到了一些问题。但即使在我们用来部署页面的容器中也会出现同样的错误。

Answer 1

在不同平台和安装上遇到很多问题后，mkdocs我完全切换到 docker。我制作了自己的特殊 docker 图像alinex/mkdocs而不是默认图像。在GitLab上找到构建它的源代码。我检查了它是否可以在本地用于构建文档或在构建步骤中。

因此，您只需要在您的 mkdocs 目录中运行以下命令：

docker run -v $(pwd):/data alinex/mkdocs

可以在http://alinex.gitlab.io/env/mkdocs的示例中找到作为模块包含的内容的描述。

也许我也可以帮助某人。

Answer 2

将插件更新到 requirements.txt 中的最新版本。

例如：

mkdocs>=1.1.2