BBCode in HTML

BBCode in HTML è uno strumento gratuito che converte frammenti di BBCode in HTML non elaborato, da usare al di fuori degli editor dei forum.

A cosa serve convertire il BBCode?

La conversione del BBCode trasforma il markup tipico dei forum in HTML interpretabile da browser, sistemi di gestione dei contenuti e modelli web. Il BBCode utilizza tag tra parentesi quadre, come [b], [i] e [url], anziché elementi HTML.

È utile per migrare i post di un forum, esaminare contenuti restituiti da un'API di terze parti o preparare una vecchia knowledge base per una piattaforma che accetta HTML ma non BBCode. Può servire anche prima della pubblicazione, quando il testo importato deve essere controllato separatamente dal codice dell'applicazione che lo contiene.

Il BBCode non è un linguaggio formalmente standardizzato. I software per forum e i relativi plug-in possono definire tag, attributi e regole di annidamento propri. Una conversione che funziona con la formattazione più comune potrebbe quindi richiedere modifiche se il contenuto di origine include elementi specifici di una piattaforma, come riquadri spoiler, riferimenti ad allegati o tag multimediali personalizzati.

Come faccio a convertire il BBCode in HTML?

Inserisci o incolla il markup di origine nel campo BBCode, quindi consulta il codice convertito nel campo HTML. Copia l'HTML nella destinazione solo dopo aver verificato che gli elementi e i link corrispondano al contenuto previsto.

1. Copia l'intero frammento di BBCode, inclusi i tag di apertura e chiusura.
2. Inseriscilo nel campo BBCode senza sostituire le parentesi quadre.
3. Esamina il risultato non elaborato nel campo HTML.
4. Confronta link, immagini, elenchi e formattazione annidata con il post originale.
5. Sanifica l'output non attendibile prima di mostrarlo in una pagina pubblica.

La conversione viene eseguita sul server. I dati inseriti vengono trasmessi al server tramite HTTPS e non vengono memorizzati.

Come si interpreta l'HTML restituito?

Leggi il risultato come codice sorgente, non come anteprima visiva. L'HTML restituito dovrebbe contenere elementi che rappresentano la struttura e la formattazione definite nel BBCode di origine.

Ecco un semplice esempio concettuale:

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

Output HTML: un elemento HTML in grassetto o strong contenente il testo "Release note".

Un altro schema comune è:

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

Output HTML: un elemento di ancoraggio con destinazione https://example.org/docs e testo visibile "Read the docs".

I nomi esatti degli elementi possono variare tra i convertitori, perché i dialetti BBCode non sono standardizzati. Per esempio, il testo in grassetto può essere rappresentato da un elemento b, che richiama l'attenzione senza indicare maggiore importanza, oppure da un elemento strong, che segnala una forte importanza. Controlla il valore effettivo nel campo HTML anziché dare per scontata una determinata corrispondenza.

Questo strumento è un convertitore, non sostituisce un validatore HTML né un sistema di sanificazione. La presenza di BBCode letterale imprevisto, contenuti mancanti o elementi annidati in modo insolito può indicare che la sintassi di origine è errata o non supportata. Tra i problemi più comuni ci sono tag non chiusi, tag di chiusura nell'ordine sbagliato, attributi non validi e tag specifici di un forum privi di un equivalente HTML generico.

Input problematici e differenze tra dialetti

Spazi, punteggiatura, numeri, lettere accentate e sistemi di scrittura non latini sono testo normale, a meno che non compaiano nella sintassi dei tag o negli attributi. Devono restare contenuto, non diventare markup separato. Gli URL richiedono maggiore attenzione: i caratteri che fanno parte dell'URL, come gli spazi, potrebbero dover essere codificati in percentuale, mentre quelli con un significato speciale nella sintassi dell'attributo HTML circostante, come la e commerciale e le virgolette, potrebbero richiedere l'escape HTML.

• Annidamento errato: [b][i]Text[/b][/i] chiude i tag nell'ordine sbagliato. In un markup annidato correttamente, il tag più interno viene chiuso per primo.
• Tag di chiusura mancanti: [quote]Text non ha il tag di chiusura corrispondente quando quello finale viene omesso.
• Tag personalizzati: [spoiler], [video] e i tag degli allegati possono avere significati diversi a seconda del software del forum.
• HTML già presente: l'HTML mescolato al BBCode può essere sottoposto a escape, mantenuto oppure trattato come testo, in base al parser. Esaminalo con attenzione anziché fare affidamento su una regola universale.
• Input molto lungo: in genere è più facile elaborare le migrazioni di grandi dimensioni in lotti, così da poter individuare e correggere i record non riusciti.

Un input vuoto non contiene alcuna struttura di formattazione da convertire. Se l'origine è testo semplice senza tag BBCode, la conversione potrebbe offrire pochi vantaggi. La successiva gestione dell'HTML potrebbe comunque richiedere l'escape di caratteri come <, > e &.

Quando non conviene effettuare la conversione?

Non conviene convertire il contenuto se verrà letto esclusivamente da un sistema che comprende già il dialetto BBCode originale. Cambiare formato aggiunge un ulteriore passaggio di trasformazione e può eliminare comportamenti personalizzati del forum.

La conversione è superflua anche quando un sistema memorizza il BBCode senza modificarlo per visualizzarlo in seguito con lo stesso motore del forum. Allo stesso modo, formattare o riorganizzare manualmente l'HTML generato offre pochi vantaggi se verrà letto soltanto da una macchina, a meno che la formattazione non serva per le revisioni nel controllo di versione o per il debug.

Per le migrazioni in blocco può essere più adatto un parser eseguito tramite script, perché applica le stesse regole del dialetto a ogni record e registra gli errori. Affidarsi soltanto alle espressioni regolari è rischioso con il markup annidato. Usa un parser che gestisca annidamento, attributi e input non validi, quindi valida e sanifica separatamente l'HTML risultante. Se il contenuto convertito include configurazioni JSON incorporate, il Validatore e abbellitore JSON può aiutarti a esaminare quei dati, ma non convalida l'HTML che li circonda.

Domande frequenti

Posso pubblicare direttamente il BBCode convertito?

No. Prima della visualizzazione, l'HTML prodotto da post di forum non attendibili deve essere elaborato da un sistema di sanificazione HTML basato su un elenco di elementi consentiti. Questo è particolarmente importante per link, immagini, contenuti multimediali incorporati e qualsiasi origine che possa già contenere testo simile a HTML.

Le interruzioni di riga diventano paragrafi HTML?

La gestione delle interruzioni di riga dipende dal parser BBCode e dalle regole della piattaforma di origine. Alcuni sistemi interpretano le righe vuote come paragrafi, mentre altri inseriscono elementi di interruzione di riga o conservano i semplici spazi bianchi. Prima di migrare una raccolta di grandi dimensioni, confronta un esempio su più righe con la visualizzazione del forum originale.

Il BBCode supporta i caratteri Unicode?

Il BBCode può contenere testo Unicode, compresi caratteri accentati, emoji e sistemi di scrittura non latini, perché questi caratteri fanno parte del contenuto e non della sintassi dei tag. Anche la pagina di destinazione deve usare una codifica dei caratteri adeguata, normalmente UTF-8, altrimenti il testo potrebbe essere visualizzato in modo errato dopo la conversione.

Posso convertire il BBCode contenuto in un CSV o nell'esportazione di un database?

Converti i valori dei campi, non l'intero file esportato. Virgolette CSV, delimitatori e sequenze di escape del database appartengono al formato contenitore e possono danneggiarsi se vengono elaborati da un convertitore di markup. Conserva una copia di backup senza modifiche ed elabora un piccolo lotto prima di applicare la conversione a ogni riga.

Cosa devo controllare prima di importare l'HTML?

Controlla un esempio che contenga formattazione annidata, un link, un elenco, un riferimento a un'immagine e gli eventuali tag personalizzati usati dal forum di origine. Verifica che la destinazione accetti quegli elementi e attributi HTML, quindi esegui il passaggio di sanificazione o convalida richiesto prima dell'importazione completa.