Початок роботи з 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‑мистецтва, роблячи числові дані, прайс‑таблиці або діаграми порівняння читабельними в будь‑якому контексті. Це ідеально підходить для автоматизованих звітів, що надсилаються електронною поштою, виводу інструментів командного рядка або 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)
}

Генерація резервного електронного листа за допомогою бібліотеки Go

Одним із найпоширеніших випадків використання HTML2Text є перетворення HTML‑шаблонів електронних листів у їхні текстові еквіваленти. Клієнти електронної пошти дуже різняться у можливостях рендерингу 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)
}