BBCode до HTML

BBCode до HTML, це безкоштовний інструмент, який перетворює фрагменти BBCode на звичайний HTML для використання поза редакторами форумів.

Для чого перетворювати BBCode?

Перетворення BBCode дає змогу отримати з форумної розмітки HTML, який можуть обробляти браузери, системи керування вмістом і вебшаблони. У BBCode замість елементів HTML використовуються теги у квадратних дужках, наприклад [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, а перед повним імпортом виконай передбачене нею очищення або перевірку.