46.Python-web框架-Django - 多语言配置

目录

1.Django 多语言基础知识

1.1什么是Django国际化和本地化?

1.2Django LANGUAGE_CODE

1.3关于languages

1.4RequestContext对象针对翻译的变量

2.windows系统下的依赖

3.django多语言配置

3.1settings.py配置

引用gettext_lazy

 配置多语言中间件,注意看注释

 配置i18n模板

默认语言、可选语言、多语言文件目录配置

3.2urls.py配置

3.3多语言

创建多语言文件夹

创建多语言文件

django.po

编译多语言文件

另一种选择,手动操作--未经验证

3.4多语言效果

中文

英文

4.项目的多语言配置

4.1在模板中使用翻译文本

{%load i18n%}

{% trans %}

4.2在代码中使用翻译文本

4.3多语言切换链接

5.i18n_patterns 的一个缺陷


1.Django 多语言基础知识

多语言站点可以让不同语言的用户更好地使用和理解网站内容,提升用户体验和覆盖范围。为了实现多语言功能,我们将使用Django内置的国际化和本地化支持。我收集了一些知识点整理在这一部分,感兴趣的可以看看。直接跳过此部分也行。也可以看看官方文档:

翻译 | Django 文档 | Django

1.1什么是Django国际化和本地化?

在开始介绍实现方式之前,让我们先了解一下Django的国际化和本地化是什么。国际化是指把程序的文本和用户界面设计得可以适应不同的语言和地区。本地化是指根据用户所在的语言和地区来提供相应的语言翻译和格式化。Django提供了一套完整的国际化和本地化解决方案,可以帮助我们轻松地创建和管理多语言站点。

locale name¶

区域名称,可以是 ll 形式的语言规范,也可以是 ll_CC 形式的语言和国家组合规范。例如:itde_ATespt_BRsr_Latn。语言部分总是用小写。国家部分如果超过两个字符,则首字母大写,否则全部大写。分隔符为下划线。

language code¶

代表语言名。浏览器使用这个格式来在 Accept-Language HTTP header 里发送浏览器接受的语言名。比如:itde-atespt-br 。语言代码一般用小写表示,但是 HTTP Accept-Language header 不区分大小写。用破折号来间隔。

message file¶

一个消息文件是文本文件,代表一种语言,包含所有可用的 translation strings ,以及它们如何在给定的语言里表示。消息文件的文件扩展名是 .po 。

translation string¶

可以翻译的文字。

format file¶

格式文件是一个 Python 模块,用于定义本地数据格式。

1.2Django LANGUAGE_CODE

Django LANGUAGE_CODE 有两个作用:

  • 如果没有设置 locale 中间件,那么这个用于给所有用户提供翻译。适用于只需要一种翻译的情况
  • 如果设置了 locale 中间件,那么作为翻译的后备物品,用于没有匹配到语言的情况

Django 使用的语言代码遵循 ISO 639-1 标准。以下是 Django 支持的所有语言代码列表(中文的是zh开头,所以在列表的最后面,包括zh-hans简体中文,zh-hant繁体中文。这个和以往用zh或zh-CN不太一样。具体看1.3):

LANGUAGES = (('af', 'Afrikaans'),('ar', 'Arabic'),('ast', 'Asturian'),('az', 'Azerbaijani'),('bg', 'Bulgarian'),('be', 'Belarusian'),('bn', 'Bengali'),('br', 'Breton'),('bs', 'Bosnian'),('ca', 'Catalan'),('cs', 'Czech'),('cy', 'Welsh'),('da', 'Danish'),('de', 'German'),('dsb', 'Lower Sorbian'),('el', 'Greek'),('en', 'English'),('en-gb', 'British English'),('eo', 'Esperanto'),('es', 'Spanish'),('es-ar', 'Argentinian Spanish'),('et', 'Estonian'),('eu', 'Basque'),('fa', 'Persian'),('fi', 'Finnish'),('fr', 'French'),('fy', 'Frisian'),('ga', 'Irish'),('gd', 'Scottish Gaelic'),('gl', 'Galician'),('he', 'Hebrew'),('hi', 'Hindi'),('hr', 'Croatian'),('hsb', 'Upper Sorbian'),('hu', 'Hungarian'),('hy', 'Armenian'),('ia', 'Interlingua'),('id', 'Indonesian'),('is', 'Icelandic'),('it', 'Italian'),('ja', 'Japanese'),('ka', 'Georgian'),('kk', 'Kazakh'),('km', 'Khmer'),('kn', 'Kannada'),('ko', 'Korean'),('lb', 'Luxembourgish'),('lt', 'Lithuanian'),('lv', 'Latvian'),('mk', 'Macedonian'),('ml', 'Malayalam'),('mn', 'Mongolian'),('my', 'Burmese'),('nb', 'Norwegian Bokmal'),('ne', 'Nepali'),('nl', 'Dutch'),('nn', 'Norwegian Nynorsk'),('os', 'Ossetic'),('pa', 'Punjabi'),('pl', 'Polish'),('pt', 'Portuguese'),('pt-br', 'Brazilian Portuguese'),('ro', 'Romanian'),('ru', 'Russian'),('sk', 'Slovak'),('sl', 'Slovenian'),('sq', 'Albanian'),('sr', 'Serbian'),('sr-latn', 'Serbian Latin'),('sv', 'Swedish'),('sw', 'Swahili'),('ta', 'Tamil'),('te', 'Telugu'),('th', 'Thai'),('tr', 'Turkish'),('tt', 'Tatarish'),('udm', 'Udmurt'),('uk', 'Ukrainian'),('ur', 'Urdu'),('vi', 'Vietnamese'),('zh-hans', 'Simplified Chinese'),('zh-hant', 'Traditional Chinese'),
)

1.3关于languages

一个语言的描述规则是下面这样的:

language-extlang-script-region-variant-extension-privateuse
语言文字种类-扩展语言文字种类-变体(或方言)-使用区域-变体(或方言)-扩展-私有

这些字符串对应的值拼接起来可以对应一个准确的语言。为了方便辨识和识别,通常还有约定:

  • language 全小写,通常两位,新版规范三位,比如:zh
  • extlang 全小写,三位,表示扩展语言,比如:粤语 yue (这里还有个 macrolanguage 的事情,先不提了)
  • script 首字母大写,四位,表示变体,比如:中文的 繁体字 Hant 和 简体字 Hans
  • region 全大写,两位,表示用于地区,比如:都是繁体中文,香港的惯用语与台湾的会有区别

所以问题“zh-cn 与 zh-hans 是什么关系、有什么区别?”中的惯用写法应该改成 zh-CN 和 zh-Hans。前者第二位用了地区限制匹配范围,后者用了文字变体限制。具体值对应的内容可以在这里搜索https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry

1.4RequestContext对象针对翻译的变量

RequestContext对象有三个针对翻译的变量LANGUAGES,LANGUAGE_CODE和LANGUAGE_BIDI,分别表示语言列表,当前用户语言的偏好,和语言的书写方式:

  • LANGUAGES 是一系列元组组成的列表,每个元组的第一个元素是语言代码,第二个元素是用该语言表示的语言名称。
  • LANGUAGE_CODE是以字符串表示的当前用户偏好语言(例如, en-us )。(详见 Django 如何确定语言偏好。)
  • LANGUAGE_BIDI是当前语言的书写方式。若设为 True,则该语言书写方向为从右到左(如希伯来语和阿拉伯语);若设为 False,则该语言书写方向为从左到右(如英语、法语和德语)。

2.windows系统下的依赖

如果是在windows系统下,需要进行环境配置及下载第三方库gettext。如果没有这个工具在生成多语言文件时,会报错:

Can't find msguniq. Make sure you have GNU gettext tools 0.15 or newer installed.

进入网址gettext 0.21 and iconv 1.16 - Binaries for Windows | mlocati - Michele Locati下载软件gettext或者压缩包,下载后安装。安装后在path中配置环境变量。配置好后,退出pycharm再重新进入,使配置生效。

然后再cmd.EXT里运行命令检查是否安装和配置正确

3.django多语言配置

3.1settings.py配置

引用gettext_lazy

使用函数 gettext() 来指定翻译字符串。按照惯例,将其作为下划线( _ )导入,以保存输入。

from django.utils.translation import gettext_lazy as _

 配置多语言中间件,注意看注释

MIDDLEWARE = ['django.middleware.security.SecurityMiddleware','django.contrib.sessions.middleware.SessionMiddleware','django.middleware.locale.LocaleMiddleware',  # 多语言(LocaleMiddleware这个中间件,应于SessionMiddleware之后,CommonMiddleware之前)'django.middleware.common.CommonMiddleware','django.middleware.csrf.CsrfViewMiddleware','django.contrib.auth.middleware.AuthenticationMiddleware','django.contrib.messages.middleware.MessageMiddleware','django.middleware.clickjacking.XFrameOptionsMiddleware',
]

 配置i18n模板

TEMPLATES = [{'BACKEND': 'django.template.backends.django.DjangoTemplates','DIRS': [BASE_DIR / 'templates'],'APP_DIRS': True,'OPTIONS': {'context_processors': ['django.template.context_processors.debug','django.template.context_processors.request','django.contrib.auth.context_processors.auth','django.contrib.messages.context_processors.messages','django.template.context_processors.i18n',  # i18n上下文渲染器],},},
]

默认语言、可选语言、多语言文件目录配置

LANGUAGE_CODE = 'zh-hans'  # admin 后台默认语言
TIME_ZONE = 'Asia/Shanghai'  # 时区:亚洲上海
USE_I18N = True  # 开启国际化(Internationalization)
USE_L10N = True  # 开启本地化(localization)
USE_TZ = False  # 关闭时区支持(是否错过8小时)LANGUAGES = (('en', _('English')),('zh-hans', _('中文简体')),
)
LOCALE_PATHS = [os.path.join(BASE_DIR, 'locale'),]  # 多语言翻译文件存放位置

LOCAL_PATHS注意配置的格式,如果写的不对也会报错。

3.2urls.py配置

from django.contrib import admin, auth
from django.urls import path,include
from django.conf.urls.i18n import i18n_patternsurlpatterns = [# path('i18n/', include('django.conf.urls.i18n')),# path('admin/', admin.site.urls),
]
urlpatterns += i18n_patterns(path('admin/', admin.site.urls),
i18n_patterns这个方法的作用,可以参考下面源代码前面的注释:

将语言代码前缀添加到此函数中的每个URL模式。
这只能用于根URLconf,而不能用于包含的URLconf。

def i18n_patterns(*urls, **kwargs):"""Adds the language code prefix to every URL pattern within thisfunction. This may only be used in the root URLconf, not in an includedURLconf."""if not settings.USE_I18N:return list(urls)prefix_default_language = kwargs.pop('prefix_default_language', True)assert not kwargs, 'Unexpected kwargs for i18n_patterns(): %s' % kwargsreturn [LocaleRegexURLResolver(list(urls), prefix_default_language=prefix_default_language)]

3.3多语言

创建多语言文件夹

根据3.1中LOCAL_PATHS中的配置,在项目manage.py同级目录下,创建文件夹locale

创建多语言文件

locale文件夹中,Django会为每种语言创建一个对应的子文件夹。在每个子文件夹中,我们需要创建一个.po文件,用于存放翻译的文本。.po文件是一种可以用于人类和机器阅读的文件格式,包含了原始文本和翻译文本的对应关系。

python manage.py makemessages -l zh_hans

python manage.py makemessages -l en

这里注意一下,1.locale下必须生成相应的文件,2.执行上面命令的过程可能会有一些提示,按照提示操作就好,3.如果这步骤报错,耐心去找原因,并解决。

django.po

编译多语言文件

这句命令会把我们在template里、*.py文件里使用的msgid放入到*.po文件,我们再去po文件里的填写其它语言。

python manage.py compilemessages

另一种选择,手动操作--未经验证

假设我们要创建英语和中文简体的翻译文件。首先,我们需要在locale文件夹中创建enzh_CN两个子文件夹。然后,在每个子文件夹中创建一个与项目同名的.po文件,例如对于英语,我们可以创建一个django.po文件。

接下来,我们使用翻译工具,如Poedit,打开.po文件,并进行翻译。在.po文件中,每个待翻译的文本都由一个前缀为msgid的消息标识符表示,而翻译后的文本则由一个前缀为msgstr的消息字符串表示。

msgid "Hello, world!"
msgstr "你好,世界!"

3.4多语言效果

中文

英文

 

4.项目的多语言配置

这一部分,我这次还没开始做,第一研究的时候,做过一次。然后参照了这篇文章:

Django 多语言站点的最简单实现方式|极客教程

4.1在模板中使用翻译文本

Django提供了一个内置的模板标签trans,用于将待翻译的文本传递给翻译引擎。

{%load i18n%}

在模板中,在模板的前面加上{%load i18n%},与所有模板标签一样,这个标签需要在所有需要翻译的模板中加载,甚至那些从其他模板继承(extend)而来的模板,也需要继承 i18n 标签。

{% trans %}

使用{% trans %}标签将待翻译的文本包裹起来。例如,如果我们在模板中要翻译一个标题为”Hello, world!”的文本,可以这样写:

{% load i18n %}<h1>{% trans "Hello, world!" %}</h1>

4.2在代码中使用翻译文本

除了在模板中使用翻译文本外,我们还可以在Python代码中动态翻译文本。Django提供了一个全局函数gettext,用于在Python代码中进行翻译。我们可以通过导入django.utils.translation模块来使用该函数。

from django.utils.translation import gettext as _def welcome_message(request):message = _('Hello, world!')return HttpResponse(message)

4.3多语言切换链接

为了让用户可以切换语言,我们可以在模板中添加语言切换链接。Django提供了一个内置的标签{% language %},用于生成语言切换链接。我们可以将该标签放置在模板的适当位置,并使用url参数指定切换语言时的URL。

{% load i18n %}<ul><li><a href="{% language 'en' %}">English</a></li><li><a href="{% language 'zh-cn' %}">中文简体</a></li><!-- 添加更多语言切换链接... -->
</ul>

5.i18n_patterns 的一个缺陷

在Django中,使用i18n_patterns时,如果你遇到了POST请求被转换成GET请求的问题,这通常是因为URL语言前缀的原因。当Django处理国际化的URL时,它会将语言前缀添加到每个请求的path中,这可能会导致POST请求变成GET请求。

所以,当后台使用request.method == 'POST'处理逻辑时,一直失败。

还没有研究更好的办法,继续搜索中。解决方案如下:

49.解决django多语言redirect时把post改为get的问题-CSDN博客

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/diannao/26526.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

set与map的详细封装步骤

目录 一.set与map在STL中的源码 二.修改红黑树 1.插入与查找时的比较方式 2.插入时的返回值 3.补充成员函数 三.封装set与map 1.迭代器的实现 2.函数接口 3.map中的operator[] 四.完整代码 set.h map.h RBTree.h 一.set与map在STL中的源码 想要简单实现set与map 需…

短视频矩阵工具有哪些?如何辨别是否正规?

随着短视频平台的持续火爆&#xff0c;搭建短视频矩阵成为各大品牌商家提高营销效果和完成流量变现的主要方式之一&#xff0c;类似于短视频矩阵工具有哪些等问题也在多个社群有着不小的讨论度。 而就短视频矩阵工具的市场现状而言&#xff0c;其整体呈现出数量不断增长&#x…

使用神卓互联来访问单位内部web【内网穿透神器】

在现代工作环境中&#xff0c;有时我们需要从外部访问单位内部的 web 资源&#xff0c;而神卓互联这款内网穿透神器就能完美地满足这一需求。 使用神卓互联来访问单位内部 web 其实并不复杂&#xff0c;以下是大致的使用步骤和配置方法。 首先&#xff0c;我们需要在单位内部的…

Three.js做了一个网页版的我的世界

前言 笔者在前一阵子接触到 Three.js 后, 发现了它能为前端 3D 可视化 / 动画 / 游戏方向带来的无限可能, 正好最近在与朋友重温我的世界, 便有了用 Three.js 来仿制 MineCraft 的想法, 正好也可以通过一个有趣的项目来学习一下前端 3D 领域 介绍 游戏介绍 相信大家对我的世…

vue3+ Element-Plus 点击勾选框往input中动态添加多个tag

实现效果&#xff1a; template&#xff1a; <!--产品白名单--><div class"con-item" v-if"current 0"><el-form-item label"平台名称"><div class"contaion" click"onclick"><!-- 生成的标签 …

Unity HoloLens2 MRTK 空间锚点 基础教程

Unity HoloLens2 MRTK 空间锚点 基础教程 Unity HoloLens2 空间锚点MRTK 空间锚点 准备Unity 工程创建设置切换 UWP 平台UWP 平台设置 下载并安装混合现实功能工具导入混合现实工具包和 OpenXR 包 Unity 编辑器 UWP 设置Unity 2019.4.40 设置Unity 2022.3.0 设置Unity 2022.3.0…

KCC@深圳-升压手电制作活动

这次我们将制作一款工业风升压手电。电路简单&#xff0c;适合入门型选手。也会进行原理讲解&#xff0c;方便大家升级改造。 活动概览 活动主题升压手电制作活动时间6月16日&#xff08;周日&#xff09;13:30活动地点月亮湾山庄A13人数限制15合作伙伴706深圳&#xff08;706青…

C语言----字符函数和字符串函数

在编程的过程中&#xff0c;我们要经常处理字符和字符串&#xff0c;为了方便操作字符和字符串&#xff0c;c语言标准库中提供的一系列库函数&#xff0c;接下来我们就开始学习与认识他们 1.字符分类函数 c语言中有一系列的函数是专门做字符分类的&#xff0c;也就是一个字符…

「漏洞复现」I Doc View 在线文档预览 qJvqhFt.json 任意文件读取漏洞(XVE-2024-2115)

0x01 免责声明 请勿利用文章内的相关技术从事非法测试&#xff0c;由于传播、利用此文所提供的信息而造成的任何直接或者间接的后果及损失&#xff0c;均由使用者本人负责&#xff0c;作者不为此承担任何责任。工具来自网络&#xff0c;安全性自测&#xff0c;如有侵权请联系删…

解决electron设置透明背景后,引入element-plus样式问题

首先给当前窗口设置自定义窗口以及背景色。 const mainWindow new BrowserWindow({width: 900,height: 670,show: false,autoHideMenuBar: true,...(process.platform linux ? { icon } : {}),webPreferences: {preload: join(__dirname, ../preload/index.js),sandbox: fal…

【 EI会议 | 西南大学主办 | 往届均已实现检索】第三届神经形态计算国际会议(ICNC 2024)

第三届神经形态计算国际会议&#xff08;ICNC 2024) 2024 3rd International Conference on Neuromorphic Computing (ICNC 2024) 一、重要信息 大会官网&#xff1a;www.ic-nc.org&#xff08;点击投稿/参会/了解会议详情&#xff09; 会议时间&#xff1a;2024年12月13-15…

Elasticsearch:智能 RAG,获取周围分块

作者&#xff1a;来自 Elastic Sunile Manjee 在检索增强生成 (RAG) 领域&#xff0c;一个持续存在的挑战是找到输入大型语言模型 (LLM) 的最佳数据量。数据太少会导致响应不足或不准确&#xff0c;而数据太多会导致答案模糊。这种微妙的平衡启发我开发了一个专注于智能分块和利…

社区论坛圈子软件APP ,提供互动交流、知识共享和专业交流的社交平台。

社区论坛圈子软件APP的开发能够为用户提供一个互动交流的社交平台&#xff0c;促进用户之间的知识分享、交流和互助。本文将突出社区论坛圈子软件APP的前景、作用和特点&#xff0c;以帮助您了解该系统的潜力和优势。 一、前景&#xff1a; 知识共享&#xff1a;社区论坛圈子软…

力扣每日一题-419

题目 给你一个大小为 m x n 的矩阵 board 表示甲板&#xff0c;其中&#xff0c;每个单元格可以是一艘战舰 X 或者是一个空位 . &#xff0c;返回在甲板 board 上放置的 战舰 的数量。 战舰 只能水平或者垂直放置在 board 上。换句话说&#xff0c;战舰只能按 1 x k&#xff…

一带一路情 相逢《中国缘》-诗琳探访湘西墨戎苗寨交流有感

一带一路情 相逢《中国缘》 诗琳探访湘西墨戎苗寨交流有感 5月21日至25日&#xff0c;《中国缘》栏目组组织的走进湘西苗疆边陲的文化交流活动&#xff0c;在群山环抱、绿树成荫、人文厚重的湘西古丈墨戎苗寨美丽绽放。这场以民间角度推演的中国和中亚人民的文化交流活动&am…

有一个主域名跟多个二级子域名时该怎么申请SSL证书?

当您拥有主域名以及多个子域名时&#xff0c;选择合适的SSL证书类型对于确保网站的安全性至关重要。以下是三种SSL证书类型的简要介绍&#xff1a; 单域名SSL证书&#xff1a; 功能&#xff1a;只能绑定单个域名&#xff0c;无论是主域名还是子域名。 适用场景&#xff1a;仅…

常用 磁力搜索 磁力链接 工具使用教程

一、什么是磁力链接&#xff1f; 磁力链接&#xff08;Magnet link&#xff09;是一种链接&#xff0c;它利用磁力编码来识别和获取文件的信息。它通常由一串以“magnet:?xturn:btih:”开头的字符串组成&#xff0c;后面跟着文件的哈希值。 二、如何使用磁力链接&#xff1f…

一篇文章看懂Redission原理

文章目录 ☃️可重入锁原理☃️锁重试和WatchDog机制☃️MutiLock原理 上一篇文章讲解了 Rediision的使用 ,这篇文章讲解其原理 ☃️可重入锁原理 在Lock锁中&#xff0c;他是借助于底层的一个voaltile的一个state变量来记录重入的状态的&#xff0c;比如当前没有人持有这把锁…

探索 cartesian_product:更深入理解范围库

理解范围库中的cartesian_product适配器 一、简介二、cartesian_product 适配器的动机三、将行为封装到算法中四、算法的局限性五、总结 一、简介 view::cartesian_product 适配器是range-v3 库一个新的组件。本文主要理解这个组件的功能以及它背后的设计理念&#xff0c;可以…

罗森伯格1800M 2000M 2400M 900M无源互调分析仪

在无线通信领域&#xff0c;频段是宝贵的资源&#xff0c;不同的通信系统通常会采用不同的频段以满足其传输需求。随着技术的发展&#xff0c;越来越多的通信系统被部署在各种频段上。为了准确、高效地测试和调试这些 信系统&#xff0c;各种测试设备也应运而生。源互调分析仪便…