Mula Menggunakan HTML2Text

Kaedah yang disyorkan dan paling mudah untuk memasang HTML2Text ialah menggunakan GitHub. Sila gunakan perintah berikut untuk pemasangan yang lancar.

go get jaytaylor.com/html2text

Penukaran Asas HTML ke Teks melalui Go

Perpustakaan sumber terbuka HTML2Text memudahkan pembangun perisian memuat dan menukar fail HTML kepada format teks dalam aplikasi Go mereka. HTML2Text tidak hanya menghilangkan tag—ia secara bijak mentafsir struktur HTML untuk menghasilkan output yang boleh dibaca manusia dengan pemahaman Semantik terhadap tajuk, perenggan, dan senarai, pemeliharaan pautan dengan URL dipaparkan dalam kurungan selepas teks pautan, normalisasi ruang putih yang mengekalkan kebolehbacaan tanpa baris baru yang berlebihan, sokongan pengekodan aksara termasuk UTF-8 dengan BOM (Byte Order Mark). Berikut ialah contoh lengkap penggunaan perpustakaan yang membolehkan memuat dan menukar HTML kepada format teks dalam aplikasi Go.

package main

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

func main() {
    html := `
        
Selamat Datang ke Perkhidmatan Kami
        
Lihat halaman ciri
        untuk maklumat lanjut tentang apa yang kami tawarkan.
        

            
Sokongan 24/7
            
Percubaan Percuma
            
Pelan Perusahaan
        
    `
    
    text, err := html2text.FromString(html, html2text.Options{})
    if err != nil {
        panic(err)
    }
    
    fmt.Println(text)
}

Paparan Jadual dengan Pemformatan Cantik

Salah satu ciri menonjol HTML2Text ialah keupayaannya untuk memaparkan jadual HTML sebagai jadual teks berasaskan ASCII. Jadual dalam teks biasa biasanya menjadi sup data yang bersepah. Ciri PrettyTables mengekalkan struktur tabular menggunakan seni ASCII, menjadikan data numerik, jadual harga, atau carta perbandingan dapat dibaca dalam apa jua konteks. Ia sesuai untuk laporan automatik yang dihantar melalui e-mel, output alat baris perintah, atau notifikasi SMS di mana struktur data penting. Contoh kod berikut menunjukkan bagaimana pemaju perisian boleh menukar jadual HTML kepada jadual ASCII yang diformat menggunakan arahan 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)
}

Penjanaan Sokongan E-mel melalui Perpustakaan Go

Salah satu kegunaan paling umum untuk HTML2Text ialah menukar templat e-mel HTML kepada setara teks biasa mereka. Klien e-mel berbeza-beza dalam keupayaan rendering HTML mereka. Sesetengah pengguna yang mementingkan keselamatan mematikan HTML sepenuhnya, manakala klien lama atau pembaca skrin untuk pengguna yang mempunyai kecacatan penglihatan sering berfungsi lebih baik dengan teks biasa. Menyediakan alternatif teks bukan sekadar amalan baik—ia penting untuk kebolehcapaian dan penghantaran. Dengan menjana versi teks biasa yang diselaraskan secara automatik, anda memastikan setiap penerima dapat membaca kandungan anda, mengurangkan pencetus penapis spam, dan mematuhi piawaian kebolehcapaian seperti 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)
}

Bekerja dengan Pautan semasa Penukaran HTML ke Teks

Pustaka HTML2Text telah menyertakan sokongan lengkap untuk mengendalikan pautan dalam penukaran HTML kepada teks. Pautan sangat penting dalam kandungan HTML, dan html2text memastikan kedua-dua teks pautan dan URL dipelihara. Teks pautan dipaparkan secara normal, manakala URL sebenar ditambahkan dalam kurungan, memastikan pembaca versi teks biasa masih dapat mengakses sumber yang dipautkan. Contoh berikut menunjukkan cara untuk mencapainya.

package main

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

func main() {
    htmlContent := `
    
        
            
Lihat katalog produk kami katalog produk 
            atau lawati halaman sokongan.
        
    `
    
    text, err := html2text.FromString(htmlContent)
    if err != nil {
        log.Fatal(err)
    }
    
    fmt.Println(text)
}