Konwerter BBCode do HTML

Jak działa konwersja tagów forum na kod strony

Mechanizm opiera się na skanowaniu tekstu od lewej do prawej i rozpoznawaniu wzorca tagu: nawias kwadratowy, nazwa, opcjonalny parametr po znaku równości, nawias zamykający. Parser rozróżnia trzy postacie konstrukcji: tag otwierający (na przykład [b]), tag zamykający ([/b]) oraz tag otwierający z wartością ([url=https://example.com], [color=red], [size=14]). Każde rozpoznane wystąpienie zostaje zastąpione odpowiednikiem HTML — elementem liniowym (strong, em) albo blokiem (blockquote, pre). Reszta tekstu przechodzi bez zmian.

Zanim cokolwiek zostanie zamienione, treść wejściowa jest poddawana escapowaniu znaków specjalnych HTML: nawiasu ostrokątnego otwierającego i zamykającego oraz ampersanda. Dzięki temu tekst wklejony z forum nie zamieni się w działający kod strony — jeśli w poście ktoś wpisał surowy znacznik HTML, po konwersji zobaczymy go jako widoczny tekst, a nie jako element. To zabezpieczenie przed wstrzyknięciem kodu, ponieważ BBCode z założenia jest językiem tekstowym, a nie wykonywalnym.

Trzeci element mechanizmu to dopasowywanie par tagów. Parser prowadzi stos otwartych znaczników i tag zamykający przypisuje do ostatnio otwartego tagu tego samego typu, co daje poprawną strukturę przy zagnieżdżeniach w rodzaju [quote][b]tekst[/b][/quote]. Jeśli tag zamykający nie ma pary albo para jest niespójna, fragment pozostaje zwykłym tekstem — konwerter nie naprawia składni na siłę. Istotna jest też kolejność: najpierw przetwarzane są tagi wewnętrzne, potem zewnętrzne, a tagi z parametrem wymagają dodatkowego kroku — odczytania wartości i przeniesienia jej do atrybutu HTML.

Przykład konwersji krok po kroku

1. Wejściowy fragment posta: [quote=Anna][b]Witaj[/b] i [i]dzień dobry[/i][/quote], a w kolejnej linii [url=https://example.com]Link[/url].
2. Escapowanie: znaki specjalne HTML w tekście użytkownika zostają zamienione na encje, więc gdyby w poście był wpisany surowy znacznik, stałby się widocznym tekstem, a nie elementem strony.
3. Rozpoznanie tagów z parametrem: [quote=Anna] to otwarcie cytatu z autorem, [url=https://example.com] to odnośnik z własną etykietą. Parametr jest odczytywany i przenoszony do atrybutu — autor do podpisu cytatu, adres do atrybutu odnośnika.
4. Zamiana tagów bez parametru: [b] na strong, [i] na em. To najprostsze podstawienia, wykonywane w pierwszej kolejności.
5. Domknięcie struktury: [/url] zamyka ostatnio otwarty odnośnik, [/quote] zamyka cytat dopiero po wcześniejszym domknięciu tagów wewnętrznych, czyli pogrubienia i kursywy.
6. Wynik: blok cytatu z podpisem Anna, w jego treści pogrubione słowo Witaj i pochylone dzień dobry, a poniżej akapit z odnośnikiem o etykiecie Link.

Tabela zamian: tag forum i jego odpowiednik

Praktyczne wskazówki przy przenoszeniu treści z forum

• Wklejaj czysty BBCode — usuń z materiału wejściowego znaczniki HTML, bo po escapowaniu i tak zostaną pokazane jako tekst i zaśmiecą wynik. Mieszanie dwóch składni w jednym fragmencie to najczęstsza przyczyna błędów przy imporcie postów.
• Pilnuj zagnieżdżeń — struktury typu cytat w cytacie albo lista w cytacie działają tylko wtedy, gdy tagi otwierające i zamykające tworzą poprawne pary. Przed konwersją warto przejrzeć fragment i domknąć brakujące znaczniki.
• Traktuj kod jako treść dosłowną — w tagu [code] znajdują się często nawiasy kwadratowe, które wyglądają jak tagi. Taki blok powinien być wyłączony z parsowania, inaczej listing kodu rozsypie się po konwersji.
• Zachowaj podziały linii — BBCode z forów opiera się na akapitach rozdzielonych pustą linią. Jeśli wynik ma być publikowany w edytorze, sprawdź, czy pojedyncze przejścia do nowej linii nie zlewają się w jeden akapit.
• Sprawdź wynik na krótkim fragmencie — przekonwertuj najpierw jeden reprezentatywny post z pogrubieniem, odnośnikiem i cytatem. Dopiero gdy wynik wygląda poprawnie, przenoś całą partię materiału.

Czego konwersja nie uwzględnia

• Niestandardowe tagi forów — phpBB, vBulletin, IPB i XenForo mają wspólny rdzeń składni, ale dokładają własne rozszerzenia. Tagi specyficzne dla konkretnego silnika mogą pozostać w wyniku jako zwykły tekst.
• Niedomknięte pary tagów — jeśli w materiale brakuje tagu zamykającego, fragment nie zostanie zamieniony. Konwerter nie zgaduje intencji autora i nie dorysowuje brakujących znaczników.
• Atrybuty nietypowe — wartość parametru zawierająca spację, cudzysłów albo dodatkowe znaki może zostać odczytana błędnie, zwłaszcza w tagach linków i obrazów.
• Emotikony i skróty — zamiana kodu emotikony na obrazek oraz automatyczne linkowanie adresów to osobne funkcje silnika forum. Sama konwersja tagów ich nie obejmuje.
• Walidacja kodu wynikowego — narzędzie zamienia znaczniki, ale nie sprawdza, czy powstały HTML jest poprawny semantycznie ani czy nadaje się do publikacji w danym CMS.

Najczęstsze pytania