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

57 lines
4.0 KiB
Markdown

# Пользователю
## Где открыть
Веб-конвертер: **`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
пропускаются.
Полный перечень известных расхождений — [Ограничения рендера](architecture/limitations.md).