but keep URL unchanged. So alt becomes “Конвертировать TXT-файлы в HTML, JPG, PNG и PDF с помощью GroupDocs.Viewer для Java”. Keep the same image path.

Now produce final output.

Let’s start.

groupdocs viewer maven: Конвертировать TXT‑файлы в HTML, JPG, PNG и PDF с помощью GroupDocs.Viewer для Java

В современных Java‑приложениях groupdocs viewer maven упрощает преобразование обычных текстовых (TXT) документов в готовый к веб‑использованию HTML, изображения высокого разрешения или портативные PDF‑файлы. Независимо от того, создаёте ли вы портал документов, сервис архивирования или функцию предварительного просмотра, конвертация TXT‑файлов с помощью GroupDocs.Viewer экономит время и устраняет необходимость в пользовательских парсерах. В этом руководстве мы пройдём полный процесс настройки и покажем, как convert txt files java в HTML (одностраничный и многостраничный), JPG, PNG и PDF.

Convert TXT Files to HTML, JPG, PNG, and PDF with GroupDocs.Viewer for Java

Быстрые ответы

Какой Maven‑артефакт нужен? com.groupdocs:groupdocs-viewer (см. сниппет Maven ниже).
Можно ли рендерить многостраничный HTML? Да – используйте HtmlViewOptions.forEmbeddedResources без флага одностраничного вывода.
Нужна ли лицензия для продакшна? Триал‑версия подходит для оценки; постоянная лицензия требуется для коммерческого использования.
Какая версия Java поддерживается? Java 8 или новее (рекомендовано Java 11+).
Нужны ли дополнительные библиотеки для вывода изображений? Нет, библиотека Viewer включает поддержку JPG и PNG «из коробки».

Что такое groupdocs viewer maven?

groupdocs viewer maven – это дистрибутив GroupDocs.Viewer для Java, распространяемый через Maven. Он предоставляет простой API для рендеринга более чем 100 форматов документов — включая plain‑text — в HTML, изображения или PDF без необходимости в Microsoft Office или сторонних инструментах.

Почему стоит конвертировать txt files java?

Кроссплатформенный просмотр – HTML и изображения можно отображать в браузерах или мобильных приложениях.
Стандартизированное архивирование – PDF сохраняет форматирование и читается везде.
Удобство автоматизации – интегрируйте конвертацию в пакетные задания, облачные сервисы или CI‑конвейеры.

Предварительные требования

GroupDocs.Viewer for Java версии 25.2 или новее (поставляется через Maven).
JDK 8 + (рекомендовано Java 11 +).
IDE, например IntelliJ IDEA, Eclipse или NetBeans.
Базовые знания Java и Maven.

Настройка GroupDocs.Viewer for Java

Добавьте репозиторий и зависимость в ваш pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Шаги получения лицензии

Начните с бесплатного триала или получите временную лицензию, чтобы изучить все возможности.
Для продакшна приобретите лицензию на официальной странице покупки.

Базовая инициализация и настройка

Добавьте Maven‑зависимость, показанную выше.
Убедитесь, что ваш JDK и IDE правильно сконфигурированы.

Теперь перейдём к конкретным сценариям конвертации.

Руководство по реализации

Функция 1: Рендеринг TXT в многостраничный HTML (multi page html java)

Обзор

Этот пример преобразует TXT‑документ в многостраничный HTML, сохраняя разрывы строк на отдельных веб‑страницах.

Импорт необходимых библиотек

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

Настройка путей и Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Render the document to HTML using these options
    viewer.view(options);
}

Пояснение: HtmlViewOptions.forEmbeddedResources упаковывает CSS, шрифты и изображения непосредственно в HTML‑вывод, делая его переносимым.

Функция 2: Рендеринг TXT в одностраничный HTML (convert txt to html java)

Обзор

Сжимает весь текстовый файл в одну HTML‑страницу — идеально для быстрых превью.

Импорт необходимых библиотек

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

Настройка путей и Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result_single_page.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_2_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Set the option to render as a single page HTML
    options.setRenderToSinglePage(true);
    
    // Render the document using these options
    viewer.view(options);
}

Пояснение: setRenderToSinglePage(true) объединяет все страницы в один HTML‑файл.

Функция 3: Рендеринг TXT в JPG

Обзор

Конвертирует TXT‑файл в изображение JPEG высокого качества, удобно для публикаций на платформах, принимающих только изображения.

Импорт необходимых библиотек

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;

Настройка путей и Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.jpg");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a JPEG image
    JpgViewOptions options = new JpgViewOptions(pageFileFullPath);
    
    // Render the document as a JPG using these options
    viewer.view(options);
}

Пояснение: JpgViewOptions позволяет управлять качеством изображения, DPI и путём вывода.

Функция 4: Рендеринг TXT в PNG

Обзор

Создаёт без потерь PNG‑изображения из текстовых файлов — идеально, когда нужны чёткие масштабируемые графики.

Импорт необходимых библиотек

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

Настройка путей и Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.png");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PNG image
    PngViewOptions options = new PngViewOptions(pageFileFullPath);
    
    // Render the document as a PNG using these options
    viewer.view(options);
}

Пояснение: PNG обеспечивает безпотерьное сжатие, сохраняющее точный вид оригинального текста.

Функция 5: Рендеринг TXT в PDF (txt to pdf java / convert txt to pdf java)

Обзор

Создаёт PDF‑файл из TXT‑документа — отлично подходит для архивирования, печати или отправки клиентам.

Импорт необходимых библиотек

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;

Настройка путей и Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.pdf");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PDF
    PdfViewOptions options = new PdfViewOptions(pageFileFullPath);
    
    // Render the document as a PDF using these options
    viewer.view(options);
}

Пояснение: PdfViewOptions автоматически обрабатывает макет страниц, шрифты и внедрение ресурсов.

Практические применения

Системы управления документами: Автоматизируйте конвертацию устаревших TXT‑документов в HTML для интранет‑порталов.
Платформы публикаций: Превращайте присланные авторами TXT‑рукописи в HTML для бесшовной интеграции с CMS.
Решения по архивированию: Сохраняйте старые текстовые файлы в виде PDF или PNG для долгосрочного хранения.
Интеграция с облачными хранилищами: Конвертируйте «на лету» и сохраняйте отрендеренные файлы в AWS S3, Azure Blob или Google Cloud.

Распространённые проблемы и их решения

Проблема	Причина	Решение
Вывод пустой	Неправильный путь к файлу или отсутствие прав на чтение.	Убедитесь, что `YOUR_DOCUMENT_DIRECTORY` указывает на реальный TXT‑файл и процесс имеет права чтения.
Изображения низкого качества	По умолчанию DPI низкое.	Используйте `JpgViewOptions.setResolution(int dpi)` или `PngViewOptions.setResolution(int dpi)`, чтобы увеличить DPI (например, 300).
HTML содержит битые ссылки	Ресурсы не встроены.	Примените `HtmlViewOptions.forEmbeddedResources` или укажите пользовательскую папку ресурсов.
Исключение лицензии	Не установлена действительная лицензия.	Загрузите файл лицензии с помощью `License license = new License(); license.setLicense("path/to/license.file");` перед созданием `Viewer`.

Часто задаваемые вопросы

В: Можно ли конвертировать большие TXT‑файлы (сотни МБ) с помощью GroupDocs.Viewer?
О: Да. Библиотека потоково читает исходный файл, но для очень больших документов может потребоваться увеличить размер кучи JVM.

В: Нужны ли дополнительные зависимости для генерации JPG или PNG?
О: Нет. Пакет Viewer уже включает все необходимые библиотеки обработки изображений.

В: Можно ли настроить размер страницы PDF?
О: Конечно. Используйте PdfViewOptions.setPageSize(PageSize.A4) или любой другой PageSize перед рендерингом.

В: Как обрабатывать TXT‑файлы, защищённые паролем?
О: TXT‑файлы не поддерживают пароли. Если файл зашифрован, сначала его нужно расшифровать, а затем передать в Viewer.

В: Можно ли запускать эту конвертацию в Docker‑контейнере?
О: Да. Достаточно включить JDK, скопировать ваш pom.xml с зависимостью GroupDocs и запустить Java‑приложение внутри контейнера.

Последнее обновление: 2026-02-21
Тестировано с: GroupDocs.Viewer 25.2 for Java
Автор: GroupDocs