Django: vertimai - robotautas/kursas GitHub Wiki

Darome Django vertimus

Viso Django puslapio kalbą galime pakeisti labai paprastai, tiesiog settings.py faile:

LANGUAGE_CODE = 'lt'

Django automatiškai atvaizduoja visą administratoriaus puslapį lietuvių kalba. Tačiau taip neišverčiami mūsų sukurti laukai ir užrašai. Tai padarysime taip:

Darome vertimus mūsų puslapiuose

Iš pradžių į Windows įdiegiame reikiamas programas gettext ir iconv iš čia: https://mlocati.github.io/articles/gettext-iconv-windows.html

Padarykime vertimus puslapyje index.html:

{% extends "base.html" %}
{% load i18n %}
{% block "content" %}
  <h1>{% trans "Local library" %}</h1>
  <p>{% trans "Welcome to my Library" %}</p>
  <p>{% trans "Today we have:" %}</p>
  <ul>
    <li><strong>{% trans "Books" %}:</strong> {{ num_books }}</li>
    <li><strong>{% trans "Book Instances" %}:</strong> {{ num_instances }}</li>
    <li><strong>{% trans "Now Available" %}:</strong> {{ num_instances_available }}</li>
    <li><strong>{% trans "Authors" %}:</strong> {{ num_authors }}</li>
  </ul>

<p>{% trans "Your visits:" %} {{ num_visits }}</p>
{% endblock %}

Pakeičiame modulių laukų pavadinimus:

from django.utils.translation import gettext_lazy as _

class Book(models.Model):
    title = models.CharField(verbose_name=_("Title"), max_length=200)
    author = models.ForeignKey(to="Author", verbose_name=_("Author"), on_delete=models.SET_NULL, null=True, blank=True,
                               related_name="books")
    summary = models.TextField(verbose_name=_("Summary"), max_length=1000, help_text='Short Book Description')
    isbn = models.CharField(verbose_name=_('ISBN'), max_length=13)
    genre = models.ManyToManyField(to="Genre", verbose_name=_("Genres"))
    cover = models.ImageField(verbose_name=_("Cover"), upload_to="Covers", null=True, blank=True)

    def display_genre(self):
        return ", ".join(genre.name for genre in self.genre.all())

    display_genre.short_description = _("Genres")
    
    class Meta:
        verbose_name = _('Book')
        verbose_name_plural = _('Books')

    def __str__(self):
        return self.title)

Išverčiame pranešimų žinutes:

from django.utils.translation import gettext as _

@csrf_protect
def register(request):
    if request.method == "POST":
        # pasiimame reikšmes iš registracijos formos
        username = request.POST['username']
        email = request.POST['email']
        password = request.POST['password']
        password2 = request.POST['password2']
        # tikriname, ar sutampa slaptažodžiai
        if password == password2:
            # tikriname, ar neužimtas username
            if User.objects.filter(username=username).exists():
                messages.error(request, _('Username %s already exists!') % username)
                return redirect('register')
            else:
                # tikriname, ar nėra tokio pat email
                if User.objects.filter(email=email).exists():
                    messages.error(request, _('Email %s already exists!') % email)
                    return redirect('register')
                else:
                    # jeigu viskas tvarkoje, sukuriame naują vartotoją
                    User.objects.create_user(username=username, email=email, password=password)
        else:
            messages.error(request, _('Passwords do not match!'))
            return redirect('register')
    return render(request, 'register.html')

Tuose failuose, kuriuos django leidžia vieną kartą (models.py, forms.py) reikėtų importuoti gettext_lazy, tuose, kuriuos naudoja nuolat, pvz views.py, importuojame gettext. Dabar mūsų programoje (library) sukuriame katalogą "locale" ir konsolėje (būtinai iš library katalogo!) paleidžiame šią komandą:

django-admin makemessages -l lt

Django automatiškai sukurs vertimų failą .po, kurį galime atsidaryti su POEdit programa, pasidaryti vertimus ir juos išsaugoti .mo faile (ten pat). Pabandykime perjungti kalbas ir pažiūrėti, ar pasikeičia kalbos išverstame puslapyje, taip pat išversto modelio admin puslapyje.

Sukompiliuojame vertimus, kad Django galėtų juos naudoti:

python manage.py compilemessages

Taip pat galima išversti visą html kodo bloką, įdėjus {% blocktrans %} ir {% endblocktrans %}, pvz.:

<h1>
  <a href="/" title="{% blocktrans %}Back to '{{ race }}' homepage{% endblocktrans %}">{{ race }}</a>
</h1>

Automatiškai parenkame kalbą pagal naršyklę

Jei norime, kad kalba būtų automatiškai parenkama pagal naršyklėje nustatytą kalbą, į settings.py pridedame 'django.middleware.locale.LocaleMiddleware':

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.locale.LocaleMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

Dedame kalbos pasirinkimo formą

Galime į puslapį įdėti kalbos pasirinkimo formą. Tam:

Į settings.py dedame:

from django.utils.translation import gettext_lazy as _

LANGUAGES = (
    ('en-us', _('English')),
    ('lt', _('Lithuanian')),
)

Į mysite/urls.py pridedame:

    path('i18n/', include('django.conf.urls.i18n')),

Ten, kur norime turėti kalbos pasirinkimo formą, dedame šį kodą (pvz. į base.html meniu):

<li class="nav-item">
    {% load i18n %}
    <form action="{% url 'set_language' %}" method="post" class="d-flex">
        {% csrf_token %}
        <input name="next" type="hidden" value="{{ redirect_to }}"/>
        <select name="language" class="form-control me-2" onchange="this.form.submit()">
            {% load static %}
            {% get_current_language as LANGUAGE_CODE %}
            {% get_available_languages as LANGUAGES %}
            {% for lang in LANGUAGES %}
            <option value="{{ lang.0 }}"
                    {% if lang.0 == LANGUAGE_CODE %}selected="selected" {% endif %}>
                {{ lang.1 }}
            </option>
            {% endfor %}
        </select>
    </form>
</li>

Alternatyva:

{% load i18n %}
      <form action="{% url 'set_language' %}" method="post">
        {% csrf_token %}
        <input name="next" type="hidden" value="{{ redirect_to }}"/>
        <select name="language">
          {% get_current_language as LANGUAGE_CODE %}
          {% get_available_languages as LANGUAGES %}
          {% for lang in LANGUAGES %}
          <option value="{{ lang.0 }}" {% if lang.0 == LANGUAGE_CODE %} selected="selected" {% endif %}>
            {{ lang.1 }} ({{ lang.0 }})
          </option>
          {% endfor %}
        </select>
        <input type="submit" value="Go"/>
      </form>

Užduotis

Tęsti kurti Django užduotį – Autoservisas:

  • Visus užrašus, kintamuosius (kiek įmanoma) aprašyti anglų kalba.
  • Padaryti vertimus, kad perjungus iš anglų kalbos į lietuvių, automatiškai išsiverstų visi užrašai.
  • Padaryti mygtukus (arba pasirinkimą), kuris leistų pasirinkti puslapio kalbą.

Atsakymas

© Donatas Noreika ir Jotautas Treigys

⚠️ **GitHub.com Fallback** ⚠️