Ξεκινώντας με το HTML2Text

Ο συνιστώμενος και πιο εύκολος τρόπος για την εγκατάσταση του HTML2Text είναι μέσω του GitHub. Παρακαλώ χρησιμοποιήστε την παρακάτω εντολή για μια ομαλή εγκατάσταση.

go get jaytaylor.com/html2text

Βασική μετατροπή HTML σε κείμενο μέσω Go

Η ανοιχτού κώδικα βιβλιοθήκη HTML2Text καθιστά εύκολο για τους προγραμματιστές λογισμικού να φορτώνουν και να μετατρέπουν αρχεία HTML σε μορφή κειμένου μέσα στις εφαρμογές Go. Η HTML2Text δεν αφαιρεί μόνο τις ετικέτες· ερμηνεύει έξυπνα τη δομή του HTML για να παράγει έξοδο ευανάγνωστη από άνθρωπο με σημασιολογική κατανόηση των επικεφαλίδων, παραγράφων και λιστών, διατήρηση συνδέσμων με τις διευθύνσεις URL να εμφανίζονται σε παρενθέσεις μετά το κείμενο του συνδέσμου, κανονικοποίηση λευκού χώρου που διατηρεί την αναγνωσιμότητα χωρίς υπερβολικές αλλαγές γραμμής, υποστήριξη κωδικοποίησης χαρακτήρων συμπεριλαμβανομένου του UTF-8 με BOM (Byte Order Mark). Ακολουθεί ένα πλήρες παράδειγμα χρήσης της βιβλιοθήκης που επιτρέπει τη φόρτωση και μετατροπή HTML σε μορφή κειμένου μέσα σε εφαρμογές Go.

package main

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

func main() {
    html := `
        
Καλώς ήρθατε στην υπηρεσία μας
        
Δείτε τη σελίδα χαρακτηριστικών
        για περισσότερες πληροφορίες σχετικά με ό,τι προσφέρουμε.
        

            
Υποστήριξη 24/7
            
Δωρεάν Δοκιμή
            
Σχέδια Επιχείρησης
        
    `
    
    text, err := html2text.FromString(html, html2text.Options{})
    if err != nil {
        panic(err)
    }
    
    fmt.Println(text)
}

Απόδοση πίνακα με ωραία μορφοποίηση

Ένα από τα πιο αξιοσημείωτα χαρακτηριστικά του HTML2Text είναι η ικανότητά του να αποδίδει πίνακες HTML ως πίνακες κειμένου βασισμένους σε ASCII. Οι πίνακες σε απλό κείμενο συνήθως γίνονται ένα ακατάστατο μίγμα δεδομένων. Η λειτουργία PrettyTables διατηρεί τη δομή των πινάκων χρησιμοποιώντας τέχνη ASCII, καθιστώντας τα αριθμητικά δεδομένα, τους πίνακες τιμών ή τα διαγράμματα σύγκρισης αναγνώσιμα σε οποιοδήποτε πλαίσιο. Αυτά είναι ιδανικά για αυτοματοποιημένες αναφορές που αποστέλλονται μέσω email, έξοδο εργαλείων γραμμής εντολών ή ειδοποιήσεις SMS όπου η δομή των δεδομένων έχει σημασία. Το παρακάτω παράδειγμα κώδικα δείχνει πώς οι προγραμματιστές λογισμικού μπορούν να μετατρέψουν έναν πίνακα HTML σε μορφοποιημένο πίνακα ASCII χρησιμοποιώντας εντολές 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)
}

Δημιουργία εναλλακτικού email μέσω της βιβλιοθήκης Go

Μία από τις πιο κοινές περιπτώσεις χρήσης του HTML2Text είναι η μετατροπή προτύπων email σε HTML σε αντίστοιχες εκδόσεις απλού κειμένου. Οι πελάτες email διαφέρουν σημαντικά στις δυνατότητες απόδοσης HTML. Ορισμένοι χρήστες που δίνουν έμφαση στην ασφάλεια απενεργοποιούν εντελώς το HTML, ενώ παλαιότεροι πελάτες ή προγράμματα ανάγνωσης οθόνης για άτομα με προβλήματα όρασης συχνά λειτουργούν καλύτερα με απλό κείμενο. Η παροχή εναλλακτικού κειμένου δεν είναι μόνο καλή πρακτική — είναι απαραίτητη για την προσβασιμότητα και τη δυνατότητα παράδοσης. Με την αυτόματη δημιουργία συγχρονισμένων εκδόσεων απλού κειμένου, εξασφαλίζετε ότι κάθε παραλήπτης μπορεί να διαβάσει το περιεχόμενό σας, μειώνετε τις ενεργοποιήσεις των φίλτρων ανεπιθύμητης αλληλογραφίας και συμμορφώνεστε με πρότυπα προσβασιμότητας όπως το 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)
}

Διαχείριση συνδέσμων κατά τη μετατροπή HTML σε κείμενο

Η βιβλιοθήκη HTML2Text περιλαμβάνει πλήρη υποστήριξη για τη διαχείριση συνδέσμων κατά τη μετατροπή από HTML σε κείμενο. Οι σύνδεσμοι είναι ιδιαίτερα σημαντικοί στο περιεχόμενο HTML, και το html2text εξασφαλίζει ότι τόσο το κείμενο του συνδέσμου όσο και η διεύθυνση URL διατηρούνται. Το κείμενο του συνδέσμου εμφανίζεται κανονικά, ενώ η πραγματική URL προστίθεται σε παρενθέσεις, διασφαλίζοντας ότι οι αναγνώστες της έκδοσης απλού κειμένου μπορούν ακόμη να έχουν πρόσβαση στους συνδεδεμένους πόρους. Το παρακάτω παράδειγμα δείχνει πώς να το επιτύχετε.

package main

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

func main() {
    htmlContent := `
    
        
            
Δείτε τον κατάλογο προϊόντων 
            ή επισκεφθείτε τη σελίδα υποστήριξης.
        
    `
    
    text, err := html2text.FromString(htmlContent)
    if err != nil {
        log.Fatal(err)
    }
    
    fmt.Println(text)
}