Első lépések a HTML2Text használatával

A HTML2Text telepítésének ajánlott és legegyszerűbb módja a GitHub használata. Kérjük, használja a következő parancsot a zökkenőmentes telepítéshez.

go get jaytaylor.com/html2text

Alapvető HTML szöveggé konvertálás Go-val

Az nyílt forráskódú HTML2Text könyvtár megkönnyíti a szoftverfejlesztők számára, hogy HTML fájlt töltsenek be és alakítsák át szöveges formátumba Go alkalmazásaikban. A HTML2Text nem csak eltávolítja a címkéket – intelligensen értelmezi a HTML struktúráját, hogy ember által olvasható kimenetet állítson elő, szemantikus megértéssel a címsorok, bekezdések és listák tekintetében, a linkek megőrzésével, ahol az URL-ek a hivatkozás szövege után zárójelben jelennek meg, a szóközök normalizálásával, amely megőrzi az olvashatóságot túlzott sortörések nélkül, karakterkódolás támogatással, beleértve az UTF-8-at BOM-mal (Byte Order Mark). Íme egy teljes példa a könyvtár használatára, amely lehetővé teszi a HTML betöltését és átalakítását szöveges formátumba Go alkalmazásokban.

package main

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

func main() {
    html := `
        
Üdvözöljük szolgáltatásunkban
        
Nézze meg funkciók oldalát
        további információkért arról, hogy mit kínálunk.
        

            
24/7 támogatás
            
Ingyenes próba
            
Vállalati csomagok
        
    `
    
    text, err := html2text.FromString(html, html2text.Options{})
    if err != nil {
        panic(err)
    }
    
    fmt.Println(text)
}

Táblázat megjelenítése szép formázással

Az HTML2Text egyik kiemelkedő tulajdonsága, hogy képes a HTML táblázatokat ASCII-alapú szövegtáblázatokként megjeleníteni. A sima szöveges táblázatok általában összekuszálódott adatlevest eredményeznek. A PrettyTables funkció ASCII művészettel őrzi meg a táblázati struktúrát, így a numerikus adatok, árlisták vagy összehasonlító diagramok bármilyen környezetben olvashatóak. Ezek tökéletesek automatizált jelentésekhez, amelyeket e‑mailben, parancssori eszköz kimenetként vagy SMS értesítésekben küldenek, ahol az adatstruktúra fontos. Az alábbi kódrészlet bemutatja, hogyan konvertálhatják a szoftverfejlesztők a HTML táblázatot formázott ASCII táblázattá a Go parancsok segítségével.

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

E-mail tartalék generálás Go könyvtárral

Az HTML2Text egyik leggyakoribb felhasználási esete a HTML e-mail sablonok egyszerű szöveges megfelelőjévé alakítása. Az e-mail kliensek HTML megjelenítési képességei nagymértékben eltérnek. Néhány biztonságtudatos felhasználó teljesen letiltja a HTML-t, míg a régebbi kliensek vagy a látássérült felhasználók számára készült képernyőolvasók gyakran jobban működnek egyszerű szöveggel. A szöveges alternatíva biztosítása nem csak jó gyakorlat—elengedhetetlen a hozzáférhetőség és a kézbesíthetőség szempontjából. Az automatikus szinkronizált egyszerű szöveges verziók generálásával biztosítja, hogy minden címzett elolvassa a tartalmat, csökkenti a spam szűrők aktiválását, és megfelel a WCAG-hoz hasonló hozzáférhetőségi szabványoknak.

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

Hivatkozások kezelése HTML-ről szövegre konvertálás során

Az HTML2Text könyvtár teljes körű támogatást nyújt a HTML-ből szövegbe konvertálás során a hivatkozások kezeléséhez. A hivatkozások különösen fontosak a HTML tartalomban, és az html2text biztosítja, hogy a hivatkozás szövege és az URL is megmaradjon. A hivatkozás szövege normál módon jelenik meg, míg a tényleges URL zárójelben kerül hozzáadásra, ezáltal a egyszerű szöveges verzió olvasói is hozzáférhetnek a linkelt erőforrásokhoz. Az alábbi példa bemutatja, hogyan lehet ezt elérni.

package main

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

func main() {
    htmlContent := `
    
        
            
Tekintse meg a termékkatalógusunkat 
            vagy látogassa meg a támogatási oldalunkat.
        
    `
    
    text, err := html2text.FromString(htmlContent)
    if err != nil {
        log.Fatal(err)
    }
    
    fmt.Println(text)
}