ForHosting KIT · النصوص والذكاء الاصطناعي

تحويل BBCode إلى HTML

يحوّل هذا المحوّل من BBCode إلى HTML مجموعة عملية من وسوم التنسيق الشائعة في المنتديات إلى HTML يمكن توقعه.

● Betaمجاني · داخل متصفحك

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

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

حوّل وسوم BBCode المدعومة

يتعرف المحوّل على ست فئات شائعة من BBCode، وهي <code>[b]</code> و<code>[i]</code> و<code>[u]</code> و<code>[url]</code> و<code>[quote]</code> و<code>[list]</code>. يتحول النص العريض إلى <code><strong></code>، والمائل إلى <code><em></code>، والمسطر إلى <code><u></code>، والاقتباس إلى <code><blockquote></code>، وتتحول القوائم إلى قوائم HTML غير مرتبة تضم عناصر. يمكن كتابة الرابط بصيغة <code>[url=https://example.com]التسمية[/url]</code> أو <code>[url]https://example.com[/url]</code>. يبدأ كل عنصر داخل القائمة بالرمز <code>[*]</code>. يمكن تداخل الوسوم إذا أُغلقت بعكس ترتيب فتحها، ولذلك يمكن مثلًا وضع خط مائل داخل نص عريض. تبقى الوسوم الخارجة عن المجموعة المدعومة نصًا مُهَرَّبًا ولا تُفسر على أنها HTML. يجعل هذا النطاق المحدد النتيجة واضحة، ويتجنب ادعاء دعم الامتدادات الكثيرة غير المتوافقة بين برمجيات المنتديات. إذا كان المصدر يعتمد وسومًا مخصصة للألوان أو الأحجام أو الصور أو الجداول أو الوسائط، فلتُعالج منفصلة قبل التحويل أو بعده وفق قواعد تناسب نظام المصدر.

افهم التحقق وسلامة المخرجات

يجب أن يكون BBCode المعروف متوازنًا من حيث البنية. يحتاج كل وسم تنسيق مفتوح إلى وسم الإغلاق المطابق، ويجب إغلاق الوسوم المتداخلة بعكس ترتيب فتحها، كما يجب أن تظهر علامات عناصر القائمة داخل قائمة مباشرة. يعيد التسلسل غير الصحيح خطأ إدخال غير صالح بدل مستند جزئي. لهذه القاعدة أهمية في النشر الآلي، لأن إصلاح الترميز بصمت قد يمد التنسيق أو الروابط أو الاقتباسات إلى خارج الحدود التي قصدها المؤلف. يُهَرَّب النص العادي إلى HTML أثناء التصيير، بما في ذلك الأقواس الزاوية وعلامات العطف، كما تُهَرَّب وجهات الروابط لاستخدامها في السمات. تقتصر مخططات URL الصريحة على HTTP وHTTPS وmailto، وتُقبل كذلك الروابط الجزئية والوجهات النسبية. يمنع هذا الفحص تحوّل رابط BBCode إلى عنوان برمجي واضح، لكن ينبغي أن تمر المخرجات أيضًا بسياسة الأمان والمحتوى التي تعتمدها المنظومة التي ستدرجها. المحوّل أداة لتحويل الصياغة، وليس حد ثقة كاملًا ولا بديلًا عن منقّي HTML خاص بالموقع أو نظام الصلاحيات أو الإشراف على المحتوى.

استخدم النتيجة في مسار النشر

أرسل قيمة واحدة في الحقل <code>text</code>، واقرأ الترميز المحوّل من الحقل <code>html</code> في النتيجة. تناسب هذه البنية البسيطة برامج الترحيل، وصادرات المنتديات، ومسارات معالجة التعليقات، واستيراد قواعد المعرفة، وبيانات الاختبار. قبل تحويل أرشيف كبير، افحص عينة من سجلات منصة المصدر الفعلية، لأن لهجات BBCode تختلف؛ فبعضها يستخدم معاملات للقوائم المرقمة، أو نسبًا خاصة للاقتباسات، أو وسوم وسائط مملوكة تقع عمدًا خارج نطاق هذه القدرة. احتفظ بنسخة BBCode الأصلية مع النتيجة المحوّلة حتى تكتمل مراجعة الترحيل، لكي يمكن تعديل المعالجة المسبقة الخاصة بالمصدر من دون فقد المعلومات. في المحرر التفاعلي، اعرض خطأ الوسم غير المتوازن قرب المحتوى بدل حذف تنسيقه. وفي الاستيراد الدفعي، سجّل العنصر الذي فشل وتابع وفق سياسة إعادة المحاولة المعتمدة لديكم. تبلغ تكلفة التحويل عبر API مقدار $0.002 لكل عنصر. ولأن العملية لا تعتمد على شبكة أو ساعة أو عشوائية أو خدمة خارجية، ينتج الإدخال المقبول نفسه HTML متطابقًا على مستوى البايت في كل تشغيل.

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

ترحيل منشورات المنتديات

حوّل التنسيق المدعوم في رسائل المنتدى المصدّرة قبل استيراد المحتوى إلى نظام نشر قائم على HTML.

معاينة التعليقات القديمة

أنشئ معاينة HTML يمكن توقعها للتعليقات المحفوظة بصيغة BBCode الشائعة، وأبلغ المحرر عن التداخل غير الصحيح.

توحيد محتوى قاعدة المعرفة

حوّل النص العريض والروابط والاقتباسات والقوائم إلى مجموعة HTML فرعية متسقة أثناء ترحيل الوثائق.

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

ما وسوم BBCode المدعومة؟

الوسوم المدعومة هي b وi وu وurl وquote وlist. تستخدم عناصر القائمة [*]، وتبقى الوسوم الأخرى نصًا مُهَرَّبًا.

ماذا يحدث إذا كانت الوسوم غير متوازنة؟

يفشل الطلب بخطأ إدخال غير صالح يحدد الوسم غير المتوازن أو المتداخل على نحو غير صحيح.

هل يمكن وضع تسمية للرابط؟

نعم. استخدم [url=https://example.com]التسمية[/url]. ويمكن أيضًا وضع الوجهة نفسها بين [url] و[/url].

هل يزيل التحويل كل مخاطر HTML الممكنة؟

لا. يُهَرَّب النص والسمات وتُرفض مخططات URL الصريحة الخطرة، لكن ينبغي للمنظومة تطبيق سياسة الأمان ومنقّي المحتوى الخاصين بها عند الحاجة.

ما تكلفة عملية التحويل؟

تبلغ تكلفة كل طلب API مقدار $0.002 لكل عنصر.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/text/bbcode-to-html

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

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

curl -X POST https://api.kit.forhosting.com/text/bbcode-to-html \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"[b]Important[/b]: visit [url=https://example.com]our site[/url]."}'

const res = await fetch("https://api.kit.forhosting.com/text/bbcode-to-html", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "[b]Important[/b]: visit [url=https://example.com]our site[/url]."
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/text/bbcode-to-html",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "[b]Important[/b]: visit [url=https://example.com]our site[/url]."
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/text/bbcode-to-html", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"[b]Important[/b]: visit [url=https://example.com]our site[/url]."}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"[b]Important[/b]: visit [url=https://example.com]our site[/url]."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/bbcode-to-html", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "text": "[b]Important[/b]: visit [url=https://example.com]our site[/url]."
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_chars 200000

الأخطاء

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

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