进阶内容：编写可重用的应用 接下来如何学习？ 编写你的第一个 Django 补丁 - 1 - 本文档使用 书栈(BookStack.CN) 构建 致谢 当前文档 《Django 官方教程翻译项目》 由 进击的皇虫 使用 书栈(BookStack.CN) 进行 构建，生成于 2018-05-25。 书栈(BookStack.CN) 仅提供文档编写、整理、归类等功能，以及对文档内容的生成和导出工 Django-intro-zh Django 官方教程翻译项目 目前版本：1.11 官方文档目录 中文版文档 翻译进度 我也想一起翻译 这个项目的目的是将 Django 官方教程的 intro 部分 翻译成中文版。 起因是在看完 Django Book 之后觉得有点过时，随后看了官方文档，还是觉得官方文档写的比较 通俗易懂。为了方便更多想要学习 Django 的人（顺便翻译一遍也能更深入的理解文档），就有了 了 这个项目。 这一项目离不开辛勤帮助翻译的小伙伴们，没有他们这个项目也无法完成。 特别感谢 @Zoctan，将翻译版本从 1.8 升级到了 1.11（pr），跟上了 Django 的发展。 官方文档 在此。 以下是官方文档的目录： Django at a glance Quick install guide Writing your first Django app, part 1

tarfile --- 读写 tar 归档文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 14 文件格式 467 14.1 csv --- CSV 文件读写 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • 从流中读取输入时，如果 newline 为 None，则启用通用换行模式。输入中的行可以以 '\n'，'\r' 或 '\r\n' 结尾，这些行被翻译成 '\n' 在返回呼叫者之前。如果它是 ''，则启用通用换行模 式，但行结尾将返回给调用者未翻译。如果它具有任何其他合法值，则输入行仅由给定字符串终 止，并且行结尾将返回给未调用的调用者。 • 将输出写入流时，如果 newline 为 None，则写入的任何 None，则写入的任何 '\n' 字符都将转换为系统默认行分隔 符os.linesep。如果 newline 是 '' 或 '\n'，则不进行翻译。如果 newline 是任何其他合法值， 则写入的任何 '\n' 字符将被转换为给定的字符串。 如果 closefd 是 False 并且给出了文件描述符而不是文件名，那么当文件关闭时，底层文件描述符将保 持打开状态。如果给出文件名则 closefd 必须为

tarfile —读写 tar 归档文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446 14 文件格式 457 14.1 csv —CSV 文件读写 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • 从流中读取输入时，如果 newline 为 None，则启用通用换行模式。输入中的行可以以 '\n'，'\r' 或 '\r\n' 结尾，这些行被翻译成 '\n' 在返回呼叫者之前。如果它是 ''，则启用通用换行模 式，但行结尾将返回给调用者未翻译。如果它具有任何其他合法值，则输入行仅由给定字符串终 止，并且行结尾将返回给未调用的调用者。 • 将输出写入流时，如果 newline 为 None，则写入的任何 None，则写入的任何 '\n' 字符都将转换为系统默认行分隔 符os.linesep。如果 newline 是 '' 或 '\n'，则不进行翻译。如果 newline 是任何其他合法值， 则写入的任何 '\n' 字符将被转换为给定的字符串。 如果 closefd 是 False 并且给出了文件描述符而不是文件名，那么当文件关闭时，底层文件描述符将保 持打开状态。如果给出文件名则 closefd 必须为

tarfile —读写 tar 归档文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446 14 文件格式 457 14.1 csv —CSV 文件读写 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • 从流中读取输入时，如果 newline 为 None，则启用通用换行模式。输入中的行可以以 '\n'，'\r' 或 '\r\n' 结尾，这些行被翻译成 '\n' 在返回呼叫者之前。如果它是 ''，则启用通用换行模 式，但行结尾将返回给调用者未翻译。如果它具有任何其他合法值，则输入行仅由给定字符串终 止，并且行结尾将返回给未调用的调用者。 • 将输出写入流时，如果 newline 为 None，则写入的任何 None，则写入的任何 '\n' 字符都将转换为系统默认行分隔 符os.linesep。如果 newline 是 '' 或 '\n'，则不进行翻译。如果 newline 是任何其他合法值， 则写入的任何 '\n' 字符将被转换为给定的字符串。 如果 closefd 是 False 并且给出了文件描述符而不是文件名，那么当文件关闭时，底层文件描述符将保 持打开状态。如果给出文件名则 closefd 必须为

tarfile --- 读写 tar 归档文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431 ii 14 文件格式 441 14.1 csv --- CSV 文件读写 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • 从流中读取输入时，如果 newline 为 None，则启用通用换行模式。输入中的行可以以 '\n'， '\r' 或 '\r\n' 结尾，这些行被翻译成 '\n' 在返回呼叫者之前。如果它是 ''，则启用通 用换行模式，但行结尾将返回给调用者未翻译。如果它具有任何其他合法值，则输入行仅由 给定字符串终止，并且行结尾将返回给未调用的调用者。 • 将输出写入流时，如果 newline 为 None，则写入的任何 None，则写入的任何 '\n' 字符都将转换为系统默认行分 隔符os.linesep。如果 newline 是 '' 或 '\n'，则不进行翻译。如果 newline 是任何其他合 法值，则写入的任何 '\n' 字符将被转换为给定的字符串。 如果 closefd 是 False 并且给出了文件描述符而不是文件名，那么当文件关闭时，底层文件描述符 将保持打开状态。如果给出文件名则 closefd 必须为

tarfile --- 读写 tar 归档文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490 14 文件格式 505 14.1 csv --- CSV 文件读写 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • 从流中读取输入时，如果 newline 为 None，则启用通用换行模式。输入中的行可以以 '\n'，'\r' 或 '\r\n' 结尾，这些行被翻译成 '\n' 在返回呼叫者之前。如果它是 ''，则启用通用换行模 式，但行结尾将返回给调用者未翻译。如果它具有任何其他合法值，则输入行仅由给定字符串终 止，并且行结尾将返回给未调用的调用者。 • 将输出写入流时，如果 newline 为 None，则写入的任何 None，则写入的任何 '\n' 字符都将转换为系统默认行分隔 符os.linesep。如果 newline 是 '' 或 '\n'，则不进行翻译。如果 newline 是任何其他合法值， 则写入的任何 '\n' 字符将被转换为给定的字符串。 如果 closefd 是 False 并且给出了文件描述符而不是文件名，那么当文件关闭时，底层文件描述符将保 持打开状态。如果给出文件名则 closefd 必须为

tarfile --- 读写 tar 归档文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 ii 14 文件格式 471 14.1 csv --- CSV 文件读写 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • 从流中读取输入时，如果 newline 为 None，则启用通用换行模式。输入中的行可以以 '\n'， '\r' 或 '\r\n' 结尾，这些行被翻译成 '\n' 在返回呼叫者之前。如果它是 ''，则启用通 用换行模式，但行结尾将返回给调用者未翻译。如果它具有任何其他合法值，则输入行仅由 给定字符串终止，并且行结尾将返回给未调用的调用者。 • 将输出写入流时，如果 newline 为 None，则写入的任何 None，则写入的任何 '\n' 字符都将转换为系统默认行分 隔符os.linesep。如果 newline 是 '' 或 '\n'，则不进行翻译。如果 newline 是任何其他合 法值，则写入的任何 '\n' 字符将被转换为给定的字符串。 如果 closefd 是 False 并且给出了文件描述符而不是文件名，那么当文件关闭时，底层文件描述符 将保持打开状态。如果给出文件名则 closefd 必须为

tarfile --- 读写 tar 归档文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 ii 14 文件格式 471 14.1 csv --- CSV 文件读写 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • 从流中读取输入时，如果 newline 为 None，则启用通用换行模式。输入中的行可以以 '\n'， '\r' 或 '\r\n' 结尾，这些行被翻译成 '\n' 在返回呼叫者之前。如果它是 ''，则启用通 用换行模式，但行结尾将返回给调用者未翻译。如果它具有任何其他合法值，则输入行仅由 给定字符串终止，并且行结尾将返回给未调用的调用者。 • 将输出写入流时，如果 newline 为 None，则写入的任何 None，则写入的任何 '\n' 字符都将转换为系统默认行分 隔符os.linesep。如果 newline 是 '' 或 '\n'，则不进行翻译。如果 newline 是任何其他合 法值，则写入的任何 '\n' 字符将被转换为给定的字符串。 如果 closefd 是 False 并且给出了文件描述符而不是文件名，那么当文件关闭时，底层文件描述符 将保持打开状态。如果给出文件名则 closefd 必须为

Unicode 问题 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539 14 文件格式 541 14.1 csv --- CSV 文件读写 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 配置字典架构 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713 16.7.4 配置文件格式 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719 16.8 logging • 从流中读取输入时，如果 newline 为 None，则启用通用换行模式。输入中的行可以以 '\n'，'\r' 或 '\r\n' 结尾，这些行被翻译成 '\n' 在返回呼叫者之前。如果它是 ''，则启用通用换行模 式，但行结尾将返回给调用者未翻译。如果它具有任何其他合法值，则输入行仅由给定字符串终 止，并且行结尾将返回给未调用的调用者。 • 将输出写入流时，如果 newline 为 None，则写入的任何

Unicode 问题 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524 14 文件格式 525 14.1 csv --- CSV 文件读写 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 配置字典架构 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691 16.7.4 配置文件格式 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696 16.8 logging • 从流中读取输入时，如果 newline 为 None，则启用通用换行模式。输入中的行可以以 '\n'，'\r' 或 '\r\n' 结尾，这些行被翻译成 '\n' 在返回呼叫者之前。如果它是 ''，则启用通用换行模 式，但行结尾将返回给调用者未翻译。如果它具有任何其他合法值，则输入行仅由给定字符串终 止，并且行结尾将返回给未调用的调用者。 • 将输出写入流时，如果 newline 为 None，则写入的任何