Question

我喜欢阅读书籍而不是阅读电子书。

是否有最新django文档的精美印刷版本？

我知道它存在于pdf中并且可以打印pdf。这不是我的选择：pdf不是很好排版（我的意思是它是sphinx ......，如果你有很多东西需要排版很重要）并且+1000页太多了，无法打印。

由于

Answer 1

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

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

文档README：

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

它使用ReST（reStructuredText）1和Sphinx文档   系统[2]。这使它可以更容易地构建到其他形式   查看和浏览。

创建文档的HTML版本：



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



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



然后可以在a中查看_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      ?=

Answer 2

我不认为有;这里的问题是因为django是社区驱动的，所以文档不断变化。因此，任何出版物在从打印机返回之前都会过时。但要提及的是，目前还有6个django版本。

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

是否有django文档的硬拷贝？

2 个答案: