django-admin makemessages：它是如何处理 txt、xml 和其他文件的？

Question

我正在翻译 Django 应用程序。我在具有特定扩展名的文件（.vue 文件，但目前这不是很重要）中有可翻译的字符串。

我必须运行makemessages命令来解析这些字符串并生成 .po 文件。

文档说：

makemessages：遍历当前目录的整个源代码树并提取所有标记为翻译的字符串。

此外，文档指出默认文件扩展名是：html, txt, py并给出了一个明确定义扩展名的例子：

django-admin makemessages --locale=de --extension=html,txt --extension xml

我的问题是：makemessages应该如何处理像txt和这样的非编译文件xml？我如何在这样的文件中标记要翻译的字符串？

我知道如何在模板或 .py 文件中执行此操作：

.html

{% trans "Text to be translated" %}

.py

gettext("Text to be translated")

# or

_("Text to be translated")

但是其他扩展呢？.txt，.xml？...最终.vue？

Answer 1

该makemessages命令搜索要翻译的文件并调用(x)gettext实用程序来提取标记为翻译的字符串。根据您是否告诉它使用django或 ，它的行为会有所不同djangojs --domain。使用django域时，它运行非.py文件django.utils.translation.templatize以“将 Django 模板转换为可理解的内容xgettext”）。它基本上将整个文件XXXXX与词法分析器确定的相关部分分开gettext，从而保持行号完整等。>>> from django.utils.translation import templatize>>> content = """This is a {% trans "test" %}!... {# Translators: these comments remain intact for translators #}... {% blocktrans %}Only applies to --domain=django and non-.py files {% endblocktrans %}...&nbsp;... Everything else is {# ignored #}... {% trans "EOM" %}... :)""">>> print(templatize(content))XXXX XX X&nbsp; gettext(u'test') X# Translators: these comments remain intact for translators&nbsp;gettext(u'Only applies to --domain=django and non-.py files ') SSSS SSSSSSS SS SSSSSSSSSSSSSSS SSS SSSSSSS SSSSS&nbsp;XXXXXXXXXX XXXX XX&nbsp;&nbsp;gettext(u'EOM')&nbsp;XX>>>&nbsp;因此，对于大多数非 Python、非 Django 模板文件，这将消除您的可翻译内容。使用djangojs域时，Django 不会对文件执行任何此类预处理。（对于gettext比 更早的版本0.18.3，makemessages会调用django.utils.jslex.prepare_js_for_gettext，这有点不那么激进，并且在必要时只调整任何转义/正则表达式语法）。如果你运行makemessages -a -d djangojs -e "js,vue"，Django会告诉xgettext解析您.js和.vue处理文件--language=JavaScript和额外一定数量的--keyword配置来支持gettext_noop，gettext_lazy等（gettext默认为一keywordspec的_, gettext, dgettext:2, dcgettext:2, ngettext:1,2, dngettext:2,3, pgettext:1c,2, dpgettext:2c,3对JavaScript）。makemessages也会通过--from-code=UTF-8和--add-comments=Translators论据。然后gettext根据这些规范进行解析，并根据--language指定的文件对文件进行自己的理解。因此，翻译.txt、.xml等文件的最佳选择makemessages是使用djangojs域并查看gettext基于 的内容--language=JavaScript，因此您可以像对 JavaScript 一样标记字符串。或者对于 Jinja2 模板等，您可以使用替代解决方案，例如Babel's Message Extraction或者您甚至可以自定义makemessages以gettext根据您的要求传递不同的参数。所以对于你的 Vue 例子......如果你的.vue文件中包含的调用gettextJavaScript代码段（默认解析似乎没有拿起gettext模板属性中调用等），你会发现，makemessages将提取这些字符串翻译（和compilemessages将生成后所需的二进制文件.po文件编辑）。然后，为了在代码运行时查看翻译，您需要使用Django JavaScript Catalog，因此请确保<script type="text/javascript" src="{% url 'javascript-catalog' %}"></script>在代码中包含类似的内容，以便gettextetc 函数实际存在。（听起来您已经有了这个，但为了完整起见，将其包括在内。）在您的.vue文件中，您可以使用以下内容：<script> // trick to ensure xgettext doesn't omit the code below: </closetag>&nbsp;&nbsp; &nbsp; data(){&nbsp; &nbsp; &nbsp; &nbsp; const _ = gettext;&nbsp; &nbsp; &nbsp; &nbsp; // gettext default JavaScript keywordspec includes "_" shortcut&nbsp; &nbsp; &nbsp; &nbsp; // and should extract the strings below by default&nbsp; &nbsp; &nbsp; &nbsp; // -- or you could just use gettext('my string') directly&nbsp; &nbsp; &nbsp; &nbsp; return {&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; heading: _('This is my translatable heading'),&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; button_text: _('Click here'),&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;&nbsp; &nbsp; &nbsp; &nbsp; }&nbsp; &nbsp; }</script><template>&nbsp; &nbsp; <h1>{{ heading }}</h1>&nbsp; &nbsp; <button type="button">{{ button_text }}</button></template>-- 应根据 Django 翻译机制当前激活的语言礼貌来翻译字符串。

Answer 2

如果您希望这些文件的任何内容是动态的，那么您需要对它们进行某种解析过程。绝对没有理由不能将它们视为 Django 模板并通过正常的 Django 模板渲染过程来渲染它们；显然，在不知道您对这些文件做了什么的情况下，不可能给您具体的建议，但您可能想要使用render_to_string.&nbsp;就其本身而言，这与翻译或生成消息没有任何关系。