b3511f8b74
- Контент-дерево docs/: пользователь, REST API, библиотека, архитектура, разработчику, эксплуатация; навигация обязательна (strict-сборка). - docs/agent/ и docs/standards/ из сайта исключены (exclude_docs), ссылки на них — внешние, на Gitea. - Javadoc публичного API core попадает на сайт как docs/apidocs (gitignored).
57 lines
4.0 KiB
Markdown
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).
|