Chore: рабочие материалы и эталоны — в develop/ (вне git); .gitignore без упоминаний локальных артефактов
This commit is contained in:
@@ -3,6 +3,7 @@ target/
|
||||
.git/
|
||||
.codegraph/
|
||||
diff/
|
||||
/develop/
|
||||
.idea/
|
||||
*.iml
|
||||
dependency-reduced-pom.xml
|
||||
|
||||
+2
-5
@@ -18,10 +18,8 @@ wordpdf-web/dist/
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
|
||||
# Локальные примеры и выгрузки в корне
|
||||
|
||||
# Артефакты ручной калибровки диаграмм
|
||||
/diff/
|
||||
# Рабочие материалы и эталоны разработки (вне git)
|
||||
/develop/
|
||||
|
||||
# Секреты деплоя
|
||||
.env
|
||||
@@ -29,4 +27,3 @@ Thumbs.db
|
||||
# Индекс CodeGraph
|
||||
.codegraph/
|
||||
|
||||
# Выход конвертера из references/ (артефакт ручной проверки, не эталон)
|
||||
|
||||
@@ -49,7 +49,7 @@
|
||||
|
||||
### 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`).
|
||||
|
||||
@@ -69,8 +69,7 @@
|
||||
| корневой `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/`, в репо его нет |
|
||||
| `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 не подключать |
|
||||
| `diff/`, корневые `word-export.*` | gitignored артефакты ручной калибровки |
|
||||
| `develop/` (вне git) | рабочие материалы и эталон Word 365 (`word.docx` + `word.pdf`), артефакты ручной калибровки — **ручное сравнение, не фикстуры**, в тесты/jar не подключать |
|
||||
|
||||
## Development Commands
|
||||
|
||||
|
||||
@@ -160,7 +160,7 @@ docx ──> нормализация байтов ──> docx4j (Wordprocessin
|
||||
- Символы U+2000–U+2EFF (em-dash и т.п.) берутся из шрифта ранa, если в нём
|
||||
есть глиф, иначе — из fallback-семейства DejaVu.
|
||||
- Знаков, которых нет ни в одном шрифте бандла, это не касается: вместо них
|
||||
остаётся `.notdef`. В эталонном `references/word.docx` таких два — U+2188 (ↈ)
|
||||
остаётся `.notdef`. В эталонном экспорте Word (`develop/`, вне git) таких два — U+2188 (ↈ)
|
||||
и U+218A (↊), они есть только в GNU FreeSerif под GPL, а бандл держится
|
||||
целиком на SIL OFL.
|
||||
- Поддержка таблиц/изображений — базовая (через docx4j/FOP).
|
||||
|
||||
@@ -18,7 +18,7 @@ import java.util.zip.ZipOutputStream;
|
||||
* → закэшированный результат → {@code fldChar end}. Экспорт docx4j в XSL-FO
|
||||
* игнорирует {@code w:instrText} внутри такого поля и печатает кэш из docx,
|
||||
* поэтому в колонтитулах всех страниц стоит одно и то же число
|
||||
* (в references/word.docx — «2» вместо 1, 2, 3 …).
|
||||
* (в эталонном экспорте Word — «2» вместо 1, 2, 3 …).
|
||||
*
|
||||
* Собственно поле docx4j умеет: {@code w:fldSimple} обрабатывает
|
||||
* {@code FldSimpleWriter} из docx4j-export-fo, у которого есть обработчики
|
||||
|
||||
@@ -29,7 +29,7 @@ import java.util.zip.ZipOutputStream;
|
||||
* а имя шрифта — на fallback-семейство (в нём этих глифов достаточно).
|
||||
* Таблица кодов — из {@code org.docx4j.convert.out.common.writer.SymbolMapper}
|
||||
* (docx4j 17.x), отфильтрована по наличию глифа в DejaVu Sans; она же
|
||||
* сверяется с эталоном Word (references/word.pdf).
|
||||
* сверяется с эталоном Word (develop/, вне git).
|
||||
*
|
||||
* Обрабатываются оба места, где встречается символный шрифт:
|
||||
* <ul>
|
||||
|
||||
@@ -298,7 +298,7 @@ class WordPdfConverterTest {
|
||||
// Em-dash рисуется вшитым в PDF шрифтом, а не базовым неembedded
|
||||
// Helvetica. Какой именно это шрифт — решает docx4j: если в шрифте
|
||||
// ранa есть глиф U+2014, остаётся он (так же делает Word: в
|
||||
// references/word.pdf em-dash нарисовано Calibri/Times, DejaVu там
|
||||
// эталонном word.pdf (develop/) em-dash нарисовано Calibri/Times, DejaVu
|
||||
// нет вообще), иначе — fallback-семейство.
|
||||
String font = fontNameOf(pdf, '—');
|
||||
assertFalse(font.startsWith("Helvetica"),
|
||||
|
||||
+1
-1
@@ -14,7 +14,7 @@ import static org.junit.jupiter.api.Assertions.*;
|
||||
/**
|
||||
* Замена символьных шрифтов Symbol/Wingdings на Unicode + бандл-шрифт
|
||||
* (см. SymbolFontNormalizer). Коды берутся из SymbolMapper docx4j 17.x и
|
||||
* сверяются с экспортом Word (references/word.pdf).
|
||||
* сверяются с экспортом Word (develop/, вне git).
|
||||
*/
|
||||
class SymbolFontNormalizerTest {
|
||||
|
||||
|
||||
Reference in New Issue
Block a user