ترجمة وثائق Docusaurus إلى لغة أخرى دون المساس بـ MDX والأكواد البرمجية
اضغط مجلد docs في ملف ZIP وارفعه، وستستلمه مترجماً بالملفات نفسها، ليكون جاهزاً لوضعه مباشرة في i18n/<locale>/docusaurus-plugin-content-docs/current. تظل أسطر الاستيراد (Import) ومكونات Tabs والمكونات الأخرى وعلامات التنبيهات وكتل الأكواد البرمجية والروابط كما هي دون تغيير؛ بينما تُترجم العناوين وتسميات الشريط الجانبي (sidebar labels) والأوصاف والنصوص العادية. الجزء الأول مجاني بدون تسجيل؛ وما يصل إلى 1,000,000 حرف من النصوص مقابل $5 دفعة واحدة.
- نسخ أسطر import وexport ومكونات JSX كما كُتبت تماماً
- يتم الحفاظ على علامات التنبيه (:::note, :::tip)؛ مع ترجمة النص بداخلها
- ترويسة Front matter: تُترجم title وdescription وsidebar_label؛ مع الحفاظ على id وslug وsidebar_position
- الحفاظ على روابط العناوين الثابتة مثل {#install} لضمان استمرار عمل الروابط
- استعادة مسارات المجلدات نفسها في ملف zip. مع نسخ الصور دون أي تعديل
Docusaurus i18n بدون عناء النسخ واللصق
يتطلب نظام Docusaurus نسخة مترجمة من كل ملف وثائق داخل مجلد اللغة (locale)، وبأسماء الملفات نفسها. والقيام بذلك يدوياً أو ملفاً بملف عبر روبوت الدردشة يستغرق وقتاً طويلاً، كما أن ملفات MDX تجعل عواقب الأخطاء مكلفة؛ إذ يكفي ترجمة اسم استيراد أو تغيير خاصية برمجية (prop) حتى يتعطل بناء الموقع (build). تترجم هذه الأداة فقط الأجزاء التي يراها القارئ وتنسخ كل ما عدا ذلك من ملفاتك الأصلية بدقة.
تُستبدل الأكواد المضمنة، ووجهات الروابط، ومسارات الصور، وتعبيرات MDX {expressions} بعلامات مؤقتة قبل الترجمة ثم تُعاد كما كانت بعدها، حتى لا يتعامل النموذج معها إطلاقاً. كما يتم تجاوز الأسطر المقتصرة على JSX، مثل <Tabs> أو <TabItem value="mac">، بالإضافة إلى تجاوز كتل الأكواد البرمجية بالكامل بما في ذلك التعليقات البرمجية.
بعد التنزيل
- فك الضغط وانسخ محتويات مجلد docs-<locale> إلى المسار i18n/<locale>/docusaurus-plugin-content-docs/current
- شغّل الأمر docusaurus write-translations لتسميات القالب وأسماء تصنيفات الشريط الجانبي المحفوظة في ملفات JSON
- شغّل الموقع باستخدام الخيار locale <locale>-- وتصفح الصفحات للتأكد
- راجع وصحح أي فقرة واردة في ملف التحذيرات (إن وجد)
ما لا تشمله الأداة
توجد تسميات فئات الشريط الجانبي ونصوص شريط التنقل (navbar) والتذييل في ملفات JSON يتم إنشاؤها عبر الأمر write-translations؛ ويمكنك ترجمتها باستخدام أداة ترجمة ملفات التوطين. تعمل مقالات المدونة بالطريقة نفسها تماماً: اضغط مجلد blog في ملف ZIP وارفعه في مهمة منفصلة، أو ارفعه مع مجلد docs في ملف zip. واحد.
تجد طريقة عمل الأداة وتكلفتها وكيفية التعامل مع ملفاتك في صفحة ترجمة وثائق Markdown؛ وأسعار كل الأدوات في صفحة الأسعار.
آخر تحديث:
أسئلة وأجوبة
هل ستنجح عملية بناء الموقع (build) دون أخطاء؟
تُنسخ أسطر الاستيراد، والمكونات، والخصائص (props)، والأكواد، ووجهات الروابط مباشرة من ملفاتك الأصلية، وهي النقاط التي غالباً ما تسبب فشل بناء ملفات MDX. شغّل عملية البناء مرة واحدة بعد نسخ الملفات، وتحقق من ملف التحذيرات.
هل تُترجم التنبيهات (admonitions)؟
يُحتفظ بأسطر :::note و ::: كما هي، بينما يُترجم النص المكتوب بينها فقط.
ما السعة التي تستوعبها المهمة الواحدة؟
ما يصل إلى 1,000,000 حرف من النصوص، أي نحو 300 صفحة، مقابل $5. ولا تُحتسب الأكواد البرمجية ومفاتيح front matter ضمن هذا الحد.
هل يمكنني تجربة بضعة ملفات أولاً؟
نعم. يُترجم الجزء الأول مجاناً ويُعرض على الشاشة؛ وتكون المهمة التي تصل إلى 40 فقرة مجانية بالكامل.