HTML2Text ile Başlarken

HTML2Text'i kurmanın önerilen ve en kolay yolu GitHub kullanmaktır. Lütfen sorunsuz bir kurulum için aşağıdaki komutu kullanın.

go get jaytaylor.com/html2text

Go ile Temel HTML'den Metne Dönüştürme

Açık kaynaklı HTML2Text kütüphanesi, yazılım geliştiricilerin Go uygulamaları içinde HTML dosyasını yükleyip metin formatına dönüştürmesini kolaylaştırır. HTML2Text sadece etiketleri kaldırmakla kalmaz—HTML yapısını akıllıca yorumlayarak başlıklar, paragraflar ve listeler hakkında anlamsal anlayışa sahip, insan tarafından okunabilir bir çıktı üretir; bağlantı metninin ardından parantez içinde URL'leri göstererek bağlantı koruması sağlar, aşırı satır sonu olmadan okunabilirliği koruyan boşluk normalizasyonu yapar, UTF-8 BOM (Byte Order Mark) dahil karakter kodlaması desteği sunar. İşte kütüphaneyi kullanarak Go uygulamaları içinde HTML'yi metin formatına yükleyip dönüştüren tam bir örnek.

package main

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

func main() {
    html := `
        
Hizmetimize Hoş Geldiniz
        
Ne sunduğumuz hakkında daha fazla bilgi için özellikler sayfasına
        göz atın.
        

            
7/24 Destek
            
Free Trial
            
Enterprise Plans
        
    `
    
    text, err := html2text.FromString(html, html2text.Options{})
    if err != nil {
        panic(err)
    }
    
    fmt.Println(text)
}

Güzel Biçimlendirme ile Tablo Oluşturma

HTML2Text'in öne çıkan özelliklerinden biri, HTML tablolarını ASCII tabanlı metin tablolarına dönüştürme yeteneğidir. Düz metin tabloları genellikle karışık veri çorbasına dönüşür. PrettyTables özelliği, ASCII sanatı kullanarak tablo yapısını korur ve sayısal verileri, fiyat tablolarını veya karşılaştırma grafiklerini her bağlamda okunabilir hâle getirir. Bunlar, veri yapısının önemli olduğu e-posta ile gönderilen otomatik raporlar, komut satırı aracı çıktıları veya SMS bildirimleri için mükemmeldir. Aşağıdaki kod örneği, yazılım geliştiricilerin Go komutlarıyla HTML tablosunu biçimlendirilmiş ASCII tabloya nasıl dönüştürebileceğini gösterir.

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

Go Kütüphanesi ile E-posta Yedek Oluşturma

HTML2Text'in en yaygın kullanım senaryolarından biri, HTML e-posta şablonlarını düz metin eşdeğerlerine dönüştürmektir. E-posta istemcileri, HTML renderleme yetenekleri açısından büyük ölçüde farklılık gösterir. Güvenlik odaklı bazı kullanıcılar HTML'yi tamamen devre dışı bırakırken, eski istemciler veya görme engelli kullanıcılar için ekran okuyucular genellikle düz metinle daha iyi çalışır. Metin alternatifi sağlamak sadece iyi bir uygulama değil—erişilebilirlik ve teslim edilebilirlik için esastır. Otomatik olarak senkronize düz metin sürümleri oluşturarak, her alıcının içeriğinizi okuyabilmesini, spam filtre tetiklemelerini azaltmasını ve WCAG gibi erişilebilirlik standartlarına uymasını sağlarsınız.

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

HTML'den Metne Dönüştürürken Bağlantılarla Çalışma

HTML2Text kütüphanesi, HTML'den metne dönüşüm sırasında bağlantıların işlenmesi için tam destek eklemiştir. Bağlantılar, HTML içeriğinde özellikle önemlidir ve html2text, hem bağlantı metninin hem de URL'nin korunmasını sağlar. Bağlantı metni normal olarak görüntülenirken, gerçek URL parantez içinde eklenir; bu sayede düz metin sürümünün okuyucuları hâlâ bağlantılı kaynaklara erişebilir. Aşağıdaki örnek, bunun nasıl yapılacağını gösterir.

package main

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

func main() {
    htmlContent := `
    
        
            
Ürün kataloğumuza göz atın ürün kataloğu 
            veya destek sayfamızı ziyaret edin destek sayfası.
        
    `
    
    text, err := html2text.FromString(htmlContent)
    if err != nil {
        log.Fatal(err)
    }
    
    fmt.Println(text)
}