BBCode إلى HTML

أداة BBCode إلى HTML مجانية، وتحول مقتطفات BBCode إلى كود HTML خام لاستخدامه خارج محررات المنتديات.

ما المشكلة التي يحلها تحويل BBCode؟

يحول BBCode تنسيق المنتديات إلى HTML يمكن للمتصفحات وأنظمة إدارة المحتوى وقوالب الويب تفسيره. ويستخدم BBCode وسوما بين أقواس مربعة، مثل [b] و[i] و[url]، بدلا من عناصر HTML.

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

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

كيف أحول BBCode إلى HTML؟

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

1. انسخ مقتطف BBCode كاملا، بما في ذلك وسوم الفتح والإغلاق.
2. ضعه في حقل BBCode من دون استبدال الأقواس المربعة.
3. راجع النتيجة الخام في حقل HTML.
4. قارن الروابط والصور والقوائم والتنسيقات المتداخلة بالمشاركة الأصلية.
5. نظف المخرجات غير الموثوقة قبل عرضها على صفحة عامة.

تجري عملية التحويل على الخادم. تُرسل مدخلاتك إلى الخادم عبر HTTPS ولا يتم تخزينها.

كيف أقرأ كود HTML الناتج؟

تعامل مع النتيجة على أنها كود مصدر، لا معاينة مرئية. يجب أن يحتوي كود HTML الناتج على عناصر تمثل البنية والتنسيق المحددين في BBCode الأصلي.

إليك مثالا مبسطا:

مدخل BBCode: [b]Release note[/b]

مخرج HTML: عنصر HTML يعرض النص بخط عريض أو يميزه بأهمية قوية، ويحتوي على النص "Release note".

ومن الأنماط الشائعة أيضا:

مدخل BBCode: [url=https://example.org/docs]Read the docs[/url]

مخرج HTML: عنصر رابط وجهته https://example.org/docs ونصه الظاهر "Read the docs".

قد تختلف أسماء العناصر الدقيقة بين أدوات التحويل، لأن لهجات BBCode ليست موحدة. فمثلا، قد يمثل النص العريض بعنصر b الذي يلفت الانتباه من دون التعبير عن أهمية إضافية، أو بعنصر strong الذي يشير إلى أهمية قوية. تحقق من القيمة الفعلية في حقل HTML بدلا من افتراض تحويل الوسوم بطريقة معينة.

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

المدخلات المربكة واختلاف لهجات BBCode

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

• التداخل غير الصحيح: [b][i]Text[/b][/i] يغلق الوسوم بترتيب خاطئ. في التداخل الصحيح، يُغلق الوسم الداخلي أولا.
• وسوم الإغلاق المفقودة: لا يحتوي [quote]Text على وسم إغلاق مقابل عند حذف الوسم الأخير.
• الوسوم المخصصة: قد تختلف معاني [spoiler] و[video] ووسوم المرفقات من برنامج منتدى إلى آخر.
• كود HTML الموجود مسبقا: عند مزج HTML مع BBCode، قد يحوله المحلل إلى كيانات، أو يبقيه كما هو، أو يعامله كنص، بحسب المحلل المستخدم. افحصه بعناية ولا تعتمد على قاعدة عامة واحدة.
• المدخلات الطويلة جدا: يسهل عادة تنفيذ عمليات النقل الكبيرة على دفعات، حتى تتمكن من تحديد السجلات التي فشلت وتصحيحها.

لا تحتوي المدخلات الفارغة على بنية تنسيق يمكن تحويلها. وإذا كان المصدر نصا عاديا بلا وسوم BBCode، فقد لا يضيف التحويل فائدة تُذكر، مع أن معالجة HTML اللاحقة قد تظل بحاجة إلى تحويل محارف مثل < و> و& إلى كيانات.

متى لا يستحق التحويل العناء؟

لا يستحق التحويل العناء إذا كان المحتوى لن يقرأه إلا نظام يفهم بالفعل لهجة BBCode الأصلية. فتغيير التنسيق يضيف خطوة تحويل أخرى، وقد يؤدي إلى فقدان سلوكيات مخصصة للمنتدى.

ولا يكون التحويل ضروريا أيضا عندما يخزن نظام آلي BBCode من دون تغيير، لعرضه لاحقا باستخدام محرك المنتدى نفسه. وبالمثل، لا تضيف إعادة تنسيق كود HTML الناتج أو ترتيب أجزائه يدويا فائدة كبيرة إذا كانت آلة وحدها ستقرأه، إلا عند الحاجة إلى التنسيق لمراجعات أنظمة التحكم في الإصدارات أو لتصحيح الأخطاء.

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

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

هل يمكنني نشر BBCode المحول مباشرة بأمان؟

لا. يجب تمرير كود HTML الناتج من مشاركات منتدى غير موثوقة عبر أداة تنظيف تعتمد قائمة سماح قبل عرضه. ويكتسب ذلك أهمية خاصة مع الروابط والصور والوسائط المضمنة وأي مصدر قد يحتوي مسبقا على نص يشبه HTML.

هل تتحول فواصل الأسطر إلى فقرات HTML؟

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

هل يدعم BBCode محارف Unicode؟

يمكن أن يحتوي BBCode على نص Unicode، بما في ذلك الحروف ذات العلامات النطقية والرموز التعبيرية والكتابات غير اللاتينية، لأن هذه المحارف جزء من المحتوى وليست من صياغة الوسوم. ويجب أن تستخدم صفحة الوجهة أيضا ترميز محارف مناسبا، يكون عادة UTF-8، وإلا فقد يظهر النص بصورة غير صحيحة بعد التحويل.

هل يمكنني تحويل BBCode داخل ملف CSV أو ملف تصدير من قاعدة بيانات؟

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

ما الذي يجب فحصه قبل استيراد HTML؟

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