ما الذي يفعله Weblate
Weblate منصة ترجمة مستمرة: بدل تصدير الملفات يدويًا، تعطيه عنوان مستودع Git الخاص بتطبيقك. فيقرأ ملفات اللغات — gettext PO وJSON (i18next وvue-i18n) وXLIFF وYAML وAndroid وiOS وARB وخصائص Java — ويعرض كل سلسلة على المترجمين في محرر ويب. وتعود الترجمات المعتمدة إلى المستودع على شكل commits، أو pull requests إن فضّلت المراجعة.
المشروع منشور برخصة GPL-3.0. وتعتمد صورة Docker الرسمية على PostgreSQL وعلى Valkey (أو Redis) للتخزين المؤقت وطابور المهام. على الخادم، توقّع نحو 1.7 غيغابايت من الذاكرة في وضع الخمول مع عمليتي عمل.
ما الذي يقدمه لك Weblate
- مصدر حقيقة واحد: Git — يضيف المطورون السلاسل في الشيفرة، وتعود الترجمات إلى المستودع نفسه.
- فحوص الجودة — متغيرات ناقصة، وسوم مكسورة، مسافات وعلامات ترقيم، صيغ جمع غير مكتملة.
- العربية دون حلول ترقيعية — تحرير من اليمين إلى اليسار وست صيغ للجمع.
- مراجعة صريحة — يمكن وسم كل سلسلة بأنها تحتاج تعديلًا أو مترجمة أو معتمدة.
- ذاكرة ترجمة ومسرد — مصطلحات منتجك تُترجم دائمًا بالطريقة نفسها.
- اقتراحات آلية — من نسخة LibreTranslate الخاصة بك أو من خدمة ترجمة أخرى.
منصة مستضافة أم Weblate على خادمك
مرّر الجدول أفقيًا
| منصة مستضافة (Crowdin وLokalise…) | Weblate على خادمك | |
|---|---|---|
| أين تعيش السلاسل | خوادم المزوّد | خادمك |
| الربط بالشيفرة | تكامل مع Git | تكامل مع Git |
| حسابات المترجمين | حسب الاشتراك | بقدر ما تريد |
| النصوص غير المنشورة | لدى طرف ثالث | عندك |
| رخصة الخادم | خدمة احتكارية | GPL-3.0 |
المتطلبات
خادم VPS بنظام Ubuntu 24.04 بذاكرة 4 غيغابايت ومعالجين افتراضيين. تحتاج إلى Docker مع إضافة Compose، وnginx وcertbot على المضيف، واسم (weblate.example.com في هذا الدليل) يشير إلى عنوان IP الخاص بالخادم. وجهّز أيضًا حساب SMTP يستمع على المنفذ 587 مع TLS: يرسل Weblate الدعوات وإعادة تعيين كلمات المرور بالبريد.
تثبيت Weblate باستخدام Docker Compose
تجهيز المجلد وملف .env
يستخدم Docker Compose وحاوية Weblate الملف نفسه. يغلق
WEBLATE_REGISTRATION_OPEN=0التسجيل، ويفرضWEBLATE_REQUIRE_LOGIN=1تسجيل الدخول لقراءة أي شيء. استبدل أسطر SMTP الثلاثة بأسطر مزوّدك.mkdir -p /opt/weblate && cd /opt/weblate cat > .env <<EOF WEBLATE_SITE_DOMAIN=weblate.example.com WEBLATE_ENABLE_HTTPS=1 WEBLATE_SECURE_PROXY_SSL_HEADER=HTTP_X_FORWARDED_PROTO,https WEBLATE_IP_PROXY_HEADER=HTTP_X_FORWARDED_FOR [email protected] WEBLATE_ADMIN_PASSWORD=$(openssl rand -hex 16) WEBLATE_REGISTRATION_OPEN=0 WEBLATE_REQUIRE_LOGIN=1 [email protected] [email protected] WEBLATE_EMAIL_HOST=smtp.example.com [email protected] WEBLATE_EMAIL_HOST_PASSWORD=<SMTP_PASSWORD> POSTGRES_HOST=database POSTGRES_DB=weblate POSTGRES_USER=weblate POSTGRES_PASSWORD=$(openssl rand -hex 16) REDIS_HOST=cache REDIS_PASSWORD=$(openssl rand -hex 16) EOF chmod 600 .envكتابة ملف docker-compose.yml
ثلاث خدمات: PostgreSQL، وValkey محمي بكلمة مرور، وWeblate. المنفذ منشور على الواجهة المحلية فقط: وحده nginx سيكون معرّضًا للإنترنت.
services: database: image: postgres:18.7-alpine restart: unless-stopped environment: POSTGRES_DB: weblate POSTGRES_USER: weblate POSTGRES_PASSWORD: "${POSTGRES_PASSWORD}" volumes: - weblate-db:/var/lib/postgresql cache: image: valkey/valkey:9.1.3 restart: unless-stopped command: ["valkey-server", "--save", "60", "1", "--requirepass", "${REDIS_PASSWORD}"] volumes: - weblate-redis:/data weblate: image: weblate/weblate:2026.11.2.0 restart: unless-stopped depends_on: [database, cache] env_file: .env ports: - "127.0.0.1:8080:8080" volumes: - weblate-data:/app/data - weblate-cache:/app/cache tmpfs: [/run, /tmp] volumes: weblate-db: {} weblate-redis: {} weblate-data: {} weblate-cache: {}التشغيل والتحقق
ينشئ التشغيل الأول القاعدة وحساب
admin، ويستغرق ذلك دقيقة إلى دقيقتين. يجب أن تجيب نقطة الصحة بـ200، ويعرض الأمر الأخير كلمة مرور المسؤول:docker compose up -d docker compose ps curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/healthz/ grep WEBLATE_ADMIN_PASSWORD .env
لا تنشر نسخة مفتوحة
مع WEBLATE_REGISTRATION_OPEN=1 يستطيع أي شخص إنشاء حساب على نسختك، وبدون WEBLATE_REQUIRE_LOGIN=1 تُقرأ المشاريع العامة دون حساب — بما في ذلك سلاسل ميزة لم يُعلن عنها بعد. احتفظ بالإعدادين الواردين في هذا الدليل واترك المنفذ على 127.0.0.1.
نشر Weblate عبر HTTPS باستخدام nginx
أنشئ /etc/nginx/sites-available/weblate بكتلة الخادم هذه، ثم فعّلها برابط رمزي في sites-enabled. الترويسة X-Forwarded-Proto ضرورية: فهي التي تخبر Weblate أن الطلب وصل عبر HTTPS.
server {
listen 80;
server_name weblate.example.com;
client_max_body_size 100m;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}تحقق من الإعداد، وأعد تحميل nginx، واطلب الشهادة؛ يضيف certbot بنفسه كتلة HTTPS والتحويل من HTTP.
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d weblate.example.comثم افتح https://weblate.example.com/accounts/login/ وسجّل الدخول باسم المستخدم admin.
ترجمة أول مستودع Git
أنشئ مشروعًا ثم مكوّنًا. أدخل عنوان المستودع والفرع وقناع ملفات اللغات — مثلًا locales/*.json لـ vue-i18n أو locale/*/LC_MESSAGES/django.po لـ Django. يستنسخ Weblate المستودع، ويكتشف اللغات الموجودة، ويقترح إضافة غيرها.
ولكي يعيد الترجمات، افتح الإدارة › مفاتيح SSH، وولّد مفتاح النسخة وأضفه كمفتاح نشر بصلاحية الكتابة على المستودع، ثم اضبط عنوان الدفع للمكوّن عبر SSH. يجمع Weblate التعديلات ويدفعها على شكل commits. ولكي يتحدّث فور دفع أحد المطورين للشيفرة، صرّح بـ webhook نحو https://weblate.example.com/hooks/github/ (وتوجد أيضًا /hooks/gitlab/ و/hooks/gitea/).
ويمكن التحكم في كل شيء أيضًا عبر واجهة REST، بالرمز المعروض في ملفك الشخصي:
curl -s https://weblate.example.com/api/projects/ \
-H "Authorization: Token <API_TOKEN>"ربط LibreTranslate للاقتراحات
يقدّم Weblate اقتراحات آلية تحت كل سلسلة. إذا كانت لديك نسخة LibreTranslate خاصة، افتح الإدارة › خدمات الترجمة، وأضف خدمة LibreTranslate بعنوان نسختك ومفتاح واجهتها البرمجية. يرى المترجمون حينها اقتراحًا بالعربية أو الفرنسية أو الإنجليزية أو الإسبانية، يصححونه قبل اعتماده: لا يغادر النص خوادمك. ويوجد الإعداد نفسه على مستوى المشروع إن أردت حصره في بعض المشاريع.
النسخ الاحتياطي والتحديث
شيئان يجب نسخهما احتياطيًا: قاعدة PostgreSQL والحجم weblate-data، الذي يحوي المفتاح السري للنسخة ومفاتيح SSH ونسخ المستودعات.
cd /opt/weblate
docker compose exec -T database pg_dump -U weblate weblate | gzip > weblate-db-$(date +%F).sql.gz
docker run --rm -v weblate_weblate-data:/data -v "$PWD":/backup alpine:3.22 \
tar czf /backup/weblate-data-$(date +%F).tar.gz -C /data .للتحديث، اقرأ أولًا ملاحظات الإصدار على GitHub، وخذ نسخة احتياطية، ثم غيّر وسم الصورة؛ يطبّق Weblate ترحيلاته عند التشغيل:
cd /opt/weblate
sed -i 's|weblate/weblate:2026.11.2.0|weblate/weblate:<NEW_VERSION>|' docker-compose.yml
docker compose pull && docker compose up -dتثبيت Weblate بنقرة واحدة على ServOrbit
على خادم ServOrbit، يُثبَّت Weblate من المتجر. ينشر السكربت الصورة الرسمية مع PostgreSQL وValkey، ويولّد كلمة مرور المسؤول وكلمات مرور الخدمات، ويغلق التسجيل، ويفرض تسجيل الدخول، ويضبط الوكيل العكسي nginx عبر HTTPS — على نطاق فرعي من أحد نطاقاتك أو على النطاق الفرعي المجاني للخادم. تسجّل الدخول باسم المستخدم admin وكلمة المرور المعروضة في مساحة العميل، ثم تربط أول مستودع كما سبق. لا يبقى إلا ضبط SMTP لدعوة المترجمين.
servorbit.com/ma-ar/المدونة/استضافة-weblate-على-vps