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,一经查实,立即删除!

相关文章

深入理解Elasticsearch集群:节点与分片机制

Elasticsearch作为当下最流行的开源搜索引擎和数据分析引擎之一&#xff0c;其强大的分布式集群能力和可扩展性是其核心优势。在Elasticsearch集群中&#xff0c;节点&#xff08;Node&#xff09;和分片&#xff08;Shard&#xff09;是两个核心概念&#xff0c;它们共同构成了…

PyTorch -- 最常见损失函数 LOSS 的选择

损失函数&#xff1a;度量模型的预测结果与真实值之间的差异&#xff1b;通过最小化 loss -> 最大化模型表现代码实现框架&#xff1a;设有 模型预测值 f (x), 真实值 y 方法一&#xff1a; 步骤 1. criterion torch.nn.某个Loss()&#xff1b;步骤 2. loss criterion(f(x…

广州·2025全国眼睛健康产业博览会眼科医学大会|全国眼博会

广州2025全国眼睛健康产业博览会眼科医学大会&#xff0c;2025年4月10-12日&#xff0c;在广州南丰国际会展中心举办&#xff1b; ——随着时代的进步和科技的飞速发展&#xff0c;人们的眼睛健康问题日益受到关注。为了推动眼睛健康产业的持续发展&#xff0c;加强眼科医学的…

实施ISO 26262与ISO 21434的关键要素分析

随着汽车工业的快速发展和智能化水平的不断提升&#xff0c;汽车的功能性和安全性成为了消费者关注的重点。为了确保车辆的安全性和可靠性&#xff0c;国际标准化组织&#xff08;ISO&#xff09;制定了一系列与汽车安全相关的标准&#xff0c;其中ISO 26262&#xff08;道路车…

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 领域 介绍 游戏介绍 相信大家对我的世…

模式识别与机器学习复习题解析(2023春)

文章目录 一、判断题二、填空题三、单选题四、简答题relu激活h1layer2h2 h1w2b2relu激活h2outputout h2w3 b3 一、判断题 1 单层感知机的局限性&#xff0c;它仅对线性问题具有分类能力( )。T 2.多层感知机的问题是隐藏层的权值无法训练( )。T 3.ReLU和Batch Normalization都…

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…

CDH远程监控所有HDFS节点磁盘空间和自动清除日志

目录 1. SSH协议的重要性 2. JSch库简介 3. 项目依赖配置 4. 亲测可用的代码实现 5. 实际应用场景 6. 安全性和最佳实践 在大数据运维领域,自动化是一项至关重要的技能。随着集群规模的扩大和业务的复杂化,手动检查和操作各个服务器上的Hadoop分布式文件系统(HDFS)状…

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;如有侵权请联系删…

力扣1385.两个数组间的距离值

力扣1385.两个数组间的距离值 二分判断答案是否正确 class Solution {public:int findTheDistanceValue(vector<int>& arr1, vector<int>& arr2, int d) {ranges::sort(arr2);ranges::sort(arr1);int m arr2.size();auto check [&](int low,int h…

IP_Endpoint类型在CAPL中的使用

在使用TCP/IP协议栈通信时,创建Socket套接字调用接口函数实现通信的整个过程成为一种主流且便捷的方式。在CAPL中,Client需要创建TCP或UDP套接字,绑定自己的IP地址和一个端口号,作为自己的通信端点。 on key c {clientsocket = tcpOpen(ipGetAddressAsNumber("192.16…

解决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;而数据太多会导致答案模糊。这种微妙的平衡启发我开发了一个专注于智能分块和利…