BBCode la HTML

BBCode la HTML este un instrument gratuit care convertește fragmente BBCode în cod HTML brut, pentru a putea fi folosite în afara editoarelor de forumuri.

Ce problemă rezolvă conversia BBCode?

Conversia BBCode transformă marcajele folosite pe forumuri în HTML pe care îl pot interpreta browserele, sistemele de administrare a conținutului și șabloanele web. În locul elementelor HTML, BBCode folosește etichete între paranteze drepte, precum [b], [i] și [url].

Conversia este utilă când muți postări de pe un forum, depanezi conținutul returnat de un API terț sau pregătești o bază de cunoștințe veche pentru o platformă care acceptă HTML, dar nu și BBCode. Te poate ajuta și înainte de publicare, atunci când textul importat trebuie verificat separat de codul aplicației în care va fi integrat.

BBCode nu este un limbaj standardizat oficial. Platformele de forum și extensiile lor își pot defini propriile etichete, atribute și reguli de imbricare. Prin urmare, o conversie care funcționează pentru formatarea obișnuită poate necesita ajustări dacă sursa conține elemente specifice unei platforme, cum ar fi casete pentru spoilere, referințe la atașamente sau etichete media personalizate.

Cum convertesc BBCode în HTML?

Introdu sau lipește marcajul sursă în câmpul BBCode, apoi consultă codul convertit în câmpul HTML. Copiază acel cod HTML la destinație numai după ce verifici dacă elementele și linkurile corespund conținutului dorit.

1. Copiază fragmentul BBCode complet, inclusiv etichetele de deschidere și de închidere.
2. Introdu-l în câmpul BBCode fără să înlocuiești parantezele drepte.
3. Examinează rezultatul brut din câmpul HTML.
4. Compară linkurile, imaginile, listele și formatarea imbricată cu postarea originală.
5. Igienizează rezultatul provenit din surse care nu sunt de încredere înainte de a-l afișa pe o pagină publică.

Conversia se efectuează pe server. Datele introduse sunt trimise către server prin HTTPS și nu sunt stocate.

Cum interpretez codul HTML returnat?

Privește rezultatul ca pe un cod sursă, nu ca pe o previzualizare vizuală. Codul HTML returnat ar trebui să conțină elemente care reprezintă structura și formatarea exprimate în BBCode-ul sursă.

Un exemplu conceptual simplu:

Intrare BBCode: [b]Release note[/b]

Ieșire HTML: un element HTML pentru text aldin sau evidențiat puternic, care conține textul "Release note".

Un alt tipar întâlnit frecvent:

Intrare BBCode: [url=https://example.org/docs]Read the docs[/url]

Ieșire HTML: un element ancoră a cărui destinație este https://example.org/docs și al cărui text vizibil este "Read the docs".

Denumirile exacte ale elementelor pot varia de la un convertor la altul, deoarece dialectele BBCode nu sunt standardizate. De exemplu, textul aldin poate fi reprezentat fie printr-un element b, care atrage atenția fără a exprima o importanță suplimentară, fie printr-un element strong, care indică o importanță deosebită. Verifică valoarea efectivă din câmpul HTML în loc să presupui că se folosește o anumită corespondență.

Acest instrument este un convertor, nu înlocuiește un validator HTML sau un instrument de igienizare pentru securitate. Secvențele BBCode rămase ca text literal, conținutul lipsă sau elementele imbricate neobișnuit pot indica o sintaxă incorectă ori neacceptată în sursă. Printre problemele frecvente se numără etichetele neînchise, etichetele închise în ordinea greșită, atributele scrise incorect și etichetele specifice unui forum care nu au un echivalent HTML general.

Intrări problematice și diferențe între dialecte

Spațiile, semnele de punctuație, cifrele, literele cu diacritice și scrierile care nu folosesc alfabetul latin sunt text obișnuit, cu excepția cazului în care apar în sintaxa etichetelor sau în atribute. Acestea trebuie să rămână parte din conținut, nu să devină marcaje separate. Adresele URL necesită mai multă atenție: caracterele care fac parte din URL, precum spațiile, pot necesita codificare procentuală, iar caracterele cu semnificație specială în sintaxa atributului HTML din jur, precum semnul ampersand și ghilimelele, pot necesita escapare HTML.

• Imbricare incorectă: [b][i]Text[/b][/i] închide etichetele în ordinea greșită. Într-o structură imbricată corect, eticheta interioară se închide prima.
• Etichete de închidere lipsă: [quote]Text nu are o etichetă de închidere corespunzătoare dacă eticheta finală este omisă.
• Etichete personalizate: [spoiler], [video] și etichetele pentru atașamente pot avea semnificații diferite în funcție de platforma de forum.
• HTML existent: codul HTML combinat cu BBCode poate fi escapat, păstrat sau tratat ca text, în funcție de parser. Verifică-l cu atenție, în loc să te bazezi pe o regulă universală.
• Intrare foarte lungă: migrările de mari dimensiuni sunt de obicei mai ușor de procesat pe loturi, astfel încât înregistrările nereușite să poată fi identificate și corectate.

O intrare goală nu are nicio structură de formatare care să poată fi convertită. Dacă sursa conține doar text simplu, fără etichete BBCode, conversia poate aduce puține beneficii. Totuși, procesarea HTML ulterioară poate necesita în continuare escaparea unor caractere precum <, > și &.

Când nu merită să faci conversia?

Conversia nu merită făcută dacă materialul va fi citit numai de un sistem care înțelege deja dialectul BBCode original. Schimbarea formatului introduce o etapă suplimentară de transformare și poate elimina comportamentele personalizate ale forumului.

Conversia nu este necesară nici atunci când un sistem stochează BBCode-ul neschimbat pentru a-l reda ulterior cu același motor de forum. În mod similar, reformatarea sau rearanjarea manuală a codului HTML generat aduce puține beneficii dacă va fi citit doar de un sistem, cu excepția situațiilor în care formatarea este necesară pentru verificări în sistemul de control al versiunilor sau pentru depanare.

Pentru migrări în masă, un parser rulat prin script poate fi mai potrivit, deoarece poate aplica aceleași reguli de dialect fiecărei înregistrări și poate consemna erorile. Folosirea exclusivă a expresiilor regulate este riscantă pentru marcajele imbricate. Utilizează un parser care înțelege imbricarea, atributele și intrările incorecte, apoi validează și igienizează separat codul HTML rezultat. Dacă materialul convertit conține configurații JSON încorporate, un Validator și înfrumusețator JSON te poate ajuta să examinezi acele date, dar nu validează codul HTML din jur.

Întrebări frecvente

Pot publica direct codul BBCode convertit?

Nu. Codul HTML generat din postări de forum care nu sunt de încredere trebuie trecut printr-un instrument de igienizare HTML bazat pe o listă de elemente permise înainte de a fi afișat. Acest lucru este deosebit de important pentru linkuri, imagini, conținut media încorporat și orice sursă care poate conține deja text asemănător codului HTML.

Întreruperile de rând devin paragrafe HTML?

Modul de tratare a întreruperilor de rând depinde de parserul BBCode și de regulile platformei sursă. Unele sisteme interpretează rândurile goale drept paragrafe, în timp ce altele inserează elemente pentru întreruperi de rând sau păstrează spațiile albe ca atare. Compară un exemplu pe mai multe rânduri cu afișarea sa pe forumul original înainte de a migra o colecție mare.

BBCode acceptă caractere Unicode?

BBCode poate conține text Unicode, inclusiv caractere cu diacritice, emoji și sisteme de scriere care nu folosesc alfabetul latin, deoarece aceste caractere fac parte din conținut, nu din sintaxa etichetelor. Și pagina de destinație trebuie să folosească o codificare adecvată a caracterelor, de obicei UTF-8. În caz contrar, textul poate fi afișat incorect după conversie.

Pot converti BBCode dintr-un export CSV sau dintr-o bază de date?

Convertește valorile câmpurilor, nu întregul fișier exportat. Ghilimelele CSV, delimitatorii și secvențele de escapare ale bazei de date aparțin formatului container și pot fi deteriorate dacă sunt trecute printr-un convertor de marcaje. Păstrează o copie de rezervă nemodificată și procesează un lot mic înainte de a aplica conversia tuturor rândurilor.

Ce trebuie să verific înainte de a importa codul HTML?

Verifică un eșantion care conține formatare imbricată, un link, o listă, o referință la o imagine și toate etichetele personalizate folosite de forumul sursă. Confirmă că destinația acceptă elementele și atributele HTML respective, apoi efectuează etapa de igienizare sau validare cerută de aceasta înainte de importul complet.