“Django/docs/3.0.x/index”的版本间差异
来自菜鸟教程
Django/docs/3.0.x/index
（autoload） |
小 （Page commit） |
||
| 第1行： | 第1行： | ||
| + | {{DISPLAYTITLE:Django 文档 — Django 文档}} | ||
<div id="django-documentation" class="section"> | <div id="django-documentation" class="section"> | ||
= Django 文档 = | = Django 文档 = | ||
| − | + | 关于 Django，你需要知道的一切。 | |
<div id="first-steps" class="section"> | <div id="first-steps" class="section"> | ||
<span id="index-first-steps"></span> | <span id="index-first-steps"></span> | ||
| − | == | + | == 第一步 == |
| − | + | 您是 Django 新手还是编程新手？ 这是开始的地方！ | |
| − | * ''' | + | * '''从头开始：''' [[../intro/overview|<span class="doc">概述</span>]] | [[../intro/install|<span class="doc">安装</span>]] |
| − | * ''' | + | * '''教程：''' [[../intro/tutorial01|<span class="doc">第 1 部分：请求和响应</span>]] | [[../intro/tutorial02|<span class="doc">第 2 部分：模型和管理站点</span>]] | [[../intro/tutorial03|<span class="doc">第 3 部分：视图和模板</span>]] | [[../intro/tutorial04|<span class="doc">第 4 部分：表单和通用视图</span>]] | [[../intro/tutorial05|<span class="doc">第 5 部分：测试</span>]] | [[../intro/tutorial06|<span class="doc">第 6 部分：静态文件</span>]] | [[../intro/tutorial07|<span class="doc">第 7 部分：自定义管理站点</span>]] |
| − | * ''' | + | * '''高级教程：''' [[../intro/reusable-apps|<span class="doc">如何编写可重用的应用程序</span>]] | [[../intro/contributing|<span class="doc">为 Django 编写你的第一个补丁</span>]] |
| 第20行： | 第21行： | ||
<div id="getting-help" class="section"> | <div id="getting-help" class="section"> | ||
| − | == | + | == 获得帮助 == |
| − | + | 遇到麻烦？ 我们愿意帮忙！ | |
| − | * 试试 [[../faq/index| | + | * 试试 [[../faq/index|FAQ]] - 它有许多常见问题的答案。 |
| − | * | + | * 寻找具体信息？ 试试[[../genindex|索引]]、[[../py-modindex|模块索引]]或[[../contents|详细目录]]。 |
| − | * | + | * 什么都没找到？ 有关获得支持和向社区提问的信息，请参阅 [[../faq/help|常见问题解答：获得帮助]] 。 |
| − | * 在我们的 [https://code.djangoproject.com/ | + | * 在我们的 [https://code.djangoproject.com/ 票务跟踪器] 中报告 Django 的错误。 |
| 第33行： | 第34行： | ||
<div id="how-the-documentation-is-organized" class="section"> | <div id="how-the-documentation-is-organized" class="section"> | ||
| − | == | + | == 文档的组织方式 == |
| − | Django | + | Django 有很多文档。 对其组织方式的高级概述将帮助您了解在哪里查找某些内容： |
| − | * [[../intro/index| | + | * [[../intro/index|教程]] 带您通过一系列步骤来创建 Web 应用程序。 如果您不熟悉 Django 或 Web 应用程序开发，请从这里开始。 另请查看“[[#index-first-steps|第一步]]”。 |
| − | * [[../topics/index| | + | * [[../topics/index|主题指南]] 在相当高的层次上讨论关键主题和概念，并提供有用的背景信息和解释。 |
| − | * [[../ref/index| | + | * [[../ref/index|参考指南]] 包含 API 和 Django 机器其他方面的技术参考。 它们描述了它是如何工作的以及如何使用它，但假设您对关键概念有基本的了解。 |
| − | * [[../howto/index| | + | * [[../howto/index|操作指南]]是食谱。 它们指导您完成解决关键问题和用例所涉及的步骤。 它们比教程更高级，并假设对 Django 的工作原理有一些了解。 |
| 第48行： | 第49行： | ||
== 模型层 == | == 模型层 == | ||
| − | Django | + | Django 提供了一个抽象层（“模型”）来构建和操作 Web 应用程序的数据。 在下面了解更多信息： |
| − | * ''' | + | * '''楷模：''' [[../topics/db/models|<span class="doc">模型介绍</span>]] | [[../ref/models/fields|<span class="doc">字段类型</span>]] | [[../ref/models/indexes|<span class="doc">索引</span>]] | [[../ref/models/options|<span class="doc">元选项</span>]] | [[../ref/models/class|<span class="doc">模型类</span>]] |
| − | * ''' | + | * '''查询集：''' [[../topics/db/queries|<span class="doc">进行查询</span>]] | [[../ref/models/querysets|<span class="doc">QuerySet 方法参考</span>]] | [[../ref/models/lookups|<span class="doc">查找表达式</span>]] |
| − | * ''' | + | * '''模型实例：''' [[../ref/models/instances|<span class="doc">实例方法</span>]] | [[../ref/models/relations|<span class="doc">访问相关对象</span>]] |
| − | * ''' | + | * '''迁移：''' [[../topics/migrations|<span class="doc">迁移简介</span>]] | [[../ref/migration-operations|<span class="doc">操作参考</span>]] | [[../ref/schema-editor|<span class="doc">架构编辑器</span>]] | [[../howto/writing-migrations|<span class="doc">编写迁移</span>]] |
| − | * ''' | + | * '''先进的：''' [[../topics/db/managers|<span class="doc">经理</span>]] | [[../topics/db/sql|<span class="doc">原始 SQL</span>]] | [[../topics/db/transactions|<span class="doc">交易</span>]] | [[../topics/db/aggregation|<span class="doc">聚合</span>]] | [[../topics/db/search|<span class="doc">搜索</span>]] | [[../howto/custom-model-fields|<span class="doc">自定义字段</span>]] | [[../topics/db/multi-db|<span class="doc">多个数据库</span>]] | [[../howto/custom-lookups|<span class="doc">自定义查找</span>]] | [[../ref/models/expressions|<span class="doc">查询表达式</span>]] | [[../ref/models/conditional-expressions|<span class="doc">条件表达式</span>]] | [[../ref/models/database-functions|<span class="doc">数据库函数</span>]] | [[../topics/async|<span class="doc">异步支持</span>]] |
| − | * ''' | + | * '''其他：''' [[../ref/databases|<span class="doc">支持的数据库</span>]] | [[../howto/legacy-databases|<span class="doc">遗留数据库</span>]] | [[../howto/initial-data|<span class="doc">提供初始数据</span>]] | [[../topics/db/optimization|<span class="doc">优化数据库访问</span>]] | [[../ref/contrib/postgres/index|<span class="doc">PostgreSQL 特定功能</span>]] |
| 第63行： | 第64行： | ||
== 视图层 == | == 视图层 == | ||
| − | Django | + | Django 有“视图”的概念来封装负责处理用户请求和返回响应的逻辑。 通过以下链接查找您需要了解的有关视图的所有信息： |
| − | * ''' | + | * '''基础知识：''' [[../topics/http/urls|<span class="doc">配置文件</span>]] | [[../topics/http/views|<span class="doc">查看功能</span>]] | [[../topics/http/shortcuts|<span class="doc">快捷方式</span>]] | [[../topics/http/decorators|<span class="doc">装饰器</span>]] |
| − | * '''参考：''' [[../ref/views|<span class="doc">内置视图</span>]] | [[../ref/request-response|<span class="doc"> | + | * '''参考：''' [[../ref/views|<span class="doc">内置视图</span>]] | [[../ref/request-response|<span class="doc">请求/响应对象</span>]] | [[../ref/template-response|<span class="doc">模板响应对象</span>]] |
| − | * '''文件上传：''' [[../topics/http/file-uploads|<span class="doc"> | + | * '''文件上传：''' [[../topics/http/file-uploads|<span class="doc">概述</span>]] | [[../ref/files/file|<span class="doc">文件对象</span>]] | [[../ref/files/storage|<span class="doc">存储API</span>]] | [[../topics/files|<span class="doc">管理文件</span>]] | [[../howto/custom-file-storage|<span class="doc">自定义存储</span>]] |
| − | * '''基于类的视图：''' [[../topics/class-based-views/index|<span class="doc"> | + | * '''基于类的视图：''' [[../topics/class-based-views/index|<span class="doc">概述</span>]] | [[../topics/class-based-views/generic-display|<span class="doc">内置显示视图</span>]] | [[../topics/class-based-views/generic-editing|<span class="doc">内置编辑视图</span>]] | [[../topics/class-based-views/mixins|<span class="doc">使用混入</span>]] | [[../ref/class-based-views/index|<span class="doc">API参考</span>]] | [[../ref/class-based-views/flattened-index|<span class="doc">扁平化索引</span>]] |
| − | * ''' | + | * '''先进的：''' [[../howto/outputting-csv|<span class="doc">生成 CSV</span>]] | [[../howto/outputting-pdf|<span class="doc">生成PDF</span>]] |
| − | * '''中间件：''' [[../topics/http/middleware|<span class="doc"> | + | * '''中间件：''' [[../topics/http/middleware|<span class="doc">概述</span>]] | [[../ref/middleware|<span class="doc">内置中间件类</span>]] |
| 第78行： | 第79行： | ||
== 模板层 == | == 模板层 == | ||
| − | + | 模板层提供了一种设计者友好的语法来呈现要呈现给用户的信息。 了解设计人员如何使用此语法以及程序员如何对其进行扩展： | |
| − | * ''' | + | * '''基础知识：''' [[../topics/templates|<span class="doc">概述</span>]] |
| − | * ''' | + | * '''对于设计师：''' [[../ref/templates/language|<span class="doc">语言概览</span>]] | [[../ref/templates/builtins|<span class="doc">内置标签和过滤器</span>]] | [[../ref/contrib/humanize|<span class="doc">人性化</span>]] |
| − | * ''' | + | * '''对于程序员：''' [[../ref/templates/api|<span class="doc">模板API</span>]] | [[../howto/custom-template-tags|<span class="doc">自定义标签和过滤器</span>]] |
| 第88行： | 第89行： | ||
<div id="forms" class="section"> | <div id="forms" class="section"> | ||
| − | == | + | == 表格 == |
| − | Django | + | Django 提供了丰富的框架来方便表单的创建和表单数据的操作。 |
| − | * ''' | + | * '''基础知识：''' [[../topics/forms/index|<span class="doc">概述</span>]] | [[../ref/forms/api|<span class="doc">表单API</span>]] | [[../ref/forms/fields|<span class="doc">内置字段</span>]] | [[../ref/forms/widgets|<span class="doc">内置小部件</span>]] |
| − | * ''' | + | * '''先进的：''' [[../topics/forms/modelforms|<span class="doc">模型表格</span>]] | [[../topics/forms/media|<span class="doc">整合媒体</span>]] | [[../topics/forms/formsets|<span class="doc">表单集</span>]] | [[../ref/forms/validation|<span class="doc">自定义验证</span>]] |
| 第99行： | 第100行： | ||
<div id="the-development-process" class="section"> | <div id="the-development-process" class="section"> | ||
| − | == | + | == 开发过程 == |
| − | + | 了解可帮助您开发和测试 Django 应用程序的各种组件和工具： | |
| − | * '''设置：''' [[../topics/settings|<span class="doc"> | + | * '''设置：''' [[../topics/settings|<span class="doc">概述</span>]] | [[../ref/settings|<span class="doc">完整的设置列表</span>]] |
| − | * ''' | + | * '''应用：''' [[../ref/applications|<span class="doc">概述</span>]] |
| − | * ''' | + | * '''例外：''' [[../ref/exceptions|<span class="doc">概述</span>]] |
| − | * '''django-admin | + | * '''django-admin 和 manage.py：''' [[../ref/django-admin|<span class="doc">概述</span>]] | [[../howto/custom-management-commands|<span class="doc">添加自定义命令</span>]] |
| − | * '''测试：''' [[../topics/testing/index|<span class="doc">介绍</span>]] | [[../topics/testing/overview|<span class="doc"> | + | * '''测试：''' [[../topics/testing/index|<span class="doc">介绍</span>]] | [[../topics/testing/overview|<span class="doc">编写和运行测试</span>]] | [[../topics/testing/tools|<span class="doc">包含的测试工具</span>]] | [[../topics/testing/advanced|<span class="doc">进阶课题</span>]] |
| − | * '''部署：''' [[../howto/deployment/index|<span class="doc">概述</span>]] | [[../howto/deployment/wsgi/index|<span class="doc">WSGI 服务器</span>]] | <span class=" | + | * '''部署：''' [[../howto/deployment/index|<span class="doc">概述</span>]] | [[../howto/deployment/wsgi/index|<span class="doc">WSGI 服务器</span>]] | [[../howto/deployment/asgi/index|<span class="doc">ASGI 服务器</span>]] | [[../howto/static-files/deployment|<span class="doc">部署静态文件</span>]] | [[../howto/error-reporting|<span class="doc">通过电子邮件跟踪代码错误</span>]] | [[../howto/deployment/checklist|<span class="doc">部署清单</span>]] |
| 第114行： | 第115行： | ||
<div id="the-admin" class="section"> | <div id="the-admin" class="section"> | ||
| − | == | + | == 管理员 == |
| − | + | 查找有关自动化管理界面的所有信息，这是 Django 最受欢迎的功能之一： | |
* [[../ref/contrib/admin/index|<span class="doc">管理站点</span>]] | * [[../ref/contrib/admin/index|<span class="doc">管理站点</span>]] | ||
| − | * [[../ref/contrib/admin/actions|<span class="doc"> | + | * [[../ref/contrib/admin/actions|<span class="doc">管理员操作</span>]] |
* [[../ref/contrib/admin/admindocs|<span class="doc">管理文档生成器</span>]] | * [[../ref/contrib/admin/admindocs|<span class="doc">管理文档生成器</span>]] | ||
| 第128行： | 第129行： | ||
== 安全 == | == 安全 == | ||
| − | + | 安全性是 Web 应用程序开发中最重要的话题，Django 提供了多种保护工具和机制： | |
* [[../topics/security|<span class="doc">安全概览</span>]] | * [[../topics/security|<span class="doc">安全概览</span>]] | ||
| − | * [[../releases/security|<span class="doc"> | + | * [[../releases/security|<span class="doc">Django 中披露的安全问题</span>]] |
* [[../ref/clickjacking|<span class="doc">点击劫持保护</span>]] | * [[../ref/clickjacking|<span class="doc">点击劫持保护</span>]] | ||
| − | * [[../ref/csrf|<span class="doc"> | + | * [[../ref/csrf|<span class="doc">跨站请求伪造保护</span>]] |
| − | * [[../topics/signing|<span class="doc"> | + | * [[../topics/signing|<span class="doc">加密签名</span>]] |
* [[../ref/middleware#security-middleware|<span class="std std-ref">安全中间件</span>]] | * [[../ref/middleware#security-middleware|<span class="std std-ref">安全中间件</span>]] | ||
| 第143行： | 第144行： | ||
== 国际化和本地化 == | == 国际化和本地化 == | ||
| − | Django | + | Django 提供了一个强大的国际化和本地化框架来帮助你开发多语言和世界区域的应用程序： |
| − | * [[../topics/i18n/index| | + | * [[../topics/i18n/index|概述]] | [[../topics/i18n/translation|国际化]] | [[../topics/i18n/translation#how-to-create-language-files|定位]] | [[../topics/i18n/formatting|本地化的Web UI格式和表单输入]] |
* [[../topics/i18n/timezones|<span class="doc">时区</span>]] | * [[../topics/i18n/timezones|<span class="doc">时区</span>]] | ||
| 第154行： | 第155行： | ||
== 性能和优化 == | == 性能和优化 == | ||
| − | + | 有多种技术和工具可以帮助您的代码更高效地运行 - 更快，并使用更少的系统资源。 | |
* [[../topics/performance|<span class="doc">性能和优化概述</span>]] | * [[../topics/performance|<span class="doc">性能和优化概述</span>]] | ||
| 第164行： | 第165行： | ||
== 地理框架 == | == 地理框架 == | ||
| − | [[../ref/contrib/gis/index| | + | [[../ref/contrib/gis/index|GeoDjango]] 旨在成为世界一流的地理 Web 框架。 其目标是尽可能轻松地构建 GIS Web 应用程序并利用启用空间的数据的力量。 |
| 第170行： | 第171行： | ||
<div id="common-web-application-tools" class="section"> | <div id="common-web-application-tools" class="section"> | ||
| − | == | + | == 常见的网络应用工具 == |
| − | Django | + | Django 提供了 Web 应用程序开发中常用的多种工具： |
| − | * ''' | + | * '''验证：''' [[../topics/auth/index|<span class="doc">概述</span>]] | [[../topics/auth/default|<span class="doc">使用认证系统</span>]] | [[../topics/auth/passwords|<span class="doc">密码管理</span>]] | [[../topics/auth/customizing|<span class="doc">自定义认证</span>]] | [[../ref/contrib/auth|<span class="doc">API 参考</span>]] |
* [[../topics/cache|<span class="doc">缓存</span>]] | * [[../topics/cache|<span class="doc">缓存</span>]] | ||
| − | * [[../topics/logging|<span class="doc"> | + | * [[../topics/logging|<span class="doc">日志记录</span>]] |
| − | * [[../topics/email|<span class="doc"> | + | * [[../topics/email|<span class="doc">发送电子邮件</span>]] |
| − | * [[../ref/contrib/syndication|<span class="doc"> | + | * [[../ref/contrib/syndication|<span class="doc">联合提要 (RSS/Atom)</span>]] |
* [[../topics/pagination|<span class="doc">分页</span>]] | * [[../topics/pagination|<span class="doc">分页</span>]] | ||
* [[../ref/contrib/messages|<span class="doc">消息框架</span>]] | * [[../ref/contrib/messages|<span class="doc">消息框架</span>]] | ||
| 第191行： | 第192行： | ||
<div id="other-core-functionalities" class="section"> | <div id="other-core-functionalities" class="section"> | ||
| − | == | + | == 其他核心功能 == |
| − | + | 了解 Django 框架的其他一些核心功能： | |
* [[../topics/conditional-view-processing|<span class="doc">有条件的内容处理</span>]] | * [[../topics/conditional-view-processing|<span class="doc">有条件的内容处理</span>]] | ||
* [[../ref/contrib/contenttypes|<span class="doc">内容类型和通用关系</span>]] | * [[../ref/contrib/contenttypes|<span class="doc">内容类型和通用关系</span>]] | ||
| − | * [[../ref/contrib/flatpages|<span class="doc"> | + | * [[../ref/contrib/flatpages|<span class="doc">平页</span>]] |
* [[../ref/contrib/redirects|<span class="doc">重定向</span>]] | * [[../ref/contrib/redirects|<span class="doc">重定向</span>]] | ||
* [[../topics/signals|<span class="doc">信号</span>]] | * [[../topics/signals|<span class="doc">信号</span>]] | ||
| 第208行： | 第209行： | ||
<div id="the-django-open-source-project" class="section"> | <div id="the-django-open-source-project" class="section"> | ||
| − | == | + | == Django 开源项目 == |
| − | 了解 Django | + | 了解 Django 项目本身的开发过程以及如何做出贡献： |
| − | * '''社区：''' [[../internals/contributing/index|<span class="doc"> | + | * '''社区：''' [[../internals/contributing/index|<span class="doc">如何参与</span>]] | [[../internals/release-process|<span class="doc">发布过程</span>]] | [[../internals/organization|<span class="doc">团队组织</span>]] | [[../internals/git|<span class="doc">Django 源代码库</span>]] | [[../internals/security|<span class="doc">安全政策</span>]] | [[../internals/mailing-lists|<span class="doc">邮件列表</span>]] |
| − | * ''' | + | * '''设计理念：''' [[../misc/design-philosophies|<span class="doc">概述</span>]] |
* '''文档：''' [[../internals/contributing/writing-documentation|<span class="doc">关于本文档</span>]] | * '''文档：''' [[../internals/contributing/writing-documentation|<span class="doc">关于本文档</span>]] | ||
| − | * ''' | + | * '''第三方发行版：''' [[../misc/distributions|<span class="doc">概述</span>]] |
| − | * ''' | + | * '''Django随着时间的推移：''' [[../misc/api-stability|<span class="doc">API稳定性</span>]] | [[../releases/index|<span class="doc">发行说明和升级说明</span>]] | [[../internals/deprecation|<span class="doc">弃用时间表</span>]] |
| 第222行： | 第223行： | ||
</div> | </div> | ||
| + | <div class="clearer"> | ||
| − | [[Category:Django 3.0.x | + | |
| + | |||
| + | </div> | ||
| + | |||
| + | [[Category:Django 3.0.x 文档]] | ||
2021年10月31日 (日) 04:08的最新版本
Django 文档
关于 Django，你需要知道的一切。
第一步
您是 Django 新手还是编程新手？ 这是开始的地方！
- 从头开始： 概述 | 安装
- 教程： 第 1 部分：请求和响应 | 第 2 部分：模型和管理站点 | 第 3 部分：视图和模板 | 第 4 部分：表单和通用视图 | 第 5 部分：测试 | 第 6 部分：静态文件 | 第 7 部分：自定义管理站点
- 高级教程： 如何编写可重用的应用程序 | 为 Django 编写你的第一个补丁
获得帮助
遇到麻烦？ 我们愿意帮忙！
- 试试 FAQ - 它有许多常见问题的答案。
- 寻找具体信息？ 试试索引、模块索引或详细目录。
- 什么都没找到？ 有关获得支持和向社区提问的信息，请参阅 常见问题解答：获得帮助 。
- 在我们的 票务跟踪器 中报告 Django 的错误。
文档的组织方式
Django 有很多文档。 对其组织方式的高级概述将帮助您了解在哪里查找某些内容：
- 教程 带您通过一系列步骤来创建 Web 应用程序。 如果您不熟悉 Django 或 Web 应用程序开发，请从这里开始。 另请查看“第一步”。
- 主题指南 在相当高的层次上讨论关键主题和概念，并提供有用的背景信息和解释。
- 参考指南 包含 API 和 Django 机器其他方面的技术参考。 它们描述了它是如何工作的以及如何使用它，但假设您对关键概念有基本的了解。
- 操作指南是食谱。 它们指导您完成解决关键问题和用例所涉及的步骤。 它们比教程更高级，并假设对 Django 的工作原理有一些了解。
模型层
Django 提供了一个抽象层（“模型”）来构建和操作 Web 应用程序的数据。 在下面了解更多信息：
- 楷模： 模型介绍 | 字段类型 | 索引 | 元选项 | 模型类
- 查询集： 进行查询 | QuerySet 方法参考 | 查找表达式
- 模型实例： 实例方法 | 访问相关对象
- 迁移： 迁移简介 | 操作参考 | 架构编辑器 | 编写迁移
- 先进的： 经理 | 原始 SQL | 交易 | 聚合 | 搜索 | 自定义字段 | 多个数据库 | 自定义查找 | 查询表达式 | 条件表达式 | 数据库函数 | 异步支持
- 其他： 支持的数据库 | 遗留数据库 | 提供初始数据 | 优化数据库访问 | PostgreSQL 特定功能
视图层
Django 有“视图”的概念来封装负责处理用户请求和返回响应的逻辑。 通过以下链接查找您需要了解的有关视图的所有信息：
- 基础知识： 配置文件 | 查看功能 | 快捷方式 | 装饰器
- 参考： 内置视图 | 请求/响应对象 | 模板响应对象
- 文件上传： 概述 | 文件对象 | 存储API | 管理文件 | 自定义存储
- 基于类的视图： 概述 | 内置显示视图 | 内置编辑视图 | 使用混入 | API参考 | 扁平化索引
- 先进的： 生成 CSV | 生成PDF
- 中间件： 概述 | 内置中间件类
模板层
模板层提供了一种设计者友好的语法来呈现要呈现给用户的信息。 了解设计人员如何使用此语法以及程序员如何对其进行扩展：
开发过程
了解可帮助您开发和测试 Django 应用程序的各种组件和工具：
- 设置： 概述 | 完整的设置列表
- 应用： 概述
- 例外： 概述
- django-admin 和 manage.py： 概述 | 添加自定义命令
- 测试： 介绍 | 编写和运行测试 | 包含的测试工具 | 进阶课题
- 部署： 概述 | WSGI 服务器 | ASGI 服务器 | 部署静态文件 | 通过电子邮件跟踪代码错误 | 部署清单
