🤴 📥 🍐 Django: अंतर्राष्ट्रीयकरण के लिए एक त्वरित गाइड 🆚 🏪 🧘🏻

विभिन्न भाषाओं में किसी एप्लिकेशन का अनुवाद और उसका स्थानीयकरण कुछ ऐसा है जिससे सभी डेवलपर्स को निपटना पड़ता है। सामग्री, जिसका अनुवाद आज हम प्रकाशित करते हैं, Django अनुप्रयोगों के अंतर्राष्ट्रीयकरण पर एक संक्षिप्त गाइड प्रदान करता है।

यहाँ चर्चा की गई किसी भी बात का हिस्सा किसी भी पायथन परियोजनाओं के स्थानीयकरण पर लागू होगा। बुनियादी बातों की जांच करने के बाद, हम अंतर्राष्ट्रीयकरण के प्रयासों में तेजी लाने के बारे में बात करेंगे। विशेष रूप से, वाक्यांश मंच के उपयोग पर । यह माना जाता है कि इस सामग्री के पाठक के पास एक कामकाजी Django एप्लिकेशन है, और उसके पास एक पैकेज स्थापित है (आप इसे स्थापित कर सकते हैं, उदाहरण के लिए, एक कमांड के साथ )। यदि आपने पहले Django (लोकप्रिय पायथन-आधारित वेब फ्रेमवर्क) का उपयोग नहीं किया है, तो आपके लिए इस पर पहले नज़र डालना उपयोगी हो सकता है।

gettextpip install gettextआधिकारिक गाइड , और फिर इस लेख पर लौटें।

बुनियादी काम पर्यावरण सेटिंग्स

तो, मान लीजिए कि आपके पास एक Django परियोजना है mysite, और एक एप्लिकेशन है जिसे कहा जाता है polls। परियोजना की संरचना कुछ इस तरह दिखनी चाहिए:

/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        wsgi.py
    polls/
        migrations/
        __init__.py
        admin.py
        models.py
        tests.py
        views.py

हमारे काम का पहला चरण यह जांचना है कि परियोजना कॉन्फ़िगरेशन में अंतर्राष्ट्रीयकरण विकल्प सक्रिय है या नहीं। ऐसा करने के लिए, आपको निम्नलिखित परिवर्तन करने होंगे mysite/settings.py:

# mysite/settings.py
LANGUAGE_CODE = 'en-us'
TIME_ZONE = 'UTC'
USE_I18N = True
USE_L10N = True
USE_TZ = True

टेम्पलेट्स का अंतर्राष्ट्रीयकरण

अब आपको उन सभी पंक्तियों को चिह्नित करने की आवश्यकता है जिन्हें विभिन्न भाषाओं में अनुवादित किया जाना चाहिए। मान लें कि आपके पास निम्न टेम्प्लेट फ़ाइल है polls/templates/polls/index.html:

<!-- polls/templates/polls/index.html -->
<h1>Welcome to our site!</h1>
<p>Here you find polls.</p>

इस फ़ाइल को निम्नानुसार संसाधित करने की आवश्यकता है:

<!-- polls/templates/polls/index.html -->
{% load i18n %}
<h1>{% trans 'WelcomeHeading' %}</h1>
<p>{% trans 'WelcomeMessage' %}</p>

यहां हमने स्थानीयकरण के लिए एक पैकेज आयात किया और सभी पाठों को दृश्य निर्माणों से बदल दिया trans 'SomeTranslationKeyName'। इसके अलावा, इस दृष्टिकोण के विकल्प के रूप में, आप अनुवाद कुंजी के रूप में डिफ़ॉल्ट अनुवाद ग्रंथों का उपयोग कर सकते हैं। इस दृष्टिकोण के साथ, आपके पास हमेशा एक अच्छा डिफ़ॉल्ट पाठ होगा यदि कोई निश्चित कुंजी के लिए कोई अनुवाद उपलब्ध नहीं है।

पायथन कोड में अंतर्राष्ट्रीयकरण

यदि आप पायथन कोड के अंदर तार को स्थानीय करना चाहते हैं (उदाहरण के लिए, फ़ाइल में polls/views.py), तो आपको फ़ंक्शन को फ़ाइल में आयात करना होगा ugettext। उसके लिए, जो काफी सामान्य है, आप एक उपनाम दे सकते हैं _। यहाँ एक फ़ाइल से एक साधारण फ़ंक्शन का स्थानीयकृत संस्करण कैसा दिखेगा views.py:

# polls/views.py
from django.http import HttpResponse
from django.utils.translation import ugettext as _
def index(request):
    output = _('StatusMsg')
    return HttpResponse(output)

अनुवाद फ़ाइलें बनाना

अब हमें प्रत्येक भाषा सेटिंग के लिए अनुवाद फाइल बनाने की आवश्यकता है जिसे हम समर्थन करना चाहते हैं। ऐसा करने के लिए, एक निर्देशिका बनाएं polls/localeऔर निर्देशिका pollsमें निम्नलिखित कमांड निष्पादित करें:

django-admin makemessage -l de

यहां deआप उस भाषा के लिए लोकेल कोड को बदल सकते हैं जिसे आप एप्लिकेशन में जोड़ना चाहते हैं। हमारे उदाहरण में, इस कमांड के निष्पादन से निम्नलिखित सामग्री के gettextसाथ -फाइल का निर्माण होगा polls/locale/de/LC_MESSAGES/django.po:

# polls/locale/de/LC_MESSAGES/django.po
...
#: templates/polls/index.html:3
msgid "WelcomeHeading"
msgstr ""
#: templates/polls/index.html:4
msgid "WelcomeMessage"
msgstr ""

अब आप इस फाइल में लाइन फीड दर्ज कर सकते हैं:

# polls/locale/de/LC_MESSAGES/django.po
...
#: templates/polls/index.html:3
msgid "WelcomeHeading"
msgstr "Willkommen auf unserer Seite!"
#: templates/polls/index.html:4
msgid "WelcomeMessage"
msgstr "Hier findet Ihr Umfragen."

जब अनुवाद तैयार हो जाता है, तो आपको निम्नलिखित कमांड चलाकर सब कुछ संकलित करना होगा:

$ django-admin compilemessages

इस कमांड को फिर से डायरेक्टरी में चलाएं polls।

अनुवाद की संचालनशीलता को जल्दी से जांचने के लिए, आपको फ़ाइल में भाषा कोड को बदलना होगा mysite/settings.py। उदाहरण के लिए, इस तरह:

# mysite/settings.py
LANGUAGE_CODE = 'de'

यदि आप अब किसी ब्राउज़र में एप्लिकेशन खोलते हैं, तो इसका जर्मन में अनुवाद किया जाना चाहिए।

वाक्यांश का उपयोग करके अनुप्रयोग स्थानीयकरण को गति दें

यदि आप स्थानीय अनुप्रयोगों पर काम को व्यवस्थित करने के लिए वाक्यांश का उपयोग करते हैं, तो आपको वास्तव में * .po फ़ाइलों को मैन्युअल रूप से बनाने और संपादित करने की आवश्यकता नहीं है! आपको बस कुंजियाँ WelcomeHeadingऔर WelcomeMessageवाक्यांश बनाने और स्थानांतरित करने की आवश्यकता है और * .po-files को डाउनलोड करने के लिए निर्यात फ़ंक्शन का उपयोग करें।

यदि आपके पास हमारी कमांड लाइन टूल स्थापित है Phrase Client, तो आपका काम और भी सरल हो जाता है। यह .phraseapp.ymlनिम्नलिखित सामग्री के साथ परियोजना की मूल निर्देशिका में एक विन्यास फाइल बनाने के लिए पर्याप्त है :

# .phraseapp.yml
phraseapp:
  access_token: <your access token>
  project_id: <your project's id on PhraseApp>
  file_format: po
  pull:
    targets:
        file: "polls/locale/<locale_code>/LC_MESSAGES/django.po

फिर आपको प्रोजेक्ट के रूट डायरेक्टरी में निम्नलिखित कमांड चलाने की जरूरत है:

phraseapp pull && django-admin compilemessages

इसके लिए धन्यवाद, परियोजना के सभी अनुवाद अपडेट किए जाएंगे।

इसके अलावा, आपके Django प्रोजेक्ट में हमारे इन-कॉनटेक्स्ट एडिटर का उपयोग कार्य को और सरल बना सकता है । ऐसा करने के लिए, बस django-phraseका उपयोग कर स्थापित करें pip:

pip install django-phrase

फिर जब आप उपयोग करने की योजना बना रहे हैं, तब केवल टेम्प्लेट संपादित करें In-Context-Editor:

<!-- polls/templates/polls/index.html -->
{% load i18n %}
{% load phrase_i18n %}
{% phrase_javascript %}
<h1>{% trans 'WelcomeHeading' %}</h1>
<p>{% trans 'WelcomeMessage' %}</p>

कृपया ध्यान दें कि लोडिंग के phrase_i18nबाद किया जाना चाहिए i18n।

अंत में, कॉन्फ़िगरेशन फ़ाइल में निम्न जोड़ें:

# mysite/settings.py
PHRASE_ENABLED = True
PHRASE_PROJECT_ID = 'YOUR_PROJECT_ID'
PHRASE_PREFIX = '{{__'
PHRASE_SUFFIX = '__}}'

उसके बाद, सब कुछ जाने के लिए तैयार हो जाएगा।

स्थान चयन

आमतौर पर, एप्लिकेशन डेवलपर्स उपयोगकर्ता की ब्राउज़र सेटिंग्स के आधार पर स्थान निर्धारित करते हैं। ऐसा करने के लिए, आपको फ़ाइल mysite/settings.pyको निम्नलिखित फ़ॉर्म में लाना होगा :

# mysite/settings.py
from django.utils.translation import ugettext_lazy as _
...
MIDDLEWARE_CLASSES = (
    ...,
    'django.middleware.locale.LocaleMiddleware',
    ...,
)
...
LANGUAGE_CODE = 'en-us'
LANGUAGES = (
    ('en-us', _('English')),
    ('de', _('German')),
)

इस दृष्टिकोण के साथ, यदि उपयोगकर्ता के पास एक स्थान है German, तो उसे एक अनुवाद विकल्प दिखाई देगा de। अन्यथा, डिफ़ॉल्ट अनुवाद का उपयोग किया जाएगा en-us। आप इस तंत्र के सही संचालन को सत्यापित कर सकते हैं curl:

curl http://localhost:8000/polls -H "Accept-Language: de"

इस कमांड को कुछ इस तरह से लौटना चाहिए:

<h1>Willkommen auf unserer Seite!</h1>
<p>Hier findet Ihr Umfragen.</p>

सारांश

इस लेख में, हमने Django अनुप्रयोगों के अंतर्राष्ट्रीयकरण की मूल बातों की जांच की। यहां हमने वाक्यांश सेवा के बारे में बात की, जो काम को गति देने और सरल बनाने में सक्षम है। हम आशा करते हैं कि आपने जो सीखा है वह आपके लिए उपयोगी है।

प्रिय पाठकों! आप अपने पायथन प्रोजेक्ट्स के अंतर्राष्ट्रीयकरण के बारे में क्या सोचते हैं?

Django: अंतर्राष्ट्रीयकरण के लिए एक त्वरित गाइड