Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Is a django application that allows the translation of django templtes from the rendered html in the browser

Project Description

Introduction

Inlinetrans is a django application that allows the translation of django templates from the rendered html in the browser. Once you have your templates internationalized with inlinetrans, you can click on the untranslated messages in their corresponding web pages to add their translations. This can be of great help for translators, as they will be able to translate the messages right in their intended context.

Features

  • A templatetag, inline_trans (or itrans), intended as a replacement for django’s trans.
  • A management command, inline_makemessage, intended as a replacement for django’s makemessages.
  • A translation bar to show translatable messages, by default visible only to staff members (you can change this behavior with the variable USER_CAN_TRANSLATE, add it in the settings)

To translate the messages in a web page rendered in your browser, you first find out, through the translation bar, which messages have already been translated (marked light green) and which ones lack translation (marked light red).

Then, you click on a marked message, and are prompted for its translation; on entering the text and clicking OK, the new translation is sent to the server and saved in the correct .po file.

Once you have translated all messages in a page, you can click on “apply changes” on the translation bar. This forces a restart on the server, and the reloading of the page with the translations applied.

Requirements

To use inlinetrans, you need:

Demo (this video use a very old version of django-inlinetrans)

Video Demo, of django-inlinetrans, django-inplaceedit and django-inplaceedit-extra-fields (Set full screen mode to view it correctly)

Using inlinetrans

Make sure you load inlinetrans in all templates you want to internationalize, by adding the following code:

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

Then, you can use:

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

Or:

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

Instead of:

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

Also, you can customize the toolbar and other parameters using inlinetrans as follow:

{% 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 adds html code to each translation, so make sure you don’t use inline_trans tags inside html attributes, such as this:

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

In these cases you have to use the regular trans tag.

Once your template is internationalized, you run the following command:

>>> $ ./manage.py inline_makemessages

This extracts both inline_trans (itrans) and trans messages from the templates, and incorporates them to the gettext catalogs, just as makemessages does for trans messages.

Afterwords, you can start your server, navigate to the rendered pages (by default, as a staff member), and, as explained above, translate the messages through the web.

Contributors

  • Antonio Pérez-Aranda Alcaide, ant30
  • Emilio Sánchez, emilio.sanchez
  • Manuel Saelices, lin
  • Pablo Martín, goinnn

Change history

0.6.0 (2013-10-04)

  • Support to python2.6 (It was not supported with django-inlinetrans==0.5.X)
  • Improvements in the example project

0.5.1 (2013-09-13)

  • Improvements in metainfo (readme file, and contributors file)

0.5.0 (2013-09-13)

  • Django 1.5 (1.4, 1.3 and 1.2) compatible, before does not work because csrf token protection
  • Python 3 compatible
  • Use the statics file, django-inlinetrans used media files still
  • Remove polib frozen, now this is a dependence
  • Remove code of inline_makemessages, now fix the problem with monkey patching
  • Now we can customize with a setting that users can inline translate
  • Add example project
  • Add meta info

0.4.12 (2011-05-23)

  • Drop line break from inlinetrans template

0.4.11 (2011-05-17)

  • Do not try to log server restarts if the log file doesn’t exist
  • Fix double translation problem when template nodes are cached

0.4.10 (2011-04-18)

  • Django 1.3 compatibility

0.4.9 (2011-04-13)

  • Escape msgid so the DOM parser do not replace html entities. This fixes the translation of strings with entities like &copy;

0.4.8 (2011-04-13)

  • Send some data to avoid that a proxy/gateway/firewall blocks the POST request if it has no body.

0.4.7 (2011-03-22)

  • Set the locale path, needed if the django server has been launched from outside the project dir.

0.4.6 (2011-03-18)

  • Fixed translation when the label was found in two or more catalogs. The priority was not calculated well.

0.4.5 (2011-03-17)

  • Corrected command execution in some environments.

0.4.4 (2011-03-17)

  • Support for custom restart commands with parameters.

0.4.3 (2011-03-14)

  • Spanish translations.

0.4.2 (2011-03-09)

  • inline_makemessages command was not finding any itrans templatetag.

0.4.1 (2011-02-27)

  • Fixed a bug created in 0.4.0 for anonymous user.
  • Make customizable the media base directory used by inlinetrans.

0.4.0 (2011-02-24)

  • Make compatible with Django 1.2 and 1.3.
  • Allow using filters with the inline_trans tag.

0.3.2 (2011-02-22)

  • Allow to create/update po files when the msgid is not found in any catalog.

0.3.1 (2011-02-08)

  • Passed request to context because may be needed for external applications which customize templates.

0.3 (2011-02-07)

  • Refactored code to be more reusable and customizable from javascript. It’s now more like a jquery plugin.

0.2 (2011-01-28)

  • Created itrans templatetag, an alias for inline_trans.

0.1 (2010-12-21)

  • Adapting to use a egg using basic_package skel

Download

Release History

Release History

This version
History Node

0.6.0

History Node

0.5.1

History Node

0.5.0

History Node

0.4.12bdev-r70

History Node

0.4.12dev-r70

History Node

0.4.11dev-r68

History Node

0.4.10dev-r65

History Node

0.4.9dev-r63

History Node

0.4.8dev-r61

History Node

0.4.7dev-r59

History Node

0.4.6dev-r57

History Node

0.4.5dev-r55

History Node

0.4.4dev-r54

History Node

0.4.3dev-r52

History Node

0.4.2dev-r50

History Node

0.4.1dev-r48

History Node

0.4dev-r44

History Node

0.3.2dev-r41

History Node

0.3.2dev-r40

History Node

0.3.1dev-r38

History Node

0.3.1dev-r36

History Node

0.3dev-r35

History Node

0.3dev-r34

History Node

0.3dev-r33

History Node

0.2dev-r31

History Node

0.1dev-r30

History Node

0.1dev-r29

History Node

0.1dev-r28

History Node

0.1dev-r27

History Node

0.1dev-r26

History Node

0.1dev-r24

History Node

0.1dev

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-inlinetrans-0.6.0.tar.gz (19.1 kB) Copy SHA256 Checksum SHA256 Source Oct 4, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting