Kom i gang med HTML2Text

Den anbefalte og enkleste måten å installere HTML2Text på er via GitHub. Vennligst bruk følgende kommando for en smidig installasjon.

go get jaytaylor.com/html2text

Grunnleggende HTML til tekst konvertering via Go

Det åpne kildekodebiblioteket HTML2Text gjør det enkelt for programvareutviklere å laste inn og konvertere HTML-filer til tekstformat i sine Go‑applikasjoner. HTML2Text fjerner ikke bare tagger – den tolker HTML‑strukturen intelligent for å produsere menneskelig lesbar output med semantisk forståelse av overskrifter, avsnitt og lister, bevaring av lenker med URL‑er vist i parentes etter lenketeksten, normalisering av mellomrom som opprettholder lesbarhet uten overdrevne linjeskift, og støtte for tegnkoding inkludert UTF‑8 med BOM (Byte Order Mark). Her er et komplett eksempel på hvordan du bruker biblioteket for å laste inn og konvertere HTML til tekstformat i Go‑applikasjoner.

package main

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

func main() {
    html := `
        
Velkommen til vår tjeneste
        
Sjekk ut vår funksjonsside
        for mer informasjon om hva vi tilbyr.
        

            
24/7 support
            
Gratis prøveperiode
            
Bedriftsplaner
        
    `
    
    text, err := html2text.FromString(html, html2text.Options{})
    if err != nil {
        panic(err)
    }
    
    fmt.Println(text)
}

Tabellgjengivelse med pen formatering

En av de mest fremtredende funksjonene i HTML2Text er evnen til å gjengi HTML‑tabeller som ASCII‑baserte teksttabeller. Tabeller i ren tekst blir vanligvis en rotete datasuppe. PrettyTables‑funksjonen bevarer tabellstrukturen ved hjelp av ASCII‑kunst, noe som gjør numeriske data, pristabeller eller sammenligningsdiagrammer lesbare i enhver kontekst. Disse er perfekte for automatiserte rapporter sendt via e‑post, kommandolinjeverktøyets utdata eller SMS‑varsler der datastrukturen er viktig. Følgende kodeeksempel viser hvordan programvareutviklere kan konvertere en HTML‑tabell til en formatert ASCII‑tabell ved hjelp av Go‑kommandoer.

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)
}

Generering av e‑postfallback via Go‑bibliotek

En av de mest vanlige bruksområdene for HTML2Text er å konvertere HTML‑e‑postmaler til deres ren‑tekst‑ekvivalenter. E‑postklienter varierer sterkt i sine HTML‑gjengivelsesmuligheter. Noen sikkerhetsbevisste brukere deaktiverer HTML helt, mens eldre klienter eller skjermlesere for synshemmede ofte fungerer bedre med ren tekst. Å tilby et tekstalternativ er ikke bare god praksis—det er essensielt for tilgjengelighet og leveringsdyktighet. Ved automatisk å generere synkroniserte ren‑tekst‑versjoner, sikrer du at hver mottaker kan lese innholdet ditt, reduserer utløsere for spamfiltre, og overholder tilgjengelighetsstandarder som 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)
}

Arbeide med lenker under HTML til tekst

HTML2Text‑biblioteket har inkludert full støtte for håndtering av lenker under HTML‑til‑tekst‑konvertering. Lenker er spesielt viktige i HTML‑innhold, og html2text sørger for at både lenketeksten og URL‑en blir bevart. Lenketeksten vises normalt, mens den faktiske URL‑en legges til i parentes, slik at lesere av ren‑tekst‑versjonen fortsatt kan få tilgang til de lenkede ressursene. Følgende eksempel demonstrerer hvordan man oppnår dette.

package main

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

func main() {
    htmlContent := `
    
        
            
Check out our produktkatalog 
            or visit our supportside.
        
    `
    
    text, err := html2text.FromString(htmlContent)
    if err != nil {
        log.Fatal(err)
    }
    
    fmt.Println(text)
}