बीबीकोड से एचटीएमएल

बीबीकोड से एचटीएमएल एक मुफ़्त टूल है, जो BBCode स्निपेट को रॉ HTML में बदलता है ताकि उन्हें फ़ोरम एडिटर के बाहर इस्तेमाल किया जा सके।

BBCode को बदलने से कौन-सी समस्या हल होती है?

BBCode कन्वर्ज़न फ़ोरम में इस्तेमाल होने वाले मार्कअप को ऐसे HTML में बदल देता है, जिसे ब्राउज़र, कॉन्टेंट मैनेजमेंट सिस्टम और वेब टेम्पलेट समझ सकते हैं। HTML एलिमेंट के बजाय BBCode में [b], [i] और [url] जैसे चौकोर ब्रैकेट वाले टैग इस्तेमाल होते हैं।

यह तब उपयोगी है, जब फ़ोरम की पोस्ट किसी दूसरी जगह माइग्रेट करनी हों, किसी थर्ड-पार्टी API से मिले कॉन्टेंट को डीबग करना हो या पुराने नॉलेज बेस को ऐसे प्लेटफ़ॉर्म के लिए तैयार करना हो जो 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 आउटपुट: एक बोल्ड या strong 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 में अधिक सावधानी चाहिए। URL का हिस्सा बनने वाले वर्ण, जैसे स्पेस, प्रतिशत-एन्कोड करने पड़ सकते हैं। वहीं, आसपास के HTML एट्रिब्यूट सिंटैक्स में खास अर्थ रखने वाले वर्ण, जैसे एम्परसैंड और उद्धरण चिह्न, HTML एस्केप करने पड़ सकते हैं।

• गलत नेस्टिंग: [b][i]Text[/b][/i] में टैग गलत क्रम में बंद होते हैं। सही नेस्टेड मार्कअप में अंदर वाला टैग पहले बंद होता है।
• क्लोज़िंग टैग गायब होना: अगर अंतिम टैग छोड़ दिया जाए, तो [quote]Text का कोई क्लोज़िंग समकक्ष नहीं रहता।
• कस्टम टैग: अलग-अलग फ़ोरम सॉफ़्टवेयर में [spoiler], [video] और अटैचमेंट टैग के अर्थ अलग हो सकते हैं।
• पहले से मौजूद HTML: पार्सर के अनुसार BBCode में मिला HTML एस्केप किया जा सकता है, जस का तस रखा जा सकता है या टेक्स्ट माना जा सकता है। किसी एक सार्वभौमिक नियम पर निर्भर रहने के बजाय उसे ध्यान से जांचें।
• बहुत लंबा इनपुट: बड़े माइग्रेशन को आम तौर पर बैच में प्रोसेस करना आसान होता है, ताकि विफल रिकॉर्ड पहचाने और ठीक किए जा सकें।

खाली इनपुट में बदलने के लिए कोई फ़ॉर्मेटिंग संरचना नहीं होती। अगर सोर्स में केवल सादा टेक्स्ट है और कोई BBCode टैग नहीं है, तो कन्वर्ज़न से बहुत कम फ़ायदा हो सकता है। हालांकि, आगे HTML संभालते समय <, > और & जैसे वर्णों को एस्केप करना फिर भी ज़रूरी हो सकता है।

कन्वर्ज़न कब करना ज़रूरी नहीं है?

अगर कॉन्टेंट केवल ऐसा सिस्टम पढ़ेगा जो उसके मूल BBCode रूप को पहले से समझता है, तो कन्वर्ज़न करना उपयोगी नहीं है। फ़ॉर्मेट बदलने से एक अतिरिक्त ट्रांसफ़ॉर्मेशन चरण जुड़ता है और फ़ोरम का कस्टम व्यवहार खो सकता है।

जब कोई सिस्टम BBCode को बिना बदले स्टोर करता है और बाद में वही फ़ोरम इंजन उसे रेंडर करेगा, तब भी कन्वर्ज़न की ज़रूरत नहीं होती। इसी तरह, अगर जेनरेट किए गए HTML को केवल मशीन पढ़ेगी, तो उसे सुंदर तरीके से फ़ॉर्मेट करने या मैन्युअल रूप से दोबारा व्यवस्थित करने से बहुत कम लाभ मिलता है। अपवाद तब है, जब वर्ज़न-कंट्रोल समीक्षा या डीबगिंग के लिए फ़ॉर्मेटिंग चाहिए।

बड़े पैमाने के माइग्रेशन में स्क्रिप्ट वाला पार्सर बेहतर हो सकता है, क्योंकि वह हर रिकॉर्ड पर एक जैसे रूप-संबंधी नियम लागू कर सकता है और विफलताओं का लॉग रख सकता है। नेस्टेड मार्कअप के लिए केवल रेगुलर एक्सप्रेशन पर निर्भर रहना जोखिम भरा है। ऐसा पार्सर इस्तेमाल करें जो नेस्टिंग, एट्रिब्यूट और गलत इनपुट को समझता हो, फिर बने हुए HTML को अलग से वैलिडेट और सैनिटाइज़ करें। अगर बदले गए कॉन्टेंट में एम्बेडेड JSON कॉन्फ़िगरेशन है, तो JSON सत्यापनकर्ता और सौंदर्यीकरण उपकरण उस डेटा की जांच में मदद कर सकता है, लेकिन वह आसपास के HTML को वैलिडेट नहीं करता।

अक्सर पूछे जाने वाले सवाल

क्या बदले हुए BBCode को सीधे प्रकाशित करना सुरक्षित है?

नहीं। अविश्वसनीय फ़ोरम पोस्ट से बने HTML को रेंडर करने से पहले allow-list HTML सैनिटाइज़र से गुज़ारना चाहिए। यह खास तौर पर लिंक, इमेज, एम्बेडेड मीडिया और ऐसे किसी भी सोर्स के लिए ज़रूरी है जिसमें पहले से HTML जैसा टेक्स्ट हो सकता है।

क्या लाइन ब्रेक HTML पैराग्राफ में बदल जाएंगे?

लाइन ब्रेक कैसे संभाले जाएंगे, यह BBCode पार्सर और सोर्स प्लेटफ़ॉर्म के नियमों पर निर्भर करता है। कुछ सिस्टम खाली लाइनों को पैराग्राफ मानते हैं, जबकि कुछ लाइन-ब्रेक एलिमेंट जोड़ते हैं या सामान्य व्हाइटस्पेस बनाए रखते हैं। बड़ी संख्या में कॉन्टेंट माइग्रेट करने से पहले कई लाइनों वाले नमूने की तुलना मूल फ़ोरम रेंडरिंग से करें।

क्या BBCode में Unicode वर्ण इस्तेमाल किए जा सकते हैं?

BBCode में Unicode टेक्स्ट हो सकता है, जिसमें उच्चारण चिह्न वाले वर्ण, इमोजी और गैर-लैटिन लिपियां शामिल हैं, क्योंकि ये वर्ण टैग सिंटैक्स नहीं बल्कि कॉन्टेंट होते हैं। गंतव्य पेज पर भी सही कैरेक्टर एन्कोडिंग, आम तौर पर UTF-8, इस्तेमाल होनी चाहिए। वरना कन्वर्ज़न के बाद टेक्स्ट गलत दिखाई दे सकता है।

क्या CSV या डेटाबेस एक्सपोर्ट के अंदर मौजूद BBCode बदल सकते हैं?

पूरी एक्सपोर्ट फ़ाइल के बजाय उसके फ़ील्ड मान बदलें। CSV के उद्धरण चिह्न, डिलिमिटर और डेटाबेस एस्केप सीक्वेंस कंटेनर फ़ॉर्मेट का हिस्सा होते हैं। उन्हें मार्कअप कन्वर्टर से गुज़ारने पर नुकसान हो सकता है। बिना बदला हुआ बैकअप रखें और हर पंक्ति पर कन्वर्ज़न लागू करने से पहले एक छोटा बैच प्रोसेस करें।

HTML इंपोर्ट करने से पहले क्या जांचना चाहिए?

ऐसा नमूना जांचें जिसमें नेस्टेड फ़ॉर्मेटिंग, एक लिंक, एक सूची, एक इमेज रेफ़रेंस और सोर्स फ़ोरम में इस्तेमाल होने वाले सभी कस्टम टैग शामिल हों। पक्का करें कि गंतव्य उन HTML एलिमेंट और एट्रिब्यूट को स्वीकार करता है। इसके बाद पूरा इंपोर्ट करने से पहले उसकी आवश्यक सैनिटाइज़ेशन या वैलिडेशन प्रक्रिया चलाएं।