ForHosting KIT · الترجمة

ترجمة تعليقات الكود البرمجي

تترجم هذه الأداة التعليقات المكتوبة داخل ملف كود برمجي — الأسطر التي تبدأ بعلامة تعليق أو داخل كتلة توثيق — بين العربية والإنجليزية أو أي لغة أخرى، وتترك كل سطر برمجي وأسماء المتغيرات والدوال دون أي تغيير. تناسب فرق تطوير تريد توثيقًا داخليًا بلغة الفريق أو تحضّر مشروعًا مفتوح المصدر بلغة أخرى.

● Betaلكل طلب · لكل 1,000 كلمة$0.003

تشغيل — $0.003 + $0.0135/1,000 كلمة اطّلع على الـAPI

استخدمها من الويبAPIالبريدالتطبيق قريبًاTelegram قريبًا

شغّلها أونلاين

شغّل هذه المهمة على خوادمنا باستخدام حسابك. الأدوات المجانية تعمل داخل متصفحك، أما هذه فتُخصم من رصيدك في KIT حسب السعر الموضّح أعلاه.

كيف تميّز الأداة الكود عن التعليق

تحلل الأداة بنية الملف البرمجي فتحدد الأسطر التي هي تعليق فعلي — بعد // أو # أو داخل /* */ أو داخل نص توثيقي docstring — في أغلب لغات البرمجة الشائعة مثل Python وJavaScript وPHP وJava، وتترجم نص التعليق فقط بينما يبقى كل سطر كود منطقي كما هو حرفيًا دون أي مساس. هذا التحليل الأولي لبنية الملف هو ما يمنع الأداة من الخلط بين نص برمجي حقيقي ونص تعليق يشبهه شكليًا، وهو خطأ شائع في أدوات الترجمة العامة التي لا تفهم صيغة الكود أصلًا وتتعامل مع الملف كنص عادي متصل.

أسماء المتغيرات والدوال لا تُترجَم أبدًا

اسم دالة مثل calculateTotal أو متغير مثل userEmail يبقى في الكود كما هو دائمًا، حتى لو ورد اسمه داخل نص التعليق نفسه؛ الترجمة تطال الشرح البشري المحيط بالكود فقط، لأن تغيير اسم رمزي واحد يكسر تشغيل البرنامج بالكامل ويحتاج مطورًا لتتبع الخطأ لاحقًا. حتى أسماء الملفات والمسارات المذكورة داخل التعليق تبقى كما هي لنفس السبب، لأنها غالبًا تشير إلى ملف حقيقي في المشروع.

توثيق الدوال يُترجَم مع الحفاظ على بنيته

كتل التوثيق التي تصف معاملات دالة ونوع القيمة المرجعة (docstring أو JSDoc) تُترجَم نصًا مع إبقاء وسوم البنية مثل @param أو @returns في مكانها تمامًا كما وردت، فيبقى التوثيق قابلًا لقراءة أدوات توليد التوثيق الآلي بعد الترجمة دون كسر تنسيقها. يتغيّر الشرح البشري لكل معامل فقط، بينما يبقى اسم المعامل ونوعه المرجعي كما كتبهما المطور الأصلي حرفيًا. هذا مهم خصوصًا في المشاريع التي تولّد صفحة توثيق تلقائية من هذه التعليقات مباشرة.

من المتصفح أو عبر الـAPI

ملف واحد صغير يُلصَق في صفحة الأداة لترجمة سريعة تناسب مطورًا يراجع ملفًا واحدًا بمفرده. أما فريق تطوير يترجم عشرات الملفات دوريًا ضمن مشروع كبير فيدمج الـAPI نفسه ضمن مسار عمل آلي أو سكربت نشر، فتُترجَم التعليقات في كل ملف جديد تلقائيًا دون فتح صفحة الأداة يدويًا لكل ملف على حدة. هذا يناسب فرقًا موزعة جغرافيًا تكتب الكود بلغة والتوثيق النهائي بلغة أخرى لعملاء أو شركاء دوليين.

السعر

$0.003 لكل طلب زائد $0.0135 لكل ألف كلمة من نصوص التعليقات المُترجَمة فقط، لا من إجمالي حجم الملف؛ ملف كبير بكود كثير وتعليقات قليلة يكلف أقل من ملف بنفس الحجم لكن تعليقاته أطول، لأن السعر يُحسَب على كلمات الشرح البشري فقط دون احتساب أسطر الكود المنطقي التي لا تُترجَم أصلًا. هذا يجعل ترجمة مشروع برمجي كامل أرخص بكثير مما يتوقعه أغلب فرق التطوير قبل تجربة الأداة فعليًا.

حالات الاستخدام

فريق محلي يوثّق مشروعًا مستورَدًا

يترجم عبدالله المنصوري تعليقات مكتبة برمجية مفتوحة المصدر من الإنجليزية إلى العربية قبل تسليمها لفريق تطوير محلي مبتدئ، مع إبقاء كل سطر كود كما كتبه المطور الأصلي دون تعديل.

مشروع داخلي يستعد ليصبح مفتوح المصدر

تترجم شركة الخليج الرقمية تعليقات كود كتبها فريقها بالعربية إلى الإنجليزية قبل نشر المشروع على منصة عامة، فيصل التعليق مفهومًا لمطورين لا يقرؤون العربية دون المساس بمنطق الكود.

توثيق دالة برمجية لفريق دولي

يترجم خالد العتيبي كتلة توثيق دالة تصف معاملات نظام داخلي من العربية إلى الإنجليزية، مع إبقاء وسوم البنية في مكانها ليقرأها مولّد التوثيق الآلي للفريق.

الأسئلة الشائعة

هل تُحفظ ملفات الكود بعد الترجمة؟

لا، يُعالَج الملف لاستخراج التعليقات وترجمتها فقط ثم يُستبعد فور اكتمال الطلب، دون حفظ دائم على الخادم.

هل يمكن أن تغيّر الترجمة سطرًا برمجيًا بالخطأ؟

لا، الأداة تحلل بنية الملف أولًا لتفصل الكود عن التعليق، ولا تلمس أي سطر مصنَّف كودًا منطقيًا؛ الترجمة تطال نص التعليق البشري فقط.

ماذا لو ورد اسم متغير داخل جملة التعليق نفسها؟

يبقى اسم المتغير كما هو داخل نص التعليق أيضًا، لأنه غالبًا يشير إلى رمز حقيقي في الكود يجب أن يبقى قابلًا للبحث والمطابقة.

ما لغات البرمجة المدعومة؟

أغلب اللغات الشائعة مثل Python وJavaScript وPHP وJava ولغة C؛ تتعرف الأداة على صيغة التعليق الخاصة بكل لغة تلقائيًا من امتداد الملف أو محتواه.

كم تكلفة ترجمة ملف بألف كلمة من التعليقات؟

$0.003 سعرًا ثابتًا للطلب زائد $0.0135 لكل ألف كلمة من نصوص التعليقات فقط، لا من حجم الكود الكامل.

هل تعمل هذه الأداة من المتصفح أم عبر الـAPI فقط؟

الاثنان معًا: ملف واحد يُلصَق في صفحة الأداة لترجمة سريعة، وفرق التطوير التي تترجم عشرات الملفات دوريًا تستخدم الـAPI ضمن مسار عملها الآلي.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/translate/code-comments

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/translate/code-comments \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"text":"…"}'

const res = await fetch("https://api.kit.forhosting.com/translate/code-comments", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/translate/code-comments",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "text": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/translate/code-comments", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"text":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/translate/code-comments", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "text": "…"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "translate.code_comments",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.003

لكل 1,000 كلمة$0.0135

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

max_tokens 20000

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.
`422`	`task_failed`	لم تنجح معالجة المهمة، ولن تُحتسب عليك؛ أعد المحاولة أو راسلنا مباشرة.

اطّلع على توثيق KIT الكامل ←