46.django - 多语言配置

1.Django 多语言基础知识

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

翻译 | Django 文档 | Django

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

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

locale name¶

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

language code¶

代表语言名。浏览器使用这个格式来在 Accept-Language HTTP header 里发送浏览器接受的语言名。比如：it, de-at, es, pt-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文件夹中创建en和zh_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>

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

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

相关文章

安装搭建java版的悟空crm遇到 网络错误请稍候再试 终极解决办法（hrm人力资源模块）

安装搭建java版的悟空crm遇到 网络错误请稍候再试 终极解决办法（hrm人力资源模块）

java版 项目目录 ├── build – webpack 配置文件 ├── config – 项目配置文件 ├── src – 源码目录 │ ├── api – axios请求接口 │ ├── assets – 静态图片资源文件 │ ├── components – 通用组件 │ ├── directives – 通用指令 │ ├── filters –…
阅读更多...
项目中的任务调度和消息队列方案详解

项目中的任务调度和消息队列方案详解

✨✨谢谢大家捧场&#xff0c;祝屏幕前的小伙伴们每天都有好运相伴左右&#xff0c;一定要天天开心哦&#xff01;✨✨ &#x1f388;&#x1f388;作者主页&#xff1a; 喔的嘛呀&#x1f388;&#x1f388; 目录 引言 任务…
阅读更多...
软件项目调研三部曲（调研计划，调研大纲，调研报告）原件获取

软件项目调研三部曲（调研计划，调研大纲，调研报告）原件获取

软件项目详细调研的目的是依据项目合同的要求&#xff0c;能够通过在客户现场&#xff0c;并通过访谈的方式&#xff0c;尽可能的了解客户的需求和业务现状&#xff0c;包括客户涉及到的业务部门的岗位设置、岗位职责、工作内容、工作流程、管理难点以及通过实施信息化系统的期…
阅读更多...
GDPU Java 天码行空15 数据库编程

GDPU Java 天码行空15 数据库编程

一、实验目的 1、 了解数据库的基础知识。 2、 掌握MySQL的下载、安装与配置。 3、 掌握MySQL可视化工具的使用。 4、 了解SQL语言。 5、 掌握JDBC中的API&#xff0c;并能进行简单的数据库操作。 二、实验内容 1、 安装MySQL &#x1f468;‍&#x1f3eb; 视频教程 2、建…
阅读更多...
华为云加码数智升级 赋能山西培育新质生产力

华为云加码数智升级 赋能山西培育新质生产力

加码企业数智升级&#xff0c;驱动山西新质生产力跃升。6月4日&#xff0c;“云上共创晋而有为”华为云山西数智升级思享会在山西智创城NO.1创新孵化基地举办。 活动由华为云计算技术有限公司主办&#xff0c;太原清控科创科技园管理有限公司协办。活动整合山西鲲鹏生态创新中…
阅读更多...
嵌入式单片机中项目在线仿真工具分享

嵌入式单片机中项目在线仿真工具分享

前段时间，无意间发现了一个不错的在线仿真工具（Wokwi），支持多种平台，支持市面上主流的开发板，比如：STM32、ESP32、Arduino、树莓派等。 还支持常见的传感器、显示器件（LCD、LED屏幕）等，还可以播放音乐、联网、逻辑分析仪等，关键还提供了很多实际项目的案例。 这款工…
阅读更多...
Cocos2dx 编译游戏安装包制作教程

Cocos2dx 编译游戏安装包制作教程

在本教程中&#xff0c;我们将学习如何为 Visual Studio 编译项目配置图标&#xff0c;并使用 Inno Setup 创建安装包。我们将包括以下部分&#xff1a; 设置项目图标&#xff1a;在 Visual Studio 中配置 .exe 文件的图标&#xff0c;或者使用第三方工具替换编译后的图标。创…
阅读更多...
简记：为Docker配置服务代理

简记：为Docker配置服务代理

简记 为Docker配置服务代理 - 文章信息 - Author: 李俊才 (jcLee95) Visit me at CSDN: https://jclee95.blog.csdn.netMy WebSite&#xff1a;http://thispage.tech/Email: 291148484163.com. Shenzhen ChinaAddress of this article:https://blog.csdn.net/qq_28550263/art…
阅读更多...
小冬瓜AIGC 手撕LLM 拼课

小冬瓜AIGC 手撕LLM 拼课

小冬瓜aigc手撕LLM学习 官方认证 手撕LLMRLHF速成班-(附赠LLM加速分布式训练超长文档&#xff09; 帮助多名同学上岸LLM方向&#xff0c;包括高校副教授&#xff0c;北美PhD&#xff0c;大厂等 课程名称【手撕LLMRLHF】 授课形式&#xff1a;在线会议直播讲解课后录播 时间&…
阅读更多...
RK3568笔记三十一：ekho 6.3 文本转语音移植

RK3568笔记三十一：ekho 6.3 文本转语音移植

若该文为原创文章&#xff0c;转载请注明原文出处。 移植的目的是在在OCR识别基础上增加语音播放&#xff0c;把识别到的文字直接转TTS播报出来&#xff0c;形成类似点读机的功能。 1、下载文件 libsndfile-1.0.28.tar.gz ekho-6.3.tar.xz 2、解压 tar zxvf libsndfile-1.0…
阅读更多...
LangChain基础知识入门

LangChain基础知识入门

LangChain的介绍和入门 1 什么是LangChain LangChain由 Harrison Chase 创建于2022年10月&#xff0c;它是围绕LLMs&#xff08;大语言模型&#xff09;建立的一个框架&#xff0c;LLMs使用机器学习算法和海量数据来分析和理解自然语言&#xff0c;GPT3.5、GPT4是LLMs最先进的代…
阅读更多...
【源码】Spring Data JPA原理解析之事务注册原理

【源码】Spring Data JPA原理解析之事务注册原理

Spring Data JPA系列 1、SpringBoot集成JPA及基本使用 2、Spring Data JPA Criteria查询、部分字段查询 3、Spring Data JPA数据批量插入、批量更新真的用对了吗 4、Spring Data JPA的一对一、LazyInitializationException异常、一对多、多对多操作 5、Spring Data JPA自定…
阅读更多...
Docker 基础使用 (4) 网络管理

Docker 基础使用 (4) 网络管理

文章目录 Docker 网络管理需求Docker 网络架构认识Docker 常见网络类型1. bridge 网络2. host 网络3. container 网络4. none 网络5. overlay 网络 Docker 网路基础指令Docker 网络管理实操 其他相关链接 Docker 基础使用(0&#xff09;基础认识 Docker 基础使用(1&#xff09;…
阅读更多...
文件操作(Python和C++版)

文件操作(Python和C++版)

一、C版 程序运行时产生的数据都属于临时数据&#xff0c;程序—旦运行结束都会被释放通过文件可以将数据持久化 C中对文件操作需要包含头文件< fstream > 文件类型分为两种: 1. 文本文件 - 文件以文本的ASCII码形式存储在计算机中 2. 二进制文件- 文件以文本的二进…
阅读更多...
Spring运维之boo项目表现层测试匹配响应执行状态响应体JSON和响应头

Spring运维之boo项目表现层测试匹配响应执行状态响应体JSON和响应头

匹配响应执行状态 我们创建了测试环境 而且发送了虚拟的请求 我们接下来要进行验证 验证请求和预期值是否匹配 MVC结果匹配器 匹配上了 匹配失败 package com.example.demo;import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Auto…
阅读更多...
Transformer动画讲解：Softmax函数

Transformer动画讲解：Softmax函数

暑期实习基本结束了&#xff0c;校招即将开启。 不同以往的是&#xff0c;当前职场环境已不再是那个双向奔赴时代了。求职者在变多&#xff0c;HC 在变少&#xff0c;岗位要求还更高了。提前准备才是完全之策。 最近&#xff0c;我们又陆续整理了很多大厂的面试题&#xff0c…
阅读更多...
读AI未来进行式笔记07量子计算

读AI未来进行式笔记07量子计算

1. AI审讯技术 1.1. 发明者最初的目的是发明一种能够替代精神药物&#xff0c;为人类带来终极快乐的技术 1.1.1. 遗憾的是&#xff0c;他找到的只是通往反方向的大门 1.2. 通过非侵入式的神经电磁干扰大脑边缘系统&#xff0c;诱发受审者最…
阅读更多...
VRRP基础配置（华为）

VRRP基础配置（华为）

#交换设备 VRRP基础配置 VRRP (Virtual Router Redundancy Protocol) 全称是虚拟路由规元余协议&#xff0c;它是一种容错协议。该协议通过把几台路由设备联合组成一台虚拟的路由设备&#xff0c;该虚拟路由器在本地局域网拥有唯一的一个虚拟 ID 和虚拟 IP 地址。实际上&…
阅读更多...
UV胶的均匀性对产品质量有什么影响吗?

UV胶的均匀性对产品质量有什么影响吗?

UV胶的均匀性对产品质量有什么影响吗? UV胶的均匀性对产品质量具有显著的影响&#xff0c;主要体现在以下几个方面&#xff1a; 粘合强度&#xff1a;UV胶的均匀性直接影响其粘合强度。如果UV胶分布不均匀&#xff0c;可能导致部分区域粘接力不足&#xff0c;从而影响产品的…
阅读更多...
报错：CMake Error OpenCVConfig.cmake opencv-config.cmake

报错：CMake Error OpenCVConfig.cmake opencv-config.cmake

1、编译过程中&#xff0c;出现OpenCV 报错问题 报错&#xff1a;CMake Error OpenCVConfig.cmake opencv-config.cmake 解决思路&#xff1a;参考此链接
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023