“本地特色”附加功能

由于历史因素，Django自带了django.contrib.localflavor — 各种各样的代码片段，有助于在特定的国家地区或文化中使用。为了便于维护以及减少Django代码库的体积，这些代码现在在Django之外单独发布。

详见官方文档：

https://django-localflavor.readthedocs.org/

这些代码托管在GIthub上面，https://github.com/django/django-localflavor。

如何迁移

如果你使用了老版本的django.contrib.localflavor包，或者 django-localflavor-* 的模板之一，执行这两个简单的步骤就可以更新你的代码：

  • 在PyPI中安装第三方的django-localflavor 包。

  • 修改你应用的导入语句来引用新的包。

    例如，将：

    1.  from django.contrib.localflavor.fr.forms import FRPhoneNumberField

    …改为：

    1.  from localflavor.fr.forms import FRPhoneNumberField

新的包中的代码和以前一样(它是直接从Django中复制出来的)，所以你并不用担心功能上的向后兼容问题。只需要修改导入语句。

弃用政策

在 Django 1.5中，导入django.contrib.localflavor会产生 DeprecationWarning异常。也就是说你的代码还可以继续工作，但是你应该尽快修改它。

在Django 1.6中，导入 django.contrib.localflavor将不会继续工作。

译者：Django 文档协作翻译小组，原文：“Local flavor”。

本文以 CC BY-NC-SA 3.0 协议发布，转载请保留作者署名和文章出处。

Django 文档协作翻译小组人手紧缺，有兴趣的朋友可以加入我们，完全公益性质。交流群：467338606。