read-the-docs - 如何找到 Read-the-docs 项目的 PDF 版本

Question

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

PDF Generation

When you build your project on RTD, we automatically build a PDF of your project’s documentation. We also build them for every version that you upload, so we can host the PDFs of your latest documentation, as well as your latest stable releases as well.

但是你如何找到PDF版本？网络搜索找到了这个 2012 blog post作者说:

Here, for example, is the url to Django-Tastypie’s PDF docs:

http://media.readthedocs.org/pdf/django-tastypie/latest/django-tastypie.pdf

You can replace django-tastypie with the slug for any Read the Docs project.

但是，RTD 不允许用户通过以下 URL 浏览网站的目录树: http://media.readthedocs.org/pdf/[project slug]/ , 找我 403 FORBIDDEN !至少对于项目 CookieCutter。

Answer 1

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

无论如何，我猜你正在寻找这些:

https://media.readthedocs.org/pdf/cookiecutter/latest/cookiecutter.pdf

https://media.readthedocs.org/pdf/cookiecutter/stable/cookiecutter.pdf

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



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



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

注意:PDF 生成在某些拥有自己的 RtD 副本的网站上可能不起作用。
一个例子是 Haskell Stack ;另见这个问题:
how to download the docs as PDF