Chore: рабочие материалы и эталоны — в develop/ (вне git); .gitignore без упоминаний локальных артефактов
This commit is contained in:
@@ -3,6 +3,7 @@ target/
|
|||||||
.git/
|
.git/
|
||||||
.codegraph/
|
.codegraph/
|
||||||
diff/
|
diff/
|
||||||
|
/develop/
|
||||||
.idea/
|
.idea/
|
||||||
*.iml
|
*.iml
|
||||||
dependency-reduced-pom.xml
|
dependency-reduced-pom.xml
|
||||||
|
|||||||
+2
-5
@@ -18,10 +18,8 @@ wordpdf-web/dist/
|
|||||||
.DS_Store
|
.DS_Store
|
||||||
Thumbs.db
|
Thumbs.db
|
||||||
|
|
||||||
# Локальные примеры и выгрузки в корне
|
# Рабочие материалы и эталоны разработки (вне git)
|
||||||
|
/develop/
|
||||||
# Артефакты ручной калибровки диаграмм
|
|
||||||
/diff/
|
|
||||||
|
|
||||||
# Секреты деплоя
|
# Секреты деплоя
|
||||||
.env
|
.env
|
||||||
@@ -29,4 +27,3 @@ Thumbs.db
|
|||||||
# Индекс CodeGraph
|
# Индекс CodeGraph
|
||||||
.codegraph/
|
.codegraph/
|
||||||
|
|
||||||
# Выход конвертера из references/ (артефакт ручной проверки, не эталон)
|
|
||||||
|
|||||||
@@ -49,7 +49,7 @@
|
|||||||
|
|
||||||
### Chart-движок (`internal/chart`, package-private кроме `DrawingPreRenderer.run`)
|
### Chart-движок (`internal/chart`, package-private кроме `DrawingPreRenderer.run`)
|
||||||
|
|
||||||
Свой Java2D-рендер DrawingML. Калибровка surface3D зафиксирована тестами, эталон — стр. 3 gitignored `word-export.pdf` (экспорт Word, `pdftoppm -r 300`): `CAMERA_DISTANCE = 2.36` (`perspective` — НЕ угол FOV; fov≈49°), `DEPTH_RATIO = 0.705`, `HEIGHT_RATIO = 0.664`, поля `0.1485/0.116/0.146` от области построения, `rotY` берётся как `-Math.toRadians(...)` (знак обратный правому правилу), Lambert `0.92 + 0.88·dot` кламп `[0.80; 1.25]`, свет `(0.83, 0.48, 0.28)`. Цели: силуэт 314,9×65,3 pt центр (227,3; 82,3), уклон передней кромки 0.1282, аспект 0.207, шаги осей 0.0504/0.1176. Триангуляция ячейки — диагональ с большей суммой значений (седло; фиксированная диагональ даёт невидимую щепку); клиппинг полос — по треугольникам. `w01 = z[r+1][c]`, `w10 = z[r][c+1]` — перестановка закручивает квад в бабочку. `ChartRenderer.axisBounds` без явного `c:min` поднимает нижнюю границу до 0. Пустой `c:title` + `autoTitleDeleted val="0"` → автозаголовок `Chart Title` (для pie/pie3D/doughnut — имя ряда). Границы калибровки менять только вместе с тестами `Surface3dPainterTest`/`PiePainterTest`.
|
Свой Java2D-рендер DrawingML. Калибровка surface3D зафиксирована тестами, эталон — стр. 3 `develop/word-export.pdf` (ручной экспорт Word, `pdftoppm -r 300`): `CAMERA_DISTANCE = 2.36` (`perspective` — НЕ угол FOV; fov≈49°), `DEPTH_RATIO = 0.705`, `HEIGHT_RATIO = 0.664`, поля `0.1485/0.116/0.146` от области построения, `rotY` берётся как `-Math.toRadians(...)` (знак обратный правому правилу), Lambert `0.92 + 0.88·dot` кламп `[0.80; 1.25]`, свет `(0.83, 0.48, 0.28)`. Цели: силуэт 314,9×65,3 pt центр (227,3; 82,3), уклон передней кромки 0.1282, аспект 0.207, шаги осей 0.0504/0.1176. Триангуляция ячейки — диагональ с большей суммой значений (седло; фиксированная диагональ даёт невидимую щепку); клиппинг полос — по треугольникам. `w01 = z[r+1][c]`, `w10 = z[r][c+1]` — перестановка закручивает квад в бабочку. `ChartRenderer.axisBounds` без явного `c:min` поднимает нижнюю границу до 0. Пустой `c:title` + `autoTitleDeleted val="0"` → автозаголовок `Chart Title` (для pie/pie3D/doughnut — имя ряда). Границы калибровки менять только вместе с тестами `Surface3dPainterTest`/`PiePainterTest`.
|
||||||
|
|
||||||
В `DrawingPreRenderer` rels части берутся через `part.getRelationshipsPart()` (`Base`), а **не** `getOwningRelationshipPart()` — у `document.xml` последнее указывает на пакетный `.rels`. Обход `pkg.getParts()` — только по снимку списка: `createImagePart` докидывает части в тот же реестр (живой обход → `ConcurrentModificationException`).
|
В `DrawingPreRenderer` rels части берутся через `part.getRelationshipsPart()` (`Base`), а **не** `getOwningRelationshipPart()` — у `document.xml` последнее указывает на пакетный `.rels`. Обход `pkg.getParts()` — только по снимку списка: `createImagePart` докидывает части в тот же реестр (живой обход → `ConcurrentModificationException`).
|
||||||
|
|
||||||
@@ -69,8 +69,7 @@
|
|||||||
| корневой `docker-compose.dev.yml` | dev-стенд без ключа: проект `wordpdf-dev`, вход http://127.0.0.1:9011, springdoc включён |
|
| корневой `docker-compose.dev.yml` | dev-стенд без ключа: проект `wordpdf-dev`, вход http://127.0.0.1:9011, springdoc включён |
|
||||||
| корневой `.env.example` | шаблон env деплоя: ключ (`WORDPDF_API_KEY`) и лимиты входа (`WORDPDF_MAX_BYTES`/`WORDPDF_MAX_PAGES`); реальный прод `.env` живёт в `PROD-DIR/`, в репо его нет |
|
| корневой `.env.example` | шаблон env деплоя: ключ (`WORDPDF_API_KEY`) и лимиты входа (`WORDPDF_MAX_BYTES`/`WORDPDF_MAX_PAGES`); реальный прод `.env` живёт в `PROD-DIR/`, в репо его нет |
|
||||||
| `wordpdf-web/Dockerfile`, `wordpdf-web/nginx.conf` | образ SPA (node→nginx); только статика (прокси — в шлюзе); base сборки — `ARG VITE_BASE` (prod `/pdf-converter/`, дефолт `/`) |
|
| `wordpdf-web/Dockerfile`, `wordpdf-web/nginx.conf` | образ SPA (node→nginx); только статика (прокси — в шлюзе); base сборки — `ARG VITE_BASE` (prod `/pdf-converter/`, дефолт `/`) |
|
||||||
| `references/` | эталон Word 365 (`word.docx` + `word.pdf`) — **ручное сравнение, не фикстуры**, в тесты/jar не подключать |
|
| `develop/` (вне git) | рабочие материалы и эталон Word 365 (`word.docx` + `word.pdf`), артефакты ручной калибровки — **ручное сравнение, не фикстуры**, в тесты/jar не подключать |
|
||||||
| `diff/`, корневые `word-export.*` | gitignored артефакты ручной калибровки |
|
|
||||||
|
|
||||||
## Development Commands
|
## Development Commands
|
||||||
|
|
||||||
|
|||||||
@@ -160,7 +160,7 @@ docx ──> нормализация байтов ──> docx4j (Wordprocessin
|
|||||||
- Символы U+2000–U+2EFF (em-dash и т.п.) берутся из шрифта ранa, если в нём
|
- Символы U+2000–U+2EFF (em-dash и т.п.) берутся из шрифта ранa, если в нём
|
||||||
есть глиф, иначе — из fallback-семейства DejaVu.
|
есть глиф, иначе — из fallback-семейства DejaVu.
|
||||||
- Знаков, которых нет ни в одном шрифте бандла, это не касается: вместо них
|
- Знаков, которых нет ни в одном шрифте бандла, это не касается: вместо них
|
||||||
остаётся `.notdef`. В эталонном `references/word.docx` таких два — U+2188 (ↈ)
|
остаётся `.notdef`. В эталонном экспорте Word (`develop/`, вне git) таких два — U+2188 (ↈ)
|
||||||
и U+218A (↊), они есть только в GNU FreeSerif под GPL, а бандл держится
|
и U+218A (↊), они есть только в GNU FreeSerif под GPL, а бандл держится
|
||||||
целиком на SIL OFL.
|
целиком на SIL OFL.
|
||||||
- Поддержка таблиц/изображений — базовая (через docx4j/FOP).
|
- Поддержка таблиц/изображений — базовая (через docx4j/FOP).
|
||||||
|
|||||||
@@ -18,7 +18,7 @@ import java.util.zip.ZipOutputStream;
|
|||||||
* → закэшированный результат → {@code fldChar end}. Экспорт docx4j в XSL-FO
|
* → закэшированный результат → {@code fldChar end}. Экспорт docx4j в XSL-FO
|
||||||
* игнорирует {@code w:instrText} внутри такого поля и печатает кэш из docx,
|
* игнорирует {@code w:instrText} внутри такого поля и печатает кэш из docx,
|
||||||
* поэтому в колонтитулах всех страниц стоит одно и то же число
|
* поэтому в колонтитулах всех страниц стоит одно и то же число
|
||||||
* (в references/word.docx — «2» вместо 1, 2, 3 …).
|
* (в эталонном экспорте Word — «2» вместо 1, 2, 3 …).
|
||||||
*
|
*
|
||||||
* Собственно поле docx4j умеет: {@code w:fldSimple} обрабатывает
|
* Собственно поле docx4j умеет: {@code w:fldSimple} обрабатывает
|
||||||
* {@code FldSimpleWriter} из docx4j-export-fo, у которого есть обработчики
|
* {@code FldSimpleWriter} из docx4j-export-fo, у которого есть обработчики
|
||||||
|
|||||||
@@ -29,7 +29,7 @@ import java.util.zip.ZipOutputStream;
|
|||||||
* а имя шрифта — на fallback-семейство (в нём этих глифов достаточно).
|
* а имя шрифта — на fallback-семейство (в нём этих глифов достаточно).
|
||||||
* Таблица кодов — из {@code org.docx4j.convert.out.common.writer.SymbolMapper}
|
* Таблица кодов — из {@code org.docx4j.convert.out.common.writer.SymbolMapper}
|
||||||
* (docx4j 17.x), отфильтрована по наличию глифа в DejaVu Sans; она же
|
* (docx4j 17.x), отфильтрована по наличию глифа в DejaVu Sans; она же
|
||||||
* сверяется с эталоном Word (references/word.pdf).
|
* сверяется с эталоном Word (develop/, вне git).
|
||||||
*
|
*
|
||||||
* Обрабатываются оба места, где встречается символный шрифт:
|
* Обрабатываются оба места, где встречается символный шрифт:
|
||||||
* <ul>
|
* <ul>
|
||||||
|
|||||||
@@ -298,7 +298,7 @@ class WordPdfConverterTest {
|
|||||||
// Em-dash рисуется вшитым в PDF шрифтом, а не базовым неembedded
|
// Em-dash рисуется вшитым в PDF шрифтом, а не базовым неembedded
|
||||||
// Helvetica. Какой именно это шрифт — решает docx4j: если в шрифте
|
// Helvetica. Какой именно это шрифт — решает docx4j: если в шрифте
|
||||||
// ранa есть глиф U+2014, остаётся он (так же делает Word: в
|
// ранa есть глиф U+2014, остаётся он (так же делает Word: в
|
||||||
// references/word.pdf em-dash нарисовано Calibri/Times, DejaVu там
|
// эталонном word.pdf (develop/) em-dash нарисовано Calibri/Times, DejaVu
|
||||||
// нет вообще), иначе — fallback-семейство.
|
// нет вообще), иначе — fallback-семейство.
|
||||||
String font = fontNameOf(pdf, '—');
|
String font = fontNameOf(pdf, '—');
|
||||||
assertFalse(font.startsWith("Helvetica"),
|
assertFalse(font.startsWith("Helvetica"),
|
||||||
|
|||||||
+1
-1
@@ -14,7 +14,7 @@ import static org.junit.jupiter.api.Assertions.*;
|
|||||||
/**
|
/**
|
||||||
* Замена символьных шрифтов Symbol/Wingdings на Unicode + бандл-шрифт
|
* Замена символьных шрифтов Symbol/Wingdings на Unicode + бандл-шрифт
|
||||||
* (см. SymbolFontNormalizer). Коды берутся из SymbolMapper docx4j 17.x и
|
* (см. SymbolFontNormalizer). Коды берутся из SymbolMapper docx4j 17.x и
|
||||||
* сверяются с экспортом Word (references/word.pdf).
|
* сверяются с экспортом Word (develop/, вне git).
|
||||||
*/
|
*/
|
||||||
class SymbolFontNormalizerTest {
|
class SymbolFontNormalizerTest {
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user