django-inlinetrans 0.6.0

简介

Inlinetrans是一个django应用程序，允许从浏览器渲染的HTML中翻译django模板。一旦您使用inlinetrans将模板国际化，您就可以单击相应网页中的未翻译消息来添加它们的翻译。这对翻译人员来说非常有帮助，因为他们将能够在他们希望的环境中直接翻译这些消息。

特性

• 一个模板标签，inline_trans（或itrans），旨在替代django的trans。

• 一个管理命令，inline_makemessage，旨在替代django的makemessages。

• 一个显示可翻译消息的翻译栏，默认情况下仅对员工成员可见（您可以通过变量USER_CAN_TRANSLATE更改此行为，在设置中添加它）

要在浏览器中渲染的网页中翻译消息，您首先通过翻译栏找出哪些消息已经被翻译（标记为浅绿色）以及哪些消息缺少翻译（标记为浅红色）。

然后，您点击一个标记的消息，并提示其翻译；输入文本并点击“确定”后，新的翻译将发送到服务器并保存在正确的.pot文件中。

一旦您翻译了页面中的所有消息，您可以在翻译栏上点击“应用更改”。这将强制服务器重启，并重新加载应用了翻译的页面。

要求

要使用inlinetrans，您需要

• Django >= 1.0

• jQuery >= 1.2.6

演示（此视频使用非常旧的django-inlinetrans版本）

视频演示，django-inlinetrans，django-inplaceedit和django-inplaceedit-extra-fields（设置为全屏模式以正确查看）

使用inlinetrans

请确保您在所有要国际化的模板中加载inlinetrans，通过添加以下代码

>>>
{% load inlinetrans %}
{% inlinetrans_static %}
<div id="inlinetrans-toolbar">place holder for inlinetrans toolbar</div>
{% inlinetrans_toolbar "inlinetrans-toolbar" %}

然后，您可以使用

>>> {% inline_trans "translate this" %}

或者

>>> {% itrans "translate this" %}

而不是

>>> {% trans "translate this" %}

此外，您还可以使用以下方式自定义工具栏和其他参数

{% load i18n inlinetrans %}

{% inlinetrans_media %}

<script language="javascript">
    (function ($) {
        $(document).ready(function () {
            var messages_dict = {
                givetranslationfor: 'Give a new translation for {0} to {{ language }}',
                emptytranslation: "You're sending an empty translation ¿Are you sure? ",
                reloading: "Reloading",
                apply_changes: "Apply changes",
                applying_changes: "Applying changes",
                error_cant_send: "Can't send translation",
                error_cant_restart: "Can't restart server"
            };
            var new_translation_url = "{% url inlinetrans.views.set_new_translation %}";
            var restart_url = "{% url inlinetrans.views.do_restart %}";

            var toolbar_tpl = '\
                <div class="inlinetransContainer">\
                    <img id="changes-loading" src="{{ INLINETRANS_MEDIA_URL }}img/ajax-loader-transparent.gif"/>\
                    <span class="inlinetransActions">\
                        <span class="inlinetransAction hightlightTrans">See translatable items</span>\
                        <span class="inlinetransAction hightlightNotrans">See non translated items</span>\
                        <span class="inlinetransAction restartServer">Apply changes</span>\
                    </span>\
                </div>';
            // init inlinetrans toolbar
            $('#{{ node_id }}').inlinetranstoolbar(toolbar_tpl, new_translation_url, restart_url, messages_dict);
        });
    })(jQuery);
</script>

Inlinetrans为每个翻译添加HTML代码，因此请确保您不要在HTML属性中使用inline_trans标签，例如这样

>>> <a href="#" alt="{% inline_trans "translate this" %}"></a>

在这些情况下，您必须使用常规的trans标签。

一旦您的模板实现了国际化，您运行以下命令

>>> $ ./manage.py inline_makemessages

这将从模板中提取所有inline_trans（itrans）和trans消息，并将它们合并到gettext目录中，就像makemessages为trans消息所做的那样。

之后，您可以启动服务器，导航到渲染的页面（默认情况下，作为员工成员），然后，如上所述，通过网页翻译消息。