BBCode към HTML

BBCode към HTML е безплатен инструмент, който преобразува фрагменти с BBCode в чист HTML за използване извън редакторите на форуми.

Какъв проблем решава преобразуването на 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 резултат: 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 еквивалент.

Проблемни входни данни и разлики между диалектите

Интервалите, пунктуацията, числата, буквите с диакритични знаци и нелатинските писмености са обикновен текст, освен когато се намират в синтаксиса на таг или в атрибут. Те трябва да останат част от съдържанието, а не да се превръщат в отделна маркировка. URL адресите изискват повече внимание. Знаци, които са част от адреса, например интервали, може да се нуждаят от процентно кодиране. Знаци със специално значение в синтаксиса на околния HTML атрибут, като амперсанди и кавички, може да трябва да бъдат екранирани като HTML.

• Неправилно влагане: [b][i]Text[/b][/i] затваря таговете в грешен ред. При правилно влагане първо се затваря вътрешният таг.
• Липсващи затварящи тагове: [quote]Text няма съответен затварящ таг, когато последният таг е пропуснат.
• Персонализирани тагове: [spoiler], [video] и таговете за прикачени файлове може да имат различно значение в отделните форумни платформи.
• Съществуващ HTML: HTML, смесен с BBCode, може да бъде екраниран, запазен или третиран като текст според използвания анализатор. Провери го внимателно, вместо да разчиташ на универсално правило.
• Много дълги входни данни: големите миграции обикновено се обработват по-лесно на части, за да могат неуспешните записи да бъдат откривани и коригирани.

Празните входни данни не съдържат структура за форматиране, която да бъде преобразувана. Ако източникът е обикновен текст без BBCode тагове, преобразуването може да не носи почти никаква полза. Въпреки това при последващата обработка като HTML може да е необходимо екраниране на знаци като <, > и &.

Кога няма смисъл да преобразувам BBCode?

Преобразуването не си струва, ако съдържанието ще се чете само от система, която вече разбира оригиналния му BBCode диалект. Смяната на формата добавя още една стъпка за преобразуване и може да доведе до загуба на специфично поведение на форума.

То не е необходимо и когато дадена система съхранява BBCode без промени, за да бъде визуализиран по-късно от същия форумен механизъм. По същия начин разкрасяването или ръчното пренареждане на генерирания HTML е от малка полза, ако ще го чете само машина, освен когато форматирането е нужно за преглед на промени в система за контрол на версиите или за отстраняване на проблеми.

При масови миграции скриптов анализатор може да е по-подходящ, защото прилага едни и същи правила на диалекта към всеки запис и регистрира грешките. Използването само на регулярни изрази е рисковано при вложена маркировка. Използвай анализатор, който разбира влагане, атрибути и невалидни входни данни, след което отделно валидирай и обезопаси получения HTML. Ако преобразуваното съдържание включва вградена JSON конфигурация, инструментът „JSON валидатор и форматиране“ може да помогне при прегледа на тези данни, но не валидират околния HTML.

Често задавани въпроси

Безопасно ли е да публикувам преобразувания BBCode директно?

Не. HTML, генериран от ненадеждни форумни публикации, трябва да премине през средство за обезопасяване с разрешителен списък, преди да бъде визуализиран. Това е особено важно за връзки, изображения, вградена мултимедия и всеки източник, който може вече да съдържа текст, наподобяващ HTML.

Ще се превърнат ли новите редове в HTML абзаци?

Обработката на новите редове зависи от BBCode анализатора и правилата на изходната платформа. Някои системи третират празните редове като абзаци, а други добавят елементи за нов ред или запазват обикновените празни знаци. Преди да мигрираш голям набор от съдържание, сравни многострочен пример с начина, по който изглежда в оригиналния форум.

Поддържа ли BBCode Unicode знаци?

BBCode може да съдържа Unicode текст, включително букви с диакритични знаци, емоджита и нелатински писмености, защото тези знаци са съдържание, а не синтаксис на таговете. Целевата страница също трябва да използва подходящо знаково кодиране, обикновено UTF-8. В противен случай текстът може да се показва неправилно след преобразуването.

Мога ли да преобразувам BBCode в CSV файл или експорт от база данни?

Преобразувай стойностите на полетата, а не целия експортиран файл. Кавичките, разделителите в CSV и екраниращите последователности на базата данни принадлежат към формата контейнер и може да бъдат повредени, ако преминат през конвертор за маркировка. Запази непроменено резервно копие и първо обработи малка партида, преди да приложиш преобразуването към всеки ред.

Какво да проверя, преди да импортирам HTML?

Провери пример с вложено форматиране, връзка, списък, препратка към изображение и всички персонализирани тагове, използвани в изходния форум. Увери се, че целевата система приема тези HTML елементи и атрибути, след което изпълни изискваната от нея стъпка за обезопасяване или валидиране преди пълното импортиране.