1

比起阅读电子书，我更喜欢看书。

  • 最新的 django 文档有印刷精美的版本吗？

我知道它存在于 pdf 中，并且可以打印 pdf。不过，这对我来说不是一个选择：pdf 的排版不好（我的意思是狮身人面像......，如果你有很多要阅读的内容，排版很重要）而且 +1000 页的打印太多了。

谢谢

4

2 回答 2

3

不，没有硬拷贝，因为在墨水干之前它就会过时。

您可以自己生成文档。文档自述文件说明了一切。Docs 使用 reStructuredText 和 Sphinx。这是 Django 为您提供的，也是生成任何其他表示的起点。

文档自述文件：

此树中的文档是纯文本文件，可以使用任何文本文件查看器查看。

它使用 ReST (reStructuredText) 1和 Sphinx 文档系统 [2]。这允许将其内置到其他形式中，以便于查看和浏览。

要创建文档的 HTML 版本：

  • 安装 Sphinx（使用sudo pip install Sphinx或其他方法）

  • 在此 docs/ 目录中，在 shell 提示符下键入make html（或make.bat html在 Windows 上）。

然后可以在 Web 浏览器中查看 _build/html/index.html 中的文档。

1 http://docutils.sourceforge.net/rst.html [2] http://sphinx-doc.org/

在 /path/to/django-master/docs/

$ make help
Please use `make <target>' where <target> is one of
  html       to make standalone HTML files
  dirhtml    to make HTML files named index.html in directories
  singlehtml to make a single large HTML file
  pickle     to make pickle files
  json       to make JSON files
  htmlhelp   to make HTML files and a HTML help project
  qthelp     to make HTML files and a qthelp project
  devhelp    to make HTML files and a Devhelp project
  epub       to make an epub
  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
  latexpdf   to make LaTeX files and run them through pdflatex
  text       to make text files
  man        to make manual pages
  texinfo    to make a Texinfo source file
  gettext    to make PO message catalogs
  changes    to make an overview of all changed/added/deprecated items
  linkcheck  to check all external links for integrity
  doctest    to run all doctests embedded in the documentation (if enabled)

看来您可以生成一些有用的格式！

并阅读make文件：

# You can set these variables from the command line.
SPHINXOPTS    ?=
SPHINXBUILD   ?= sphinx-build
PAPER         ?=
BUILDDIR      ?= _build
LANGUAGE      ?=
于 2013-09-26T11:33:46.160 回答
1

我认为没有；这里的问题是，因为django是社区驱动的，所以文档在不断变化。因此，任何出版物在印刷商退回之前都会过时。更不用说目前也有 6 个版本的django。

您最好的选择是使用上述的 PDF 或下载 HTML 版本，然后您可以自己修改字体、大小和布局。

于 2013-09-26T08:49:43.993 回答