A Django management command to automatically find and translate strings in HTML templates.
Project description
Django Bub Translate 🚀
ترجمه خودکار قالبهای جنگو با هوش مصنوعی
این کتابخانه به شما کمک میکند تا فرآیند چندزبانه کردن پروژههای جنگو را خودکار کنید.
ویژگیها
- اسکن خودکار فایلهای HTML و اضافه کردن تگهای
{% trans %}. - ترجمه خودکار فایلهای
.poبا استفاده از Google Translate. - مدیریت هوشمند تگهای جینجا و جلوگیری از ترجمه کدهای برنامهنویسی.
نصب
pip install django-autotranslate-ai
سپس django_autotranslate را به INSTALLED_APPS در فایل settings.py اضافه کنید:
INSTALLED_APPS = [
...
'django_autotranslate',
]
نحوه استفاده
۱. آمادهسازی تنظیمات پروژه (Settings)
برای پیکربندی خودکار settings.py و افزودن زبانهای مورد نظر:
python manage.py setup_i18n --langs fa ar
این دستور کارهای زیر را انجام میدهد:
- فعالسازی
USE_I18N = True. - افزودن
LocaleMiddlewareبه لیست میانافزارها. - تعریف
LANGUAGESوLOCALE_PATHS. - ایجاد پوشه
localeدر ریشه پروژه.
۲. آمادهسازی تگها
برای اضافه کردن تگهای ترجمه به تمام فایلهای HTML در پوشه قالبها:
python manage.py prepare_tags templates/
۳. ترجمه خودکار
برای استخراج پیامها و ترجمه آنها به زبان مورد نظر (مثلاً فارسی):
python manage.py auto_translate --lang fa
۴. مدیریت با رابط گرافیکی (GUI)
برای مشاهده، جستجو و ویرایش دستی ترجمهها در یک محیط گرافیکی:
python manage.py translate_gui --lang fa
این دستور یک پنجره باز میکند که در آن میتوانید:
- تمامی عبارات استخراج شده را ببینید.
- در میان متون اصلی و ترجمهها جستجو کنید.
- ترجمهها را به صورت دستی ویرایش و ذخیره کنید.
- فایل
.moرا به صورت خودکار کامپایل کنید.
۵. تنظیمات موتورهای ترجمه (اختیاری)
به طور پیشفرض از Google Translate (رایگان) استفاده میشود. برای استفاده از سایر سرویسها، تنظیمات زیر را به settings.py اضافه کنید:
# برای DeepL
AUTOTRANSLATE_ENGINE = 'deepl'
AUTOTRANSLATE_API_KEY = 'your-deepl-api-key'
# برای Microsoft Azure
AUTOTRANSLATE_ENGINE = 'microsoft'
AUTOTRANSLATE_API_KEY = 'your-azure-key'
AUTOTRANSLATE_REGION = 'global' # اختیاری
پیشنیازها
- Python 3.7+
- Django 3.0+
- BeautifulSoup4
- googletrans (نسخه alpha برای پایداری بیشتر)
- polib (برای مدیریت فایلهای ترجمه به صورت خالص در پایتون)
- requests (در صورت استفاده از DeepL یا Microsoft)
نکته: این کتابخانه هیچ وابستگی به gettext ندارد و تمامی مراحل استخراج، ترجمه و کامپایل را به صورت داخلی انجام میدهد. این یعنی روی ویندوز، لینوکس و مک بدون نصب هیچ ابزار اضافهای کار میکند.
لایسنس
MIT
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_bub_translate_mahdi-0.1.0.tar.gz.
File metadata
- Download URL: django_bub_translate_mahdi-0.1.0.tar.gz
- Upload date:
- Size: 13.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ee6e6ba11c5597f93b68af308a4a5d2e691978dcce44a10d334b6bf08974cc0a
|
|
| MD5 |
30a02812706ccc3578fd7ddec73e7da3
|
|
| BLAKE2b-256 |
41d289d6467c33a250befb4d0e30baf3668ffe1fc5ded7826e6c1c3eeda2adf3
|
File details
Details for the file django_bub_translate_mahdi-0.1.0-py3-none-any.whl.
File metadata
- Download URL: django_bub_translate_mahdi-0.1.0-py3-none-any.whl
- Upload date:
- Size: 14.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
98754008305fc75f602fe0569ad78a8ae7f4b2d56e063d8225837a0c31b4d56e
|
|
| MD5 |
ecb7746e2d0ed61e5afd47109a726152
|
|
| BLAKE2b-256 |
42c50740ec112e9888a57acd7406ee84b9dce7e75e53eed1aebc28a9fcfd5108
|
