Sphinx文档: conf.py变量的翻译(i18n)
Sphinx文档是一种用于生成文档的工具，它支持多种文档格式，如HTML、PDF和EPUB等。conf.py是Sphinx项目的配置文件，其中包含了许多变量，其中之一是用于国际化（i18n）的变量。
国际化是指将软件或文档适应不同的语言和地区的过程。在Sphinx中，conf.py中的i18n变量用于配置文档的翻译功能。通过使用i18n变量，可以为不同的语言提供翻译版本的文档，以满足不同用户的需求。
在Sphinx中，i18n变量的配置包括以下几个步骤：
- 安装语言包：首先，需要安装所需语言的翻译包。Sphinx支持多种语言，如英语、中文、法语等。可以通过在conf.py中设置语言代码来指定所需的语言。
- 配置翻译文件：在conf.py中，可以指定用于翻译的文件路径。这些文件通常是.po（Portable Object）文件，包含了源文本和对应的翻译文本。可以使用工具如gettext来生成和编辑这些翻译文件。
- 生成翻译版本：一旦配置好翻译文件，可以使用Sphinx的命令行工具来生成翻译版本的文档。通过运行类似于"sphinx-build -b html -D language=zh_CN sourcedir builddir"的命令，可以生成指定语言的文档版本。
i18n变量的使用可以使得Sphinx文档更加易于全球用户理解和使用。通过提供多语言版本的文档，可以满足不同语言用户的需求，提高文档的可用性和可访问性。
腾讯云提供了一系列与云计算相关的产品，其中包括文档托管、内容分发网络（CDN）等。这些产品可以帮助用户在云端存储和分发文档，提供高可用性和快速访问的服务。您可以访问腾讯云的官方网站（https://cloud.tencent.com/）了解更多相关产品的详细信息。
相关·内容
2回答
如何在狮身人面像运行时预处理源文件？
python、python-3.x、vhdl、python-sphinx、read-the-docs
我已经为我的项目设置了Sphinx文档，并希望提取源文件的文档字符串并将它们嵌入到最终文档中。不幸的是，Sphinx不支持源文件的语言(VHDL)。VHDL似乎没有狮身人面像域。
因此，我的想法如下：
钩入Sphinx，运行并在Sphinx之前执行一些Python代码
Python代码从每个源文件(最顶层的多行注释块)中提取文本块，每个源文件组装一个reST文件，包括这个注释块和其他一些reST标记。
所有源文件都列在一个index.rst中，以生成.. toctree::指令。
每个源代码目录都递归地进行文本提取和转换。
因此，主要的问题是：如何连接到Spinx?
还
浏览 2提问于2016-05-24得票数 11
回答已采纳
1回答
Sphinx文档: conf.py变量的翻译(i18n)
python、internationalization、python-sphinx
在sphinx文档项目中，如何向conf.py中定义的变量添加翻译 举个恰当的例子：project变量是"<Brand Name> Setup and Configuration Manual"，我想把后面的部分翻译过来。 使用标准i18n工具时，.pot文件中缺少这些值。我也找不到如何在conf.py中获取命令行指定的语言(通过硬编码字典进行翻译)。
浏览 9提问于2019-04-23得票数 1
2回答
Sphinx文档变量
python、python-sphinx
我正在使用Sphinx为一个新项目编写文档
但是因为这个项目是新的，它的名称可能会改变，我不想在我的所有文档中替换所有“项目名称”的引用。
所以我想知道是否有一种方法可以将一些变量/常量放在Sphinx上来做到这一点。
我知道Sphinx上有一个i18n功能，所以我可以使用gettext来更改“项目名称”，而不需要其他东西。但我正在寻找一种合适的方法来做到这一点。
浏览 0提问于2013-02-28得票数 6
回答已采纳
1回答
基于角度i18n的语言翻译
angular、internationalization
在使用i18n的角度上，我面临着一些语言转换的问题。为了验证，我从REST中获得了一些错误代码，我将基于错误代码的消息放在环境文件中。我在组件ts文件中导入了文件。环境文件看起来像
loginErrorMsg01EN:'Invalid Credentails!!',
loginErrorMsg01ES:'Credentails inválidos!!'
文件中的html行
<label align="center" class="error-text" i18n="@@loginErrorMsg">{{
浏览 2提问于2020-01-14得票数 1
3回答
在姜戈，什么是i18n？
django
我正在查看，并且在每个文件中都看到{% load i18n %}这一行。什么是i18n
我知道这与有关，但有人能解释一下并给出一个详细的例子吗？谢谢。
浏览 0提问于2012-03-09得票数 25
回答已采纳
25回答
【开箱吧腾讯云】开发工具千千万，哪个最高效最好用？
腾讯云、产品、工具、开发、开发工具
开发工具千千万，哪个最高效最好用？
在关键时刻解决了你的卡点和痛点，欢迎你和我们一起分享你使用过的腾讯云宝藏工具！
点赞最高的前5名将获得猫王小王子花梨原木便携蓝牙音箱1个（截止时间：11月12日24:00）
另外在11月9日晚20:00-21:00
【开箱吧腾讯云】将迎来3位开发大神分享自身工具箱
快来腾讯云开发者视频号预约吧！更有超多双十一产品优惠等你！
图片
浏览 1725提问于2022-11-02
2回答
在平原php (没有任何框架)上有任何i18n库吗？
php、internationalization
可能重复：
我继承了一些代码，这只是简单的php，在这里我必须做一些更改。由于更改非常小，最大的要求是支持多语言，所以我选择保留现有代码，而不是重写它，但我需要一个普通php的i18n库。
是否有与普通php一起使用的默认库？我真的不知道，链接到使用/下载将是非常有帮助的。
更新1:
如果您能向我指出一些类似控制台的工具，帮助我构建一个包含所有应该被翻译的字符串的文件，而不是手工操作(在CakePHP中是__()函数之间的每个实例)，那就太好了。
浏览 6提问于2012-07-16得票数 1
回答已采纳
1回答
当gettext_compact=False时，sphinx不匹配子目录中的文本域。
python、windows、internationalization、python-sphinx、gettext
我目前正在使用python开发一个复杂的文档项目。我的下一步是启用国际化。
项目概览(简化)：
doc\
build\ # contains sphinx build output
images\ # contains image resources
locales\ # gnu gettext structure (simplified)
en\LC_MESSAGES\index.po+mo
en\LC_MESSAGES\articles\connect.po+mo
de\LC_MESSAGES\index.po+mo
de\LC
浏览 10提问于2022-04-06得票数 0
回答已采纳
1回答
HTML的i18next和lang属性的差异？
html、internationalization、javascript、lang、i18next
我被要求做一个应用程序的内部化。所以我做了我的研究，发现i8next基本上满足了我的需求。
i18next是一个功能齐全的i18n javascript库，用于翻译您的for应用程序。运行在浏览器中，在node.js、犀牛和其他javascript运行时下运行。i18next.com
然后，我记得在html中有一个选项，lang属性，用于设置html语言。
有什么关系呢？我是正确的，还是说我用了18next，或者有吸引力的郎朗可以很容易地解决我的问题？
浏览 1提问于2014-03-14得票数 0
回答已采纳
2回答
用Java i18n翻译长文本的最佳实践
java、spring、internationalization
我使用Java i18n翻译我的网页。我想知道翻译长文的最佳做法是什么。
示例:我有属性文件usermsg_en.properties：
short_text = short line
long_text = post about something with lot of text lines...
和jsp文件：
....
<div id="content"><spring:message code="long_text"/></div>
....
浏览 0提问于2016-01-11得票数 2
回答已采纳
2回答
Rails i18n Config文件管理最佳实践
ruby-on-rails、ruby、internationalization
我正在做一个i18n转换的RoR网站。我正在使用Sven Fuchs textmate包和NewDesk的翻译插件。我从Sven这里提供的yaml文件开始()
我正在快速地看到文件之间的键不同步，在开发实例之间的管理变得非常痛苦，使用"FROM=en TO=ru rake translate:google“任务或"rake translate:merge_keys”在prod中进行更新
yaml翻译文件扩散的最佳实践是什么？
跨环境同步yaml文件的最佳实践是什么？
浏览 2提问于2009-05-08得票数 5
1回答
狮身人面像LaTeX PDF中的侧边栏
pdf、latex、python-sphinx、hyperref
我正在从Sphinx生成一个LaTeX文档，并使用pdflatex (来自MikTeX)将其转换为PDF。文档在PDF查看器的侧边栏中缺少一个目录。
如果我将手动\usepackage{hyperref}添加到tex文件中，它就能工作。但是我如何让狮身人面像在conf.py项目文件中这样做呢？乳胶输出选项中没有(明显的)相关选项。
谢谢!
浏览 2提问于2015-09-01得票数 4
回答已采纳
1回答
Plomino多语言站点
multilingual、plone-4.x
我有CMFPlomino 2.13.15，Plone 4.2.0.1，LinguaPlone 4.1.3和Zope1.17.2
我需要在Plone上做一个多语言的网站，并使用Plomino。我发现我可以用LinguaPlone翻译plomino数据库、表单和视图，但不能翻译文档。我已经看过 (多语言应用程序-如何构建多语言Plomino应用程序)的过程，并在上看到了更详细的过程。我不确定我是否可以使用这个过程来翻译文档的内容，因为前面提到的教程指出“如果文本与来自i18n域的任何msgid不匹配，它将保持不变”。
这是否意味着文档内容的所有翻译都应该包含在.po文件中？有人能向我解释一下这个机
浏览 1提问于2013-08-21得票数 1
2回答
使用Sphinx扩展将svg转换为pdf
imagemagick、latex、python-sphinx、imagemagick-convert、pdflatex
我的公司正在使用狮身人面像为我们的产品制作手册。我们的产品带有PDF和HTML文档。我们使用Windows作为唯一的开发环境。
一个必要的要求是从相同的源(*.rst文件)生成两种格式。
遗留文档使用广泛的SVG，但是sphinx构建格式latex在\includegraphics{}环境中不支持SVG。
现在，我找到了有前途的狮身人面像扩展sphinx.ext.imgconverter，并将其包含在我的conf.py中。
extensions = [
'sphinx.ext.imgmath',
'sphinx.ext.ifconfig',
浏览 0提问于2018-04-18得票数 5
5回答
这是在.Net中维护国际化资源的好方法。
c#、.net、localization、resources、internationalization
我想出了三种方法来使用Visual 2008在.Net项目中为WinForms创建和维护资源。(我相信应该有三种以上的方法。)在开始为我们的产品实施国际化之前，我需要决定一个。
对每个.net项目中的每个窗口窗体或UI块(自定义控件)都有单独的资源文件集(resx)。这些是Visual在窗体或控件properties.Have中将可定位属性设置为true时自动生成的，每个.net项目只有一个资源文件。有一个资源管理器项目，它为一组.net项目的所有组件提供了资源。
就我个人而言，我不喜欢第一种方法，因为它创建了许多资源文件。这种方法的唯一优点是我们不需要手动设置UI元素中的文本。
我喜欢第二和
浏览 2提问于2009-09-03得票数 3
2回答
用于内部化和翻译的通用python库
python、internationalization
我需要国际化和翻译python应用程序。我期待着一些字典集合驻留在额外的资源文件中，这些资源文件可以在运行时进行切换，并在python代码中顺利使用。
我已经在stackoverflow.com上搜索过类似的工具，但只找到了特定于平台的库，例如pylons，django等等。
有没有通用的可供使用的库？
浏览 0提问于2013-01-23得票数 1
回答已采纳
3回答
内容翻译:视图中无法使用的语言筛选器
7、commerce、views、i18n-l10n、flags
我使用视图显示由全局标志(任何用户、任何语言)标记的节点列表，并且只返回与当前语言相关的节点。
为此，我应该能够在视图中添加一个过滤器，类似于“内容翻译:语言”。然而，似乎没有这样的过滤器可用。知道为什么这个过滤器不见了吗？
浏览 0提问于2015-05-14得票数 2
回答已采纳
3回答
网络：私有网络是什么意思？可以直接上互联网吗？
私有网络、5折上云
[图片]
标题：腾讯云云产品新购特惠，五折上云！
地址：https://cloud.tencent.com/act/first_purchase?utm_source=portal&utm_medium=rightbanner&utm_campaign=firstpurchase&utm_term=0109&_ga=2.121460426.337043824.1519722173-1832914836.1510649862
浏览器信息
Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (K
浏览 5078提问于2018-02-28
4回答
easy_install把东西安装在哪里？
python、easy-install
我想安装sphinx，网站上说要使用：
easy_install -U Sphinx
安装此命令时会发生什么情况？我也会得到源码吗？它将安装在哪里？
浏览 2提问于2011-02-07得票数 20
4回答
角6- i18n与ngx-平移
angular、angular-i18n
我正在使用Range6进行一个大型项目，这个项目需要大量的i18n集成。我正试图就如何进行作出正确的决定。
在我看来，我可以在以下两种方式之间做出选择：
ngx翻译()
角i18n ()
我倾向于选择选项2；角的i18n。这是因为它是角的内置包，这只是更好地与我坐在一起。显然，这也是更好的SEO和稍微更好的性能，没有任何工作周围。而且，现在它已经发布了，我认为ngx翻译可能会被废弃。这里有很多信息：。
然而，以下是我的保留意见：
显然角的版本是相当新的/仍在追赶()。这是不是太新了，不能接受？
显然，我必须为每种语言建立一个单独的网站()？我真的不认为那会是件好事。是那
浏览 1提问于2018-06-28得票数 35
回答已采纳
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
即时通信 IM
ICP备案
对象存储
实时音视频活动推荐
腾讯云开发者
