看来你已经阅读了 介绍性资料 ,而且决定继续使用Django。 前面我们只是概要性的介绍(实际上,即使你读了所有的介绍,也只看了整个文档的5%)。
所以下一步是什么呢?
我们一直热衷于通过实践来学习。 基于这一点,你应该开始你自己的项目然后开始动手做。 当你需要新的技能的时候,回来查文档。
我们花了大量的精力来使Django文档实用、易读、尽可能的完备。 下面的文档更多的是关于文档是如何使用,以便于你可以最大化的利用它。
(是的,这篇文档是关于如何使用文档的。 放心我们不会再为这篇文档的文档再写一篇文档了:P)
Django 的主要程序说明书可以分解为几个用于满足不同需求的部分:
介绍性资料专为Django的新用户或一般的Web开发人员而设计。 它并不包含所有深度的内容,但相对地提供高程度的对于如何培养使用Django的“感觉”的概览。
主题指南,通过另一种方式,在Django的每一块做了深入讲解。 主题包括 模型系统, 模板引擎, 表单框架 等等。
这可能是你想要花大部分时间的地方;如果你通过这些指导工作,你应该知道几乎所有关于Django的知识。
Web开发通常范围广,但是不深--问题会涉及很多领域。 我们已经写了一套how-to 指南来回答诸如“我如何...”等问题。 在这里您可以找到关于使用Django生成PDF文件、编写自定义模板标签等等的信息。
对于细节性的问题可以在FAQ中找到。
主题指南和How-To指南没有完全覆盖到Django中的每个类、函数、方法---如果那样的话会太多,不利于学习。 实际上,每个类、函数、方法还有模块的细节在 参考 中。 那里才是当你需要查找函数细节或是什么其他细节的地方。
如果你对部署项目到公网感兴趣,我们有several guides是关于部署的,比如 部署清单 是你需要关心的。
最后,有一些"特殊"的文档通常与大多数开发者无关。 包括 版本说明 和内部文档是写给那些想贡献代码到Django的人,以及一些很少地方使用的东西。
像Django代码通常每天都在开发和进步一样,我们的文档是持续改进的。 我们改进文档的理由:
Django 文档和代码一样是有版本控制的。 它在我们 Git 仓库的docs目录下。 每篇文章在仓库中是一个独立的文本文件。
你可以通过几种不同方式阅读Django文档。 以下用优先顺序排列:
最新版本的Django文档来源于右边网址https://docs.djangoproject.com/en/dev/. 这些HTML页面是由源控制的文本本件自动产生的。 这意味着他们反映了Django“最新和最好”的方面——包括最新的更正和新添加的内容,以及对于可能仅针对Django最新版本的用户开放的新特性的讨论。 (见下文“版本之间的差异”)
我们鼓励您在 工单系统. 中提交更改、更正或者建议以促进文档的改善。 Django 的开发者会主动查看工单系统,并且使用你的反馈意见来改善文档。
注意,不管怎样,工单应该非常明确的是和文档相关的,而不是问一些技术支持的问题。 如果你需要特别的 Django 帮助,试试django-users邮件列表或者 #django IRC频道。
离线阅读,或者移动阅读,你可以阅读 Django 纯文本文档。
如果你正在使用 Django 官方发行版,注意代码压缩包(tarball)包括一个docs/
目录,包含了对应发行版的文档。
如果你在使用开发版的 Django(又称为"trunk"),注意docs/
目录包含了所有的文档。 你可以通过 git checkout 来获取最新更新。
一个稍微有点技术含量的查看文档的方法是通过 Unix 系统的grep
命令来查找关键字搜索文档。 例如,这将会展示 Django 文档中提到"max_length"的地方。
$ grep -r max_length /path/to/django/docs/
你可以通过以下简单的方法获取 HTML 格式的文档:
像之前提到的,我们 Git 仓库中的文本文档包含更多"最新"改变的文档 。 这些改变通常包含 Django 开发版增加的一些特性。 因此,我们的策略是保留各种版本的开发文档。
我们遵从的策略:
2017年9月6日