Iniziare con HTML2Text

Il modo consigliato e più semplice per installare HTML2Text è utilizzare GitHub. Per favore usa il comando seguente per un'installazione fluida.

go get jaytaylor.com/html2text

Conversione di base da HTML a testo tramite Go

La libreria open source HTML2Text semplifica per gli sviluppatori software il caricamento e la conversione di file HTML in formato testo all'interno delle loro applicazioni Go. HTML2Text non si limita a rimuovere i tag: interpreta in modo intelligente la struttura HTML per produrre un output leggibile dall'uomo con comprensione semantica di intestazioni, paragrafi e liste, preservazione dei collegamenti con gli URL visualizzati tra parentesi dopo il testo del link, normalizzazione degli spazi bianchi che mantiene la leggibilità senza interruzioni di riga eccessive, supporto della codifica dei caratteri incluso UTF-8 con BOM (Byte Order Mark). Ecco un esempio completo di utilizzo della libreria che consente di caricare e convertire HTML in formato testo all'interno delle applicazioni Go.

package main

import (
    "fmt"
    "jaytaylor.com/html2text"
)

func main() {
    html := `
        
Benvenuto al nostro servizio
        
Dai un'occhiata alla nostra pagina delle funzionalità
        per ulteriori informazioni su ciò che offriamo.
        

            
Assistenza 24/7
            
Prova gratuita
            
Piani aziendali
        
    `
    
    text, err := html2text.FromString(html, html2text.Options{})
    if err != nil {
        panic(err)
    }
    
    fmt.Println(text)
}

Rendering di tabelle con formattazione elegante

Una delle caratteristiche più distintive di HTML2Text è la sua capacità di rendere le tabelle HTML come tabelle di testo basate su ASCII. Le tabelle in testo semplice di solito diventano una confusa zuppa di dati. La funzione PrettyTables preserva la struttura tabellare usando l'arte ASCII, rendendo i dati numerici, le tabelle dei prezzi o i grafici comparativi leggibili in qualsiasi contesto. Queste sono perfette per report automatizzati inviati via email, output di strumenti da riga di comando o notifiche SMS dove la struttura dei dati è importante. Il seguente esempio di codice mostra come gli sviluppatori software possono convertire una tabella HTML in una tabella ASCII formattata usando i comandi Go.

func sendMonthlyReport(userEmail string, metricsHTML string) {
    // Convert HTML table to formatted ASCII table
    textReport, _ := html2text.FromString(metricsHTML, html2text.Options{
        PrettyTables: true, // Preserves table structure visually
    })
    
    // Even in plain text, the data remains organized:
    // +----------------+-----------+
    // | METRIC         | VALUE     |
    // +----------------+-----------+
    // | Page Views     | 24,589    |
    // | Conversion Rate| 2.4%      |
    // +----------------+-----------+
    
    sendEmail(userEmail, "Monthly Report", textReport)
}

Generazione di fallback email tramite libreria Go

Uno dei casi d'uso più comuni per HTML2Text è la conversione dei modelli di email HTML nelle loro controparti di testo semplice. I client di posta elettronica variano notevolmente nelle loro capacità di rendering HTML. Alcuni utenti attenti alla sicurezza disabilitano completamente l'HTML, mentre client più vecchi o lettori di schermo per utenti ipovedenti spesso funzionano meglio con il testo semplice. Fornire un'alternativa testuale non è solo una buona pratica—è essenziale per l'accessibilità e la consegna. Generando automaticamente versioni di testo semplice sincronizzate, garantisci che ogni destinatario possa leggere il tuo contenuto, ridurre le attivazioni dei filtri antispam e rispettare gli standard di accessibilità come WCAG.

func sendTransactionalEmail(userEmail, htmlContent string) error {
    // Generate plain text fallback
    textContent, err := html2text.FromString(htmlContent, html2text.Options{})
    if err != nil {
        return fmt.Errorf("failed to create text alternative: %v", err)
    }
    
    // Send multipart email (both HTML and text)
    email := &Email{
        To: userEmail,
        HTMLBody: htmlContent,
        TextBody: textContent, // Critical for users with HTML disabled
    }
    
    return emailService.Send(email)
}

Gestire i collegamenti durante la conversione da HTML a testo

La libreria HTML2Text ha incluso un supporto completo per la gestione dei collegamenti durante la conversione da HTML a testo. I collegamenti sono particolarmente importanti nei contenuti HTML, e html2text garantisce che sia il testo del collegamento sia l'URL vengano preservati. Il testo del collegamento viene visualizzato normalmente, mentre l'URL reale viene aggiunto tra parentesi, assicurando che i lettori della versione di testo semplice possano comunque accedere alle risorse collegate. L'esempio seguente dimostra come ottenere questo.

package main

import (
    "fmt"
    "log"
    
    "jaytaylor.com/html2text"
)

func main() {
    htmlContent := `
    
        
            
Scopri il nostro catalogo prodotti 
            o visita la nostra pagina di supporto.
        
    `
    
    text, err := html2text.FromString(htmlContent)
    if err != nil {
        log.Fatal(err)
    }
    
    fmt.Println(text)
}