Question

我没看到什么？ RTD features页面说：

PDF生成

在RTD上构建项目时，我们会自动构建PDF文件   你的项目文件。我们还为每个版本构建它们   您上传的内容，因此我们可以托管您最新文档的PDF，   以及您最新的稳定版本。

但是你如何找到PDF版本？网络搜索找到了2012 blog post作者所说的内容：

例如，这里是Django-Tastypie的PDF文档的URL：
http://media.readthedocs.org/pdf/django-tastypie/latest/django-tastypie.pdf
你可以用任何Read the Docs的slug替换django-tastypie 项目

但是，RTD不允许用户通过网址浏览网站的目录树：http://media.readthedocs.org/pdf/[project slug]/，获取我403 FORBIDDEN！至少对于项目CookieCutter。

Answer 1

出于安全原因，许多网站不允许您浏览Web服务器上的目录列表。因此是403。

无论如何，我想您正在寻找这些东西：

通常，不需要自己构造此URL。 RtD的导航栏中有一个链接。您只需要知道在哪里可以找到它。

请注意页面左下方的“阅读文档”标签（以及版本指示符）。单击它，一个面板将打开。

在面板中，您可以选择所需的版本。 “ PDF”链接导航到PDF文件。 RtD的构建系统应自动将此文件与文档来源保持最新。

注意：PDF生成在某些托管自己的RtD副本的网站上可能无法正常工作。一个示例是Haskell Stack；另请参阅以下问题： how to download the docs as PDF

Answer 2

我发现最好使用Read the Docs标签来打开带有pdf链接的面板。但是，如果不存在，则可以进行网络搜索。

例如搜索
readthedocs cookiecutter pdf
我看到的第一个结果（截至2020年7月8日）是指向pdf的链接：https://readthedocs.org/projects/cookiecutter/downloads/pdf/latest/

截至2020年7月8日，cookiecutter readthedocs确实具有带有pdf链接的可扩展面板。然而，当我查看readthedocs for pipenv时，没有ReadTheDocs可点击来打开面板。但是如果我在Google中搜索
readthedocs pipenv pdf
第一个结果是指向pdf的链接：https://media.readthedocs.org/pdf/pipenv/latest/pipenv.pdf

如何找到Read-the-docs项目的pdf版本？

2 个答案: