Files
java-word-pdf/docs/user.md
T
Pjandro b3511f8b74 docs: сайт документации на MkDocs Material
- Контент-дерево docs/: пользователь, REST API, библиотека, архитектура,
  разработчику, эксплуатация; навигация обязательна (strict-сборка).
- docs/agent/ и docs/standards/ из сайта исключены (exclude_docs),
  ссылки на них — внешние, на Gitea.
- Javadoc публичного API core попадает на сайт как docs/apidocs (gitignored).
2026-11-22 21:39:08 +03:00

4.0 KiB

Пользователю

Где открыть

Веб-конвертер: https://pjandro.ru/pdf-converter/. Работает в любом современном браузере, установка не нужна.

Как пользоваться

  1. Перетащите файл .docx или .doc в зону загрузки (или выберите его через диалог).
  2. Документ конвертируется на сервере; результат появляется во встроенном предпросмотре PDF.
  3. Нажмите «Скачать» — PDF сохранится под именем исходного файла с расширением .pdf (кириллица в имени поддерживается).

В форме есть три переключателя («Диаграммы», «SmartArt», «OLE-объекты», по умолчанию выключены): при включённом конвертация отменится, если документ содержит соответствующие объекты, и интерфейс покажет понятное сообщение. По умолчанию диаграммы и SmartArt конвертируются в картинки всегда, а OLE-объекты тихо удаляются (картинка-плейсхолдер из документа сохраняется).

Ключ доступа

Если сервер защищён ключом доступа, при первом открытии появится экран ввода ключа. Ключ хранится в браузере (localStorage) и подставляется автоматически; при неверном ключе стирается, и экран появляется снова. Если сервер ключ не требует, экран не показывается вовсе.

Поддерживаемые форматы

Формат Что это
.docx OOXML (Word 2007 и новее), включая строгий (strict) OOXML
.doc бинарный Word 97–2003; читается собственным мостом, без Word и LibreOffice

Лимиты документа (размер, число страниц) задаёт сервер; конкретные значения зависят от развёрнутого экземпляра.

Что конвертируется точно, а что приближённо

Конвертер не является pixel-perfect рендером Word: это ограничения движка FOP/docx4j, а не упущение проекта. Текст, стили, таблицы, списки, колонтитуки, картинки, диаграммы и SmartArt воспроизводятся надёжно; раскладка, поля и некоторые эффекты могут отличаться от Word.

Символы, которых нет в шрифте ранa (например, тире «—», кавычки), берутся из fallback-семейства DejaVu с гарантированной кириллицей. Знаков, которых нет ни в одном шрифте бандла, это не касается — для них останутся пустые боксы; в эталонном наборе таких символа два (U+2188, U+218A — римские/осмы числительные, доступны только в GPL-шрифтах).

На .doc переключатели «Диаграммы/SmartArt/OLE» не срабатывают: плейсхолдеры бинарного формата — уже растры, они вставляются картинками; векторные EMF/WMF/PICT пропускаются.

Полный перечень известных расхождений — Ограничения рендера.