docs: сайт документации на MkDocs Material
- Контент-дерево docs/: пользователь, REST API, библиотека, архитектура, разработчику, эксплуатация; навигация обязательна (strict-сборка). - docs/agent/ и docs/standards/ из сайта исключены (exclude_docs), ссылки на них — внешние, на Gitea. - Javadoc публичного API core попадает на сайт как docs/apidocs (gitignored).
This commit is contained in:
@@ -0,0 +1,56 @@
|
||||
# Пользователю
|
||||
|
||||
## Где открыть
|
||||
|
||||
Веб-конвертер: **`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).
|
||||
Reference in New Issue
Block a user