BBCode na HTML

BBCode na HTML to bezpłatne narzędzie, które przekształca fragmenty BBCode w surowy kod HTML do wykorzystania poza edytorami forów.

Jaki problem rozwiązuje konwersja BBCode?

Konwersja BBCode zamienia znaczniki używane na forach na kod HTML, który mogą interpretować przeglądarki, systemy zarządzania treścią i szablony stron internetowych. BBCode używa znaczników w nawiasach kwadratowych, takich jak [b], [i] i [url], zamiast elementów HTML.

Przydaje się to podczas przenoszenia wpisów z forum, debugowania treści zwracanej przez zewnętrzne API albo przygotowywania starej bazy wiedzy do użycia na platformie, która obsługuje HTML, ale nie BBCode. Może też pomóc przed wdrożeniem, gdy zaimportowany tekst trzeba sprawdzić niezależnie od otaczającego go kodu aplikacji.

BBCode nie jest jednym formalnie ustandaryzowanym językiem. Oprogramowanie forów i wtyczki mogą definiować własne znaczniki, atrybuty oraz zasady zagnieżdżania. Konwersja działająca z typowym formatowaniem może więc wymagać poprawek, jeśli materiał źródłowy zawiera konstrukcje charakterystyczne dla konkretnej platformy, na przykład pola ze spoilerami, odwołania do załączników lub niestandardowe znaczniki multimediów.

Jak przekonwertować BBCode na HTML?

Wpisz lub wklej kod źródłowy w polu BBCode, a następnie odczytaj przekonwertowany kod w polu HTML. Skopiuj go do miejsca docelowego dopiero po sprawdzeniu, czy elementy i odsyłacze odpowiadają zamierzonej treści.

1. Skopiuj cały fragment BBCode, łącznie ze znacznikami otwierającymi i zamykającymi.
2. Umieść go w polu BBCode, nie zastępując nawiasów kwadratowych.
3. Sprawdź surowy wynik w polu HTML.
4. Porównaj odsyłacze, obrazy, listy i zagnieżdżone formatowanie z oryginalnym wpisem.
5. Oczyść niezaufany wynik przed wyświetleniem go na publicznej stronie.

Konwersja odbywa się na serwerze. Wprowadzone dane są przesyłane na serwer przez HTTPS i nie są przechowywane.

Jak odczytać zwrócony kod HTML?

Traktuj wynik jako kod źródłowy, a nie wizualny podgląd. Zwrócony HTML powinien zawierać elementy odpowiadające strukturze i formatowaniu określonym w źródłowym BBCode.

Prosty przykład wygląda tak:

Dane wejściowe BBCode: [b]Release note[/b]

Wynik HTML: element HTML oznaczający tekst pogrubiony lub o dużym znaczeniu, zawierający tekst "Release note".

Inny często spotykany przykład:

Dane wejściowe BBCode: [url=https://example.org/docs]Read the docs[/url]

Wynik HTML: element odsyłacza prowadzący do https://example.org/docs i wyświetlający tekst "Read the docs".

Dokładne nazwy elementów mogą się różnić w zależności od konwertera, ponieważ dialekty BBCode nie są ustandaryzowane. Pogrubiony tekst może być na przykład reprezentowany przez element b, który wyróżnia treść bez nadawania jej dodatkowej ważności, albo element strong, wskazujący na duże znaczenie treści. Zamiast zakładać konkretne przypisanie, sprawdź rzeczywistą wartość w polu HTML.

To narzędzie służy do konwersji. Nie zastępuje walidatora HTML ani mechanizmu oczyszczania kodu. Nieoczekiwany nieprzetworzony BBCode, brakująca treść lub nieprawidłowo zagnieżdżone elementy mogą wskazywać, że źródło zawiera błędną albo nieobsługiwaną składnię. Typowe problemy to niezamknięty znacznik, znaczniki zamykające w niewłaściwej kolejności, nieprawidłowy atrybut oraz znaczniki właściwe dla konkretnego forum, które nie mają ogólnego odpowiednika w HTML.

Nietypowe dane wejściowe i różnice między dialektami

Spacje, znaki interpunkcyjne, cyfry, litery ze znakami diakrytycznymi i tekst zapisany alfabetem innym niż łaciński są zwykłą treścią, chyba że występują w składni znacznika lub atrybutu. Powinny pozostać częścią treści, a nie stać się osobnymi znacznikami. Adresy URL wymagają większej uwagi. Znaki należące do adresu, takie jak spacje, mogą wymagać kodowania procentowego. Z kolei znaki mające specjalne znaczenie w składni otaczającego je atrybutu HTML, na przykład ampersandy i cudzysłowy, mogą wymagać zapisania za pomocą encji HTML.

• Nieprawidłowe zagnieżdżenie: [b][i]Text[/b][/i] zamyka znaczniki w niewłaściwej kolejności. W prawidłowo zagnieżdżonym kodzie najpierw zamykany jest znacznik wewnętrzny.
• Brak znaczników zamykających: [quote]Text nie ma odpowiadającego mu zamknięcia, jeśli pominięto końcowy znacznik.
• Niestandardowe znaczniki: [spoiler], [video] i znaczniki załączników mogą mieć różne znaczenie w zależności od oprogramowania forum.
• Istniejący kod HTML: HTML zmieszany z BBCode może zostać zastąpiony encjami, zachowany albo potraktowany jako tekst, zależnie od parsera. Sprawdź go uważnie, zamiast zakładać, że obowiązuje jedna uniwersalna reguła.
• Bardzo długie dane wejściowe: duże migracje zwykle łatwiej przetwarzać partiami, aby można było zidentyfikować i poprawić rekordy, których konwersja się nie powiodła.

Puste dane wejściowe nie zawierają struktury formatowania, którą można przekonwertować. Jeśli źródło jest zwykłym tekstem bez znaczników BBCode, konwersja może niewiele zmienić. Dalsze przetwarzanie HTML może jednak nadal wymagać zastąpienia znaków takich jak <, > i & odpowiednimi encjami.

Kiedy konwersja nie ma sensu?

Konwersja nie ma sensu, jeśli treść będzie odczytywana wyłącznie przez system, który już obsługuje jej pierwotny dialekt BBCode. Zmiana formatu wprowadza dodatkowy etap przekształcania i może spowodować utratę niestandardowych funkcji forum.

Nie jest też potrzebna, gdy system przechowuje BBCode bez zmian, aby później wyświetlić go przy użyciu tego samego silnika forum. Podobnie upiększanie lub ręczne porządkowanie wygenerowanego HTML przynosi niewielkie korzyści, jeśli kod będzie odczytywany wyłącznie przez system, chyba że odpowiednie formatowanie jest potrzebne podczas przeglądania zmian w systemie kontroli wersji lub debugowania.

Przy migracjach masowych lepszym rozwiązaniem może być parser uruchamiany ze skryptu, ponieważ potrafi stosować te same reguły dialektu do każdego rekordu i zapisywać informacje o błędach. Używanie samych wyrażeń regularnych do zagnieżdżonych znaczników jest ryzykowne. Wybierz parser, który rozumie zagnieżdżenia i atrybuty oraz radzi sobie z nieprawidłowymi danymi wejściowymi, a następnie osobno zweryfikuj i oczyść wynikowy HTML. Jeśli przekonwertowana treść zawiera osadzoną konfigurację JSON, Walidator i upiększacz JSON może pomóc w sprawdzeniu tych danych, ale nie zweryfikuje otaczającego ich kodu HTML.

Najczęściej zadawane pytania

Czy przekonwertowany BBCode można od razu opublikować?

Nie. Kod HTML utworzony z niezaufanych wpisów na forum powinien przed wyświetleniem zostać przepuszczony przez mechanizm oczyszczający, który dopuszcza tylko elementy z listy dozwolonych. Ma to szczególne znaczenie w przypadku odsyłaczy, obrazów, osadzonych multimediów i wszelkich źródeł, które mogą już zawierać tekst przypominający HTML.

Czy podziały wierszy zostaną zamienione na akapity HTML?

Sposób obsługi podziałów wierszy zależy od parsera BBCode i reguł platformy źródłowej. Niektóre systemy traktują puste wiersze jako akapity, inne wstawiają elementy podziału wiersza albo zachowują zwykłe białe znaki. Przed przeniesieniem dużego zbioru porównaj wielowierszowy przykład z jego wyglądem na pierwotnym forum.

Czy BBCode obsługuje znaki Unicode?

BBCode może zawierać tekst Unicode, w tym litery ze znakami diakrytycznymi, emoji i tekst zapisany alfabetem innym niż łaciński, ponieważ znaki te są treścią, a nie składnią znaczników. Strona docelowa również musi używać odpowiedniego kodowania znaków, zwykle UTF-8. W przeciwnym razie po konwersji tekst może wyświetlać się nieprawidłowo.

Czy można przekonwertować BBCode w eksporcie CSV lub bazie danych?

Konwertuj wartości poszczególnych pól, a nie cały wyeksportowany plik. Cudzysłowy CSV, ograniczniki i sekwencje ucieczki bazy danych należą do formatu kontenera i mogą zostać uszkodzone po przekazaniu ich do konwertera znaczników. Zachowaj niezmienioną kopię zapasową i przetwórz małą partię, zanim zastosujesz konwersję do wszystkich wierszy.

Co sprawdzić przed zaimportowaniem HTML?

Sprawdź próbkę zawierającą zagnieżdżone formatowanie, odsyłacz, listę, odwołanie do obrazu oraz wszystkie niestandardowe znaczniki używane na forum źródłowym. Upewnij się, że system docelowy akceptuje te elementy i atrybuty HTML, a następnie przed pełnym importem wykonaj wymagane przez niego oczyszczanie lub walidację.