Compare commits
140 Commits
1d5601d29c
...
docs-site
| Author | SHA1 | Date | |
|---|---|---|---|
| b558fe1c30 | |||
| 187938c4db | |||
| 0e9266450c | |||
| b3511f8b74 | |||
| ae7c8b755a | |||
| fca253b9f5 | |||
| e308db47da | |||
| f3ff218686 | |||
| 202e4ca97e | |||
| fa45b7a8be | |||
| 1c8f6e1516 | |||
| 9d4661be3f | |||
| 67f8636b0c | |||
| 08c68305be | |||
| f7304094ec | |||
| e6a8b86583 | |||
| d44eac683a | |||
| aaad5d2bb0 | |||
| 334e6a9006 | |||
| 72cc717056 | |||
| 0b2dda8caa | |||
| d8eda0a2e4 | |||
| e9abcd38c8 | |||
| 5631c9e0c0 | |||
| 13ca7425a3 | |||
| af5d09e001 | |||
| 8a8e8a9f84 | |||
| 41b4f89e74 | |||
| 8b16d64059 | |||
| 638e28c653 | |||
| d8353aab61 | |||
| 8d2fa3dad9 | |||
| 2116ec43a4 | |||
| bc98a12421 | |||
| 8061a2fbe7 | |||
| f41ac54072 | |||
| 2dce945614 | |||
| 3dd770c542 | |||
| 4b79d3a1ef | |||
| ba755e8ac0 | |||
| 1ecaa9e959 | |||
| 30aba6bb45 | |||
| 1f00512a66 | |||
| 33d829a22d | |||
| c920cac7bf | |||
| eabc2b0e0d | |||
| de9995bba3 | |||
| 0a08d12b33 | |||
| 341971dbb7 | |||
| bb1b40db5c | |||
| 814eef86f4 | |||
| 07028d1509 | |||
| 230fe233c0 | |||
| 1dbb5f12da | |||
| 6d0ada328e | |||
| 402cc27fed | |||
| 8d5a19491e | |||
| ffe03accd1 | |||
| fe693efcb0 | |||
| f3f3db342f | |||
| ef3feaa94d | |||
| abfa673b85 | |||
| 9dd852a90b | |||
| 74a15ecbfb | |||
| dfd9a9277a | |||
| 93e342f105 | |||
| e929c6ade7 | |||
| 8de839f375 | |||
| 5db9d4368c | |||
| ddbd8f8fd9 | |||
| 8cd6079170 | |||
| 68e4f41cb2 | |||
| 9082d2624d | |||
| a06b988e83 | |||
| f698354817 | |||
| 86a2d761d7 | |||
| 1f37931f86 | |||
| b1adc91606 | |||
| 7ffafefd27 | |||
| b708772227 | |||
| 60c60ba9ec | |||
| b29972fbf8 | |||
| c67786151c | |||
| 89e76be289 | |||
| fba9a492f0 | |||
| e5de09d5e1 | |||
| bab12c0b79 | |||
| bd6057a262 | |||
| 461e66a2ae | |||
| ab8ea495a8 | |||
| 5beca8a61d | |||
| 8523d9da24 | |||
| eec35b7600 | |||
| 169be786a4 | |||
| 75ebd256a7 | |||
| 5d8455e825 | |||
| 1f2c63f7c5 | |||
| ddb41ab620 | |||
| 922bc915ba | |||
| 90e3b8040b | |||
| 7f0c7f1b73 | |||
| ce3fc813ce | |||
| 3d77cc5034 | |||
| c7af4185cc | |||
| 03213dceb4 | |||
| 153ae17d5d | |||
| ae63892c71 | |||
| fbdada1fda | |||
| 6ab732b1b4 | |||
| 179a2e5258 | |||
| 4a0cd6a9b3 | |||
| 5714bc835b | |||
| e356c36e45 | |||
| 086199f734 | |||
| a67a16851c | |||
| 166bd43ba7 | |||
| ef2656a364 | |||
| 114b1fe2ee | |||
| 05c8cd33d8 | |||
| f4b92f2140 | |||
| 50447aa9d0 | |||
| 41fe926ba0 | |||
| 8cbe88fdec | |||
| b9ce970d26 | |||
| f702b704ca | |||
| 3886b152e0 | |||
| 8a07597d4c | |||
| dfa6135701 | |||
| 037474cf5b | |||
| 4ab6cf8463 | |||
| 93ec325aa6 | |||
| 62ae5ee164 | |||
| b768715363 | |||
| 4bc2334b78 | |||
| 6b2715f1c2 | |||
| dff143d92e | |||
| 1d5486f4c7 | |||
| 6c02718624 | |||
| 2e06189bfb | |||
| a5922ea4ae |
@@ -0,0 +1,20 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!--
|
||||||
|
Maven-зеркало через Nexus: URL берётся из переменной окружения MAVEN_MIRROR_URL —
|
||||||
|
координаты стенда в репозитории не хранятся (в CI — Gitea Actions Variable,
|
||||||
|
в Containerfile — build-arg, локально — literal URL в ~/.m2/settings.xml).
|
||||||
|
mirrorOf="*" перехватывает все репозитории (кастомных <repositories> в pom'ах нет)
|
||||||
|
и срабатывает раньше штатного maven-default-http-blocker (Maven >= 3.8.1 блокирует
|
||||||
|
http://): пользовательский mirror матчится первым. Проверено на 3.9.9/3.9.16.
|
||||||
|
-->
|
||||||
|
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
|
||||||
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||||
|
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd">
|
||||||
|
<mirrors>
|
||||||
|
<mirror>
|
||||||
|
<id>nexus-mirror</id>
|
||||||
|
<mirrorOf>*</mirrorOf>
|
||||||
|
<url>${env.MAVEN_MIRROR_URL}</url>
|
||||||
|
</mirror>
|
||||||
|
</mirrors>
|
||||||
|
</settings>
|
||||||
@@ -10,3 +10,7 @@ dependency-reduced-pom.xml
|
|||||||
wordpdf-web/node_modules
|
wordpdf-web/node_modules
|
||||||
wordpdf-web/dist
|
wordpdf-web/dist
|
||||||
.env
|
.env
|
||||||
|
.venv/
|
||||||
|
/.mise/
|
||||||
|
__pycache__/
|
||||||
|
.pytest_cache/
|
||||||
|
|||||||
+200
-54
@@ -11,26 +11,99 @@ jobs:
|
|||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v5
|
- uses: actions/checkout@v5
|
||||||
|
|
||||||
- name: Setup JDK 21
|
- name: Check maven mirror var
|
||||||
uses: actions/setup-java@v5
|
env:
|
||||||
with:
|
MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }}
|
||||||
java-version: '21'
|
|
||||||
distribution: 'temurin'
|
|
||||||
|
|
||||||
- name: Cache Maven repository
|
|
||||||
uses: actions/cache@v4
|
|
||||||
with:
|
|
||||||
path: ~/.m2/repository
|
|
||||||
key: maven-${{ hashFiles('pom.xml', 'wordpdf-core/pom.xml', 'wordpdf-app/pom.xml') }}
|
|
||||||
restore-keys: maven-
|
|
||||||
|
|
||||||
- name: Setup Maven 3.9.16
|
|
||||||
run: |
|
run: |
|
||||||
curl -fsSL https://dlcdn.apache.org/maven/maven-3/3.9.16/binaries/apache-maven-3.9.16-bin.tar.gz | tar xz -C /opt
|
[ -n "$MAVEN_MIRROR_URL" ] || {
|
||||||
echo "/opt/apache-maven-3.9.16/bin" >> "$GITHUB_PATH"
|
echo "Задайте Actions Variable MAVEN_MIRROR_URL — см. GITEA-vars.md" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
- name: Build and test (PMD gate included)
|
- name: Build and test without fontconfig (PMD+JaCoCo included)
|
||||||
run: mvn -B clean verify
|
env:
|
||||||
|
MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }}
|
||||||
|
run: |
|
||||||
|
DOCKER_BUILDKIT=0 docker build \
|
||||||
|
-f Containerfile.test \
|
||||||
|
--build-arg MAVEN_MIRROR_URL="$MAVEN_MIRROR_URL" \
|
||||||
|
-t wordpdf-verify:ci \
|
||||||
|
.
|
||||||
|
|
||||||
|
- name: Extract JaCoCo reports
|
||||||
|
if: always()
|
||||||
|
run: |
|
||||||
|
id=$(docker create wordpdf-verify:ci 2>/dev/null) || {
|
||||||
|
echo "образ не собран — сводка покрытия будет пустой"
|
||||||
|
exit 0
|
||||||
|
}
|
||||||
|
mkdir -p wordpdf-core/target/site/jacoco wordpdf-app/target/site/jacoco
|
||||||
|
docker cp "$id:/build/wordpdf-core/target/site/jacoco/jacoco.xml" \
|
||||||
|
wordpdf-core/target/site/jacoco/jacoco.xml || true
|
||||||
|
docker cp "$id:/build/wordpdf-app/target/site/jacoco/jacoco.xml" \
|
||||||
|
wordpdf-app/target/site/jacoco/jacoco.xml || true
|
||||||
|
docker rm "$id" >/dev/null
|
||||||
|
|
||||||
|
- name: Coverage summary
|
||||||
|
if: always()
|
||||||
|
run: |
|
||||||
|
python3 - <<'PY' > coverage-summary.md
|
||||||
|
import os
|
||||||
|
import xml.etree.ElementTree as ET
|
||||||
|
def pct(root, kind):
|
||||||
|
for c in root.findall("counter"):
|
||||||
|
if c.get("type") == kind:
|
||||||
|
missed, covered = int(c.get("missed")), int(c.get("covered"))
|
||||||
|
return f"{100.0 * covered / (missed + covered):.1f}%"
|
||||||
|
return "—"
|
||||||
|
print("<!-- jacoco-coverage -->")
|
||||||
|
print("## Покрытие (JaCoCo)\n")
|
||||||
|
print("| Модуль | Строки | Ветви | Порог строк |")
|
||||||
|
print("|---|---|---|---|")
|
||||||
|
for m in ("wordpdf-core", "wordpdf-app"):
|
||||||
|
p = f"{m}/target/site/jacoco/jacoco.xml"
|
||||||
|
if not os.path.exists(p):
|
||||||
|
print(f"| {m} | нет данных | — | 90% |")
|
||||||
|
continue
|
||||||
|
r = ET.parse(p).getroot()
|
||||||
|
print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |")
|
||||||
|
PY
|
||||||
|
cat coverage-summary.md >> "$GITHUB_STEP_SUMMARY"
|
||||||
|
|
||||||
|
# Таблица покрытия — комментарием в PR: видно в обсуждении, не открывая run.
|
||||||
|
# Повторные push обновляют тот же комментарий (поиск по маркеру),
|
||||||
|
# github.token — task-токен раннера, падение не валит job. Артефактов с
|
||||||
|
# отчётами НЕТ намеренно: upload-artifact@v4 Gitea не поддерживает, @v3 на
|
||||||
|
# этом стенде висит на загрузке (отменена и с 153 файлами, и с одним zip);
|
||||||
|
# HTML — локально в target/site/jacoco. Шаг байт-в-байт одинаков в обоих
|
||||||
|
# workflow, в main.yml if не срабатывает — нет PR-события
|
||||||
|
- name: Comment coverage on PR
|
||||||
|
if: always() && github.event_name == 'pull_request'
|
||||||
|
continue-on-error: true
|
||||||
|
env:
|
||||||
|
GITEA_TOKEN: ${{ github.token }}
|
||||||
|
API: ${{ github.api_url }}
|
||||||
|
REPO: ${{ github.repository }}
|
||||||
|
PR_NUMBER: ${{ github.event.pull_request.number }}
|
||||||
|
run: |
|
||||||
|
[ -s coverage-summary.md ] || exit 0
|
||||||
|
python3 - <<'PY'
|
||||||
|
import json, os, urllib.request
|
||||||
|
api, repo, pr = os.environ["API"], os.environ["REPO"], os.environ["PR_NUMBER"]
|
||||||
|
token = os.environ["GITEA_TOKEN"]
|
||||||
|
body = open("coverage-summary.md").read()
|
||||||
|
def req(method, url, payload=None):
|
||||||
|
data = json.dumps(payload).encode() if payload is not None else None
|
||||||
|
r = urllib.request.Request(url, data=data, method=method,
|
||||||
|
headers={"Authorization": f"token {token}",
|
||||||
|
"Content-Type": "application/json"})
|
||||||
|
return json.loads(urllib.request.urlopen(r).read() or "null")
|
||||||
|
base = f"{api}/repos/{repo}/issues/{pr}/comments"
|
||||||
|
existing = next((c["id"] for c in req("GET", base)
|
||||||
|
if "<!-- jacoco-coverage -->" in c.get("body", "")), None)
|
||||||
|
req("PATCH" if existing else "POST",
|
||||||
|
f"{base}/{existing}" if existing else base, {"body": body})
|
||||||
|
PY
|
||||||
|
|
||||||
web:
|
web:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
@@ -56,9 +129,51 @@ jobs:
|
|||||||
working-directory: wordpdf-web
|
working-directory: wordpdf-web
|
||||||
run: npm run lint
|
run: npm run lint
|
||||||
|
|
||||||
images:
|
images-app:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
needs: [java, web]
|
needs: java
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v5
|
||||||
|
|
||||||
|
- name: Check registry vars and secret
|
||||||
|
env:
|
||||||
|
REGISTRY: ${{ vars.REGISTRY }}
|
||||||
|
MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }}
|
||||||
|
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
|
||||||
|
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
|
||||||
|
run: |
|
||||||
|
[ -n "$REGISTRY" ] && [ -n "$MAVEN_MIRROR_URL" ] && [ -n "$REGISTRY_USER" ] && [ -n "$REGISTRY_PASSWORD" ] || {
|
||||||
|
echo "Задайте Actions Variables REGISTRY/MAVEN_MIRROR_URL и Secrets REGISTRY_USER/REGISTRY_PASSWORD — см. GITEA-vars.md" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
|
- name: Docker auth
|
||||||
|
env:
|
||||||
|
REGISTRY: ${{ vars.REGISTRY }}
|
||||||
|
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
|
||||||
|
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
|
||||||
|
run: |
|
||||||
|
mkdir -p ~/.docker
|
||||||
|
printf '{"auths":{"%s":{"auth":"%s"}}}' "$REGISTRY" \
|
||||||
|
"$(printf '%s:%s' "$REGISTRY_USER" "$REGISTRY_PASSWORD" | base64 -w0)" > ~/.docker/config.json
|
||||||
|
|
||||||
|
- name: Build and push app image
|
||||||
|
env:
|
||||||
|
REGISTRY: ${{ vars.REGISTRY }}
|
||||||
|
MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }}
|
||||||
|
run: |
|
||||||
|
sha="${GITHUB_SHA:0:7}"
|
||||||
|
# DOCKER_BUILDKIT=0: daemon за раннером — podman, BuildKit-сессий нет,
|
||||||
|
# только classic /build (buildah).
|
||||||
|
DOCKER_BUILDKIT=0 docker build -f Containerfile \
|
||||||
|
--build-arg MAVEN_MIRROR_URL="$MAVEN_MIRROR_URL" \
|
||||||
|
-t "$REGISTRY/wordpdf-app:prod" -t "$REGISTRY/wordpdf-app:sha-$sha" .
|
||||||
|
docker push "$REGISTRY/wordpdf-app:prod"
|
||||||
|
docker push "$REGISTRY/wordpdf-app:sha-$sha"
|
||||||
|
|
||||||
|
images-web:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
needs: web
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v5
|
- uses: actions/checkout@v5
|
||||||
|
|
||||||
@@ -83,18 +198,6 @@ jobs:
|
|||||||
printf '{"auths":{"%s":{"auth":"%s"}}}' "$REGISTRY" \
|
printf '{"auths":{"%s":{"auth":"%s"}}}' "$REGISTRY" \
|
||||||
"$(printf '%s:%s' "$REGISTRY_USER" "$REGISTRY_PASSWORD" | base64 -w0)" > ~/.docker/config.json
|
"$(printf '%s:%s' "$REGISTRY_USER" "$REGISTRY_PASSWORD" | base64 -w0)" > ~/.docker/config.json
|
||||||
|
|
||||||
- name: Build and push app image
|
|
||||||
env:
|
|
||||||
REGISTRY: ${{ vars.REGISTRY }}
|
|
||||||
run: |
|
|
||||||
sha="${GITHUB_SHA:0:7}"
|
|
||||||
# DOCKER_BUILDKIT=0: daemon за раннером — podman, BuildKit-сессий нет,
|
|
||||||
# только classic /build (buildah).
|
|
||||||
DOCKER_BUILDKIT=0 docker build -f Containerfile \
|
|
||||||
-t "$REGISTRY/wordpdf-app:prod" -t "$REGISTRY/wordpdf-app:sha-$sha" .
|
|
||||||
docker push "$REGISTRY/wordpdf-app:prod"
|
|
||||||
docker push "$REGISTRY/wordpdf-app:sha-$sha"
|
|
||||||
|
|
||||||
- name: Build and push web image
|
- name: Build and push web image
|
||||||
env:
|
env:
|
||||||
REGISTRY: ${{ vars.REGISTRY }}
|
REGISTRY: ${{ vars.REGISTRY }}
|
||||||
@@ -110,7 +213,7 @@ jobs:
|
|||||||
|
|
||||||
deploy:
|
deploy:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
needs: images
|
needs: [images-app, images-web]
|
||||||
env:
|
env:
|
||||||
DEPLOY_HOST: ${{ vars.DEPLOY_HOST }}
|
DEPLOY_HOST: ${{ vars.DEPLOY_HOST }}
|
||||||
DEPLOY_USER: ${{ vars.DEPLOY_USER }}
|
DEPLOY_USER: ${{ vars.DEPLOY_USER }}
|
||||||
@@ -122,6 +225,7 @@ jobs:
|
|||||||
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
|
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
|
||||||
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
|
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
|
||||||
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
||||||
|
DEPLOY_KNOWN_HOSTS: ${{ secrets.DEPLOY_KNOWN_HOSTS }}
|
||||||
steps:
|
steps:
|
||||||
- name: Check deploy vars and secrets
|
- name: Check deploy vars and secrets
|
||||||
run: |
|
run: |
|
||||||
@@ -129,7 +233,7 @@ jobs:
|
|||||||
for v in DEPLOY_HOST DEPLOY_USER DEPLOY_DIR REGISTRY WORDPDF_MAX_MB WORDPDF_MAX_PAGES; do
|
for v in DEPLOY_HOST DEPLOY_USER DEPLOY_DIR REGISTRY WORDPDF_MAX_MB WORDPDF_MAX_PAGES; do
|
||||||
[ -n "${!v}" ] || { echo "Задайте Actions Variable $v — см. GITEA-vars.md" >&2; missing=1; }
|
[ -n "${!v}" ] || { echo "Задайте Actions Variable $v — см. GITEA-vars.md" >&2; missing=1; }
|
||||||
done
|
done
|
||||||
for s in DEPLOY_SSH_KEY REGISTRY_USER REGISTRY_PASSWORD WORDPDF_API_KEY; do
|
for s in DEPLOY_SSH_KEY REGISTRY_USER REGISTRY_PASSWORD WORDPDF_API_KEY DEPLOY_KNOWN_HOSTS; do
|
||||||
[ -n "${!s}" ] || { echo "Задайте Actions Secret $s — см. GITEA-vars.md" >&2; missing=1; }
|
[ -n "${!s}" ] || { echo "Задайте Actions Secret $s — см. GITEA-vars.md" >&2; missing=1; }
|
||||||
done
|
done
|
||||||
exit "$missing"
|
exit "$missing"
|
||||||
@@ -142,6 +246,9 @@ jobs:
|
|||||||
# Ключ API в файл не пишется: compose интерполирует его из окружения деплоя.
|
# Ключ API в файл не пишется: compose интерполирует его из окружения деплоя.
|
||||||
- name: Render prod stack files
|
- name: Render prod stack files
|
||||||
run: &render-stack-files |
|
run: &render-stack-files |
|
||||||
|
set -euo pipefail
|
||||||
|
# (якорь общий с rollback; команды шага — heredoc'и в кавычках и
|
||||||
|
# ||-цепочка pip — pipefail-safe)
|
||||||
cat > docker-compose.yml <<COMPOSE
|
cat > docker-compose.yml <<COMPOSE
|
||||||
name: wordpdf-prod
|
name: wordpdf-prod
|
||||||
# Рендерится CI на каждый деплой (Gitea Actions, job deploy в main.yml) —
|
# Рендерится CI на каждый деплой (Gitea Actions, job deploy в main.yml) —
|
||||||
@@ -156,6 +263,9 @@ jobs:
|
|||||||
# не крушит стек бесконечным crash-loop. Синтаксис on-failure:N podman
|
# не крушит стек бесконечным crash-loop. Синтаксис on-failure:N podman
|
||||||
# переваривает и применяет (проверено: maxtries=N, после исчерпания exited).
|
# переваривает и применяет (проверено: maxtries=N, после исчерпания exited).
|
||||||
restart: on-failure:5
|
restart: on-failure:5
|
||||||
|
# фиксированный heap -Xms2g -Xmx2g в ENTRYPOINT образа, лимит 3g —
|
||||||
|
# запас под metaspace/потоки/native; паритет с repo compose.yml
|
||||||
|
mem_limit: 3g
|
||||||
# healthcheck дублируется в compose, а не только в Containerfile: podman
|
# healthcheck дублируется в compose, а не только в Containerfile: podman
|
||||||
# выгружает образы в OCI, где HEALTHCHECK теряется, а gateway в depends_on
|
# выгружает образы в OCI, где HEALTHCHECK теряется, а gateway в depends_on
|
||||||
# ждал бы healthy вечно. wget, не curl: alpine-jre образ curl не содержит.
|
# ждал бы healthy вечно. wget, не curl: alpine-jre образ curl не содержит.
|
||||||
@@ -163,7 +273,9 @@ jobs:
|
|||||||
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1"]
|
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1"]
|
||||||
interval: 10s
|
interval: 10s
|
||||||
timeout: 3s
|
timeout: 3s
|
||||||
start_period: 45s
|
# старт приложения ~3 с (замер: "Started WordPdfApplication in 2.577s"),
|
||||||
|
# podman не считает health до истечения start_period — 10s с запасом ×3
|
||||||
|
start_period: 10s
|
||||||
retries: 5
|
retries: 5
|
||||||
environment:
|
environment:
|
||||||
# ключ берётся из окружения деплоя (Gitea Secret WORDPDF_API_KEY),
|
# ключ берётся из окружения деплоя (Gitea Secret WORDPDF_API_KEY),
|
||||||
@@ -175,7 +287,7 @@ jobs:
|
|||||||
image: $REGISTRY/wordpdf-web:prod
|
image: $REGISTRY/wordpdf-web:prod
|
||||||
restart: on-failure:5
|
restart: on-failure:5
|
||||||
healthcheck:
|
healthcheck:
|
||||||
test: ["CMD-SHELL", "http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
|
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
|
||||||
interval: 10s
|
interval: 10s
|
||||||
timeout: 3s
|
timeout: 3s
|
||||||
start_period: 10s
|
start_period: 10s
|
||||||
@@ -218,6 +330,14 @@ jobs:
|
|||||||
resolver 10.112.0.1 valid=10s ipv6=off;
|
resolver 10.112.0.1 valid=10s ipv6=off;
|
||||||
set \$upstream_app http://app:8080;
|
set \$upstream_app http://app:8080;
|
||||||
set \$upstream_web http://web:80;
|
set \$upstream_web http://web:80;
|
||||||
|
# X-Forwarded-* переписываются безусловно: клиент не должен иметь
|
||||||
|
# возможности подсунуть бэкенду подставной "реальный IP/схема/хост"
|
||||||
|
# (Spring ForwardedHeaderFilter доверяет этим заголовкам).
|
||||||
|
# X-Forwarded-Prefix не трогаем: его проставляет внешний nginx,
|
||||||
|
# на нём держится корректный base у swagger-ui за прокси.
|
||||||
|
proxy_set_header X-Forwarded-For \$remote_addr;
|
||||||
|
proxy_set_header X-Forwarded-Proto \$scheme;
|
||||||
|
proxy_set_header X-Forwarded-Host \$host;
|
||||||
location /api/ {
|
location /api/ {
|
||||||
# в proxy_pass нет path-части, поэтому URI передаётся как есть
|
# в proxy_pass нет path-части, поэтому URI передаётся как есть
|
||||||
proxy_pass \$upstream_app;
|
proxy_pass \$upstream_app;
|
||||||
@@ -249,7 +369,11 @@ jobs:
|
|||||||
mkdir -p "$HOME/.ssh" && chmod 700 "$HOME/.ssh"
|
mkdir -p "$HOME/.ssh" && chmod 700 "$HOME/.ssh"
|
||||||
printf '%s\n' "$DEPLOY_SSH_KEY" > "$HOME/.ssh/id_deploy"
|
printf '%s\n' "$DEPLOY_SSH_KEY" > "$HOME/.ssh/id_deploy"
|
||||||
chmod 600 "$HOME/.ssh/id_deploy"
|
chmod 600 "$HOME/.ssh/id_deploy"
|
||||||
set -- -i "$HOME/.ssh/id_deploy" -o StrictHostKeyChecking=accept-new
|
# host-key pinning: пустой секрет → пустой known_hosts → ssh падает на
|
||||||
|
# StrictHostKeyChecking=yes ДО передачи секретов (fail-closed)
|
||||||
|
printf '%s\n' "$DEPLOY_KNOWN_HOSTS" > "$HOME/.ssh/known_hosts"
|
||||||
|
chmod 600 "$HOME/.ssh/known_hosts"
|
||||||
|
set -- -i "$HOME/.ssh/id_deploy" -o UserKnownHostsFile="$HOME/.ssh/known_hosts" -o StrictHostKeyChecking=yes
|
||||||
D=$(printf '%q' "$DEPLOY_DIR")
|
D=$(printf '%q' "$DEPLOY_DIR")
|
||||||
H="$DEPLOY_USER@$DEPLOY_HOST"
|
H="$DEPLOY_USER@$DEPLOY_HOST"
|
||||||
ssh "$@" "$H" "umask 077; mkdir -p $D && cat > $D/docker-compose.yml" < docker-compose.yml
|
ssh "$@" "$H" "umask 077; mkdir -p $D && cat > $D/docker-compose.yml" < docker-compose.yml
|
||||||
@@ -275,13 +399,13 @@ jobs:
|
|||||||
# timeout обязателен: podman-compose up -d бесконечно ждёт «успокоившийся»
|
# timeout обязателен: podman-compose up -d бесконечно ждёт «успокоившийся»
|
||||||
# контейнер, а crash-loop без лимита попыток не успокаивается никогда
|
# контейнер, а crash-loop без лимита попыток не успокаивается никогда
|
||||||
# (рег. run 488: deploy висел на этой команде, rollback не запускался).
|
# (рег. run 488: deploy висел на этой команде, rollback не запускался).
|
||||||
timeout 180 podman-compose up -d --force-recreate app web
|
timeout 90 podman-compose up -d --force-recreate app web
|
||||||
for _ in $(seq 1 60); do
|
for _ in $(seq 1 30); do
|
||||||
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] && break
|
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] && break
|
||||||
sleep 2
|
sleep 2
|
||||||
done
|
done
|
||||||
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] \
|
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] \
|
||||||
|| { echo "app не стал healthy за 120с" >&2; exit 1; }
|
|| { echo "app не стал healthy за 60с" >&2; exit 1; }
|
||||||
# Гейт: app/web обязаны идти на только что стянутый из реестра образ
|
# Гейт: app/web обязаны идти на только что стянутый из реестра образ
|
||||||
# (защита от молчаливого деплоя старого кода).
|
# (защита от молчаливого деплоя старого кода).
|
||||||
for svc in app web; do
|
for svc in app web; do
|
||||||
@@ -292,7 +416,7 @@ jobs:
|
|||||||
done
|
done
|
||||||
# gateway пересоздаётся последним (после healthy app/web): nginx.conf
|
# gateway пересоздаётся последним (после healthy app/web): nginx.conf
|
||||||
# на каждый деплой рендерится заново, пересоздание применяет его.
|
# на каждый деплой рендерится заново, пересоздание применяет его.
|
||||||
timeout 120 podman-compose up -d --force-recreate gateway
|
timeout 60 podman-compose up -d --force-recreate gateway
|
||||||
for _ in $(seq 1 10); do
|
for _ in $(seq 1 10); do
|
||||||
curl -fsS -o /dev/null "http://127.0.0.1:9010/actuator/health" 2>/dev/null && break || sleep 1
|
curl -fsS -o /dev/null "http://127.0.0.1:9010/actuator/health" 2>/dev/null && break || sleep 1
|
||||||
done
|
done
|
||||||
@@ -307,23 +431,34 @@ jobs:
|
|||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v5
|
- uses: actions/checkout@v5
|
||||||
|
|
||||||
- name: Setup venv
|
# Проверка обязательных Variables/Secret — ДО установки зависимостей: без
|
||||||
run: |
|
# PIP_INDEX_URL pip некуда вести, падать надо до попытки установки (fail-closed).
|
||||||
python3 -m venv .venv
|
|
||||||
.venv/bin/pip install -q -r prod-autotests/requirements.txt
|
|
||||||
|
|
||||||
- name: Check autotest vars and secret
|
- name: Check autotest vars and secret
|
||||||
env:
|
env:
|
||||||
WORDPDF_BASE_URL: ${{ vars.WORDPDF_BASE_URL }}
|
WORDPDF_BASE_URL: ${{ vars.WORDPDF_BASE_URL }}
|
||||||
WORDPDF_MAX_PAGES: ${{ vars.WORDPDF_MAX_PAGES }}
|
WORDPDF_MAX_PAGES: ${{ vars.WORDPDF_MAX_PAGES }}
|
||||||
WORDPDF_MAX_MB: ${{ vars.WORDPDF_MAX_MB }}
|
WORDPDF_MAX_MB: ${{ vars.WORDPDF_MAX_MB }}
|
||||||
|
PIP_INDEX_URL: ${{ vars.PIP_INDEX_URL }}
|
||||||
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
||||||
run: |
|
run: |
|
||||||
[ -n "$WORDPDF_BASE_URL" ] && [ -n "$WORDPDF_MAX_PAGES" ] && [ -n "$WORDPDF_MAX_MB" ] && [ -n "$WORDPDF_API_KEY" ] || {
|
[ -n "$WORDPDF_BASE_URL" ] && [ -n "$WORDPDF_MAX_PAGES" ] && [ -n "$WORDPDF_MAX_MB" ] && [ -n "$PIP_INDEX_URL" ] && [ -n "$WORDPDF_API_KEY" ] || {
|
||||||
echo "Задайте Actions Variables WORDPDF_BASE_URL/WORDPDF_MAX_PAGES/WORDPDF_MAX_MB и Secret WORDPDF_API_KEY — см. GITEA-vars.md" >&2
|
echo "Задайте Actions Variables WORDPDF_BASE_URL/WORDPDF_MAX_PAGES/WORDPDF_MAX_MB/PIP_INDEX_URL и Secret WORDPDF_API_KEY — см. GITEA-vars.md" >&2
|
||||||
exit 1
|
exit 1
|
||||||
}
|
}
|
||||||
|
|
||||||
|
# Индекс — pypi-proxy на Nexus (тот же хост, что docker-реестр): pypi.org из
|
||||||
|
# раннера не опрашивается вовсе, кеш пакетов — сам Nexus (actions/cache не нужен).
|
||||||
|
# PIP_TRUSTED_HOST вырезается из URL (Nexus на HTTP-коннекторе); --timeout/--retries
|
||||||
|
# увеличены: первый запрос некешированного пакета проксируется в pypi.
|
||||||
|
- name: Setup venv
|
||||||
|
env:
|
||||||
|
PIP_INDEX_URL: ${{ vars.PIP_INDEX_URL }}
|
||||||
|
run: |
|
||||||
|
python3 -m venv .venv
|
||||||
|
host="${PIP_INDEX_URL#*://}"; host="${host%%/*}"; host="${host%%:*}"
|
||||||
|
PIP_TRUSTED_HOST="$host" .venv/bin/pip install -q --timeout 60 --retries 5 \
|
||||||
|
-i "$PIP_INDEX_URL" -r prod-autotests/requirements.txt
|
||||||
|
|
||||||
- name: Run prod autotests
|
- name: Run prod autotests
|
||||||
env:
|
env:
|
||||||
WORDPDF_BASE_URL: ${{ vars.WORDPDF_BASE_URL }}
|
WORDPDF_BASE_URL: ${{ vars.WORDPDF_BASE_URL }}
|
||||||
@@ -345,6 +480,9 @@ jobs:
|
|||||||
WORDPDF_MAX_PAGES: ${{ vars.WORDPDF_MAX_PAGES }}
|
WORDPDF_MAX_PAGES: ${{ vars.WORDPDF_MAX_PAGES }}
|
||||||
DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
|
DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
|
||||||
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
||||||
|
DEPLOY_KNOWN_HOSTS: ${{ secrets.DEPLOY_KNOWN_HOSTS }}
|
||||||
|
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
|
||||||
|
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
|
||||||
steps:
|
steps:
|
||||||
# Конфиг рендерится заново (тот же шаг, что у deploy) и перезаливается: откат
|
# Конфиг рендерится заново (тот же шаг, что у deploy) и перезаливается: откат
|
||||||
# не зависит от того, что осталось на хосте после упавшего деплоя (рег. run 482:
|
# не зависит от того, что осталось на хосте после упавшего деплоя (рег. run 482:
|
||||||
@@ -359,13 +497,16 @@ jobs:
|
|||||||
mkdir -p "$HOME/.ssh" && chmod 700 "$HOME/.ssh"
|
mkdir -p "$HOME/.ssh" && chmod 700 "$HOME/.ssh"
|
||||||
printf '%s\n' "$DEPLOY_SSH_KEY" > "$HOME/.ssh/id_deploy"
|
printf '%s\n' "$DEPLOY_SSH_KEY" > "$HOME/.ssh/id_deploy"
|
||||||
chmod 600 "$HOME/.ssh/id_deploy"
|
chmod 600 "$HOME/.ssh/id_deploy"
|
||||||
set -- -i "$HOME/.ssh/id_deploy" -o StrictHostKeyChecking=accept-new
|
# host-key pinning, как в deploy (fail-closed на пустом секрете)
|
||||||
|
printf '%s\n' "$DEPLOY_KNOWN_HOSTS" > "$HOME/.ssh/known_hosts"
|
||||||
|
chmod 600 "$HOME/.ssh/known_hosts"
|
||||||
|
set -- -i "$HOME/.ssh/id_deploy" -o UserKnownHostsFile="$HOME/.ssh/known_hosts" -o StrictHostKeyChecking=yes
|
||||||
D=$(printf '%q' "$DEPLOY_DIR")
|
D=$(printf '%q' "$DEPLOY_DIR")
|
||||||
H="$DEPLOY_USER@$DEPLOY_HOST"
|
H="$DEPLOY_USER@$DEPLOY_HOST"
|
||||||
ssh "$@" "$H" "umask 077; mkdir -p $D && cat > $D/docker-compose.yml" < docker-compose.yml
|
ssh "$@" "$H" "umask 077; mkdir -p $D && cat > $D/docker-compose.yml" < docker-compose.yml
|
||||||
{
|
{
|
||||||
printf 'export DEPLOY_DIR=%q REGISTRY=%q WORDPDF_API_KEY=%q\n' \
|
printf 'export DEPLOY_DIR=%q REGISTRY=%q REGISTRY_USER=%q REGISTRY_PASSWORD=%q WORDPDF_API_KEY=%q\n' \
|
||||||
"$DEPLOY_DIR" "$REGISTRY" "$WORDPDF_API_KEY"
|
"$DEPLOY_DIR" "$REGISTRY" "$REGISTRY_USER" "$REGISTRY_PASSWORD" "$WORDPDF_API_KEY"
|
||||||
cat <<'REMOTE'
|
cat <<'REMOTE'
|
||||||
set -euo pipefail
|
set -euo pipefail
|
||||||
cd "$DEPLOY_DIR"
|
cd "$DEPLOY_DIR"
|
||||||
@@ -376,14 +517,19 @@ jobs:
|
|||||||
. ./.rollback.env
|
. ./.rollback.env
|
||||||
podman tag "$PREV_APP" "$REGISTRY/wordpdf-app:prod"
|
podman tag "$PREV_APP" "$REGISTRY/wordpdf-app:prod"
|
||||||
podman tag "$PREV_WEB" "$REGISTRY/wordpdf-web:prod"
|
podman tag "$PREV_WEB" "$REGISTRY/wordpdf-web:prod"
|
||||||
timeout 180 podman-compose up -d --force-recreate app web
|
# реестр :prod обязан соответствовать откаченному ранящемуся образу:
|
||||||
for _ in $(seq 1 60); do
|
# иначе ручной pull/пересборка стека вернёт битый билд
|
||||||
|
printf '%s' "$REGISTRY_PASSWORD" | podman login "$REGISTRY" --username "$REGISTRY_USER" --password-stdin
|
||||||
|
podman push "$REGISTRY/wordpdf-app:prod"
|
||||||
|
podman push "$REGISTRY/wordpdf-web:prod"
|
||||||
|
timeout 90 podman-compose up -d --force-recreate app web
|
||||||
|
for _ in $(seq 1 30); do
|
||||||
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] && break
|
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] && break
|
||||||
sleep 2
|
sleep 2
|
||||||
done
|
done
|
||||||
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] \
|
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] \
|
||||||
|| { echo "app НЕ healthy после отката" >&2; exit 1; }
|
|| { echo "app НЕ healthy после отката" >&2; exit 1; }
|
||||||
timeout 120 podman-compose up -d --force-recreate gateway
|
timeout 60 podman-compose up -d --force-recreate gateway
|
||||||
curl -fsS "http://127.0.0.1:9010/actuator/health"
|
curl -fsS "http://127.0.0.1:9010/actuator/health"
|
||||||
REMOTE
|
REMOTE
|
||||||
} | ssh "$@" "$H" bash -s
|
} | ssh "$@" "$H" bash -s
|
||||||
|
|||||||
+116
-18
@@ -10,26 +10,124 @@ jobs:
|
|||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v5
|
- uses: actions/checkout@v5
|
||||||
|
|
||||||
- name: Setup JDK 21
|
- name: Check maven mirror var
|
||||||
uses: actions/setup-java@v5
|
env:
|
||||||
with:
|
MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }}
|
||||||
java-version: '21'
|
|
||||||
distribution: 'temurin'
|
|
||||||
|
|
||||||
- name: Cache Maven repository
|
|
||||||
uses: actions/cache@v4
|
|
||||||
with:
|
|
||||||
path: ~/.m2/repository
|
|
||||||
key: maven-${{ hashFiles('pom.xml', 'wordpdf-core/pom.xml', 'wordpdf-app/pom.xml') }}
|
|
||||||
restore-keys: maven-
|
|
||||||
|
|
||||||
- name: Setup Maven 3.9.16
|
|
||||||
run: |
|
run: |
|
||||||
curl -fsSL https://dlcdn.apache.org/maven/maven-3/3.9.16/binaries/apache-maven-3.9.16-bin.tar.gz | tar xz -C /opt
|
[ -n "$MAVEN_MIRROR_URL" ] || {
|
||||||
echo "/opt/apache-maven-3.9.16/bin" >> "$GITHUB_PATH"
|
echo "Задайте Actions Variable MAVEN_MIRROR_URL — см. GITEA-vars.md" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
- name: Build and test (PMD gate included)
|
- name: Build and test without fontconfig (PMD+JaCoCo included)
|
||||||
run: mvn -B clean verify
|
env:
|
||||||
|
MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }}
|
||||||
|
run: |
|
||||||
|
DOCKER_BUILDKIT=0 docker build \
|
||||||
|
-f Containerfile.test \
|
||||||
|
--build-arg MAVEN_MIRROR_URL="$MAVEN_MIRROR_URL" \
|
||||||
|
-t wordpdf-verify:ci \
|
||||||
|
.
|
||||||
|
|
||||||
|
- name: Extract JaCoCo reports
|
||||||
|
if: always()
|
||||||
|
run: |
|
||||||
|
id=$(docker create wordpdf-verify:ci 2>/dev/null) || {
|
||||||
|
echo "образ не собран — сводка покрытия будет пустой"
|
||||||
|
exit 0
|
||||||
|
}
|
||||||
|
mkdir -p wordpdf-core/target/site/jacoco wordpdf-app/target/site/jacoco
|
||||||
|
docker cp "$id:/build/wordpdf-core/target/site/jacoco/jacoco.xml" \
|
||||||
|
wordpdf-core/target/site/jacoco/jacoco.xml || true
|
||||||
|
docker cp "$id:/build/wordpdf-app/target/site/jacoco/jacoco.xml" \
|
||||||
|
wordpdf-app/target/site/jacoco/jacoco.xml || true
|
||||||
|
docker rm "$id" >/dev/null
|
||||||
|
|
||||||
|
- name: Coverage summary
|
||||||
|
if: always()
|
||||||
|
run: |
|
||||||
|
python3 - <<'PY' > coverage-summary.md
|
||||||
|
import os
|
||||||
|
import xml.etree.ElementTree as ET
|
||||||
|
def pct(root, kind):
|
||||||
|
for c in root.findall("counter"):
|
||||||
|
if c.get("type") == kind:
|
||||||
|
missed, covered = int(c.get("missed")), int(c.get("covered"))
|
||||||
|
return f"{100.0 * covered / (missed + covered):.1f}%"
|
||||||
|
return "—"
|
||||||
|
print("<!-- jacoco-coverage -->")
|
||||||
|
print("## Покрытие (JaCoCo)\n")
|
||||||
|
print("| Модуль | Строки | Ветви | Порог строк |")
|
||||||
|
print("|---|---|---|---|")
|
||||||
|
for m in ("wordpdf-core", "wordpdf-app"):
|
||||||
|
p = f"{m}/target/site/jacoco/jacoco.xml"
|
||||||
|
if not os.path.exists(p):
|
||||||
|
print(f"| {m} | нет данных | — | 90% |")
|
||||||
|
continue
|
||||||
|
r = ET.parse(p).getroot()
|
||||||
|
print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |")
|
||||||
|
PY
|
||||||
|
cat coverage-summary.md >> "$GITHUB_STEP_SUMMARY"
|
||||||
|
|
||||||
|
# Таблица покрытия — комментарием в PR: видно в обсуждении, не открывая run.
|
||||||
|
# Повторные push обновляют тот же комментарий (поиск по маркеру),
|
||||||
|
# github.token — task-токен раннера, падение не валит job. Артефактов с
|
||||||
|
# отчётами НЕТ намеренно: upload-artifact@v4 Gitea не поддерживает, @v3 на
|
||||||
|
# этом стенде висит на загрузке (отменена и с 153 файлами, и с одним zip);
|
||||||
|
# HTML — локально в target/site/jacoco. Шаг байт-в-байт одинаков в обоих
|
||||||
|
# workflow, в main.yml if не срабатывает — нет PR-события
|
||||||
|
- name: Comment coverage on PR
|
||||||
|
if: always() && github.event_name == 'pull_request'
|
||||||
|
continue-on-error: true
|
||||||
|
env:
|
||||||
|
GITEA_TOKEN: ${{ github.token }}
|
||||||
|
API: ${{ github.api_url }}
|
||||||
|
REPO: ${{ github.repository }}
|
||||||
|
PR_NUMBER: ${{ github.event.pull_request.number }}
|
||||||
|
run: |
|
||||||
|
[ -s coverage-summary.md ] || exit 0
|
||||||
|
python3 - <<'PY'
|
||||||
|
import json, os, urllib.request
|
||||||
|
api, repo, pr = os.environ["API"], os.environ["REPO"], os.environ["PR_NUMBER"]
|
||||||
|
token = os.environ["GITEA_TOKEN"]
|
||||||
|
body = open("coverage-summary.md").read()
|
||||||
|
def req(method, url, payload=None):
|
||||||
|
data = json.dumps(payload).encode() if payload is not None else None
|
||||||
|
r = urllib.request.Request(url, data=data, method=method,
|
||||||
|
headers={"Authorization": f"token {token}",
|
||||||
|
"Content-Type": "application/json"})
|
||||||
|
return json.loads(urllib.request.urlopen(r).read() or "null")
|
||||||
|
base = f"{api}/repos/{repo}/issues/{pr}/comments"
|
||||||
|
existing = next((c["id"] for c in req("GET", base)
|
||||||
|
if "<!-- jacoco-coverage -->" in c.get("body", "")), None)
|
||||||
|
req("PATCH" if existing else "POST",
|
||||||
|
f"{base}/{existing}" if existing else base, {"body": body})
|
||||||
|
PY
|
||||||
|
|
||||||
|
macos-sim:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v5
|
||||||
|
|
||||||
|
- name: Check maven mirror var
|
||||||
|
env:
|
||||||
|
MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }}
|
||||||
|
run: |
|
||||||
|
[ -n "$MAVEN_MIRROR_URL" ] || {
|
||||||
|
echo "Задайте Actions Variable MAVEN_MIRROR_URL — см. GITEA-vars.md" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
|
- name: Tests under macOS emulation (-Dos.name)
|
||||||
|
env:
|
||||||
|
MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }}
|
||||||
|
run: |
|
||||||
|
DOCKER_BUILDKIT=0 docker build \
|
||||||
|
-f Containerfile.test \
|
||||||
|
--build-arg MAVEN_MIRROR_URL="$MAVEN_MIRROR_URL" \
|
||||||
|
--build-arg "SUREFIRE_OS_NAME=Mac OS X" \
|
||||||
|
-t wordpdf-verify:macos-sim \
|
||||||
|
.
|
||||||
|
|
||||||
web:
|
web:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
|
|||||||
+14
@@ -2,6 +2,9 @@
|
|||||||
target/
|
target/
|
||||||
dependency-reduced-pom.xml
|
dependency-reduced-pom.xml
|
||||||
|
|
||||||
|
# Аргумент-файлы javac (мусор компиляции в корне)
|
||||||
|
javac.*.args
|
||||||
|
|
||||||
# Node (wordpdf-web)
|
# Node (wordpdf-web)
|
||||||
node_modules/
|
node_modules/
|
||||||
wordpdf-web/dist/
|
wordpdf-web/dist/
|
||||||
@@ -26,6 +29,9 @@ Thumbs.db
|
|||||||
# Рабочие материалы и эталоны разработки (вне git)
|
# Рабочие материалы и эталоны разработки (вне git)
|
||||||
/develop/
|
/develop/
|
||||||
|
|
||||||
|
# Исходный dated-.docx [MS-DOC] — скачивается по команде из docs/standards/doc/README.md
|
||||||
|
docs/standards/doc/ms-doc.docx
|
||||||
|
|
||||||
# Секреты деплоя
|
# Секреты деплоя
|
||||||
.env
|
.env
|
||||||
|
|
||||||
@@ -35,3 +41,11 @@ DEPLOY.md
|
|||||||
# Индекс CodeGraph
|
# Индекс CodeGraph
|
||||||
.codegraph/
|
.codegraph/
|
||||||
|
|
||||||
|
# Mise: локальный бинарь mise (bootstrap.sh / bootstrap.ps1)
|
||||||
|
/.mise/
|
||||||
|
|
||||||
|
# Сайт документации: сборка, venv, копия javadoc
|
||||||
|
site/
|
||||||
|
docs/.venv/
|
||||||
|
docs/apidocs/
|
||||||
|
|
||||||
|
|||||||
@@ -1,165 +1,130 @@
|
|||||||
# Repository Guidelines
|
# Repository Guidelines
|
||||||
|
|
||||||
|
> Роутер: правила, инварианты и команды — здесь; глубокие детали — `docs/agent/*.md` (pipeline, doc-bridge, chart, testing, ci-cd, repo-map, render-limitations — каждый авторитетен наравне с этим файлом), нормативные форматы — `docs/standards/` (навигатор — `docs/standards/README.md`, ссылка на спецификацию — с номером секции).
|
||||||
|
|
||||||
## Project Overview
|
## Project Overview
|
||||||
|
|
||||||
Конвертер `.docx` → `.pdf` на чистом Java (docx4j 17.3.2 + форк Apache FOP, без LibreOffice/Aspose). Java 21, только Maven. Модули: `wordpdf-core` (библиотека), `wordpdf-app` (Spring Boot 4.1.1 REST API); `wordpdf-web` — React SPA в nginx-контейнере (отдельный деп, вне Maven). Единственный гейт перед `git push` — `mvn clean verify` (CI нет; SPA гейтуется `npm run build` + `npm run lint`). Вход стека — gateway-контейнер nginx (:9010 prod / :9011 dev), НЕ 8080. README устарел (порты/топология, «413 6 МБ» — фактически 100 МБ, нет API-ключа, лимиты подаёт как константы — они конфигурируемы); авторитетен этот файл.
|
Конвертер `.docx`/`.doc` → `.pdf` на чистом Java: docx4j 17.3.2 → XSL-FO → форк Apache FOP (`org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.6 — транзитив от `docx4j-export-fo`), без LibreOffice/Aspose. Бинарный `.doc` (Word 97-2003) переносится мостом MS-DOC/MS-CFB (`internal/doc`) в in-memory `.docx` и идёт тем же конвейером. Maven-мультимодуль `ru.pjandro:java-word-pdf:1.0.0`: `wordpdf-core` (библиотека), `wordpdf-app` (REST на Spring Boot 4.1.1); вне Maven-реактора — SPA `wordpdf-web` (React 19.2 + TS ~6.0 + Vite 8.3 + oxlint + Tailwind v4.3, npm; strict-режим TS намеренно не включён — сборка не strict-гейт) и pytest-автотесты `prod-autotests/`. Java 17, только Maven.
|
||||||
|
|
||||||
## Architecture & Data Flow
|
## Architecture & Data Flow
|
||||||
|
|
||||||
### Пайплайн `WordPdfConverter.convert(byte[], String[, ConvertOptions])` (порядок фиксирован, менять местами нельзя)
|
Единственный вход стека — gateway-контейнер nginx (`:9010` prod-like `compose.yml`, `:9011` dev `compose.dev.yml`), **не** 8080. Реальный прод-стек (`docker-compose.yml` + прод `nginx.conf`) рендерит CI-job `deploy` — копий на хосте/в репо не заводить. Наружный прод-вход — `https://pjandro.ru/pdf-converter/` (образ web собирается с `VITE_BASE=/pdf-converter/` — bake в job `images-web`, не в compose).
|
||||||
|
|
||||||
Наружу `WordPdfValidator.validate(docxBytes, options)` (размер → zip-подпись `PK\x03\x04` → контейнер (.docx-манифест + zip-бомба) → страницы) вызывается **до** приватного `convertToStream`; внутри `convertToStream`:
|
**Пайплайн** `WordPdfConverter.convert(byte[] docxBytes, String title, ConvertOptions)` → `convertToStream` (публичная сигнатура единственная, 2-аргументной перегрузки **нет**); порядок шагов фиксирован:
|
||||||
|
|
||||||
1. `new BundledFontMapper()` → `BundledFonts.init()` → `BundledFonts.restrictToBundled()`. Конструктор маппера каждый раз добавляет системные шрифты в реестр `PhysicalFonts`; ключ реестра — имя из name-таблицы TTF, `addPhysicalFont(URI)` не перезаписывает занятый → `init()` вызывает `dropNonBundled()` **до** регистрации и `load()` (иначе системный Calibri ломает em-dash-fallback).
|
0. `DependencyGuard.check()` (commons-compress ≥ 1.25.0 API-проба);
|
||||||
2. Нормализация байтов docx до JAXB-загрузки (цепочка `byte[] → byte[]`, порядок значим): `StrictOoxmlNormalizer` (strict-OOXML → transitional-байт: `a:`-проценты и `w14:fillToRect` → тысячные ×1000, текст `wp14:pctWidth`/`pctHeight`, элементы и атрибуты `w:start`/`w:end` → `w:left`/`w:right` (кроме `w:lvl/w:start` в numbering.xml), значения `start`/`end` у `w:jc`/`w:tab`; в `mc-preprocessor.xslt` docx4j ветка `%` закомментирована, start/end не маппятся; namespaces и `pt`-значения правит сам mc-preprocessor — собственный рерайт URI ломает его pt-конверсию) → `DocxOnOffNormalizer` (`w:val="off"/"on"` → `false`/`true`) → `SymbolFontNormalizer` (PUA U+F0xx Symbol/Wingdings/Webdings → Unicode + DejaVu Sans, переписывает и элементы `<w:sym>`; 5 карт по 256 слотов, таблица `SymbolMapper` сгенерирована из docx4j 17.x) → `FieldNormalizer` (`fldChar` PAGE/NUMPAGES/SECTIONPAGES → `w:fldSimple`, вложенные/битые поля пропускает) → `GlyphCoverageNormalizer` (режет ран по покрытию глифов, пишет семейство в `w:rFonts`, иначе FOP рисует «#»; покрытие — `GlyphFont` (fontbox, cmap) + BitSet-кэш, НЕ docx4j `GlyphCheck` — тот плодит INFO-лог, `java.awt.Font` требовал fontconfig на хосте; для serif-ран fallback ищется сначала в `SERIF_FAMILIES` (DejaVu Serif/Tinos/Caladea), затем в sans) → `WordprocessingMLPackage.load`.
|
1. шрифты: `new BundledFontMapper()` → `BundledFonts.init()` → `restrictToBundled()` — строго в этом порядке, до `load()`;
|
||||||
3. `WordPdfValidator.checkPageCount(docxBytes, maxPages)` — **до** рендера, lightweight (zip/StAX) по нормализованным байтам — тот же путь, что у приложения до очереди.
|
2. нормализаторы (`DocxRewritePipeline.STEP` + лямбда `OleObjectNormalizer`) → `WordprocessingMLPackage.load`;
|
||||||
4. `pkg.setFontMapper(mapper)` → `DrawingPreRenderer.run(pkg, options)` (шаг 3.5: `c:chart`/`dgm:relIds` docx2fo.xslt не умеет — свой Java2D-движок `internal/chart/*` рендерит в PNG 300 dpi и подменяет на `pic:pic`; объект, выключенный в `ConvertOptions`, пропускается до рендера и остаётся в docx; упавший рендер — объект **удаляется** из docx (`gd.getAny().clear()`) + warn, деградация не падение).
|
3. `setFontMapper`; 3.5 `DrawingPreRenderer.run` (chart/SmartArt/OMML-формулы → PNG; error-флаги бросаются здесь) — **обязателен до `FOSettings`**, иначе FOP молча теряет диаграммы;
|
||||||
5. `new FOSettings(pkg)` + `FopFallbackFonts.declare` (декларирует **все** бандл-семейства — FOP встраивает только задекларированные) → `FORendererApacheFOP`/`FOUserAgent` (непустой `title` → заголовок PDF) → `Docx4J.toFO(..., FLAG_EXPORT_PREFER_XSL)`.
|
4. `FOSettings` + `ChartImageHandler` + `FopFallbackFonts.declare`; 4.25 `LayoutPostRenderer.register`; 4.5 `setCustomXsltTemplates(VendoredXslt.TEMPLATES)`;
|
||||||
6. `finally`: `deleteEmbeddedFontTempFiles()` (в 17.x `OpcPackage.close()` нет).
|
5. общая `FopFactory` (DCL на мониторе `WordPdfConverter.class`);
|
||||||
|
6. `Docx4J.toFO(…, FLAG_EXPORT_PREFER_XSL)` — последним;
|
||||||
|
7. `finally`: сброс temp-шрифтов (`FontTablePart.deleteEmbeddedFontTempFiles()`), `resetSharedImageCaches()` (иначе ~1,5 ГБ за 30 конвертаций), `restrictToBundled()` (иначе встроенные в предыдущий docx шрифты травят реестр).
|
||||||
|
|
||||||
### REST API (`wordpdf-app`, всё package-private кроме `WordPdfApplication`)
|
`WordPdfValidator.validate` вызывается в `convert()` **до** монитора (параллельно); при `options == null` бросает `ValidationException` сам `convert()`. Вход роутируется по сигнатуре: `PK\x03\x04` → docx; `D0 CF 11 E0 A1 B1 1A E1` (CFB) → `DocToDocx.convert`. Для `.doc` страницы считаются по сырым байтам. Пороги валидатора в `WordPdfConverter` объявлены compile-time literals (javac инлайнит, static-блок конвертера не дёргается).
|
||||||
|
|
||||||
- Единственный эндпоинт `POST /api/v1/convert` (multipart-поле `file`, факультативные query/form-параметры `renderCharts`/`renderSmartArt`/`errorOnCharts`/`errorOnSmartArt`) → `application/pdf`, `Content-Disposition: attachment; filename*=UTF-8''…`. Проверка `.docx`-расширения — в `ConvertController`; `safeBaseName` в `ConversionService` — единый источник имени для файла, заголовка ответа и PDF-title (разрешены `[\p{L}\p{N} ._-]`, пустое → `document`).
|
**Слои ядра** (`wordpdf-core/src/main/java/ru/pjandro/wordpdf/`):
|
||||||
- Конвертации **сериализованы** однопоточным `ThreadPoolExecutor` (`ConversionService.QUEUE_CAPACITY = 16`, переполнение → 503): ядро мутирует глобальный реестр `PhysicalFonts`. `future.cancel(true)` при таймауте не останавливает FOP мгновенно — осознанный компромисс.
|
- публичный API: `WordPdfConverter`, `WordPdfValidator`, `ConvertOptions` (record `errorOnCharts/errorOnSmartArt/errorOnOle/maxMb/maxPages` — порядок полей фиксирован), `ConversionException` + `ValidationException` + `Charts/SmartArt/OleFoundException`; `warmup()` — идемпотентный прогрев (никогда не бросает), решает вызывающий;
|
||||||
- Ошибки (`ApiExceptionHandler`, тело `{"error": …}`): `ValidationException` → 400; `DrawingRejectedException` (core-`DrawingFoundException` от error-флагов, конвертируется в `ConversionService.doConvert`) → **422** (текст — контракт с фронтом, показывается дословно); `ConversionFailedException` → 500; `ConversionRejectedException` → 503; `ConversionTimeoutException` (`wordpdf.convert-timeout`, 2m) → 504; `MaxUploadSizeExceededException` → 413; `MissingServletRequestPartException`/`MissingServletRequestParameterException` → 400; `NoResourceFoundException` (неизвестный путь) → 404; catch-all → 500 (подробности только в лог). `ValidationException` — тип ядра `ru.pjandro.wordpdf.ValidationException extends ConversionException` (публичный), валидатор бросает его сам, app-дубликата нет; четыре app-исключения (`ConversionFailed/Rejected/Timeout/DrawingRejected`) — package-private, несут семантику 500/503/504/422. Граница: сломанный контейнер (не zip / голый zip без манифеста wordprocessingml / zip-бомба / размер / страницы) → 400, валидный .docx-контейнер с мусором внутри → 500. Валидация до очереди: `WordPdfValidator.validate(docxBytes, options)` (внутри порядок значим: `checkInput` → zip-магик `PK\x03\x04` → `checkDocxContainer` — потоковый проход: декларация `wordprocessingml.document` в `[Content_Types].xml` + лимиты zip-бомбы `WordPdfSettings.MAX_DECOMPRESSED_MB`/`MAX_ZIP_ENTRIES`, не переопределяются `ConvertOptions` — → `checkPageCount`); тот же метод — вход ядра.
|
- `internal/`: контракт нормализатора — `byte[] normalize(byte[])`, нечего менять → **тот же массив** (`assertSame`); правила 1–11 идут одним zip-проходом `DocxRewritePipeline.STEP` в фиксированном порядке Strict→OnOff→Symbol→Field→Invisible→MathFallback→GlyphCoverage→TableIndent→NumberingSuffix→Hidden→Ruby (порядок в javadoc `WordPdfConverter.normalizers` устарел — не доверять), `OleObjectNormalizer` — 12-й, отдельным байтовым проходом (не zip); неизменённые записи копируются raw-сжатыми байтами; наружу только `DocxNormalizer`, `DocxRewritePipeline.STEP`, `OleObjectNormalizer`, `FopFallbackFonts`, `LayoutPostRenderer`, `DependencyGuard`;
|
||||||
- **Ключ доступа**: `ApiKeyFilter` сверяет заголовок `X-API-Key` (`ApiKeyFilter.HEADER`) со свойством `wordpdf.api-key` (env `WORDPDF_API_KEY`, сравнение `MessageDigest.isEqual`). Пустое свойство = аутентификация выключена (dev `java -jar`, тесты). Без ключа открыты `/actuator/**` (HEALTHCHECK), `/swagger-ui*`, `/v3/api-docs*` — матч по пути **без forwarded-contextPath** (`getRequestURI()` минус `getContextPath()`; иначе под `X-Forwarded-Prefix` HEALTHCHECK получил бы 401). 401 пишет сам фильтр (`ApiExceptionHandler` ошибок фильтров не видит). Springdoc в repo `compose.yml` **выключён** (`SPRINGDOC_API_DOCS_ENABLED`/`SPRINGDOC_SWAGGER_UI_ENABLED=false`); на живом проде (compose вне репо) включён и документация открыта без ключа под `https://pjandro.ru/pdf-converter/swagger-ui.html` — это безусловно проверяют prod-автотесты; server-URL спека собирается из `X-Forwarded-*` (`server.forward-headers-strategy=framework` — `native`-клапан Tomcat `X-Forwarded-Prefix` не понимает). Регрессии — `ApiKeyFilterTest#forwardedPrefix_healthStaysOpen`, `ApiKeyFilterTest#docsOpenWithoutKey`.
|
- `internal/doc`: мост `.doc`→`.docx`, 18 top-level классов (17 package-private + `DocToDocx`) + вложенный `DocxBody`, наружу только `DocToDocx.convert/countPages`; любая бита/шифрованный/Word 6-95 входов → `ConversionException`; раскладки — `docs/agent/doc-bridge.md`;
|
||||||
- Лимиты входа задаёт **только конфигурация сервера**: `wordpdf.max-mb`/`wordpdf.max-pages` (env `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES`), `@Value` в `ConvertController` с дефолтом-SpEL из `WordPdfSettings` (5 МБ / 100); значение ≤ 0 → `IllegalStateException` на старте; параметрами запроса не переопределяются. Ключи в `application.properties` **не объявлены** — пустое значение затенит SpEL-дефолт.
|
- `internal/chart`: Java2D → PNG (`ChartRenderer.DPI = 300`, `MAX_PIXELS` 4096² — `fitDpi` понижает dpi; `MAX_POINTS` 100 000, бюджет chart/math-PNG на документ 128 MiB); формулы OMML — собственный растер `MathModel` (разбор §22.1 в дерево боксов, `SUPPORTED` — единый список конструкций) + `MathRenderer` (без AWT/JEuclid, только бандл через `GlyphFont`); модель **деградации**: битая chart-часть/превышение бюджета → объект удалён + warn; неподдерживаемая/битая формула → **текст** (конкатенация `m:t`) + warn; `wp:extent` вне диапазона/ноль → объект **остаётся** + warn (FOP молча потеряет); `OutOfMemoryError` — не деградация, а `ConversionException` (500);
|
||||||
- SPA: вся сеть в `src/api.ts` (компоненты `fetch` не вызывают); ключ в `localStorage` (`wordpdf.api.key`), при 401 очищается, экран `ApiKeyGate` (`UnauthorizedError` — наследник `ApiError`, проверяется раньше); гейт показывается только когда `probeApiKey()` (GET /api/v1/convert → 401 от `ApiKeyFilter`) подтвердил требование ключа — в dev без ключа форма открывается сразу; запросы на `${import.meta.env.BASE_URL}api/...` (vite `base` из `VITE_BASE`, дефолт `/`) — CORS не нужен (dev: vite-proxy → :8080; prod: nginx с префиксом `/pdf-converter/`).
|
- `fonts/GlyphFont`: метрика/глифы через fontbox напрямую, **без** `java.awt.Font` (fontconfig хосту не нужен).
|
||||||
|
|
||||||
### Chart-движок (`internal/chart`, package-private кроме `DrawingPreRenderer.run`)
|
**Concurrency-инвариант**: `PhysicalFonts` — глобальный мутируемый реестр → все конвертации сериализованы монитором `WordPdfConverter.class` (convert, warmup, DCL-фабрика, мутации `BundledFonts`, `BundledFonts.font()`). Приложение дополнительно держит однопоточный `ThreadPoolExecutor` (очередь 16 → 503, `wordpdf.convert-timeout=2m` → 504), головой очереди стоит `warmup()`; `WordPdfValidator.checkInput` выполняется синхронно до очереди.
|
||||||
|
|
||||||
Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры — в пунктах, EMU→pt `cx/12700.0`). `ChartSpec.parse` (`enum Type`: PIE/PIE3D/DOUGHNUT/BAR/BAR_HORIZONTAL/LINE/AREA/SURFACE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Chart Title"`; палитра `accent1..6` темы, легенда по умолчанию снизу, позиция `t` поддержана, `overlay` → место не резервируется) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word) → пейнтеры `CartesianPainter`/`PiePainter` (`DEPTH_RATIO=0.22`, `TILT_CORRECTION=0.95`, `FIT_MARGIN=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi: `CAMERA_DISTANCE=2.36`, `DEPTH_RATIO=0.705`, `HEIGHT_RATIO=0.664`, `GUTTER_LEFT/RIGHT=0.1485`, `GUTTER_TOP=0.116`, `GUTTER_BOTTOM=0.146`, свет `LIGHT_X/Y/Z=0.83/0.48/0.28`); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`; fit-scale ×0.80); палитра темы — `DrawMlColor` (instance; без ThemePart — дефолтная Office-палитра `accent1=4472C4`…); текст — `DrawMlText`; утилиты `RgbHsl`, `PrstGeomShapes`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`.
|
**REST** (`wordpdf-app`, всё package-private кроме `WordPdfApplication`): `POST /api/v1/convert` (multipart `file` + `errorOnCharts/errorOnSmartArt/errorOnOle`, `maxMb/maxPages` переопределяют серверный дефолт в обе стороны, ≤ 0 → 400; `file.getBytes()` — только после проверки размера; имя файла из `Content-Disposition`, UTF-8 + `.pdf`). Коды: 400 валидация/битые параметры, 401 `ApiKeyFilter` (`X-API-Key` ↔ `wordpdf.api-key`, пусто = выключено, сравнение `MessageDigest.isEqual`; открытые префиксы `/actuator/` (со слэшем!), `/swagger-ui`, `/v3/api-docs`; dot-segment (`..`, `%2e`) заставляет требовать ключ даже на открытых; Advice фильтров не видит — 401 пишет сам), 413 multipart, **422** отказ по графике (`DrawingRejectedException`, фиксированные тексты CHARTS/SMART_ART/OLE — контракт с фронтом), 500 `ConversionFailedException` (текст ядра только в лог, наружу фиксированный), 503 переполнение очереди, 504 timeout; тело ошибки — `{"error": …}` (`record ApiError`). Полная карта, включая 404/405/415, — `docs/agent/repo-map.md`. На `.doc` error-флаги не срабатывают (OLE-вложения — U+0001, мост деградирует в картинки); при снятом флаге `.docx`-OLE теряет data-части, **но сохраняет плейсхолдер-картинку**.
|
||||||
|
|
||||||
### Критические инварианты (нарушение = битый вывод)
|
**SPA** (`wordpdf-web/src`): вся сеть — единственная точка `api.ts` (ровно 2 `fetch`: `convertDocx`, `probeApiKey()` — 401=required / иначе open; ключ в localStorage `wordpdf.api.key`, при 401 стирается; имя файла из `Content-Disposition filename*=utf-8''`); единственный источник состояния — `useState` в `components/App.tsx` (+ `useRef` для `AbortController`/blob-URL), store-библиотек нет; лимиты на клиенте не задаются — только сервер.
|
||||||
|
|
||||||
- `docx4j.convert.out.fo.gsubFeatures=false` — static-блок `WordPdfConverter`. Иначе FO невалиден → `WordLayoutFixups` молча отказывает всем фиксам (без них нет колонок) → FOP падает на `docx4j-baseline`.
|
### Критические инварианты (нарушение = битый вывод, не исключение)
|
||||||
- `slf4j-simple` обязателен в ядре: без SLF4J-провайдера docx4j пишет «TO HIDE THESE MESSAGES» прямо в PDF (регрессия `noLoggingWarningInPdf`). Приложение исключает его из зависимости ядра — логи ведёт logback.
|
|
||||||
- FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.6 (транзитив от `docx4j-export-fo` 17.3.2, в pom не пинится; пакеты `org.apache.fop.*`). `Fop.Renderers.getRenderer()` возвращает **список** (рендер выбирается по mime `application/pdf`). `docx2fo.xslt` в репозитории нет — он в jar `docx4j-export-fo`.
|
|
||||||
- Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; explicit = межсекционные `sectPr` в body + `w:br type="page"` + `pageBreakBefore` (включая таблицы и `w:sdt`). Единственный путь — lightweight (StAX по zip, secure-ридер без DTD/external entities; JAXB-обход удалён — `WordPdfValidator` не зависит от docx4j): атрибуты — по локальному имени (`attrLocal`, не по transitional-URI: иначе в strict-документе `w:br type="page"` не засчитываются); `sectPr` внутри `pPr` не считает, последнюю body-direct секцию не считает, `continuous`-секции не считает, в колонтитулах — только `w:br type="page"`, `pageBreakBefore` — только внутри `pPr` вне `sectPr` (truthy-значения `val`: `null|true|1|on`); на не-zip молчит — подпись проверяет вызывающий. Все отказы — `ValidationException`.
|
|
||||||
- Известный остаток эталона: U+2188/U+218A — глифов нет в OFL-шрифтах бандла, остаются `.notdef` (GNU FreeSerif GPL — не добавляем намеренно).
|
|
||||||
- Внимательно: комментарии в `WordPdfConverter`/`DocxOnOffNormalizer` говорят «docx4j 11.x» — устаревшее число, фактически 17.3.2 (описанное поведение верно); javadoc `PrstGeomShapes` gear «×0.92» vs код `×0.82`.
|
|
||||||
|
|
||||||
### Шрифты (30 TTF + 3 лицензии, SIL OFL, `wordpdf-core/src/main/resources/fonts/`)
|
- Static-блок `WordPdfConverter`: `docx4j.convert.out.fo.gsubFeatures=false` (иначе `WordLayoutFixups` отказывает всем фиксам → FOP падает), `docx4j.fonts.discoverPhysicalFonts.enabled=false`, `discoverJarFonts.enabled=false` — не удалять.
|
||||||
|
- Единственный XSL-FO-стилист — вендорный `wordpdf-core/src/main/resources/xslt/docx2fo.xslt` (копия из docx4j-export-fo 17.3.2 + AUDIT-FIX-патчи); обновление docx4j = ручной перенос патчей; дрейф-гейт `vendoredXsltTracksJarCopy`; команда ре-вендоринга — `docs/agent/repo-map.md`.
|
||||||
7 семейств × 4 начертания (Carlito/Caladea/Arimo/Tinos/Cousine/DejaVu Sans/DejaVu Serif) + Noto Naskh Arabic / Noto Sans Armenian (только regular). Алиасы в `BundledFontMapper.ALIASES` (ключи lowercase): MS→аналоги — Calibri→Carlito, **Calibri Light→Carlito**, Cambria→Caladea, Arial→Arimo, Times New Roman→Tinos, Courier New→Cousine; **self-map** всех бандл-семейств, включая Noto (иначе unmatched уходит в DejaVu-фолбэк); fallback — DejaVu Sans; виртуальный `SYMBOL_FONT` «Segoe UI Symbol» (U+2000–U+2EFF) → fallback до основного цикла. `DISPLAY_NAMES` — обратный маппинг lowercase→отображаемое имя для `documentFontName` (пишет `GlyphCoverageNormalizer` в `w:rFonts`); `BundledFontMapper.bundledFamily` — public-хук «имя шрифта из docx → бандл-семейство или fallback» (пользуется chart-движок). Публичный API `BundledFonts` шире реестра: `families()` (источник для `FopFallbackFonts`), `font/regular/bold/italic/boldItalic(family)`, `FALLBACK_FAMILY`. `GlyphFont` — глиф-движок на fontbox (метрики + растеризация глифов для текста chart-движка и покрытие глифов в `GlyphCoverageNormalizer`); читает TTF напрямую из classpath (не зависит от `init()`); рантайм не требует fontconfig/системных шрифтов — `java.awt.Font` из рантайм-пути убран, AWT остаётся только как геометрия Graphics2D. Новый шрифт = файл + запись в `BundledFonts.ENTRIES` (синхрон проверяет `BundledFontsTest`).
|
- `slf4j-simple` обязателен в ядре: без SLF4J-провайдера docx4j пишет «TO HIDE THESE MESSAGES» прямо в PDF; в app исключён (logback). Fontbox логируется commons-logging — единственный мост `jcl-over-slf4j`; `commons-logging` исключён из pdfbox/fontbox в dependencyManagement.
|
||||||
|
- FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.6 (транзитив от `docx4j-export-fo`, в pom не пинится); `jeuclid-fop`/`jeuclid-core` исключены из `docx4j-export-fo` в core-pom (тянут AWT/fontconfig); расхождения с upstream-доками FOP нормальны; `lineRule=auto` не «чинить».
|
||||||
|
- Chart-media префикс `/word/media/chart-*` — константа `DrawingPreRenderer.CHART_MEDIA_URI_PREFIX` (package-private), пакетный контракт с `ChartImageHandler` (отключение пересжатия); переименование молча вернёт мыльный ресемпл.
|
||||||
|
- Стоп-лист «не чинить» (до любой попытки починить расхождение с Word — `docs/agent/render-limitations.md`): `jc="distribute"`, `suff="tab"`/`lvlJc`, кернинг, `framePr`, `REF`/`SEQ`/`TOC`-кэш, руби-надстрочница, `ptab`, U+2188/U+218A (GPL-шрифты не добавляем).
|
||||||
|
|
||||||
## Key Directories
|
## Key Directories
|
||||||
|
|
||||||
|Путь|Назначение|
|
|Каталог|Назначение|
|
||||||
|---|---|
|
|---|---|
|
||||||
|`wordpdf-core/src/main/java/ru/pjandro/wordpdf/`|публичный API: `WordPdfConverter`, `WordPdfValidator` (перегрузки `checkInput`/`checkPageCount` и `validate(byte[], ConvertOptions)` — полная цепочка; без зависимости от docx4j), `ConversionException`, `ValidationException` (наследник — «вход некорректен»), `DrawingFoundException` (`enum Kind {CHARTS, SMARTART}` — отказ по error-флагу), `WordPdfSettings` (константы-дефолты: `MAX_INPUT_MB=5`, `MAX_PAGES=100`, защитные `MAX_DECOMPRESSED_MB=200`/`MAX_ZIP_ENTRIES=8192`, `RENDER_*=true`, `ERROR_*=false`), `ConvertOptions` (record: renderCharts, renderSmartArt, errorOnCharts, errorOnSmartArt, maxMb, maxPages)|
|
|`wordpdf-core/src/main/java/ru/pjandro/wordpdf/`|публичный API + `internal/` (нормализаторы) + `internal/doc/` (мост) + `internal/chart/` (рендер) + `fonts/`|
|
||||||
|`…/wordpdf/fonts/`|`BundledFonts` (реестр/выгрузка TTF, `families()`, `FALLBACK_FAMILY`), `BundledFontMapper` (алиасы MS→open-source, self-map, DISPLAY_NAMES, public-хук `bundledFamily`), `GlyphFont` (глиф-движок fontbox: метрики/глифы без java.awt.Font)|
|
|`wordpdf-core/src/main/resources/`|`fonts/` (30 TTF + лицензии OFL/Bitstream-Vera/Noto), `xslt/docx2fo.xslt`, `slf4j-simple.properties`|
|
||||||
|`…/wordpdf/internal/`|5 байтовых нормализатора + `FopFallbackFonts` (классы `public` — вызываются из родительского пакета; публичные члены только `normalize`/`declare`)|
|
|`wordpdf-core/src/test/resources/samples/`|фикстуры: 13 `.docx` + 12 `.doc` (закоммичены, билдятся в test-jar для app; у app своего `src/test/resources` **нет**)|
|
||||||
|`…/wordpdf/internal/chart/`|11 классов Java2D-рендера диаграмм/SmartArt в PNG (public только `DrawingPreRenderer`)|
|
|`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST-слой (11 классов)|
|
||||||
|`wordpdf-core/src/main/resources/fonts/`|30 TTF + 3 лицензии — бинарные фикстуры, часть jar|
|
|`wordpdf-web/src/`|SPA: `api.ts` (вся сеть), `components/` (`App.tsx` — состояние, `ApiKeyGate`, `DropZone`, `PdfPreview`, `StatusMessage`, `Logo`)|
|
||||||
|`wordpdf-core/src/test/resources/samples/`|11 закоммиченных `.docx`-фикстур (единственные фикстуры)|
|
|`prod-autotests/`|pytest-проверки живого стенда (31: 4 открытые + 27 `needs_key`)|
|
||||||
|`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 5 класса исключений|
|
|`docs/agent/` · `docs/standards/`|справочники поведения · закоммиченные спецификации (ECMA-376, MS-DOC/CFB/ODRAW…, навигатор — `docs/standards/README.md`)|
|
||||||
|`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)|
|
|`gateway/nginx.conf`|прод-like шлюз (`client_max_body_size 100m`, таймауты 300 с, `resolver` привязан literal-ом к шлюзу сети)|
|
||||||
|корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-**21-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose не в репо — его рендерит job `deploy` (лимиты запекаются из Variables); podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)|
|
|`develop/`|вне git (gitignored): эталоны Word — **не фикстуры**, в тесты/jar не подключать|
|
||||||
|корневой `.env.example`|шаблон env для локальных/compose-стендов: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает старт — binding long/int); проду `.env` **не нужен**: ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables, legacy-`.env` на проде удаляется деплоем|
|
|
||||||
|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты → `images` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)|
|
|
||||||
|корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений|
|
|
||||||
|корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 20 проверок): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`|
|
|
||||||
|`develop/` (вне git)|рабочие материалы и эталоны Word (`testDoc.doc/.pdf`, `testDoc.convert.pdf`, `openxml.docx/.pdf`) — **ручное сравнение, не фикстуры**, в тесты/jar не подключать|
|
|
||||||
|
|
||||||
## Development Commands
|
## Development Commands
|
||||||
|
|
||||||
|
Бутстрап: `sh bootstrap.sh` (Windows: `powershell -ExecutionPolicy Bypass -File .\bootstrap.ps1`) — project-local mise 2026.10.19 в `./.mise/` + `mise install` + `npm ci` web; дальше всё через `./mise.sh` / `.\mise.ps1` (тонкие exec-обёртки; инструменты — в `~/.local/share/mise`).
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
mvn clean verify # все модули + тесты + PMD (pmd-ruleset.xml) — обязательный гейт перед push
|
./mise.sh run verify # = mvn clean verify: тесты + PMD + JaCoCo (гейт перед push)
|
||||||
mvn -pl wordpdf-app -am package # исполняемый jar бэкенда
|
./mise.sh run verify-nofontconfig # тот же verify в контейнерах без fontconfig (как CI)
|
||||||
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar # :8080, ключ выключен
|
mvn test -Djacoco.skip=true # работает: пустой <argLine> по умолчанию в корневом pom
|
||||||
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
|
|
||||||
mvn -pl wordpdf-core test -Dtest=WordPdfConverterTest#pageNumbers_recomputedNotCached
|
mvn -pl wordpdf-core test -Dtest=WordPdfConverterTest#pageNumbers_recomputedNotCached
|
||||||
mvn -pl wordpdf-app -am test -Dtest=ConvertControllerTest#convertSample_returnsPdf # -am обязателен (test-jar core)
|
mvn -pl wordpdf-app -am test -Dtest=ConvertControllerTest#convertSample_returnsPdf # -am обязателен: core test-jar
|
||||||
npm run dev # (wordpdf-web/) SPA :5173, vite-proxy /api|/swagger-ui|/v3/api-docs → :8080
|
./mise.sh run app-package && ./mise.sh run app-run # jar :8080, ключ выключен
|
||||||
npm run build # (wordpdf-web/) tsc -b && vite build — гейт SPA; lint: npm run lint (oxlint)
|
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
|
||||||
podman-compose -f compose.dev.yml up -d --build # dev-стенд: http://<LAN-IP хоста>:9011 (0.0.0.0), без ключа, springdoc вкл
|
./mise.sh run web-install|web-build|web-lint|web-dev # npm ci | tsc -b && vite build | oxlint | vite :5173
|
||||||
|
./mise.sh run mem-bench # membench.sh + core MemoryBench (MB_LABEL, --scenario suite|big|all, --dir develop/)
|
||||||
|
podman-compose -f compose.dev.yml up -d --build --force-recreate # dev-стенд :9011, без ключа
|
||||||
|
podman-compose up -d --build # prod-like стенд :9010 — fail-closed: нужен .env с WORDPDF_API_KEY (шаблон .env.example)
|
||||||
|
./mise.sh run prod-tests # pytest; обязателен WORDPDF_BASE_URL
|
||||||
|
./mise.sh run docs-install|docs-serve|docs-build|docs-javadoc|docs-deploy # сайт документации (MkDocs Material): venv+pip | preview :8000 | strict-сборка в site/ | javadoc core | публикация в ~/srv/wordpdf-docs (юнит wordpdf-docs.service, :9012)
|
||||||
|
python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources/samples/*.docx # XSD (lxml)
|
||||||
```
|
```
|
||||||
|
|
||||||
Пересоздать 10 фикстур (POI, test scope; `charts-smartart.docx` НЕ генерируется — создана вручную, не перезаписывать):
|
- «Запусти тестовый сервер» (термин пользователя) = dev-стенд выше, **не** `java -jar`; вход — `http://<LAN-IP>:9011` (`hostname -I`); гейт готовности — контейнеры healthy (`podman-compose -f compose.dev.yml ps`) + корень SPA 200; `--force-recreate` обязателен.
|
||||||
|
- `mvn test` PMD и проверки JaCoCo **не** запускает (оба на `verify`; сам агент JaCoCo подключается и на `test` — execution `prepare-agent` на `initialize`); `mvn -pl wordpdf-app` без `-am` падает (зависимость от core test-jar).
|
||||||
```bash
|
- Деплой — push в `main` → Gitea Actions (детали — `docs/agent/ci-cd.md`); **перед деплоем/перезапуском прочитать `/home/pjandro/prod/java-word-pdf/DEPLOY.md`** (вне репо); ручных скриптов нет.
|
||||||
mvn -pl wordpdf-core test-compile -Dmdep.outputFile=/tmp/cp.txt dependency:build-classpath -q
|
|
||||||
java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
|
|
||||||
ru.pjandro.wordpdf.SampleDocxGenerator wordpdf-core/src/test/resources/samples
|
|
||||||
```
|
|
||||||
|
|
||||||
Деплой. **Прод** — на пользовательском LAN-сервере (podman + podman-compose, docker-бинарников нет); координаты сервера и гейты успешности — вне репо: `/home/pjandro/prod/java-word-pdf/DEPLOY.md` (обязательно прочитать перед любым деплоем/перезапуском). Прод-хост **не хранит ни деплой-конфигурации, ни секретов**: job `deploy` в `main.yml` на каждый деплой рендерит `docker-compose.yml` и `nginx.conf` в директорию деплоя (значения — из Variables `REGISTRY`/`DEPLOY_HOST`/`WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES`, API-ключ — из Secret `WORDPDF_API_KEY` через окружение деплоя, на диск не пишется), затем login/pull/`up -d --force-recreate app web`/гейты healthy+image/recreate gateway. Наследие ручного setup `restart.sh` и `.env` деплой удаляет; единственное состояние на проде — `.rollback.env` (image ID для отката). Перезадеплой — push в `main` или Run workflow (`workflow_dispatch`), ручных скриптов нет. В прод попадает только собранное CI из `main`; прод не собирает код и git-клона на проде нет (insecure-запись реестра в `/etc/containers/registries.conf.d/`). Рендеренный compose содержит podman-специфику: `x-podman.name_separator_compat` (имена `wordpdf-prod-app-1`, от них зависят гейты), явные healthcheck app/web — `wget` (alpine-jre образ curl не содержит; curl-хелсчек на новом образе давал вечный unhealthy и висящий `up`), наружный порт gateway `9010` и фиксированная подсеть `10.112.0.0/24` gw `10.112.0.1` — внутренняя геометрия стека, литералом в workflow (не координата стенда, Variables для неё не заведены). Наружный вход `https://pjandro.ru/pdf-converter/` (префикс срезает наружный nginx прод-хоста, не репозиторный gateway-конф; прод-копия gateway-конфа рендерится workflow и отличается от репо только резолвером `10.112.0.1` — под свою подсеть — и `proxy_read_timeout 300s` — в репо его нет, дефолтные 60s рвут 2-минутные конвертации; resolver + `proxy_pass` через переменную есть и там и там). Тот же наружный nginx в `location /pdf-converter/` добавляет `X-Forwarded-Host`/`X-Forwarded-Prefix` — из них springdoc собирает server-URL спека под префиксом. **Dev-стенд** — из репо `compose.dev.yml` (проект `wordpdf-dev`, `9011:80` на все интерфейсы, без env → ключ пуст, springdoc вкл). Репозиторный `compose.yml` — третий вариант (проект `wordpdf`, `9010:80`, `WORDPDF_API_KEY` fail-closed без `.env` — `up` упадёт; `VITE_BASE` — build-arg `wordpdf-web/Containerfile`, репо-compose НЕ передаёт: `compose build` без arg даёт base `/` и битые ассеты под префиксом; на прод-путь не влияет — там `VITE_BASE=/pdf-converter/` запекает CI в job `images`). Запуск по просьбе пользователя = прод-стек; dev/`java -jar`/`npm run dev` — внутренняя отладка.
|
|
||||||
|
|
||||||
## CI/CD (Gitea Actions)
|
|
||||||
|
|
||||||
Два workflow. `.gitea/workflows/pr.yml` — `PR checks` (`pull_request` + `workflow_dispatch`):
|
|
||||||
job `java` (temurin 21, кеш `~/.m2` через `actions/cache`, Maven 3.9.16 ставится вручную с dlcdn, `mvn -B clean verify`)
|
|
||||||
и `web` (кеш `~/.npm`, `npm ci`/`build`/`lint`). `.gitea/workflows/main.yml` — `Main: tests,
|
|
||||||
deploy, autotests` (`push` в `main` + `workflow_dispatch`): те же `java`/`web` (байт-в-байт
|
|
||||||
дубль — файлы самодостаточны, reusable-workflow не вводить), затем `images` (`docker build`
|
|
||||||
обоих Containerfile + `docker push` в Nexus-реестр `${{ vars.REGISTRY }}`, теги `prod` +
|
|
||||||
immovable `sha-<7 символов GITHUB_SHA>`; web пекётся с `--build-arg VITE_BASE=/pdf-converter/`;
|
|
||||||
`DOCKER_BUILDKIT=0` обязателен — daemon за раннером podman, BuildKit-сессий нет; креды —
|
|
||||||
вручную пишется `~/.docker/config.json`, job-контейнеры видят podman-сокет хоста — настройка
|
|
||||||
раннера вне репо, см. DEPLOY.md), `deploy` (SSH на прод: рендер `docker-compose.yml`
|
|
||||||
и `nginx.conf` в директорию деплоя (Variable `DEPLOY_DIR`) из Variables/Secrets —
|
|
||||||
на проде конфигурации не хранится; сохранение `.rollback.env` — image ID контейнеров
|
|
||||||
app/web; login/pull/`up -d --force-recreate app web`; гейты healthy и image;
|
|
||||||
`up -d --force-recreate gateway`; health-check. Лимиты задают Variables
|
|
||||||
`WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES`, `autotests`/`rollback` используют те же), `autotests` (venv +
|
|
||||||
`prod-autotests/` против прода),
|
|
||||||
`rollback` (`if: failure()` — retag прежних image ID на `${{ vars.REGISTRY }}/wordpdf-app:prod`
|
|
||||||
и `…/wordpdf-web:prod`, `--force-recreate app web`, пересоздание gateway). Кеш раннеров —
|
|
||||||
сервер act_runner (серверная часть, вне репо).
|
|
||||||
|
|
||||||
**Правило: координаты прода и креды в коммитимые файлы не попадают** — ни внутренние IP, ни
|
|
||||||
SSH-пользователи/логины, ни хосты, ни директория деплоя, ни ключи/токены/пароли. Координаты
|
|
||||||
стенда — Gitea Actions **Variables** (`DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_DIR`,
|
|
||||||
`WORDPDF_BASE_URL`, `WORDPDF_MAX_PAGES`, `WORDPDF_MAX_MB`, `REGISTRY`), креды — **Secrets** (`DEPLOY_SSH_KEY`,
|
|
||||||
`WORDPDF_API_KEY`, `REGISTRY_USER`, `REGISTRY_PASSWORD`); workflow-файлы ссылаются на них только `${{ vars.* }}`/`${{ secrets.* }}`.
|
|
||||||
Инструкция владельца — корневой `GITEA-vars.md` (только имена, без значений). Защита ветки
|
|
||||||
`main`: required-контексты **`PR checks / java (pull_request)`, `PR checks / web (pull_request)`**
|
|
||||||
(формат Gitea 1.26; deploy/autotests в список НЕ включать — на PR не бегут, мерж блокировался бы навсегда).
|
|
||||||
|
|
||||||
## Code Conventions & Common Patterns
|
## Code Conventions & Common Patterns
|
||||||
|
|
||||||
- Классы `final`, приватный конструктор, только `static` (stateless, DI нет; конфигурация — `Docx4jProperties` + classpath-ресурсы). Исключения — экземпляры по природе: docx4j-наследник `BundledFontMapper` (`extends BestMatchingMapper`), обёртка цветов `DrawMlColor` (тоже instance, но НЕ наследник docx4j) и Spring-компоненты `wordpdf-app`.
|
- Классы `final`, приватный конструктор, только `static` (stateless, DI в ядре нет). Исключения-экземпляры: `BundledFontMapper`, Spring-компоненты app. В `internal/**` классы package-private; `public` — только вызываемые извне пакета, контракт не расширять.
|
||||||
- Нормализаторы — единая сигнатура `public static byte[] normalize(byte[] docx) throws IOException` с флагом `changed`: нечего менять → вернуть **тот же массив** (`assertSame` в тестах); package-private хук `static String rewrite(String xml)` для юнит-тестов (возвращает `null` при отсутствии изменений); правятся только части `word/*.xml`.
|
- Ошибки публичного API — только `ConversionException extends RuntimeException`; `ValidationException` не оборачивать; в chart — деградация вместо падения; текст 500 наружу фиксированный (сообщения ядра логируются, не отдаются).
|
||||||
- Ошибки публичного API — только `ConversionException extends RuntimeException`; внутренние исключения оборачиваются на границе. В chart — деградация вместо падения.
|
- Javadoc на русском: «зачем» со ссылкой на секцию спецификации (§17.3.2.24, [MS-DOC] §2.6.1…) + что сломается без шага + регрессия в формате `Регрессия — WordPdfConverterTest#имя, фикстура samples/….docx` (по этой строке грепом восстанавливаются пары «нормализатор-тест ↔ тест-в-конвейере»).
|
||||||
- Javadoc на русском, объясняет «почему» и ссылается на регрессию и фикстуру (формат: `Регрессия — WordPdfConverterTest#имя, фикстура samples/….docx`) — новый фикс оформлять так же (в существующем main-коде convention соблюдён лишь частично — `SymbolFontNormalizer`, `WordPdfValidator`, `Surface3dPainter` и классы app; новые правки обязаны ссылаться).
|
- Логирование по пакетам: `java.util.logging` — корневой пакет и `internal/` (`WordPdfConverter`, `OleObjectNormalizer`, `DocToDocx`); SLF4J — `internal/chart` (`ChartRenderer`, `DrawingPreRenderer`) и `wordpdf-app`; остальное молчит.
|
||||||
- Константы UPPER_SNAKE с числовыми эталонными значениями (`CAMERA_DISTANCE`, `MAX_PAGES`); начертания `V_REGULAR/V_BOLD/...`; модели — `record`; размеры в chart — в пунктах, растр × `DPI/72`.
|
- Модели — `record` (`ConvertOptions`, `BundledFonts.Entry`, `MathRenderer.MathImage`, `ApiError`); константы UPPER_SNAKE с javadoc-обоснованием числа; holder-идиомы для ленивой инициализации (`VendoredXslt.TEMPLATES`); DCL+caches (`sharedFopFactory`, `GlyphFont.CACHE`); compile-time literals там, где важен инлайн (`WordPdfConverter` ↔ `WordPdfValidator`).
|
||||||
- Классы в `internal` — `public` (иначе родительский пакет не вызвал бы), но публичные члены наружу только `normalize`/`declare`/`DrawingPreRenderer.run` (`rewrite`, `split`, карты — package-private); в `wordpdf-app` всё package-private кроме `WordPdfApplication`.
|
- Шрифты: новый шрифт = файл в `resources/fonts/` + запись в `BundledFonts.ENTRIES` (синхрон проверяет `BundledFontsTest`); алиасы — `BundledFontAliases.ALIASES` (Calibri→Carlito, Cambria→Caladea, Arial→Arimo, Times New Roman→Tinos, Courier New→Cousine, …; вынесено из `BundledFontMapper`, чтобы обращение к статикам не инициировало ungated-скан `BestMatchingMapper.<clinit>`), fallback — DejaVu Sans.
|
||||||
- Тестовые методы: регрессионные — `объект_условие` через underscore (`ruPlain_cyrillicAndStyles`, `checkInput_bytesOverLimit`, `noKey_rejected`); чистые юниты — camelCase (`pageFieldBecomesFldSimple`, `splitsRunForUncoveredGlyph`).
|
- PMD (`pmd-ruleset.xml`, execution `pmd-check` на `verify`, `includeTests=true`, валит любой приоритет): правила не перенастраивать, подавления (`@SuppressWarnings("PMD…")`, `// NOPMD`) запрещены — нарушения чинятся кодом.
|
||||||
|
- Git: origin `git.pjandro.ru:pjandro/java-word-pdf`; защищённые `main`/`master`/`dev`; все правки — через PR в дефолтную ветку; push — только после `./mise.sh run verify`. Прод-координаты и креды в репо не попадают (Gitea Variables/Secrets — `GITEA-vars.md`; прод-ключ — только Gitea Secret; локальный `.env` gitignored, только для prod-like стенда).
|
||||||
|
|
||||||
## Important Files
|
## Important Files
|
||||||
|
|
||||||
- `wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java` — точка входа библиотеки + static-блок `gsubFeatures`.
|
|Файл|Что держать в голове|
|
||||||
- `wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfSettings.java` — все дефолты ядра (`MAX_INPUT_MB` 5, `MAX_PAGES` 100, `RENDER_CHARTS/SMARTART`); рантайм-конфигурации в ядре нет.
|
|---|---|
|
||||||
- `wordpdf-app/src/main/resources/application.properties` — multipart 100MB (`max-file-size`/`max-request-size` + `file-size-threshold=100MB`, держит файл в памяти; в тон gateway `client_max_body_size 100m`), `wordpdf.convert-timeout=2m`, пустой `wordpdf.api-key`, `server.forward-headers-strategy=framework` (префикс прод-прокси для springdoc) + `springdoc.swagger-ui.persist-authorization=true`; `wordpdf.max-mb`/`max-pages` здесь намеренно нет.
|
|`pom.xml` (корень)|единственное место версий (properties + dependencyManagement): docx4j 17.3.2, commons-compress 1.28.0, slf4j 2.0.20, Boot 4.1.1 BOM, springdoc 3.1.1, JUnit 6.1.3, PDFBox/fontbox 3.0.8, POI 5.5.1 (test), JaCoCo 0.8.15, PMD-плагин 3.21.2; там же плагины: compiler 3.16.0, surefire 3.6.0 (`-Djava.awt.headless=true`), jar 3.5.1; пустой `<argLine/>` — ради `-Djacoco.skip=true`|
|
||||||
- `wordpdf-app/pom.xml` — `spring-boot-maven-plugin` с **явной** execution `repackage` (в 4.1.1 сам не связывается, jar останется тонким); `slf4j-simple` исключён; `spring-boot-starter-webmvc` (Boot 4: переименован из starter-web) + `spring-boot-starter-actuator` (нужен HEALTHCHECK контейнера `/actuator/health`); тест-зависимости: `spring-boot-webmvc-test` (в Boot 4 автоконфиг MockMvc вынесен из starter-test), test-jar core.
|
|`wordpdf-core/src/main/java/.../WordPdfConverter.java`|весь конвейер, static-блок sysprops, пороги-константы, монитор сериализации|
|
||||||
- `wordpdf-core/pom.xml` — `maven-jar-plugin` execution `test-jar` (публикует фикстуры для app).
|
|`wordpdf-app/src/main/resources/application.properties`|multipart 100MB/100MB (зеркалит nginx `client_max_body_size`) + `file-size-threshold=2MB` (сброс больших частей на диск — защита от OOM), `convert-timeout=2m`, `api-key=` (пусто = auth off), `forward-headers-strategy=framework`; `wordpdf.max-mb`/`max-pages` здесь **не объявлять намеренно** — пустое значение затенит `@Value`-дефолты 5/100 (≤ 0 на старте → `IllegalStateException`)|
|
||||||
- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox `3.0.8` (test), POI `5.5.1` (test, только генератор фикстур), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; pluginManagement: compiler `3.16.0`, surefire `3.6.0` с `-Djava.awt.headless=true`, jar `3.5.1`, PMD `3.28.0`.
|
|`wordpdf-core/pom.xml` / `wordpdf-app/pom.xml`|execution `test-jar`; BRANCH-гейт 0.85 (только core); exclusions: jeuclid (core), `slf4j-simple` (app); Boot-4 имена: `spring-boot-starter-webmvc` (не `-web`), отдельный `spring-boot-webmvc-test`; `repackage` привязан явно|
|
||||||
- Корневой `pmd-ruleset.xml` — ruleset PMD (см. Testing & QA): `category/java/codestyle.xml` минус opinionated-правила, `MethodNamingConventions` с `junit5TestPattern` под underscore-имена регрессий, `TooManyStaticImports` до 12, XPath-правило `LiteralFirstInEquals`, unused-правила из `bestpractices.xml`.
|
|`Containerfile` / `Containerfile.test` / `compose*.yml` / `gateway/nginx.conf`|прод-образ (heap 2G, mem_limit 3G, wget-healthcheck, FQDN FROM, non-root 10001, обнуление прокси на команде) / CI-гейт без fontconfig (Debian-база — alpine amd64-only; `SUREFIRE_OS_NAME` для macos-sim) / стенды :9010–:9011 / шлюз. Нюанс: repo `compose.yml` (prod-like) гасит springdoc env-ами и требует `.env`-ключ, а реальный прод из CI-рендера держит swagger открытым (`test_swagger_ui_open_without_key`) — не путать|
|
||||||
- `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF.
|
|`.gitea/workflows/pr.yml`, `main.yml`, `.ci/maven-settings.xml`|CI: jobs `java`/`web` в обоих — идентичные шаги, в `pr.yml` дополнительно `macos-sim` (те же тесты с `--build-arg SUREFIRE_OS_NAME="Mac OS X"`, только на PR, не required-гейт); `main.yml`: `images-* → deploy → autotests (+ rollback при failure)`; Maven в CI живёт в контейнере `maven:3.9-eclipse-temurin-17`; зеркало `${env.MAVEN_MIRROR_URL}`, `mirrorOf="*"`|
|
||||||
- `gateway/nginx.conf` — единственный вход: `/api/`, `/swagger-ui`, `/v3/api-docs`, `/actuator` → `app:8080`, остальное → `web:80`; `client_max_body_size 100m` (без директивы upload режется HTML-413 шлюза вместо JSON-ошибки API); `resolver 10.113.0.1` + `proxy_pass` через переменные (статический proxy_pass резолвит имя один раз при старте — gateway раньше app поднялся бы с 502 до перезапуска). `wordpdf-web/nginx.conf` — чистая статика с SPA-fallback, `/api` НЕ проксирует.
|
|`wordpdf-web/src/api.ts`, `vite.config.ts`|вся сеть SPA; `base` — только через env `VITE_BASE` (в прод-образ запекается `--build-arg VITE_BASE=/pdf-converter/` в job `images-web`)|
|
||||||
- `wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур.
|
|`mise.toml`, `GITEA-vars.md`|пины инструментов и все таски / полный список Secrets+Variables CI и настройка branch protection|
|
||||||
- `wordpdf-web/vite.local.config.ts` — легаси-одноразовщик (прокси `/api` → :8091), коммит против воли автора (`*.local` в gitignore не накрывает `.ts`-суффикс), в `tsconfig.node.json` не включён; кандидат на удаление, не тиражировать паттерн.
|
|
||||||
|
|
||||||
## Runtime & Tooling Preferences
|
## Runtime/Tooling Preferences
|
||||||
|
|
||||||
- Java 21 + Maven (обязательны; wrapper `mvnw` нет); UTF-8. Только Maven — никакого Gradle/Ant.
|
- Java 17 temurin + Maven 3.9.16 + Node 24 + Python 3.15 — пинины в `mise.toml`, всё через project-local mise (`./.mise/bin/mise`, вне системы); `mvnw` **нет** (`.mvn/` — пустой) — только Maven из mise. UTF-8.
|
||||||
- Версии зависимостей — только в корневом `pom.xml` (properties + dependencyManagement); новые зависимости — latest stable.
|
- Только Maven (никаких Gradle/Ant). Версии зависимостей/плагинов — только в корневом `pom.xml`; FOP-форк отдельно не пинить; `commons-compress` не завышать (привязан к docx4j 17.3.2); `<repositories>` в pom не добавлять (зеркало — через settings).
|
||||||
- Фронт: Node `^20.19.0 || >=22.12.0` (engines vite/oxlint из lockfile; 21.x и 22.0–22.11 НЕ поддерживаются), npm с закоммиченным `package-lock.json` (`npm ci`); vite `^8.3`, React `^19.2`, TS `~6.0` (**`strict` нигде не включён** — `npm run build` не является strict-гейтом), Tailwind `^4.3`, oxlint `^1.81`; podman-сборка web на `node:24-alpine`.
|
- Веб: только npm (`package-lock.json` закоммичен; никаких pnpm/yarn); линтер — oxlint (не eslint).
|
||||||
- Контейнеры (podman/buildah): `FROM` только FQDN (`docker.io/library/...` — short-name не резолвится без `unqualified-search-registries`); buildah подмешивает хостовые прокси-переменные в `RUN`/`HEALTHCHECK` — обнулять `HTTP_PROXY= http_proxy= …` **на самой команде** (ENV не перебивает).
|
- Контейнеры: podman/buildah; `FROM` только FQDN; хостовые прокси-переменные обнулять на самой команде в `RUN`/`HEALTHCHECK`; `DOCKER_BUILDKIT=0` (CI); healthcheck через wget, не curl; fontconfig рантайму не нужен (глифы — fontbox); alpine-теги maven/temurin amd64-only — тестовый образ на Debian-базе.
|
||||||
- CI, форматтеров, checkstyle для Java — нет; статический линтер — PMD на `verify` (см. Testing & QA); проверка одна: `mvn clean verify`.
|
- Сеть: наружу публикуется только gateway (9010/9011); 8080/80 наружу не выставлять; подсети compose зафиксированы (nginx `resolver` привязан literal-ом к шлюзу сети — 10.113.0.1 стенды / 10.112.0.1 прод).
|
||||||
- Исполняемый jar бэкенда проверять только `java -jar` (тесты идут по classpath и repackage-специфику не видят; `BundledFontsTest#listedFilesCoverAllTtfInResources` требует `file:`-протокол classpath — только surefire, не fat-jar).
|
- Прод-стек (`docker-compose.yml`, `nginx.conf`) рендерится job'ом `deploy` из Variables — копий на хосте/в репо не заводить; required-контексты защиты `main` (по `GITEA-vars.md`) — буквально `PR checks / java (pull_request)`, `PR checks / web (pull_request)`; `macos-sim`, deploy/autotests — не required.
|
||||||
- Git: origin `git.pjandro.ru:pjandro/java-word-pdf`, `main`/`dev` защищены (правила глобального AGENTS.md; локально только `main`).
|
|
||||||
|
|
||||||
## Testing & QA
|
## Testing & QA
|
||||||
|
|
||||||
- Гейт `maven-pmd-plugin` 3.28.0 (PMD 7.17) на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются).
|
- Гейты на `verify`: PMD (движок 6.55.0 — default внутри maven-pmd-plugin 3.21.2, отдельно в pom не пинится; осознанный откат — ruleset использует удалённые в PMD 7 `*MustUseBraces`; подавлений в коде нет и быть не должно) + JaCoCo: LINE ≥ 0.90 оба модуля, BRANCH ≥ 0.85 только core; при провале отчёт уже в `target/site/jacoco/` (`report` привязан до `check`). CI-эквивалент — `./mise.sh run verify-nofontconfig`.
|
||||||
- 15 тестовых классов / 144 `@Test` (core 12/118, app 3/26). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
|
- Стек: JUnit 6 (`org.junit.jupiter`), **только `Assertions`** — Mockito/AssertJ запрещены и в pom их нет; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` (полностью квалифицирован, без импортов) в `andExpect`; app не объявляет junit сам — только через `spring-boot-starter-test`. Тестовые классы package-private, зеркалят main-пакеты; только `@Test` (исключения: два `@BeforeAll` прогрева шрифтов и `@AfterEach drainWorker` в `ConversionTimeoutTest`); ни `@Nested`, ни `@ParameterizedTest`, ни `@Disabled`, ни `assertAll`.
|
||||||
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах).
|
- Именование: регрессионные — `объект_условие` (`pageNumbers_recomputedNotCached`), юниты — camelCase (`pageFieldBecomesFldSimple`).
|
||||||
- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word, допуски `assertRatio` <0.06 (`PiePainterTest` аспект h/w=0.585) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px и перцентильные коридоры яркости. Эталонные замеры — по Word-экспорту 300 dpi (`develop/`, вне git).
|
- **PDF сравнивается текстом**: PDFBox 3 `PDFTextStripper` (`norm` схлопывает пробелы; негативные маркеры — `#`/`.notdef` и `Helvetica`; приём `fontNameOf` — имя шрифта символа, живёт только в `WordPdfConverterTest`). Пиксели — только юниты chart-пейнтеров (`assertRatio` < 0.06 / < 0.10, эталонные числа Word-рендеров 300 dpi захардкожены). Тестовых утилит нет — хелперы намеренно дублируются в классах. Сообщения ассертов — по-русски с наблюдаемым значением; литерал слева (`"%PDF".equals(…)`).
|
||||||
- `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig.
|
- Фикстуры — только закоммиченные `samples/*.docx`/`*.doc`, в тестах не генерировать; XSD-невалидная фикстура правится, не код. Синтетика в памяти разрешена: docx — `ZipOutputStream` из литеральных XML, `.doc` — крафт `POIFSFileSystem`. Пересоздание — одноразовые `SampleDocxGenerator`/`ChartTypesDocxGenerator` (POI test-scope, команда — `docs/agent/repo-map.md`); `charts-smartart.docx` и `ole-embedded.docx` сделаны руками — **никогда не перезаписывать** (все 12 `.doc` — эталоны заказчика, не вывод генераторов).
|
||||||
- Фикстуры — закоммиченные `samples/*.docx` (11; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject).
|
- Идиома загрузки (ловушка): **core** — classloader без ведущего слэша (`getResourceAsStream("samples/…")`); **app** — class-relative со слэшем (`"/samples/…"`, ресурсы из core test-jar).
|
||||||
- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`).
|
- App-тесты: 4 набора свойств = 4 Spring-контекста (`ConvertControllerTest` пинует пустой `wordpdf.api-key=`; `ApiKeyFilterTest`; `ConvertLimitsTest`; `ConversionTimeoutTest`); `ConversionServiceTest`/`ApiExceptionHandlerTest` — без Spring; проверяют только HTTP-код/заголовки/текст ошибки; core-юниты Spring не поднимают. Ловушка: mise инжектирует корневой `.env` в окружение задач — ambient `WORDPDF_API_KEY` взорвёт 401 все MockMvc-тесты, если ключ не запинен свойствами контекста.
|
||||||
- App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest` (`@TestPropertySource` с лимитами — отдельный класс, не `@Nested`).
|
- Регрессивная конвенция: фикс = нормализатор/рендерер + юнит + конвертер-тест + javadoc-ссылка. Счётчики (2026-11): 63 класса / 1005 тестов (core 57/957, app 6/48); детали — `docs/agent/testing.md`.
|
||||||
- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`↔`inputNotAZip_rejectedBeforeRender`, `validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`↔`plainZipNotDocx_rejected`/`inputNotDocx_rejectedBeforeRender` — контейнер и zip-бомба), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingToggles_offRemovesRasters`/`drawingToggles_chartsOffSmartArtOn`, `drawingErrors_*`↔app `errorFlagCharts_rejected`/`errorFlagSmartArt_rejected`/`errorFlags_renderWins`); `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `plainZipNotDocx_rejected` (голый zip без манифеста → 400), `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `renderFlagsOff_convertsWithoutDrawings`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath).
|
- Прод-автотесты: pytest 9.1.1 + requests 2.34.2 (timeout `(10,180)` — больше серверных 2m), конфигурация **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY` факультативен → `needs_key`-декоратор `skipif` (немаркированный marker — маркеры не регистрируются) даёт SKIP, `WORDPDF_MAX_MB`/`MAX_PAGES` — ожидаемые лимиты стенда 5/100, `WORDPDF_SAMPLES_DIR` — путь к фикстурам); запуск `./mise.sh run prod-tests` либо job `autotests` в CI.
|
||||||
- UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9 + requests, 20 проверок, env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода; `WORDPDF_API_KEY` пуст → честный SKIP `@needs_key`-проверок.
|
|
||||||
|
|||||||
+18
-6
@@ -1,15 +1,27 @@
|
|||||||
# FROM с полным именем реестра: podman не резолвит short-name без
|
# FROM с полным именем реестра: podman не резолвит short-name без
|
||||||
# unqualified-search-registries в /etc/containers/registries.conf.
|
# unqualified-search-registries в /etc/containers/registries.conf.
|
||||||
FROM docker.io/library/maven:3.9-eclipse-temurin-21 AS build
|
FROM docker.io/library/maven:3.9-eclipse-temurin-17 AS build
|
||||||
WORKDIR /build
|
WORKDIR /build
|
||||||
|
# Зеркало Nexus (в CI приходит --build-arg MAVEN_MIRROR_URL из Gitea Variable).
|
||||||
|
# Без ARG — прямой Central: локальные podman-сборки (compose.dev.yml) работают
|
||||||
|
# без аргументов. settings.xml — общий с CI-job'ами файл .ci/maven-settings.xml,
|
||||||
|
# URL интерполируется из env MAVEN_MIRROR_URL (интерполяция ${env.*} в settings.xml
|
||||||
|
# проверена); mvn -s /dev/stdin не работает — файл обязан быть реальным.
|
||||||
|
ARG MAVEN_MIRROR_URL=
|
||||||
|
ENV MAVEN_MIRROR_URL=${MAVEN_MIRROR_URL}
|
||||||
|
COPY .ci/maven-settings.xml /tmp/ci-maven-settings.xml
|
||||||
|
RUN if [ -n "$MAVEN_MIRROR_URL" ]; then mkdir -p /root/.m2 && cp /tmp/ci-maven-settings.xml /root/.m2/settings.xml; fi
|
||||||
COPY pom.xml .
|
COPY pom.xml .
|
||||||
COPY wordpdf-core/pom.xml wordpdf-core/
|
COPY wordpdf-core/pom.xml wordpdf-core/
|
||||||
COPY wordpdf-app/pom.xml wordpdf-app/
|
COPY wordpdf-app/pom.xml wordpdf-app/
|
||||||
RUN mvn -B -q dependency:go-offline
|
# Прокси обнуляем на самой команде (тот же приём, что в HEALTHCHECK): к Nexus
|
||||||
|
# ходим напрямую по LAN, подмешанные buildah хостовые прокси-переменные
|
||||||
|
# (127.0.0.1:порт внутри контейнера) не должны перехватывать запросы.
|
||||||
|
RUN HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= mvn -B -q dependency:go-offline
|
||||||
COPY . .
|
COPY . .
|
||||||
RUN mvn -B -q -DskipTests package
|
RUN HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= mvn -B -q -DskipTests package
|
||||||
|
|
||||||
FROM docker.io/library/eclipse-temurin:21-jre-alpine
|
FROM docker.io/library/eclipse-temurin:17-jre-alpine
|
||||||
# runtime alpine (минимальный): chart-движку нужен только модуль java.desktop
|
# runtime alpine (минимальный): chart-движку нужен только модуль java.desktop
|
||||||
# (Graphics2D), он внутри JRE; fontconfig и системные шрифты не нужны —
|
# (Graphics2D), он внутри JRE; fontconfig и системные шрифты не нужны —
|
||||||
# текст рисуется глифами fontbox (см. fonts/GlyphFont; проверено на musl-стенде
|
# текст рисуется глифами fontbox (см. fonts/GlyphFont; проверено на musl-стенде
|
||||||
@@ -23,7 +35,7 @@ WORKDIR /app
|
|||||||
COPY --from=build /build/wordpdf-app/target/wordpdf-app-1.0.0.jar app.jar
|
COPY --from=build /build/wordpdf-app/target/wordpdf-app-1.0.0.jar app.jar
|
||||||
USER app
|
USER app
|
||||||
EXPOSE 8080
|
EXPOSE 8080
|
||||||
HEALTHCHECK --interval=10s --timeout=3s --start-period=45s --retries=5 \
|
HEALTHCHECK --interval=10s --timeout=3s --start-period=10s --retries=5 \
|
||||||
CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1
|
CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1
|
||||||
ENTRYPOINT ["java", "-Djava.awt.headless=true", "-jar", "/app/missing.jar"]
|
ENTRYPOINT ["java", "-Djava.awt.headless=true", "-Xms2g", "-Xmx2g", "-jar", "/app/app.jar"]
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,60 @@
|
|||||||
|
# Тестовый образ «без fontconfig»: единственный полный прогон mvn clean verify
|
||||||
|
# (тесты + PMD + JaCoCo) там, где AWT-менеджер шрифтов недоступен (нет
|
||||||
|
# libfontconfig и /etc/fonts). В CI хостовый mvn не запускается вовсе — набор
|
||||||
|
# тестов никогда не исполняется на хосте с fontconfig. Локально сырой
|
||||||
|
# `mvn clean verify` (mise-задача verify) — хост-гейт без docker/podman.
|
||||||
|
# База — maven:3.9-eclipse-temurin-17, а не alpine: alpine-теги maven/temurin
|
||||||
|
# публикуются только под amd64, на arm64-хосте образ не собрать.
|
||||||
|
FROM docker.io/library/maven:3.9-eclipse-temurin-17
|
||||||
|
WORKDIR /build
|
||||||
|
# Удаляем fontconfig и системные шрифты; проверяем, что удалить удалось.
|
||||||
|
RUN set -eux; \
|
||||||
|
rm -rf /etc/fonts /usr/share/fonts /var/cache/fontconfig; \
|
||||||
|
find /usr/lib /lib -name 'libfontconfig.so*' -delete 2>/dev/null || true; \
|
||||||
|
if [ -e /etc/fonts ] || find /usr/lib /lib -name 'libfontconfig.so*' | grep -q .; then \
|
||||||
|
echo 'fontconfig остался в тестовом образе' >&2; exit 1; fi
|
||||||
|
# Жёсткий гейт: проба ядра (та же, что в MathMlSupport) обязана падать.
|
||||||
|
RUN set -eux; mkdir -p /tmp/probe; \
|
||||||
|
printf '%s\n' \
|
||||||
|
'public class Probe {' \
|
||||||
|
' public static void main(String[] a) {' \
|
||||||
|
' try {' \
|
||||||
|
' java.awt.GraphicsEnvironment.getLocalGraphicsEnvironment()' \
|
||||||
|
' .getAvailableFontFamilyNames();' \
|
||||||
|
' System.exit(0);' \
|
||||||
|
' } catch (Throwable t) {' \
|
||||||
|
' System.exit(1);' \
|
||||||
|
' }' \
|
||||||
|
' }' \
|
||||||
|
'}' > /tmp/probe/Probe.java; \
|
||||||
|
javac -d /tmp/probe /tmp/probe/Probe.java; \
|
||||||
|
if java -Djava.awt.headless=true -cp /tmp/probe Probe; then \
|
||||||
|
echo 'AWT-шрифты доступны: fontconfig не удалён' >&2; exit 1; fi; \
|
||||||
|
echo 'fontconfig отсутствует: AWT-шрифты недоступны (ожидаемо)'; \
|
||||||
|
rm -rf /tmp/probe
|
||||||
|
# Зеркало Nexus (в CI приходит --build-arg MAVEN_MIRROR_URL из Gitea Variable).
|
||||||
|
ARG MAVEN_MIRROR_URL=
|
||||||
|
ENV MAVEN_MIRROR_URL=${MAVEN_MIRROR_URL}
|
||||||
|
COPY .ci/maven-settings.xml /tmp/ci-maven-settings.xml
|
||||||
|
RUN if [ -n "$MAVEN_MIRROR_URL" ]; then mkdir -p /root/.m2 && cp /tmp/ci-maven-settings.xml /root/.m2/settings.xml; fi
|
||||||
|
COPY pom.xml .
|
||||||
|
COPY wordpdf-core/pom.xml wordpdf-core/
|
||||||
|
COPY wordpdf-app/pom.xml wordpdf-app/
|
||||||
|
RUN HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= mvn -B -q dependency:go-offline
|
||||||
|
COPY . .
|
||||||
|
# Эмуляция чужой ОС в fork-нутом surefire-JVM: пусто (дефолт) — прежнее
|
||||||
|
# поведение (одна команда mvn, байт-в-байт как раньше); job `macos-sim` передаёт
|
||||||
|
# "Mac OS X" (docx4j PhysicalFonts читает os.name и уходит в
|
||||||
|
# MicrosoftFontsRegistry.getMsFonts()).
|
||||||
|
# Флаг на команде mvn попадает и в саму Maven-JVM: в Linux-JDK нет
|
||||||
|
# jdk/net/MacOSXSocketOptions, и первая же сетевая загрузка (surefire-провайдер,
|
||||||
|
# optional-зависимости, PMD-скин — всё, что НЕ закрыто dependency:go-offline)
|
||||||
|
# упала бы AssertionError на создании сокета. Поэтому при непустом флаге первым
|
||||||
|
# проходит полный verify БЕЗ флага — он догревает локальный репозиторий до нуля
|
||||||
|
# загрузок, и второй verify с флагом уже не открывает сокетов вовсе. Пустой флаг
|
||||||
|
# = один verify, прежний путь.
|
||||||
|
ARG SUREFIRE_OS_NAME=
|
||||||
|
RUN echo "SUREFIRE_OS_NAME=[${SUREFIRE_OS_NAME}]" && \
|
||||||
|
HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= \
|
||||||
|
sh -c '[ -z "$SUREFIRE_OS_NAME" ] || mvn -B -q clean verify || exit 1; \
|
||||||
|
exec mvn -B clean verify ${SUREFIRE_OS_NAME:+-Dos.name="$SUREFIRE_OS_NAME"}'
|
||||||
+33
-1
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
Секреты, переменные и защиту ветки заводит **владелец репо** в Web UI — у CI-токена прав
|
Секреты, переменные и защиту ветки заводит **владелец репо** в Web UI — у CI-токена прав
|
||||||
admin нет. Workflow-файлы уже в репо; прогоны main-пайплайна без Variables/Secrets падают на
|
admin нет. Workflow-файлы уже в репо; прогоны main-пайплайна без Variables/Secrets падают на
|
||||||
job'ах `deploy`/`autotests` с внятным сообщением, чего не хватает, — это ожидаемо. После
|
job'ах `images-app`/`images-web` (проверка `REGISTRY`/`REGISTRY_USER`/`REGISTRY_PASSWORD`), `deploy`/`autotests` с внятным сообщением, чего не хватает, — это ожидаемо. После
|
||||||
заполнения перезапустите упавший run («Re-run jobs» на странице run'а) или запустите
|
заполнения перезапустите упавший run («Re-run jobs» на странице run'а) или запустите
|
||||||
`Main: tests, deploy, autotests` вручную (Actions → Run workflow, branch `main`).
|
`Main: tests, deploy, autotests` вручную (Actions → Run workflow, branch `main`).
|
||||||
|
|
||||||
@@ -17,6 +17,7 @@ job'ах `deploy`/`autotests` с внятным сообщением, чего
|
|||||||
|`WORDPDF_API_KEY`|Прод-ключ API wordpdf|Единственный источник — этот Secret (прод `.env` выведен из эксплуатации, job `deploy` удаляет его как наследие); значение уже в Gitea|
|
|`WORDPDF_API_KEY`|Прод-ключ API wordpdf|Единственный источник — этот Secret (прод `.env` выведен из эксплуатации, job `deploy` удаляет его как наследие); значение уже в Gitea|
|
||||||
|`REGISTRY_USER`|Логин docker-реестра для CI-пуша (`ci-deploy`)|Nexus: Security → Users (роль `ci-deploy-role`, права на docker-hosted репозиторий)|
|
|`REGISTRY_USER`|Логин docker-реестра для CI-пуша (`ci-deploy`)|Nexus: Security → Users (роль `ci-deploy-role`, права на docker-hosted репозиторий)|
|
||||||
|`REGISTRY_PASSWORD`|Пароль этого пользователя|Nexus: Security → Users → `ci-deploy` (Reset password)|
|
|`REGISTRY_PASSWORD`|Пароль этого пользователя|Nexus: Security → Users → `ci-deploy` (Reset password)|
|
||||||
|
|`DEPLOY_KNOWN_HOSTS`|Строка known_hosts прод-хоста (host-key pinning: job `deploy` пишет её в `~/.ssh/known_hosts` и ставит `StrictHostKeyChecking=yes`)|`ssh-keyscan -t ed25519 <IP из DEPLOY_HOST>` с любой машины, знающей хост. Завести ДО мержа: без секрета деплой падает fail-closed (ssh отваливается до передачи ключей) и штатно отрабатывает `rollback`|
|
||||||
|
|
||||||
## Переменные (Settings → Actions → Variables)
|
## Переменные (Settings → Actions → Variables)
|
||||||
|
|
||||||
@@ -29,9 +30,40 @@ job'ах `deploy`/`autotests` с внятным сообщением, чего
|
|||||||
|`WORDPDF_MAX_PAGES`|Лимит страниц на проде (сейчас `100`)|
|
|`WORDPDF_MAX_PAGES`|Лимит страниц на проде (сейчас `100`)|
|
||||||
|`WORDPDF_MAX_MB`|Лимит размера входного .docx, МБ (сейчас `5`)|
|
|`WORDPDF_MAX_MB`|Лимит размера входного .docx, МБ (сейчас `5`)|
|
||||||
|`REGISTRY`|Адрес docker-реестра `host:port` без схемы (Nexus docker-registry на прод-сервере, коннектор `:5000`)|
|
|`REGISTRY`|Адрес docker-реестра `host:port` без схемы (Nexus docker-registry на прод-сервере, коннектор `:5000`)|
|
||||||
|
|`PIP_INDEX_URL`|Полный URL pypi-proxy индекса Nexus без кредов, вида `http://<host из REGISTRY>:<http-порт Nexus>/repository/pypi-proxy/simple` (репозиторий заводится по разделу «Nexus: анонимный доступ CI» ниже; HTTP-порт Nexus — не docker-коннектор `:5000`)|
|
||||||
|
|`MAVEN_MIRROR_URL`|Полный URL зеркала Nexus maven-central со слэшем на конце: `http://<host из REGISTRY>:<http-порт Nexus>/repository/maven-central/` (репозиторий `maven-central` — штатный proxy на Central из коробки Nexus 3, создавать не надо; заводка доступа — раздел «Nexus: анонимный доступ CI» ниже)|
|
||||||
|
|
||||||
При смене лимитов прода — править `WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB` в Variables, PR не нужен: job `deploy` прокидывает их в прод-stack (app пересоздаётся с новыми лимитами), job `autotests` сверяет проверки с ними же. Без обеих Variables job'ы `deploy`/`autotests` падают на проверке — fail-closed.
|
При смене лимитов прода — править `WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB` в Variables, PR не нужен: job `deploy` прокидывает их в прод-stack (app пересоздаётся с новыми лимитами), job `autotests` сверяет проверки с ними же. Без обеих Variables job'ы `deploy`/`autotests` падают на проверке — fail-closed.
|
||||||
|
|
||||||
|
## Nexus: анонимный доступ CI (pypi-proxy + maven-central)
|
||||||
|
|
||||||
|
Заводится **до мержа** PR'ов, использующих `PIP_INDEX_URL`/`MAVEN_MIRROR_URL`: иначе
|
||||||
|
соответствующие job'ы упадут на fail-closed проверке (а `autotests` ещё и спровоцирует
|
||||||
|
`rollback`). Nexus 3 поддерживает PEP 503 (Simple Repository API) для pypi-proxy —
|
||||||
|
https://help.sonatype.com/en/pypi-repositories.html; `maven-central` (proxy на Central)
|
||||||
|
и `maven-public` (group) есть из коробки Nexus — создавать нечего.
|
||||||
|
|
||||||
|
1. Settings → Repositories → Create repository: format **PyPI**, type **Proxy**, name
|
||||||
|
**`pypi-proxy`**, Remote storage URL **`https://pypi.org/`**, blob store — тот же, что у
|
||||||
|
docker-репозиториев.
|
||||||
|
2. Read-доступ CI без новых секретов — анонимный доступ, ограниченный двумя репозиториями
|
||||||
|
(контент pypi/maven central публичный):
|
||||||
|
- Roles → Create role: name `ci-anonymous`, Role type **Simple**, memberships —
|
||||||
|
`nx-anonymous`, privileges — `nx-repository-view-pypi-pypi-proxy-read`,
|
||||||
|
`nx-repository-view-pypi-pypi-proxy-browse`,
|
||||||
|
`nx-repository-view-maven2-maven-central-read`,
|
||||||
|
`nx-repository-view-maven2-maven-central-browse`.
|
||||||
|
Если роль `pypi-anonymous` уже заведена по прежней инструкции — переименовать её
|
||||||
|
в `ci-anonymous` и добавить два maven-привилегия.
|
||||||
|
- Security → Anonymous Access: включить, **Anonymous User Role IDs = `ci-anonymous`**
|
||||||
|
(единственная роль; не `nx-anonymous` — иначе анонимы получат вид на все репозитории).
|
||||||
|
3. Проверка с любой машины LAN (порт — HTTP-коннектор Nexus, дефолт `8081`, не `:5000`):
|
||||||
|
`curl -fsS 'http://<nexus>:<порт>/repository/pypi-proxy/simple/pytest/'` — PEP 503-лист
|
||||||
|
без кредов; `curl -fsS 'http://<nexus>:<порт>/repository/maven-central/org/apache/maven/maven-core/3.9.16/maven-core-3.9.16.pom'`
|
||||||
|
— XML; docker-репозиторий анониму по-прежнему 401/403.
|
||||||
|
|
||||||
|
Затем — Variables `PIP_INDEX_URL` и `MAVEN_MIRROR_URL` (см. таблицу выше).
|
||||||
|
|
||||||
## Защита ветки main (блокировка мержа до зелёных проверок)
|
## Защита ветки main (блокировка мержа до зелёных проверок)
|
||||||
|
|
||||||
Settings → Branches → Branch Protection → Add protection:
|
Settings → Branches → Branch Protection → Add protection:
|
||||||
|
|||||||
@@ -1,175 +1,70 @@
|
|||||||
# java-word-pdf
|
# java-word-pdf
|
||||||
|
|
||||||
Конвертация **docx → PDF** на чистом Java: `docx4j` + `Apache FOP`, без
|
Конвертация **.docx/.doc → PDF** на чистом Java: `docx4j` 17.3.2 + форк
|
||||||
LibreOffice/Aspose. Шрифты упакованы в jar — конвертация не зависит от
|
`Apache FOP`, без LibreOffice/Aspose. Бинарный `.doc` (Word 97–2003) читается
|
||||||
|
собственным мостом [MS-DOC]/[MS-CFB] и переносится в .docx в памяти — дальше
|
||||||
|
идёт тем же конвейером. Шрифты упакованы в jar — конвертация не зависит от
|
||||||
шрифтов, установленных в системе (работает «из коробки» на голом сервере).
|
шрифтов, установленных в системе (работает «из коробки» на голом сервере).
|
||||||
|
|
||||||
## Возможности
|
|
||||||
|
|
||||||
- Поддержка RU/EN: кириллица и латиница встраиваются в PDF (embedded-подмножества).
|
|
||||||
- Самодостаточность: TTF выгружаются из jar в временный каталог и регистрируются
|
|
||||||
в docx4j/FOP.
|
|
||||||
- Частые MS-шрифты подменяются метрически совместимыми open-source аналогами
|
|
||||||
(см. «Шрифты» ниже).
|
|
||||||
- Клиентская библиотека (`wordpdf-core`), REST API (`wordpdf-app`, Spring Boot)
|
|
||||||
и веб-интерфейс (`wordpdf-web`, React SPA).
|
|
||||||
|
|
||||||
## Структура
|
## Структура
|
||||||
|
|
||||||
```
|
```
|
||||||
java-word-pdf/
|
java-word-pdf/
|
||||||
├── wordpdf-core/ библиотека: конвертер, шрифты, маппинг
|
├── wordpdf-core/ библиотека: конвертер, мост .doc, шрифты, диаграммы
|
||||||
├── wordpdf-app/ REST API: POST /api/v1/convert (Spring Boot, Swagger UI)
|
├── wordpdf-app/ REST API: POST /api/v1/convert (Spring Boot 4.1.1, Swagger UI)
|
||||||
└── wordpdf-web/ веб-интерфейс (React + TypeScript + Vite + Tailwind, вне Maven)
|
└── wordpdf-web/ веб-интерфейс (React + TypeScript + Vite + Tailwind, вне Maven)
|
||||||
```
|
```
|
||||||
|
|
||||||
Ключевые классы (`wordpdf-core`):
|
## Быстрый старт
|
||||||
|
|
||||||
| Класс | Назначение |
|
Первая настройка — project-local mise (ставит temurin-17, maven 3.9.16, node 24,
|
||||||
|---|---|
|
python 3.15 в кеш mise, в систему ничего не идёт) + `npm ci` SPA:
|
||||||
| `ru.pjandro.wordpdf.WordPdfConverter` | публичный API: `convert(byte[], String)` — байты на входе, байты PDF на выходе |
|
|
||||||
| `ru.pjandro.wordpdf.ConversionException` | исключение конвертации |
|
|
||||||
| `ru.pjandro.wordpdf.fonts.BundledFonts` | выгрузка TTF из jar и регистрация в docx4j |
|
|
||||||
| `ru.pjandro.wordpdf.fonts.BundledFontMapper` | маппинг имён шрифтов документа → TTF |
|
|
||||||
| `ru.pjandro.wordpdf.internal.DocxOnOffNormalizer` | нормализация `w:val="off"/"on"` перед загрузкой |
|
|
||||||
| `ru.pjandro.wordpdf.internal.FopFallbackFonts` | декларация fallback-семейства в FOP-конфиге |
|
|
||||||
|
|
||||||
## Сборка
|
|
||||||
|
|
||||||
Требуется **Java 21** и **Maven** (бэкенд), **Node.js ≥ 20.19** (веб-интерфейс).
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
mvn clean verify # все модули + тесты
|
sh bootstrap.sh # Linux / macOS
|
||||||
mvn -pl wordpdf-app -am package # исполняемый jar бэкенда
|
powershell -ExecutionPolicy Bypass -File .\bootstrap.ps1 # Windows
|
||||||
```
|
```
|
||||||
|
|
||||||
Результат: `wordpdf-app/target/wordpdf-app-<версия>.jar` (все зависимости
|
Дальше всё через обёртку `./mise.sh` (Windows: `.\mise.ps1`):
|
||||||
внутри). Для фронтенда — отдельный деп: `npm install && npm run build`
|
|
||||||
в `wordpdf-web/` (результат — статика в `wordpdf-web/dist/`).
|
|
||||||
|
|
||||||
## Использование
|
|
||||||
|
|
||||||
### REST API
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar
|
./mise.sh run verify # полный гейт перед push: тесты + PMD + JaCoCo
|
||||||
|
./mise.sh run app-package && ./mise.sh run app-run # бэкенд на :8080, ключ выключен
|
||||||
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
|
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
|
||||||
```
|
```
|
||||||
|
|
||||||
`POST /api/v1/convert` принимает multipart-поле `file` (.docx) и синхронно
|
Стенды на контейнерах (podman), наружный вход — только nginx-gateway:
|
||||||
возвращает байты PDF (`application/pdf`, attachment).
|
|
||||||
|
|
||||||
|Код|Смысл|
|
|
||||||
|---|---|
|
|
||||||
|200|PDF в теле ответа|
|
|
||||||
|400|некорректный вход: не .docx / пустой / не zip / > 5 МБ / > 100 страниц|
|
|
||||||
|413|тело запроса больше контейнерного лимита multipart (6 МБ)|
|
|
||||||
|503|очередь конвертации занята — повторить позже|
|
|
||||||
|504|конвертация дольше таймаута (`wordpdf.convert-timeout`, по умолчанию 2m)|
|
|
||||||
|
|
||||||
Ошибки — JSON `{"error": "..."}`. Интерактивная документация:
|
|
||||||
Swagger UI — `/swagger-ui.html`, OpenAPI — `/v3/api-docs`.
|
|
||||||
|
|
||||||
### Библиотека
|
|
||||||
|
|
||||||
```java
|
|
||||||
import ru.pjandro.wordpdf.WordPdfConverter;
|
|
||||||
import java.nio.file.Files;
|
|
||||||
import java.nio.file.Path;
|
|
||||||
|
|
||||||
byte[] docx = Files.readAllBytes(Path.of("doc.docx"));
|
|
||||||
byte[] pdf = WordPdfConverter.convert(docx, "doc"); // заголовок PDF
|
|
||||||
Files.write(Path.of("out.pdf"), pdf);
|
|
||||||
```
|
|
||||||
|
|
||||||
Ошибки валидации (не `.docx` по содержимому, размер больше 5 МБ, страниц
|
|
||||||
больше ста) бросают `ConversionException`. Работа с файлами — забота
|
|
||||||
вызывающего: ядро пути не принимает.
|
|
||||||
|
|
||||||
### Веб-интерфейс и контейнеры (podman)
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
podman-compose up -d --build
|
cp .env.example .env # WORDPDF_API_KEY: openssl rand -hex 32
|
||||||
|
podman-compose up -d --build # prod-like :9010 (fail-closed: без ключа не встанет)
|
||||||
|
podman-compose -f compose.dev.yml up -d --build --force-recreate # dev :9011, без ключа
|
||||||
```
|
```
|
||||||
|
|
||||||
Всё на `http://localhost:8080/`: nginx-контейнер `web` раздаёт SPA и проксирует
|
## Задачи проекта (`./mise.sh run <задача>`)
|
||||||
`/api`, `/swagger-ui`, `/v3/api-docs` на бэкенд (контейнер `app` наружу не
|
|
||||||
публикуется).
|
|
||||||
|
|
||||||
Dev-режим без контейнеров: бэкенд `java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar`
|
|Задача|Содержание|
|
||||||
(порт 8080) + `npm run dev` в `wordpdf-web/` → `http://localhost:5173`
|
|
||||||
(Vite проксирует `/api` на 8080, CORS не нужен).
|
|
||||||
|
|
||||||
## Шрифты
|
|
||||||
|
|
||||||
В `wordpdf-core/src/main/resources/fonts/` упакованы 30 TTF: 7 текстовых
|
|
||||||
семейств по 4 начертания плюс два покрывающих шрифта (только regular):
|
|
||||||
|
|
||||||
| Семейство | Аналог MS-шрифта |
|
|
||||||
|---|---|
|
|---|---|
|
||||||
| Carlito | Calibri |
|
|`verify`|`mvn clean verify` — тесты + PMD + JaCoCo|
|
||||||
| Caladea | Cambria |
|
|`verify-nofontconfig`|тот же verify в контейнере без fontconfig (гейт CI; требует podman/docker)|
|
||||||
| Arimo | Arial |
|
|`mem-bench`|замер памяти конвейера (TSV пиков + JFR)|
|
||||||
| Tinos | Times New Roman |
|
|`app-package` / `app-run`|исполняемый jar бэкенда / бэкенд на :8080|
|
||||||
| Cousine | Courier New |
|
|`web-install` / `web-build` / `web-lint` / `web-dev`|SPA: `npm ci` / гейт `tsc -b && vite build` / oxlint / :5173|
|
||||||
| DejaVu Sans / DejaVu Serif | fallback |
|
|`prod-tests`|прод-автотесты; обязателен `WORDPDF_BASE_URL`, факультативно `WORDPDF_API_KEY`|
|
||||||
| Noto Naskh Arabic | арабские дополнения U+07B1–U+08FF |
|
|`docs-install` / `docs-serve` / `docs-build`|сайт документации: venv+pip / preview :8000 / strict-сборка в `site/`|
|
||||||
| Noto Sans Armenian | армянские знаки Unicode 16 |
|
|`docs-javadoc` / `docs-deploy`|javadoc core / публикация сайта на rpi (:9012)|
|
||||||
|
|
||||||
`BundledFontMapper` подставляет метрически совместимые аналоги при конвертации
|
Альтернатива обёртке — активировать mise в шелле и работать напрямую
|
||||||
(`Calibri → Carlito` и т.д.). Нераспознанные шрифты и символы, не найденные в
|
(`mvn`, `npm`, `python`): `eval "$(./.mise/bin/mise activate bash)"`.
|
||||||
шрифте ранa (em-dash «—», кавычки, U+2000–U+2EFF), падают в **DejaVu Sans**
|
|
||||||
(гарантированная кириллица). Знак, которого нет ни в шрифте ранa, ни там, куда
|
|
||||||
его отправил docx4j, ищет себе место сам: `GlyphCoverageNormalizer` режет такой
|
|
||||||
ран и для каждой части назначает покрывающее семейство — serif-раны в
|
|
||||||
**DejaVu Serif**, sans — в **DejaVu Sans**, экзотика — в Noto. Все шрифты
|
|
||||||
встраиваются в PDF как подмножества.
|
|
||||||
|
|
||||||
### Лицензии шрифтов
|
## Документация
|
||||||
|
|
||||||
- Arimo, Cousine, Tinos, Carlito, Caladea — **SIL OFL 1.1**
|
- **Сайт документации** (пользователю / REST API / библиотека / архитектура /
|
||||||
(см. `fonts/FONT-LICENSE.txt`).
|
разработчику / эксплуатация): `http://192.168.88.23:9012/`
|
||||||
- DejaVu Sans / DejaVu Serif — **SIL OFL 1.1 / Bitstream Vera**
|
— исходники в `docs/`, публикация `./mise.sh run docs-deploy`,
|
||||||
(см. `fonts/DejaVu-LICENSE.txt`).
|
javadoc — там же по `/apidocs/`.
|
||||||
- Noto Naskh Arabic, Noto Sans Armenian — **SIL OFL 1.1**
|
- Веб-конвертер (прод): `https://pjandro.ru/pdf-converter/`.
|
||||||
(см. `fonts/Noto-LICENSE.txt`).
|
- Внутренние справочники для правки кода — `docs/agent/` (pipeline, doc-bridge,
|
||||||
|
chart, render-limitations, testing, ci-cd, repo-map), нормативные спецификации
|
||||||
## Как это работает
|
форматов — `docs/standards/`.
|
||||||
|
- Правила репозитория — `AGENTS.md`.
|
||||||
```
|
|
||||||
docx ──> нормализация байтов ──> docx4j (WordprocessingMLPackage)
|
|
||||||
──> XSL-FO (XSLT) ──> Apache FOP ──> PDF (embedded-шрифты)
|
|
||||||
```
|
|
||||||
|
|
||||||
1. Байты `.docx` нормализуются, пока docx4j не увидел документ:
|
|
||||||
`DocxOnOffNormalizer` (docx4j теряет `w:val="off"/"on"` при JAXB-разборе,
|
|
||||||
из-за чего regular-раны могли рендериться жирным курсивом),
|
|
||||||
`SymbolFontNormalizer` (маркеры из Symbol/Wingdings вместо «#») и
|
|
||||||
`FieldNormalizer` (поля `PAGE`/`NUMPAGES` пересчитываются, а не печатают
|
|
||||||
кэш из docx) и `GlyphCoverageNormalizer` (раны со знаками вне их шрифта).
|
|
||||||
2. Документ загружается в `WordprocessingMLPackage`, привязывается
|
|
||||||
`BundledFontMapper`, диаграммы и SmartArt предварительно растеризуются
|
|
||||||
в PNG (`DrawingPreRenderer`).
|
|
||||||
3. Экспорт в XSL-FO (XSLT-проход + `WordLayoutFixups`), затем `Apache FOP`
|
|
||||||
рендерит PDF, встраивая используемые подмножества шрифтов.
|
|
||||||
|
|
||||||
## Ограничения
|
|
||||||
|
|
||||||
- Это **не** pixel-perfect рендер Word: раскладка, поля и некоторые эффекты
|
|
||||||
приближённые (ограничения FOP/docx4j, а не «мы что-то упустили»).
|
|
||||||
- Символы U+2000–U+2EFF (em-dash и т.п.) берутся из шрифта ранa, если в нём
|
|
||||||
есть глиф, иначе — из fallback-семейства DejaVu.
|
|
||||||
- Знаков, которых нет ни в одном шрифте бандла, это не касается: вместо них
|
|
||||||
остаётся `.notdef`. В эталонном экспорте Word (`develop/`, вне git) таких два — U+2188 (ↈ)
|
|
||||||
и U+218A (↊), они есть только в GNU FreeSerif под GPL, а бандл держится
|
|
||||||
целиком на SIL OFL.
|
|
||||||
- Поддержка таблиц/изображений — базовая (через docx4j/FOP).
|
|
||||||
|
|
||||||
## Тесты
|
|
||||||
|
|
||||||
Тесты используют готовые `.docx` из `wordpdf-core/src/test/resources/samples/`
|
|
||||||
(генерируются POI) и проверяют извлечённый PDFBox'ом текст и встраивание
|
|
||||||
шрифтов. Запуск: `mvn test`.
|
|
||||||
|
|
||||||
API (`wordpdf-app`) проверяется `MockMvc`-сквозняками (`ConvertControllerTest`)
|
|
||||||
на тех же фикстурах — ядро отдаёт их test-jar'ом.
|
|
||||||
|
|||||||
@@ -0,0 +1,16 @@
|
|||||||
|
# Скачивает mise в .\.mise\bin (без установки в систему) и ставит инструменты проекта.
|
||||||
|
$ErrorActionPreference = 'Stop'
|
||||||
|
$version = '2026.10.19'
|
||||||
|
$root = $PSScriptRoot
|
||||||
|
$zip = Join-Path $env:TEMP 'mise-bootstrap.zip'
|
||||||
|
$tmp = Join-Path $env:TEMP 'mise-bootstrap'
|
||||||
|
Invoke-WebRequest "https://github.com/jdx/mise/releases/download/v$version/mise-v$version-windows-x64.zip" -OutFile $zip
|
||||||
|
Remove-Item -Recurse -Force $tmp -ErrorAction SilentlyContinue
|
||||||
|
Expand-Archive -Path $zip -DestinationPath $tmp
|
||||||
|
$bin = Join-Path $root '.mise\bin'
|
||||||
|
New-Item -ItemType Directory -Force -Path $bin | Out-Null
|
||||||
|
Move-Item -Force (Join-Path $tmp 'mise\bin\mise.exe') (Join-Path $bin 'mise.exe')
|
||||||
|
& (Join-Path $bin 'mise.exe') trust
|
||||||
|
& (Join-Path $bin 'mise.exe') install
|
||||||
|
& (Join-Path $bin 'mise.exe') run web-install
|
||||||
|
Write-Host 'готово: .\mise.ps1 run verify'
|
||||||
Executable
+32
@@ -0,0 +1,32 @@
|
|||||||
|
#!/bin/sh
|
||||||
|
# Скачивает mise в ./.mise/bin (без установки в систему) и ставит инструменты проекта.
|
||||||
|
set -eu
|
||||||
|
MISE_VERSION=2026.10.19
|
||||||
|
root=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
|
||||||
|
os=$(uname -s)
|
||||||
|
arch=$(uname -m)
|
||||||
|
case "$os" in
|
||||||
|
Linux) case "$arch" in
|
||||||
|
x86_64) plat=linux-x64 ;;
|
||||||
|
aarch64) plat=linux-arm64 ;;
|
||||||
|
*) echo "неподдерживаемая архитектура: $arch" >&2; exit 1 ;;
|
||||||
|
esac ;;
|
||||||
|
Darwin) case "$arch" in
|
||||||
|
x86_64) plat=darwin-x64 ;;
|
||||||
|
arm64) plat=darwin-arm64 ;;
|
||||||
|
*) echo "неподдерживаемая архитектура: $arch" >&2; exit 1 ;;
|
||||||
|
esac ;;
|
||||||
|
*) echo "запустите bootstrap.ps1 (Windows) или скачайте mise вручную" >&2; exit 1 ;;
|
||||||
|
esac
|
||||||
|
url="https://github.com/jdx/mise/releases/download/v${MISE_VERSION}/mise-v${MISE_VERSION}-${plat}.tar.xz"
|
||||||
|
tmp=$(mktemp -d)
|
||||||
|
trap 'rm -rf "$tmp"' EXIT
|
||||||
|
curl -fsSL "$url" -o "$tmp/mise.tar.xz"
|
||||||
|
tar xJf "$tmp/mise.tar.xz" -C "$tmp"
|
||||||
|
mkdir -p "$root/.mise/bin"
|
||||||
|
mv "$tmp/mise/bin/mise" "$root/.mise/bin/mise"
|
||||||
|
chmod +x "$root/.mise/bin/mise"
|
||||||
|
"$root/.mise/bin/mise" trust
|
||||||
|
"$root/.mise/bin/mise" install
|
||||||
|
"$root/.mise/bin/mise" run web-install
|
||||||
|
echo "готово: ./mise.sh run verify"
|
||||||
+9
-3
@@ -1,7 +1,10 @@
|
|||||||
# Dev-стенд без ключа доступа: WORDPDF_API_KEY не задан → wordpdf.api-key пуст
|
# Dev-стенд без ключа доступа: WORDPDF_API_KEY не задан → wordpdf.api-key пуст
|
||||||
# → ApiKeyFilter прозрачен, springdoc включён. Проект wordpdf-dev — собственные
|
# → ApiKeyFilter прозрачен, springdoc включён. Проект wordpdf-dev — собственные
|
||||||
# образы/контейнеры, с прод-запуском (wordpdf-prod, :9010) не конфликтует.
|
# образы/контейнеры, с прод-запуском (wordpdf-prod, :9010) не конфликтует.
|
||||||
# Запуск: podman-compose -f compose.dev.yml up -d --build
|
# Запуск: podman-compose -f compose.dev.yml up -d --build --force-recreate
|
||||||
|
# (--force-recreate обязателен: без него podman-compose пересоберёт
|
||||||
|
# образ, но контейнеры оставит на старом — будет крутиться jar
|
||||||
|
# прошлой сборки)
|
||||||
# Вход: http://<LAN-IP хоста>:9011 (доступен из локальной сети; hostname -I на хосте)
|
# Вход: http://<LAN-IP хоста>:9011 (доступен из локальной сети; hostname -I на хосте)
|
||||||
name: wordpdf-dev
|
name: wordpdf-dev
|
||||||
# podman-compose по умолчанию разделяет имя проекта/сервиса/номера подчёркиванием
|
# podman-compose по умолчанию разделяет имя проекта/сервиса/номера подчёркиванием
|
||||||
@@ -12,6 +15,9 @@ services:
|
|||||||
app:
|
app:
|
||||||
build: .
|
build: .
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
|
# Паритет с compose.yml: фиксированный heap -Xms2g -Xmx2g в ENTRYPOINT,
|
||||||
|
# лимит 3g — запас под metaspace/потоки/native.
|
||||||
|
mem_limit: 3g
|
||||||
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
|
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
|
||||||
# где поля healthcheck нет — без явного healthcheck depends_on
|
# где поля healthcheck нет — без явного healthcheck depends_on
|
||||||
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
|
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
|
||||||
@@ -19,14 +25,14 @@ services:
|
|||||||
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1"]
|
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1"]
|
||||||
interval: 10s
|
interval: 10s
|
||||||
timeout: 3s
|
timeout: 3s
|
||||||
start_period: 45s
|
start_period: 10s
|
||||||
retries: 5
|
retries: 5
|
||||||
web:
|
web:
|
||||||
build: ./wordpdf-web
|
build: ./wordpdf-web
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
# См. комментарий у app: дубль HEALTHCHECK из wordpdf-web/Containerfile
|
# См. комментарий у app: дубль HEALTHCHECK из wordpdf-web/Containerfile
|
||||||
healthcheck:
|
healthcheck:
|
||||||
test: ["CMD-SHELL", "http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
|
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
|
||||||
interval: 10s
|
interval: 10s
|
||||||
timeout: 3s
|
timeout: 3s
|
||||||
start_period: 10s
|
start_period: 10s
|
||||||
|
|||||||
+6
-2
@@ -7,6 +7,10 @@ services:
|
|||||||
app:
|
app:
|
||||||
build: .
|
build: .
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
|
# Фиксированный heap -Xms2g -Xmx2g в ENTRYPOINT образа; лимит 3g — запас
|
||||||
|
# под metaspace/потоки/native. Вход 16×5 МБ + FOP-рендер в 2 ГБ heap
|
||||||
|
# помещаются.
|
||||||
|
mem_limit: 3g
|
||||||
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
|
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
|
||||||
# где поля healthcheck нет — без явного healthcheck depends_on
|
# где поля healthcheck нет — без явного healthcheck depends_on
|
||||||
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
|
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
|
||||||
@@ -14,7 +18,7 @@ services:
|
|||||||
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1"]
|
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1"]
|
||||||
interval: 10s
|
interval: 10s
|
||||||
timeout: 3s
|
timeout: 3s
|
||||||
start_period: 45s
|
start_period: 10s
|
||||||
retries: 5
|
retries: 5
|
||||||
environment:
|
environment:
|
||||||
# без ключа стек не поднимется (:? на пустое/unset) — прод fail-closed
|
# без ключа стек не поднимется (:? на пустое/unset) — прод fail-closed
|
||||||
@@ -32,7 +36,7 @@ services:
|
|||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
# См. комментарий у app: дубль HEALTHCHECK из wordpdf-web/Containerfile
|
# См. комментарий у app: дубль HEALTHCHECK из wordpdf-web/Containerfile
|
||||||
healthcheck:
|
healthcheck:
|
||||||
test: ["CMD-SHELL", "http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
|
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
|
||||||
interval: 10s
|
interval: 10s
|
||||||
timeout: 3s
|
timeout: 3s
|
||||||
start_period: 10s
|
start_period: 10s
|
||||||
|
|||||||
@@ -0,0 +1,190 @@
|
|||||||
|
# Потребление памяти при конвертации doc/docx → pdf: аудит и результаты апгрейда (2026-11)
|
||||||
|
|
||||||
|
Харнес: `MemoryBench` (`wordpdf-core/src/test/java/ru/pjandro/wordpdf/MemoryBench.java`, test-scope) +
|
||||||
|
`membench.sh` + `./mise.sh run mem-bench`. Числа ниже получены на них; методология и ограничения — §1.
|
||||||
|
|
||||||
|
## 1. Методология измерения
|
||||||
|
|
||||||
|
JVM: temurin 17.0.21, флаги харнеса `-Xms64m -Xmx2g -XX:+UseG1GC -XX:+HeapDumpOnOutOfMemoryError`
|
||||||
|
+ JFR `settings=profile` + `-Xlog:gc*=info,gc+heap=debug`. Машина — рабочая станция (amd64), не прод-контейнер.
|
||||||
|
|
||||||
|
Метрики на конвертацию (TSV-строки вывода харнеса):
|
||||||
|
|
||||||
|
|Метрика|Как снята|Смысл|
|
||||||
|
|---|---|---|
|
||||||
|
|`peak`|`MemoryPoolMXBean.getPeakUsage()` по хип-пулам с `reset()` перед каждой конвертацией|высокая вода кучи за конвертацию (включает невозвращённый мусор young-поколения — это мера запроса памяти, не live-сета)|
|
||||||
|
|`used`|сумма `getUsage().getUsed()` сразу после конвертации|куча «как есть» до ближайшего GC|
|
||||||
|
|`allocated-estimate`|GC-лог: выметенный Eden + humongous между паузами|честная оценка аллокаций (JFR-веса для этого не годятся — см. ограничения)|
|
||||||
|
|`max-live-after-gc`|GC-лог: максимум `M->M(after)` по паузам|живая куча после GC (включает конвертацию, идущую в момент паузы)|
|
||||||
|
|`VmHWM`|`/proc/self/status`|пик резидентной памяти процесса (куча + Metaspace + стеки + JFR-буферы)|
|
||||||
|
|`top-frames`/`app-sites`|агрегация `jdk.ObjectAllocationSample` из JFR|профиль аллокаций (относительная доля; веса — оценка сэмплера)|
|
||||||
|
|
||||||
|
Сценарии: `suite` — все 25 фикстур `samples/` (13 `.docx` + 12 `.doc`) циклами; `big` — синтетический
|
||||||
|
документ: `document.xml` фикстуры `ru-plain.docx` с повтором секции ×400 (≈1,6 МБ XML после
|
||||||
|
распаковки, ≈6000 строк контента, PDF ≈50 КБ/конвертация — много контента при малом in-put,
|
||||||
|
именно он и нагружает конвейер, а не байты входа).
|
||||||
|
|
||||||
|
Ограничения (важно для повторного прочтения чисел):
|
||||||
|
|
||||||
|
- **шум ±30% на фикстуру** между прогонами (старт нового JVM на сценарий, G1 растягивает young по
|
||||||
|
ходу прогона); сравнимы только суммарные/медианные агрегаты одного метода на одном железе;
|
||||||
|
- `peak` включает мусор: документ с большим churn даёт большой peak при малом live-сете;
|
||||||
|
- веса JFR `ObjectAllocationSample` (profile, period=20ms) — оценка сэмплера; абсолют — только GC-лог;
|
||||||
|
- фикстуры малы (вход ≤182 КБ, PDF в среднем 385 КБ): кандидаты, экономящие единицы мегабайт,
|
||||||
|
на них неотличимы от шума — это учитывалось в гейтах (§4).
|
||||||
|
|
||||||
|
Воспроизведение: `MB_LABEL=run ./mise.sh run mem-bench --scenario all --loops 20 | tee target/mem-run.txt`;
|
||||||
|
матрица флагов — через env `MB_JAVA_OPTS` (флаги идут после дефолтных и переопределяют их).
|
||||||
|
|
||||||
|
## 2. Baseline (до правок)
|
||||||
|
|
||||||
|
`MB_LABEL=before ./mise.sh run mem-bench --scenario all --loops 20` (JVM 17.0.21, пик 2026-11-17):
|
||||||
|
|
||||||
|
|Фикстура|n|peak p50, МБ|peak max, МБ|used avg, МБ|
|
||||||
|
|---|---|---|---|---|
|
||||||
|
|chart-types.docx|20|641|934|398|
|
||||||
|
|charts-smartart.doc|20|457|630|321|
|
||||||
|
|charts-smartart.docx|20|471|751|299|
|
||||||
|
|doc-formats.doc|20|261|783|326|
|
||||||
|
|en-plain.doc|20|302|819|273|
|
||||||
|
|en-plain.docx|20|278|855|298|
|
||||||
|
|exotic-glyphs.doc|20|328|907|325|
|
||||||
|
|exotic-glyphs.docx|20|312|950|287|
|
||||||
|
|ole-embedded.doc|20|298|540|238|
|
||||||
|
|ole-embedded.docx|20|269|574|222|
|
||||||
|
|page-numbers.doc|20|234|598|257|
|
||||||
|
|page-numbers.docx|20|272|558|266|
|
||||||
|
|ru-en-mixed.doc|20|300|453|293|
|
||||||
|
|ru-en-mixed.docx|20|344|528|298|
|
||||||
|
|ru-plain.doc|20|344|572|256|
|
||||||
|
|ru-plain.docx|20|281|455|274|
|
||||||
|
|ru-table-image.doc|20|331|462|267|
|
||||||
|
|ru-table-image.docx|20|299|522|263|
|
||||||
|
|ru-times.doc|20|275|561|275|
|
||||||
|
|ru-times.docx|20|251|580|256|
|
||||||
|
|stale-cache.doc|20|307|511|264|
|
||||||
|
|stale-cache.docx|20|323|525|269|
|
||||||
|
|symbol-bullets.docx|20|335|459|310|
|
||||||
|
|too-many-pages.doc|20|405|599|265|
|
||||||
|
|too-many-pages.docx|20|327|724|288|
|
||||||
|
|big (синтетика ×400)|5|924|976|360|
|
||||||
|
|
||||||
|
Итоги прогона: `allocated-estimate=36069MB` (≈71 МБ churn на конвертацию при медианном peak 300 МБ),
|
||||||
|
`max-live-after-gc=504MB`, паузы 536 шт./4815 мс; `VmHWM` процесса: 1,34 ГБ после suite-части,
|
||||||
|
1,56 ГБ после big-части (`-Xmx2g` доступен, куча растягивается под churn).
|
||||||
|
|
||||||
|
Главный вывод baseline: **память уходит не в копии документа, а в churn конвейера**. Вход 2,6–182 КБ
|
||||||
|
при peak 224–641 МБ — отношение долей порядка сотен. Профиль аллокаций (JFR, alloc-total —
|
||||||
|
оценка сэмплера 26,3 МБ взвешенных):
|
||||||
|
|
||||||
|
- доли приложения в топ-кадрах: `DocxRewritePipeline.normalize` — 0,44%, `WordPdfConverter.convert` —
|
||||||
|
0,36%, `GlyphFont.draw` — 0,10%; все остальные кадры `ru.pjandro.*` — ниже 0,1% (гейты §4);
|
||||||
|
- остальное — библиотеки: JAXB-андмаршалинг docx4j через DOM (`DOMScanner.visit/scan`,
|
||||||
|
`SAXOutput.getQName`, `NamespaceContextImpl.put`, `SAX2DOMEx.startElement`, `ClassFactory.create0`),
|
||||||
|
Xalan/XSLT, FOP (таблицы OpenType: `OTFAdvancedTypographicTableReader`, `OpenFont.readHorizontalMetrics`),
|
||||||
|
commons-io `IOUtils.byteArray`, `Arrays.copyOf`, `Throwable.fillInStackTrace` (docx4j использует
|
||||||
|
исключения как control flow — «Package field null» и т.п.);
|
||||||
|
- ~~JEuclid (`Parser.parseStreamSourceAsOdf`) — OMML-формулы на хосте с fontconfig (в CI/контейнере
|
||||||
|
иначе: MathFallback)~~ — **удалён из класса путей** (2026-11): jeuclid исключён exclusion'ом из
|
||||||
|
`docx4j-export-fo`, формулы рисует собственный `MathRenderer` (PNG, только бандл-шрифты);
|
||||||
|
`MathFallbackNormalizer` теперь деградирует в текст только конструкции вне `MathModel.SUPPORTED`.
|
||||||
|
|
||||||
|
## 3. Что нашли при чтении кода (архитектурные находки)
|
||||||
|
|
||||||
|
1. **FO материалзуется как `String`.** Форк `FORendererApacheFOP.convert(FODocumentHandler,
|
||||||
|
FOConverterContext, String)` (javap docx4j-export-fo 17.3.2) принимает весь выход XSLT одной
|
||||||
|
строкой UTF-16: для FO-документа это ≈2 байта/символ и FO в разы больше исходного XML.
|
||||||
|
Убрать можно только правкой форка (`templates.transform` стримом в FOP-парсер) — вне рамок
|
||||||
|
репозитория; фиделити-риск высокий. Дорожная карта.
|
||||||
|
2. **`disableFontCache()` в форке вызывается безусловно в 3 местах** (javap `FORendererApacheFOP`:
|
||||||
|
`FontManager.disableFontCache`), один участок защищён `Fop.isUseCache()` из fop.xconf
|
||||||
|
(по умолчанию кеш выключен) → таблицы шрифтов перечитываются на каждый рендер (видно в топ-кадрах).
|
||||||
|
Потенциальный рычаг (churn+CPU), но включение кеша влияет на сабзеттинг/метрики — только с
|
||||||
|
фиделити-прогоном, в форк/конфиг. Дорожная карта.
|
||||||
|
3. **`WordprocessingMLPackage` в docx4j 17.3.2 не имеет `close()`/`dispose()`** (javap пакета
|
||||||
|
`openpackaging.packages`/`parts` — только `setJaxbElement`/`unmarshal`): «освободить пакет явно»
|
||||||
|
API не даёт; пакет — локальная переменная `convertToStream` и умирает вместе со стеком.
|
||||||
|
4. **Валидатор делает два полных стриминговых прохода** по байтам входа (`checkPageCount` +
|
||||||
|
`checkDocxContainer`/`validate`): CPU, память O(8 КБ буферов) — на peak не влияет (§4, гейт E).
|
||||||
|
5. **Мост `.doc` уже отпускает потоки** (`releaseStreams`), но `DocxWriter.write` держит одновременно
|
||||||
|
`bodyXml`+`parts`+`hyperlinks` до `toByteArray()`; на фикстурах доля моста в аллокациях <0,15% —
|
||||||
|
не рычаг при текущих документах (§4, гейт C).
|
||||||
|
|
||||||
|
## 4. Кандидаты оптимизаций и гейты
|
||||||
|
|
||||||
|
Гейт: кандидат остаётся, только если после правки suite-сумма peak или big-peak улучшились ≥3%
|
||||||
|
(для «всегдашнего» A — плюс отсутствие регрессии); для B/C/E — плюс доля ≥5% в app-sites JFR.
|
||||||
|
Прогоны «до/после» — идентичной методикой, один и тот же компьютер, подряд.
|
||||||
|
|
||||||
|
|Кандидат|Доля в аллокациях (гейт 5%)|Замер после (гейт 3%)|Итог|
|
||||||
|
|---|---|---|---|
|
||||||
|
|A. Чанковый буфер PDF вместо `ByteArrayOutputStream`|—|`allocated` +0,7% (шум), сумма peak **+7,2% (хуже)**|отклонён, откачен|
|
||||||
|
|B. Needle-гейт декода в `DocxRewritePipeline`|`normalize` 0,44%|—|отклонён до правки|
|
||||||
|
|C. Ранний отпуск `bodyXml`/`parts`/`hyperlinks` в `DocxWriter.write`|кадров моста в топ-15 нет (<0,15%)|—|отклонён до правки|
|
||||||
|
|D. Явный release пакета docx4j|API отсутствует (§3.3)|—|нереализуем|
|
||||||
|
|E. Один проход валидатора|кадров валидатора в топ-15 нет (<0,1%)|—|отклонён до правки (плюс риск порядка ошибок — контракт 400-кодов)|
|
||||||
|
|
||||||
|
**Почему A отклонён измерением, хотя «в теории» экономит.** Реализация (`PdfOutputChunks`,
|
||||||
|
чанки вместо удваивающегося `byte[]`) протестирована на эквивалентность байтов и прогнана полным
|
||||||
|
бенчем (25 фикстур ×20 + big ×5, тот же метод):
|
||||||
|
|
||||||
|
- PDF фикстур в среднем 385 КБ: для них `PdfOutputChunks` с фиксированным чанком выделяет больше,
|
||||||
|
чем рост `ByteArrayOutputStream` от `Math.max(1<<16, docxBytes.length)` — сумма peak выросла на 7,2%;
|
||||||
|
- микробенч на 24 МБ (одноразовый `PeakProof`, куча 2г): peak 76 МБ у чанков против 61 МБ у BAOS —
|
||||||
|
чанк 1 МиБ на G1 humongous (регион 1 МиБ → 2 региона на чанк, отсюда ×2), чанк 256 КиБ уходит в
|
||||||
|
young и при подсчёте `peak` платит растянутым Eden; live-минимум чанков (P+P против 2–3P у BAOS)
|
||||||
|
выигрывает только на PDF десятки мегабайт, каких в фикстурах нет;
|
||||||
|
- вердикт гейта: не улучшено → откачен, конвейер остался на `ByteArrayOutputStream`.
|
||||||
|
|
||||||
|
**Итог по правкам ядра: ни один кандидат не прошёл гейт.** Это не «нечего улучшать», а «у текущих
|
||||||
|
документов память тратят библиотеки» (JAXB-via-DOM, XSLT, FOP-шрифты — §2; JEuclid больше
|
||||||
|
не потребитель — исключён из зависимостей): точечными
|
||||||
|
правками репозитория их не сократить, а правки библиотек/форка (FO-стриминг, font cache) —
|
||||||
|
отдельные задачи с фиделити-гейтом. Практический рычаг «потреблять меньше» прямо сейчас — размеры
|
||||||
|
кучи и GC (§5).
|
||||||
|
|
||||||
|
## 5. Матрица флагов JVM (итог: что ставить в прод)
|
||||||
|
|
||||||
|
Один и тот же прогон (`--scenario all --loops 5 --big-loops 2`), меняются только флаги
|
||||||
|
(`MB_JAVA_OPTS` поверх дефолта харнеса; для смены GC нужен и `-XX:-UseG1GC` — иначе старт падает
|
||||||
|
с «Multiple garbage collectors selected»). ВМ не кончалась ни на одном наборе, OOM'а нет нигде,
|
||||||
|
включая big-сценарий:
|
||||||
|
|
||||||
|
|Набор|VmHWM suite, МБ|VmHWM +big, МБ|max-live, МБ|Паузы (шт/мс)|Вывод|
|
||||||
|
|---|---|---|---|---|---|
|
||||||
|
|f1 — G1, `-Xmx2g` (дефолт харнеса; прод-Containerfile как раз `2G`/`mem_limit 3G`)|931|1337|575|159 / 1724|работает, но куча ×2,6 к реальной потребности|
|
||||||
|
|f2 — G1, `-Xmx768m`|802|902|451|183 / 1865|**рекомендуемый**: RSS ≤0,9 ГБ с JFR-буферами, запас к max-live 1,7×|
|
||||||
|
|f3 — G1, `-Xmx512m`|818|843|416|199 / 1877|работает, но max-live 416 из 512 — малый запас на chart-тяжёлые документы|
|
||||||
|
|f4 — Serial, `-Xmx512m`|748|748|482|126 / 4453|работает; паузы ×2,6 против G1|
|
||||||
|
|f5 — Serial, `-Xmx384m`|628|634|359|150 / 5803|максимальная плотность (RSS 0,63 ГБ); паузы ×3,4, max-live 359 из 384 — впритык|
|
||||||
|
|
||||||
|
`allocated-estimate` у Serial-прогонов — 0: awk-агрегатор GC-лога понимает G1-формат (регионы),
|
||||||
|
для Serial аллокации считаются по другому шаблону — на вывод матрицы не влияет.
|
||||||
|
|
||||||
|
Рекомендация прод-стеку (рендерится job'ом `deploy` из Gitea Variables — менять их, не репо):
|
||||||
|
|
||||||
|
1. Heap: `-Xmx768m` (f2) вместо `2G`; `mem_limit` — `1g` вместо `3G`. FopFactory/XSLT-кеш перманентны,
|
||||||
|
их размер от кучи не зависит; 451 МБ max-live — это ~3 конвертации chart-тяжёлых документов в полёте
|
||||||
|
(а конвертации сериализованы монитором — реально одна).
|
||||||
|
2. G1 оставить (~13 мс пауз на конвертацию против ~40 мс у Serial; при конвертациях 1–4 с это не
|
||||||
|
критично, но G1 при 768m ещё и ровнее ведёт humongous-аллокации растров чартов).
|
||||||
|
3. Плотность выше f2 (Serial 384m) достижима, но запас <7% к max-live на 384m — для прод-вариабельности
|
||||||
|
документов неприемлемо.
|
||||||
|
|
||||||
|
## 6. Итог апгрейда
|
||||||
|
|
||||||
|
- Ядро не изменено: ни один кандидат (A–E, §4) не прошёл замерный гейт; экономия памяти на текущих
|
||||||
|
документах лежит не в коде репозитория, а внутри JAXB/XSLT/FOP (§2–3). Правки форка
|
||||||
|
(FO-стриминг, font cache) — зафиксированные дорожные пункты с фиделити-гейтом.
|
||||||
|
- Практический эффект «потреблять меньше» — профиль кучи: `2G/3G → 768m/1g` (в ~3 раза меньше
|
||||||
|
резидентной памяти на стенде) без потери проходимости всех сценариев, включая big.
|
||||||
|
- Инфраструктура измерений осталась в репо: `MemoryBench` + `membench.sh` + `./mise.sh run mem-bench`
|
||||||
|
— любой следующий раунд начинается с baseline за 10 минут.
|
||||||
|
|
||||||
|
## 7. Как читать этот документ дальше
|
||||||
|
|
||||||
|
- Перепроверить числа: §1 (команды) — прогон ~10 мин, артефакты в `target/` и `wordpdf-core/target/membench-*.jfr`.
|
||||||
|
- Перед новым «починить память»: сначала топ-кадры собственного прогона — доли приложения ≤0,4% означают,
|
||||||
|
что чинить нужно библиотеки, а не `WordPdfConverter`.
|
||||||
|
- Стоп-лист § «не чинить» из `docs/agent/render-limitations.md` остаётся в силе: экономия памяти
|
||||||
|
не должна менять выход PDF (фиделити-тесты — единственный арбитр).
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
> читать при правке `internal/chart`. Авторитетно наравне с AGENTS.md.
|
||||||
|
|
||||||
|
Нормативный источник любых правок — ECMA-376 (`docs/standards/ooxml/`: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D + полные наборы XSD `schema/strict/`/`schema/transitional/`; поведение Word — `ms-oi29500.md`, `ms-odrawxml.md`), а не догадки по исходникам LibreOffice/Word. Формулировки из стандарта при ссылке — с номером секции (§21.2.2.132 и т.п.). Эмпирические калибровки (камера, `PIE_DEPTH`) менять только вместе с пиксельными тестами. Фикстуры могут быть невалидны — код под фикстуру не правится, правится фикстура (после проверки по XSD/секции).
|
||||||
|
|
||||||
|
Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры в пунктах, EMU→pt `cx/12700.0`). Потолок растра `ChartRenderer.MAX_PIXELS = 16_777_216` (4096², 64 МБ ARGB): при превышении `fitDpi` uniform-но понижает эффективный dpi (геометрия в пунктах и безразмерные пропорции не меняются; 24″-график: 208 МБ → 64 МБ, dpi 300 → ≈171); `SmartArtRenderer` использует тот же `DPI`/`fitDpi`. `ChartSpec.parse` (`enum Type`: PIE, PIE3D, DOUGHNUT, BAR, BAR_HORIZONTAL, LINE, AREA, SURFACE3D, AREA3D, BAR3D, LINE3D, RADAR, SCATTER, BUBBLE, STOCK, OF_PIE, SURFACE, UNSUPPORTED). `c:autoTitleDeleted` (§21.2.2.7, `val` опущен — default true) применяется только при отсутствии `c:title` (MS-OI29500 §2.1.1431(a)) — явный заголовок показывается при любом флаге; при отсутствии `c:title` и `val=0` рисуется автозаголовок. Пустой/пробельный `c:title` (или `val=0` без `c:title`) — автозаголовок Office (MS-OI29500 §2.1.1561(a)): одиночный ряд с именем → имя ряда (любой тип графика), иначе `ChartSpec.AUTO_TITLE = "Название диаграммы"`; несколько абзацев `a:p` склеиваются `'\n'` (жёсткий перенос в `DrawMlText`). Регрессии — `ChartSpecTest#emptyTitleSingleSeriesBar_usesSeriesName`, `#deletedTitleWithText_stillShown`, `#deletedTitleValOmitted_stillShown`, `#multiSeriesDoughnut_placeholderNotSeriesName`, `#multiParagraphTitle_joinedWithNewlines`. Палитра `accent1..6` темы; легенда по умолчанию снизу; `overlay` (§21.2.2.132) рисуется поверх области построения, место не резервирует.
|
||||||
|
|
||||||
|
Пейнтеры: `CartesianPainter` (2-D line/bar/area; `c:grouping` stacked/percentStacked §21.2.2.76 — ряд рисуется накопленной суммой через `ChartRenderer.stackedCumulative`), `PiePainter` (`PIE_DEPTH = 0.22`, `PIE_FIT = 0.865`), `Surface3dPainter` (камера — регрессия `cameraMatchesWordReference`: `DEPTH_RATIO = 0.705`, `HEIGHT_RATIO = 0.664`, `GUTTER_LEFT/RIGHT = 0.1485`, `GUTTER_TOP = 0.116`, `GUTTER_BOTTOM = 0.146`, свет `LIGHT_X/Y/Z = 0.83/0.48/0.28`; `c:rAngAx=true` приоритетнее `c:perspective` (MS-OI29500 §2.1.1516(b)); `c:wireframe` §21.2.2.205 — только каркас), `ScatterPainter` (радиус пузыря sqrt при `c:sizeRepresents="area"` §21.2.2.128), `RadarPainter` (спицы от 12 часов), `StockPainter` (upDownBars обводятся контуром, дефолт чёрный 0.75pt), `OfPiePainter` (MS-OI29500 §2.1.1507(a), §2.1.1545(a)), `Surface2dPainter` (контурная карта §21.2.2.204, marching squares, изолинии по `c:bandFmts` §21.2.2.13/.14), `Cartesian3dPainter` (bar3D/line3D/area3D §21.2.2.19/.101/.122, `c:shape` §21.2.3.44), `SmartArtRenderer` (кэш `word/diagrams/drawing1.xml` через relationship `…/office/2007/relationships/diagramDrawing`; формы — `PresetGeometry` из `a:prstGeom`, семь пресетов дословно из `presetShapeDefinitions.xml`; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, **не** x != 0); углы в Arc2D — со знаком минус; текст — `DrawMlText`, шрифты через `BundledFontAliases.bundledFamily`; autofit только `normAutofit` §21.1.2.1.2/.3; `dgm:prSet/@phldrT` не рисуется).
|
||||||
|
|
||||||
|
Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS = 100_000` (`c:pt/@idx` §21.2.2.150/.151, `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы; отказ `IllegalArgumentException` **до** предвыделения списка), `ChartRenderer.MAX_TICKS = 1000` (шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется `niceUnit` 1/2/5·10ⁿ), `DrawingPreRenderer.MAX_EXTENT_EMU = 22_000_000` (≈24″; при `cx/cy` вне капа объект **оставляется как есть** + warn, картинка не рендерится — регрессия `hugeExtentChart_removedNotOom`). Бросок перехватывает catch в `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn». Обход `pkg.getParts()` — только по **снимку** списка (вставка media-частей `addChartMedia→addPart→loadPart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, **не** `getOwningRelationshipPart()`; обход XML обязан раскрывать `JAXBElement`.
|
||||||
|
|
||||||
|
**Combo** (Word «Комбинированная», §21.2.2.145): несколько групп в одном `c:plotArea` (`c:barChart` + `c:lineChart`/`c:areaChart`), каждая со своими `c:axId` (§21.2.2.9). `parse` привязывает группы по id осей: `Series.renderAs` (семейство отрисовки), `Series.grouping`, `Series.valAxis` + `ChartSpec.secondaryValAxis` (обычно `c:axPos="r"`); `spec.valAxis`/`catAxis` — first-wins. `CartesianPainter` рисует семейства в порядке BAR→AREA→LINE, каждая серия масштабируется по своей оси, вторичная ось — линия справа + подписи справа.
|
||||||
|
|
||||||
|
**chart-PNG media-части вставляются вручную** (`DrawingPreRenderer.addChartMedia`: `newPartForContentType` → `setBinaryData` → `rels.addPart`), БЕЗ `BinaryPartAbstractImage.createImagePart`: тот пишет PNG во временный файл и декодирует его обратно (ImageInfo) ради mime и размеров, которые нам и так известны — mime заведомо `image/png`, размер задаёт `wp:extent`; PNG-decode в exported-пути — верхняя строка потребления памяти (JFR-замер 25 фикстур). Имена `/word/media/chart-N.png` (`DrawingPreRenderer.CHART_MEDIA_URI_PREFIX`): уникальность — счётчик с проверкой реестра пакета (`PartName.generateUniqueName` уникальность НЕ даёт — конкатенация), `RENAME_IF_NAME_EXISTS` — при коллизии с media враждебного документа наша часть переименовывается, а не затирает чужую. `ChartImageHandler` (вешается `foSettings.setImageHandler` в `WordPdfConverter`) возвращает `null` из `compressedVariant` для `chart-*` — docx4j «Compress Pictures» (CR-029) для них не ресемплит растры и даже не декодирует их при экспорте (`PictureCompression.compress` декодирует ВСЕГДА); режим `word` (порог 300 ppi) наши 300-dpi растры и не трогал по размеру, экономия — именно пропуск decode/resample. Медиа документов (фото/скрины) остаются в штатном docx4j-режиме CR-029. Регрессии: `chartMedia_notDownsampled`, `DrawingPreRendererTest`, `ChartImageHandlerTest`.
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
> читать при правке workflow'ов, Containerfile'ов или деплоя. Авторитетно наравне с AGENTS.md.
|
||||||
|
|
||||||
|
### Деплой (прод)
|
||||||
|
|
||||||
|
**Прод** — на пользовательском LAN-сервере (podman + podman-compose, docker-бинарников нет); прод-хост не хранит ни конфигураций, ни секретов: job `deploy` в `main.yml` рендерит `docker-compose.yml` и `nginx.conf` в директорию деплоя (значения — из Variables, API-ключ — из Secret `WORDPDF_API_KEY` через окружение деплоя, на диск не пишется), затем login/pull/`up -d --force-recreate app web`/гейты healthy+image/recreate gateway. Наследие `restart.sh` и `.env` деплой удаляет; единственное состояние на проде — `.rollback.env` (image ID для отката). Перезадеплой — push в `main` или Run workflow (`workflow_dispatch`), ручных скриптов нет. Наружный вход — `https://pjandro.ru/pdf-converter/`.
|
||||||
|
|
||||||
|
### Job'ы workflow'ов
|
||||||
|
|
||||||
|
Два workflow. `.gitea/workflows/pr.yml` — `PR checks` (`pull_request` + `workflow_dispatch`): job `java` (fail-closed проверка Variable `MAVEN_MIRROR_URL` первым шагом → единственный прогон `mvn -B clean verify` внутри образа `Containerfile.test` — без fontconfig, набор тестов никогда не исполняется на хосте с fontconfig; `DOCKER_BUILDKIT=0` обязателен — daemon за раннером podman, BuildKit-сессий нет; зеркало Nexus приходит `--build-arg` → извлечение двух `jacoco.xml` из образа `wordpdf-verify:ci` шагами `docker create`/`docker cp || true` — при непрошедшей сборке пустая сводка, тесты не затронуты) → `Coverage summary` (разбор извлечённого `target/site/jacoco/jacoco.xml` python-сниппетом в step summary) → `Comment coverage on PR` (тот же текст комментарием; создаётся один раз, повторные push обновляют по маркеру `<!-- jacoco-coverage -->`; `continue-on-error`). job `macos-sim` — тот же образ `Containerfile.test`, собранный с `--build-arg SUREFIRE_OS_NAME="Mac OS X"` (эмуляция macOS: единственный хост-зависимый код — docx4j `PhysicalFonts`, читающий `os.name`; внутри образа набор исполняется дважды — сначала `verify` без флага догревает локальный репозиторий до нуля загрузок, затем `verify` с флагом, т.к. Linux-JVM с `os.name=Mac OS X` падает AssertionError на первом же сетевом сокете; шагов JaCoCo/комментария нет — дублировали бы `java`), в `main.yml` отсутствует намеренно. job `web` (кеш `~/.npm`, `npm ci` → `build` → `lint`; `setup-node` **нет** — нода берётся с раннера).
|
||||||
|
|
||||||
|
`.gitea/workflows/main.yml` — `Main: tests, deploy, autotests` (`push` в `main` + `workflow_dispatch`): те же `java`/`web` (байт-байт дубль — workflow-файлы самодостаточны, reusable-workflow не вводить) → `images-app`/`images-web` (build+push каждого Containerfile в Nexus-реестр `${{ vars.REGISTRY }}`, теги `prod` + immovable `sha-<7 символов GITHUB_SHA>`; app печётся с `--build-arg MAVEN_MIRROR_URL=…` (зеркало Nexus в Containerfile); web печётся с `--build-arg VITE_BASE=/pdf-converter/`; `DOCKER_BUILDKIT=0` обязателен — daemon за раннером podman, BuildKit-сессий нет; креды — вручную пишется `~/.docker/config.json`) → `deploy` (SSH на прод: рендер конфигов heredoc'ами в workspace раннера — appleboy/ssh-action непригоден, ломает heredoc; валидация PyYAML; прод-стек — подсеть `10.112.0.0/24` gw `10.112.0.1` (в репо-`compose.yml` — `10.113.0.0/24`, стенды разные), gateway биндится на `127.0.0.1:9010` + `$DEPLOY_HOST:9010`, `nginx.conf` — с `resolver 10.112.0.1`; сохранение `.rollback.env`; `login/pull/timeout 90 podman-compose up -d --force-recreate app web`; гейты healthy и image; gateway пересоздаётся последним; health-check) → `autotests` (venv + `prod-autotests/` против прода) → `rollback` (`if: failure()` — перерендер/перезалив прод-файлов тем же шагом, retag прежних image ID на `:prod`, `--force-recreate app web`, пересоздание gateway).
|
||||||
|
|
||||||
|
Артефактов покрытия нет намеренно: `upload-artifact@v4` Gitea не поддерживает, `@v3` на этом стенде зависает. HTML-отчёт — локально `target/site/jacoco/`, `web` (кеш `~/.npm`).
|
||||||
File diff suppressed because one or more lines are too long
@@ -0,0 +1,48 @@
|
|||||||
|
> читать при правке конвейера `WordPdfConverter`/нормализаторов/валидатора. Авторитетно наравне с AGENTS.md.
|
||||||
|
|
||||||
|
### Шаги конвейера 0–7 (полное «что делает» с обоснованиями)
|
||||||
|
|
||||||
|
| # | Шаг | Что делает |
|
||||||
|
|---|---|---|
|
||||||
|
| 0 | `DependencyGuard.check()` | API-проба `ZipArchiveInputStream.getNextEntry()` — совместимость commons-compress ≥ 1.25.0; иначе `ConversionException` с инструкцией вместо мутного `NoSuchMethodError` внутри docx4j |
|
||||||
|
| 1 | `new BundledFontMapper()` → `BundledFonts.init()` → `restrictToBundled()` | Конструктор маппера (static `BestMatchingMapper`) регистрирует в `PhysicalFonts` только symbol-шрифты из `docx4j-export-fo-fonts-symbol` (сканы системы и jar'ов отключены в static-блоке `WordPdfConverter` гейт-свойствами — всё найденное всё равно выбрасывает `restrictToBundled()`); `init()` вызывает `dropNonBundled()` **до** регистрации бандла, `restrictToBundled()` оставляет реестр = бандл + встроенные в docx. Порядок `init()` после конструктора — инвариант: `addPhysicalFont` не перезаписывает занятый ключ (иначе системный Calibri ломает em-dash-fallback) |
|
||||||
|
|2|`DocxRewritePipeline.STEP` → `OleObjectNormalizer` → `WordprocessingMLPackage.load`|Один zip-проход переписывания XML-частей (правила 1–11 — раздел «Нормализаторы: контракт и правила 1–12» в этом файле) + условная OLE-вычистка (правило 12)|
|
||||||
|
| 3 | `pkg.setFontMapper(mapper)` | Привязка шрифтов документа к физическим TTF |
|
||||||
|
| 3.5 | `DrawingPreRenderer.run(pkg, options)` | `c:chart`/`dgm:relIds`/`m:oMath` → PNG 300 dpi → `pic:pic` (docx2fo.xslt их не умеет); формулы — собственный растер `MathModel`/`MathRenderer` (только бандл-шрифты, без AWT/JEuclid), inline-картинка опускается ран-`w:rPr/w:position` на свой нижний запас (FOP ставит инлайн-графику нижним краем на базу строки; регрессия — WordPdfConverterTest#ommlMathInline_sitsOnTextBaseline), неподдерживаемая конструкция — текстовая деградация + warn; budget chart/math-PNG общий |
|
||||||
|
| 4 | `new FOSettings(pkg)` + `FopFallbackFonts.declare(foSettings)` | В FOP-конфиг добавляются **все** бандл-семейства: FOP встраивает только задекларированные. Конфиг обязан быть **полным при каждом `declare`**: docx4j декларирует из `fontsInUse` только использованные начертания (или simulate-style на regular-файле), а общая `FopFactory` замораживает fopconf **первого** документа JVM — `declareFamily`+`hasRealFace` дополняют каждое семейство недостающими реальными начертаниями (регрессия — `fopFactoryFrozenFromFirstDoc_fontsComplete`) |
|
||||||
|
| 4.25 | `LayoutPostRenderer.register(foSettings)` | Кастомный `FORenderer`: post-FO padding-компенсация таблиц (`start-indent` += `padding-left` первой ячейки), внутри — штатный `FORendererApacheFOP` |
|
||||||
|
| 4.5 | `foSettings.setCustomXsltTemplates(VendoredXslt.TEMPLATES)` | Стилист — вендорный `xslt/docx2fo.xslt` (копия docx4j-export-fo + AUDIT-FIX-патчи: `w:rPr/w:position`→`baseline-shift` и AUDIT-FIX-2 `moveFrom`/`moveTo`/`bdo`/`dir`); `Templates` компилируется один раз — `getTemplates` кастит значение в `Templates` |
|
||||||
|
| 5 | `FORendererApacheFOP.getFopFactoryBuilder` + `getFOUserAgent` | Непустой `title` → заголовок PDF |
|
||||||
|
| 6 | `Docx4J.toFO(foSettings, os, FLAG_EXPORT_PREFER_XSL)` | XSL-FO → PDF |
|
||||||
|
| 7 | `finally` → `getFontTablePart().deleteEmbeddedFontTempFiles()` | В docx4j 17.x `OpcPackage.close()` нет — пакет в памяти |
|
||||||
|
|
||||||
|
`BundledFontMapper` переопределяет `getBoldForm`/`getItalicForm`/`getBoldItalicForm`: на macOS `PhysicalFonts.getBoldForm` для имён `Tinos Regular`/`Carlito Regular`/… уходит в `MicrosoftFontsRegistry` и возвращает `null` (у записей нет Mac-имени файла), из-за чего docx4j строил simulate-style fopconf — FOP терял реальные начертания и кернинг (регрессии `strictOoxml_convertsNotRejected`, `ruPlain_regularRunsUseRegularFont`). Override находит реальный вариант по `embeddedURI` regular-варианта.
|
||||||
|
|
||||||
|
### `warmup()` — прогрев ядра (шаги 0–7 на минимальном docx)
|
||||||
|
|
||||||
|
Первая конвертация после старта JVM стоит 1,3–1,7 с (JAXB/XSLT/FOP/классы; замер 2026-11), её платил первый запрос после деплоя. Публичный `WordPdfConverter.warmup()` прогоняет шаги 0–7 на минимальном docx, собранном в байтах (три zip-части константами, фикстуры не задействованы; алиас Calibri→Carlito греет маппер и embed-подмножество), и греет Java2D/PNG-энкодер (`warmRaster()` — растер + `GlyphFont.draw` + `ImageIO.write`), иначе первый чартный документ платит ещё ~200 мс. Идемпотентен (`volatile warmedUp`, метод `synchronized`), никогда не бросает (провал — warn в JUL), артефакты отбрасываются; вызывать на потоке, сериализующем конвертации. Ядро само себя не зовёт: `wordpdf-app` ставит warmup головой очереди воркеров в конструкторе `ConversionService`. Прогретый первый конверт ru-plain.docx HTTP-запросом: 0,13 с против 1,74 с (A/B на одной машине, сборки ветки и `main`).
|
||||||
|
|
||||||
|
### Валидация входа и подсчёт страниц
|
||||||
|
|
||||||
|
Вход валидируется **до** `convertToStream`: `WordPdfValidator.validate(bytes, options)` (размер → подпись: zip `PK\x03\x04` или CFB `D0 CF 11 E0` → контейнер → страницы). Для `.doc` страницы считаются **по сырым байтам .doc, до конвертации**: `checkPageCountDoc` = `max(SummaryInfo PageCount, 1 + разрывы 0x0C − непрерывные межсекционные (sprmSBkc 0/1) + sprmPFPageBreakBefore)` (код — `DocFile.countPages`). Тот же метод — вход приложения. Скан выполняется ровно один раз по сырому входу, до аллокаций docx4j: правила 1–11 число учитываемых разрывов не увеличивают (правило 10 способно только убрать разрыв внутри скрытого рана — счёт по сырому входу остаётся верхней оценкой лимита).
|
||||||
|
|
||||||
|
- Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; explicit = межсекционные `w:sectPr` в body + `w:br type="page"` + `pageBreakBefore` (включая таблицы и `w:sdt`). Единственный путь — lightweight (StAX по zip, secure-ридер без DTD/external entities; `WordPdfValidator` не зависит от docx4j): атрибуты — по локальному имени (`attrLocal`, не по transitional-URI: иначе в strict-документе `w:br type="page"` не засчитываются); `sectPr` внутри `pPr` не считает, последнюю body-direct секцию не считает, `continuous`-секции не считает, в колонтитуках — только `w:br type="page"`, `pageBreakBefore` — только внутри `pPr` вне `sectPr` (truthy `val`: `null|true|1|on`). На не-zip молчит — подпись проверяет вызывающий. `checkPageCount` — один стриминговый проход `ZipInputStream` без буферизации частей (хелпер `noClose` глушит `close()` сканеров): потребление O(одной части) вместо O(суммы XML-частей).
|
||||||
|
|
||||||
|
### Нормализаторы: контракт и правила 1–12 (детали)
|
||||||
|
|
||||||
|
Контракт: `byte[] normalize(byte[]) throws IOException`; нечего менять → вернуть **тот же массив** (`assertSame` в тестах). Одиннадцать rewrite-нормализаторов цепляются в фиксированном порядке Strict→OnOff→Symbol→Field→Invisible→MathFallback→GlyphCoverage→TableIndent→NumberingSuffix→Hidden→Ruby; константу `STEP` (`public static final DocxNormalizer`) несёт только `DocxRewritePipeline` (собирает рерайты сам), у `OleObjectNormalizer` STEP **нет** — он подключается лямбдой в `WordPdfConverter.normalizers()`, а вместо `normalize(byte[])` у него `normalize(byte[], boolean)`. Правила 1–11 применяет `internal/DocxRewritePipeline` — **один zip-проход**: к каждой записи `word/*.xml` рерайты применяются последовательно (каждое правило работает только содержимым одной части — по-частная цепочка эквивалентна последовательным полным проходам); до прохода из `word/document.xml` извлекается полоса набора (`TableIndentNormalizer.bandOf`, −1 — полосы нет), и `word/headerN.xml`/`footerN.xml` дополнительно прогоняются через `TableIndentNormalizer.rewritePart` с этой полосой, и из `word/styles.xml` читается множество vanish-стилей (`HiddenTextNormalizer.vanishStyles`, цепочка `w:basedOn`) — контекст правила 10; неизменённые записи переносятся raw-копией сжатых байтов (без inflate/deflate); нигде не поменялось → тот же массив. `OleObjectNormalizer` — второй условный проход (меняет части, а не XML). Индивидуальные `normalize()` десяти нормализаторов сохранены (контракт юнит-тестов), но `WordPdfConverter` их не вызывает — его `normalizers(options)` = `DocxRewritePipeline.STEP` + лямбда OLE. Порядок правил значим:
|
||||||
|
|
||||||
|
1. `StrictOoxmlNormalizer` — strict-OOXML → transitional: `a:`-проценты и `w14:fillToRect` → тысячные ×1000, текст `wp14:pctWidth`/`pctHeight`; элементы `w:start`/`w:end` → `w:left`/`w:right` (кроме `w:lvl/w:start` в numbering.xml); значения `w:val="start"/"end"` у `w:jc` и `w:tab` правятся **всегда** (docx4j `Justification.setXslFO` знает только left/center/right/both, для END `fo:text-align` не пишет вовсе — `jc="end"` рендерился по левому краю; Part 1 §17.3.1.13: `jc val="end"` — правовыравнивание в LTR, ST_Jc §17.18.44; RTL вне контура — FOP без complex-script). Strict-ность части определяется наличием `http://purl.oclc.org` (не «transitional-URI в документе» — mixed-документ трактуется по каждой части). **Guard сосуществования форм**: атрибут `w:start`/`w:end` переименовывается только внутри открывающего тега `w:ind` (MS-OI29500 §2.1.174 — псевдонимы left/right; у `w:pgNumType` `w:start` — старт нумерации страниц, легален в transitional, Part 1 §17.13.4 — не трогается) и не переименовывается, если в том же открывающем теге уже есть `w:left`/`w:right` (дубль атрибута ломает well-formedness — регрессии `indCoexistLeftStartUntouched`, `indCoexistForms_convertsNotRejected`, `pgNumTypeStartAttrUntouched`); элементы `w:start`/`w:end` в strict-части переименовываются глобально, в transitional — только внутри `w:tcMar`/`w:tblCellMar` без одноимённого соседа (`maxOccurs=1` на left). Ничего не поменялось → `rewrite` вернул `null` → исходный массив (`StrictOoxmlNormalizerTest#transitionalCoexistReturnsOriginalArray`).
|
||||||
|
2. `DocxOnOffNormalizer` — `w:val="off"/"on"` → `"false"/"true"`; якорь по тегу, правится только атрибут `w:val`, текст между тегами не трогается.
|
||||||
|
3. `SymbolFontNormalizer` — PUA U+F000–U+F0FF (Symbol/Wingdings/Webdings) → Unicode + DejaVu Sans; переписывает `<w:sym>`, правит `w:lvl` в numbering.xml; 5 карт по 256 слотов (таблица `SymbolMapper` из docx4j 17.x).
|
||||||
|
4. `FieldNormalizer` — `fldChar` PAGE/NUMPAGES/SECTIONPAGES → `w:fldSimple` (кэш страниц в PDF не попадает); вложенные/битые поля пропускаются.
|
||||||
|
5. `InvisibleCharNormalizer` — вырезает из `w:t` U+0085, U+2028, U+2029, U+200E/200F, U+202A–202E, U+2060, U+FEFF (FOP делает из них переносы/пустые строки, Arimo/Tinos рисуют боксы). U+00A0/U+00AD/U+200B–U+200D **не** трогает.
|
||||||
|
6. `MathFallbackNormalizer` — байтовый скан OMML-формул (§22.1) до загрузки пакета: формулы с конструкциями вне `MathModel.SUPPORTED` (или structurally битые) деградируют в текст — `m:oMathPara`/`m:oMath` → обычные раны с конкатенацией `m:t` (как в штатном фолбэке docx4j `XsltFOFunctions.mathText`); поддерживаемые части не трогаются (`rewrite` → `null`, тот же массив) — их рисует собственный `MathRenderer` на шаге 3.5. Позиция **до GlyphCoverage** обязательна: деградировавшие раны с математическими символами (U+1D400+) обязаны пройти резку по покрытию, иначе FOP рисует «#». `m:oMathPara` содержит `m:oMath`, поэтому блок para заменяется первым. Регрессия — WordPdfConverterTest#ommlMathUnsupported_flattenedToText, юниты — MathFallbackNormalizerTest.
|
||||||
|
7. `GlyphCoverageNormalizer` — режет раны по покрытию глифов и пишет семейство в `w:rFonts`, иначе FOP рисует «#». Покрытие — `GlyphFont` (fontbox, cmap) + BitSet-кэш, **не** docx4j `GlyphCheck` (плодит INFO-лог; `java.awt.Font` требовал fontconfig на хосте). Для serif-ран fallback ищется сначала в `SERIF_FAMILIES` (`dejavu serif`, `tinos`, `caladea`), затем в sans.
|
||||||
|
8. `TableIndentNormalizer` — свёртка `w:tblPr/w:jc` (center/right) с любым (в т.ч. отсутствующим/нулевым) `w:tblInd` в абсолютный `w:tblInd` с удалением `w:jc` (Word: tblInd — сдвиг от поля после центрирования, MS-OI29500 §2.1.155; docx4j при jc≠left игнорирует tblInd буквально — аудит раскладки ECMA-376, матрица B3, а центрированию пишет абсолютный start-indent **без** вычета cellMar, поверх которого padding-компенсация правила LayoutPostRenderer уводит текст на +padding — свёртка обязательна и при X=0): center → (W−T)/2+X, right → (W−T)+X, W — полоса набора (pgSz − pgMar left/right; у CT_PageMar полей `w:start`/`w:end` нет, полоса берётся из сырого document.xml до правила 1; дефолты 11906/1440 — измеренное поведение docx4j, ECMA дефолтов не фиксирует §17.6.11/.13), T — Σ gridCol; пропускает несколько body-level `sectPr`, `tblInd` с явным `w:type` ≠ dxa (опущенный type — dxa, §17.4.87), `tblPr` с `tblCellSpacing` без `tblInd` (нет корректной позиции вставки по CT_TblPrBase), `tblW pct`, нецелые gridCol. Кроме `rewrite` (document.xml, полоса из собственного sectPr) есть `rewritePart(part, xml, band)` — `word/headerN.xml`/`footerN.xml` с полосой из document.xml (в частях колонтитуков своего sectPr нет) и `bandOf(documentXml)` — экстрактор полосы (−1 — полосы нет). Регрессия — WordPdfConverterTest#tableIndentCentered_shiftedLikeWord, #headerTableIndent_centeredInHeader, #tableCenteredNoIndent_shiftedLikeWord.
|
||||||
|
9. `NumberingSuffixNormalizer` — `w:suff w:val="space"` → дописанный обычный пробел в конце следующего `w:lvlText` того же уровня (порядок CT_Lvl suff→lvlText, wml.xsd; ST_LevelSuffix Part 1 §17.9.28): docx4j разделитель не эмитит вовсе (дамп n4.fo); уже пробельный lvlText не дублируется; suff=tab — отдельный Class C-остаток (нужна per-item ширина), nothing совпадает с docx4j. Регрессия — WordPdfConverterTest#suffSpace_labelGetsSpace.
|
||||||
|
10. `HiddenTextNormalizer` — вырезание скрытых ранов (Part 1 §17.3.2.41): truthy `w:vanish` в собственном `w:rPr` ранa (обе OnOff-формы; вал опущен — default true; явный `false/0/off` в ране **перекрывает** vanish-стиль) **или** `w:rStyle` ∈ vanish-стили из `word/styles.xml` (транзитивно по `w:basedOn`, капа цепочки 16, цикл — обрыв); ран с защищённым содержимым (`fldChar`/`instrText`/`footnoteReference`/`endnoteReference`/`drawing`/`pict`/`object`/`txbxContent`) не трогается — удаление спаренных `begin…separate…end` сломало бы поле. Word скрытое не печатает, стилист docx4j `vanish` не читает вовсе → без правила скрытое утекало в PDF. Индивидуальный `normalize()` — свой pass styles.xml. Регрессия — WordPdfConverterTest#hiddenText_notPrinted, #hiddenText_directFalseOverridesVanishStyle, юниты — HiddenTextNormalizerTest.
|
||||||
|
11. `RubyNormalizer` — разбор руби-разметки (Part 1 §17.3.3.24–.28): снимается обёртка `w:ruby` (схемно-валидная транзишнл-разметка `w:r`→`w:ruby`→rubyPr/rt/rubyBase иначе достаёт catch-all-шаблону XSLT, и база теряется молча), `w:rubyBase` разворачивается в обычные раны, `w:rt`/`w:rubyPr`/`w:rubyAlign` вырезаются с содержимым (надстрочница — принятая деградация, ruby-разметки в FOP нет; потеря текста хуже потери аннотации). Чинится **в байтах**, а не в XSLT: схема docx4j 17.3.2 не биндит `w:rubyBase`/`w:rt` в `w:r` — unmarshaller теряет их до стилиста (в отличие от `moveFrom`/`moveTo`/`bdo`/`dir`, которых схема знает — тех ловит AUDIT-FIX-2). Регрессия — WordPdfConverterTest#rubyBase_textPrinted, юниты — RubyNormalizerTest.
|
||||||
|
12. `OleObjectNormalizer` — принимает флаг `errorOnOle`. Два этапа: дешёвый детект по центральному каталогу zip (`ZipFile`; читаются только `[Content_Types].xml` и `word/*.xml` до первого `<w:object`; не-zip/нет центрального каталога → входной массив — прежняя снисходительность), переупаковка — только при находке. Детект OLE-бинарников — по `[Content_Types].xml`: тип `…oleObject` **или** ложный `+xml`-тип у `.bin` (XML в bin не бывает; `printerSettings` не трогается). Удаляются вместе с rels-ссылками (по типу, включая `TargetMode=External`) и Override удалённых частей. Элементы `<w:object>` из `word/*.xml` не выбрасываются, а заменяются статичным представлением — картинкой-плейсхолдером (ECMA-376 §15.2.10): `w:drawing` переиспользуется дословно, `v:imagedata r:id` → inline-DrawingML на ту же image-часть (размер из `style` `v:shape`, иначе `w:dxaOrig`/`w:dyaOrig` ×635), блоки с `w:control` и без плейсхолдера удаляются. OLE-бинарники никогда не читаются. При `errorOnOle=true` вместо вычистки — `OleFoundException`. Лечит оба механизма падения docx4j: JAXB-разбор бинарника под ложным XML-типом («Content is not allowed in prolog» → NPE) и NPE `chunkType is null` в VML-сериализации `w:object`. Многочастный: публичный член только `normalize(byte[], boolean)`, `rewrite`-хука нет.
|
||||||
|
|
||||||
|
`mc-preprocessor.xslt` docx4j (в jar `docx4j-core`) перебивает strict-namespace'ы в transitional и конвертит `pt` в twips/half-points, но ветку перевода процентов в тысячные для namespace'ных атрибутов содержит с закомментированным `<xsl:value-of select="$cleanValue * 1000"/>` (для атрибутов без namespace — она активна), а `w:start`/`w:end` в `w:left`/`w:right` не маппит вовсе. Поэтому собственный рерайт URI ломать нельзя — он сломал бы pt-конверсию preprocessor'а (FOP получил бы «10pt»).
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
> читать до попытки «починить» перечисленное ниже — это не баги, а невозможности FOP/docx4j. Авторитетно наравне с AGENTS.md.
|
||||||
|
|
||||||
|
### Ограничения раскладки (FOP / docx4j)
|
||||||
|
|
||||||
|
- Известный остаток эталона: U+2188/U+218A — глифов нет в OFL-шрифтах бандла, остаются `.notdef` (GNU FreeSerif GPL — не добавляем намеренно).
|
||||||
|
|
||||||
|
- Аудит раскладки по ECMA-376 Part 1 (2026-10) — известные нечинимые ограничения FOP/docx4j (Java-слой): `w:jc="distribute"` рендерится как left — межсимвольного распределения в FOP нет (ST_Jc §17.18.44: distribute — межсимвольный разнос, justify только межсловный), последняя строка блока не растягивается, свойства `text-align-last` в форке нет (в docx4j-fo-renderer отсутствуют классы TextAlign*); `w:suff="tab"` и `w:lvlJc` игнорируются (numbering-лейбл всегда через hanging-tab; suff=space чинит правило 9, suff=nothing совпадает с docx4j — разделителя нет); абзац без `w:line` рендерится natural-высотой FOP 15.44pt@11pt, явный `lineRule="auto"` — 13.4277pt, два «single» в конвертере (13.4277 — канонический single по метрикам Carlito/Calibri 2500/2048 em; обе величины считаются по метрикам шрифта); кернинг не применяется ни для одного бандл-семейства (замер: advance A→V = A→A — Carlito 6.369pt, DejaVu Sans 7.524pt@11pt): 22 TTF — GPOS-only, а legacy `kern`-таблица DejaVu Sans/Serif ключована glyph id, не совпадающими с cmap (2568/2727 пар без Unicode-маппинга, пары A→V нет) — латинский путь FOP (`TextLayoutManager`→`Font.hasKerning`) читает только legacy `kern` и такие пары отбрасывает; свойства `kerning` в форке нет, порог `w:kern` через FO не выражается. Word кернит только при явно заданном `w:kern` в иерархии стилей и при sz ≥ val (Part 1 §17.3.2.19: кернинг применяется, только когда элемент задан; при отсутствии `w:kern` не кернит; MS-OI29500 §2.1.83 уточняет лишь диапазон `w:val`) — по умолчанию совпадает с нами, расходится только для документов с явно заданным `w:kern`. Починено веткой layout-class-c: левый padding ячейки (`LayoutPostRenderer`, шаг 4.25), `w:tblInd` при `w:jc`≠left (правило 8), `w:suff="space"` (правило 9).
|
||||||
|
|
||||||
|
- Аудит .docx-путей по ECMA-376 (2026-11) — запинено синтетикой (без фикстур): сноски/концевые сноски с номерами (§17.11), внешние гиперссылки с `/URI`-аннотацией (§17.12.23), `PAGEREF` (complex и вложенный в результат `TOC`) и `DATE` подменяют кэш живым значением, `titlePg` → first/default колонтитуки (§17.10.6), `vMerge` restart/continue (§17.4.70), block-level `w:sdt` (§17.5.2), `wps:txbx`-текст (§17.3.3.23; формула внутри текстового бокса до растера не доходит — обход drawing-нагрузку не спускается и уходит в docx4j-фолбэк `mathText`, конкатенация `m:t`; регрессия — WordPdfConverterTest#drawingTextBoxMath_convertsViaDocx4jTextFallback), OMML-формулы (§22.1) рисует собственный растер `MathModel`/`MathRenderer` — PNG 300 dpi, только бандл-шрифты jar, без AWT/JEuclid (текст из PDF не извлекается, пинь пикселями); неподдерживаемая конструкция или превышение бюджета — текстовая деградация (конкатенация `m:t`, `MathFallbackNormalizer`, правило 6) + warn, inline-формула выравнивается по базовой линии текста (мат-ось Word — принятая деградация), `m:oMathPara` — отдельный центрированный абзац (left/right по `m:jc`, indentLeft→left); фон `w:highlight`/`w:shd` рисуется (§17.3.2.16/.29). Скрытый текст `w:vanish` не печатается (правило 10); текст руби-базы и `w:moveFrom`/`w:moveTo`/`w:bdo`/`w:dir` не теряется (правило 11 + AUDIT-FIX-2). Остаток (не чиним): `w:framePr` игнорируется — текст печатается в общем потоке, геометрия фрейма теряется (ни XSLT, ни `createBlockForPPr` не читают); `REF`/`SEQ`/литеральные записи `TOC` печатают устаревший кэш из docx (движка пересчёта нет; инстринции полей не печатаются); надстрочница руби не выводится (правило 11 печатает только базу — ruby-разметки в FOP нет); `w:ptab` без `@w:alignment`, `bar`, `list` теряются catch-all'ом; `w:bdo`/`w:dir` печатаются LTR (bidi вне контура).
|
||||||
@@ -0,0 +1,124 @@
|
|||||||
|
> читать при навигации по репо, деплое и работе с REST/шрифтами — полный «путеводитель». Авторитетно наравне с AGENTS.md.
|
||||||
|
|
||||||
|
## Key Directories (полная таблица)
|
||||||
|
|
||||||
|
| Путь | Назначение |
|
||||||
|
|---|---|
|
||||||
|
| `wordpdf-core/src/main/java/ru/pjandro/wordpdf/` | Публичный API: `WordPdfConverter` (`convert(byte[],String,ConvertOptions)`), `WordPdfValidator` (`checkInput`/`validate` наружу; `checkPageCount`/`checkPageCountDoc`/`isBinaryDoc` — package-private, всё без зависимости от docx4j), `ConversionException`, `ValidationException` (наследник — «вход некорректен»), `ChartsFoundException`/`SmartArtFoundException`/`OleFoundException` (по error-флагам), `ConvertOptions` (record; дефолтов в ядре нет). Пороги защиты — производные от лимитов входа: `WordPdfValidator.maxDecompressedBytes`/`maxDecompressedXmlBytes` (`max(MIN_*×MiB, maxMb×10/4MiB + maxPages×64/32KiB)`, крышек нет), `maxZipEntries` (`max(2048, maxMb×512 + maxPages×32)`), `maxImagePixels` (`maxMb×5_000_000`); коэффициенты и полы — package-private литералы `WordPdfConverter` (`DECOMPRESS_*`, `MIN_DECOMPRESSED_*`, `IMAGE_PIXELS_PER_MAX_MB`, `ZIP_ENTRIES_*`, javac их инлайнит — валидатор не инициализирует конвертер) |
|
||||||
|
| `…/wordpdf/fonts/` | `BundledFonts` (реестр/выгрузка TTF), `BundledFontAliases` (алиасы, `DISPLAY_NAMES`, `bundledFamily` — без наследования, статика безопасна до гейта), `BundledFontMapper` (экземпляр-маппер docx4j), `GlyphFont` (глиф-движок fontbox) |
|
||||||
|
| `…/wordpdf/internal/` | 12 нормализаторов + `DocxRewritePipeline` (один zip-проход правил 1–11, raw-копия неизменённых записей) + `LayoutPostRenderer` (кастомный `FORenderer`, post-FO padding-компенсация таблиц, шаг 4.25) + интерфейс `DocxNormalizer` + `FopFallbackFonts` + `DependencyGuard` (проверка commons-compress, шаг 0). Классы package-private; `public` — `DocxNormalizer`, `DocxRewritePipeline` (наружу только `STEP`, `normalize` package-private), `OleObjectNormalizer`, `FopFallbackFonts` (`declare`), `LayoutPostRenderer` (`register`), `DependencyGuard` (`check`), остальные нормализаторы полностью package-private; `OleObjectNormalizer` — многочастный, публичный `normalize(byte[], boolean)`, бросает `OleFoundException` |
|
||||||
|
| `…/wordpdf/internal/doc/` | Мост `.doc` → `.docx`: 18 классов (детали — `docs/agent/doc-bridge.md`) — `CfbReader`, `FibHeader`, `PieceTable`, `Grpprl`, `ChpxIndex`, `PapxIndex`, `Styles`, `Tables`, `Lists`, `Sections`, `FontTable`, `SummaryInfo`, `Headers`, `OfficeArt`, `PrcData`, `DocFile`, `DocxWriter`, `DocToDocx` (публичные `convert`/`countPages`; вложенный `DocxBody` — рендер текста и табличного автомата в XML) |
|
||||||
|
| `…/wordpdf/internal/chart/` |21 классов Java2D-рендера диаграмм/SmartArt/OMML-формул в PNG (`MathModel`/`MathRenderer`/`MathUnsupportedException` — формулы); public: `DrawingPreRenderer.run` и `ChartImageHandler` — второй инстанцируется из `WordPdfConverter`|
|
||||||
|
| `wordpdf-core/src/main/resources/fonts/` | 30 TTF + 3 лицензии — бинарные фикстуры, часть jar |
|
||||||
|
| `wordpdf-core/src/main/resources/xslt/` | `docx2fo.xslt` — вендорный XSL-FO-стилист (копия docx4j-export-fo + AUDIT-FIX-патчи), часть jar |
|
||||||
|
| `wordpdf-core/src/test/resources/samples/` | 25 закоммиченных фикстур: 13 `.docx` + 12 `.doc` (11 эталонов заказчика из `develop/doc/` с теми же базовыми именами + `doc-formats.doc`); `.docx` проходят `docs/standards/docx/validate-fixtures.py`, `.doc` — бинарные, XSD к ним неприменим |
|
||||||
|
| `wordpdf-core/src/test/resources/geom/` | `presetShapeDefinitions.xml` — копия приложения ECMA-376, синхрон таблицы `PresetGeometry` (только в тестах, в jar не попадает) |
|
||||||
|
| `wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/` | REST API (11 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key) + 5 классов исключений (`BadRequest`, `DrawingRejected`, `ConversionFailed`, `ConversionRejected`, `ConversionTimeout`) |
|
||||||
|
| `wordpdf-web/src/` | SPA: `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo) |
|
||||||
|
| `wordpdf-web/nginx.conf` | В образ SPA (`Containerfile` COPY в `/etc/nginx/conf.d/default.conf` — переопределение default-сервера, отдельного монтирования нет): `try_files` SPA-fallback + `add_header ... always` (езжают и на 4xx/5xx): CSP `default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'` (inline-стили React); `img-src`/`frame-src` + blob: (PDF-предпросмотр в iframe); `connect-src 'self'`; `object-src 'none'` + `nosniff`, XFO DENY (не мешает blob-iframe), Referrer-Policy no-referrer |
|
||||||
|
| корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf` | Образ бэкенда (multi-stage `maven:3.9-eclipse-temurin-17` → `eclipse-temurin:17-jre-alpine`, non-root uid 10001, фиксированный heap `-Xms2g -Xmx2g`, HEALTHCHECK — busybox `wget`); compose app+web+gateway (`mem_limit: 3g` app, подсеть `10.113.0.0/24` gw `10.113.0.1`, `x-podman.name_separator_compat`); прод-compose не в репо — его рендерит job `deploy`; в репо-`compose.yml` springdoc выключен env (`SPRINGDOC_API_DOCS_ENABLED=false`, `SPRINGDOC_SWAGGER_UI_ENABLED=false`), в `compose.dev.yml` springdoc-переменных нет вовсе — включён по умолчанию (не отключается). `wordpdf-web/Containerfile` — `node:24-alpine` → `nginx:alpine`, `ARG VITE_BASE=/` (прод-CI печёт `/pdf-converter/`); `wordpdf-web/nginx.conf` копируется в образ (см. строку выше) |
|
||||||
|
| `.env.example` | Шаблон env: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает binding long/int). Проду `.env` не нужен — ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables |
|
||||||
|
| `.gitea/workflows/` | Gitea Actions: `pr.yml` (`PR checks`), `main.yml` (тесты + coverage-сводка и комментарий в PR → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback) |
|
||||||
|
| `GITEA-vars.md` | Инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений |
|
||||||
|
| `prod-autotests/` | Прод-автотесты API (pytest + requests, 31 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет |
|
||||||
|
| `docs/standards/` | Нормативная документация форматов Word/Excel, восемь каталогов + навигатор `README.md`: `ooxml/` — OOXML: PDF+md ECMA-376 Part 1 (5-е изд.), md [MS-OI29500]/[MS-ODRAWXML], полные наборы XSD `ooxml/schema/strict/` (21) + `ooxml/schema/transitional/` (26); `binary/` — общее OLE2-окружение .doc/.xls [MS-CFB]/[MS-OSHARED]/[MS-ODRAW]/[MS-OLEPS]/[MS-OFFCRYPTO]/[MS-OVBA]/[MS-WMF]/[MS-EMF]; `doc/` — [MS-DOC] (`ms-doc.md` + `ms-doc-full.md` — тот же текст с HTML packet diagram'ами и таблицами sprm §2.6.1–2.6.3, где `ms-doc.md` даёт `[TABLE]`); `docx/` — `validate-fixtures.py` (XSD-валидация `samples/*.docx`, lxml, ставится отдельно); `xls/` — [MS-XLS] (`ms-xls.md` + `ms-xls-full.md` — тот же приём `[TABLE]`); `xlsx/` — [MS-XLSX] (`ms-xlsx.md`); регенерация — README в каждом каталоге |
|
||||||
|
| `develop/` (вне git, gitignored) | Рабочие материалы и эталоны сравнения рендера — **не фикстуры**, в тесты/jar не подключать; пиксельные замеры зашиты числами в chart-тестах |
|
||||||
|
| `docs/agent/` | Глубокие справочники: `pipeline` / `doc-bridge` / `chart` / `render-limitations` / `testing` / `ci-cd` / `repo-map` (когда читать — по имени файла) |
|
||||||
|
|
||||||
|
## Important Files (полностью)
|
||||||
|
|
||||||
|
- `wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java` — точка входа библиотеки + static-блок `gsubFeatures` + `normalizers(options)` (порядок цепочки).
|
||||||
|
- `wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java` — валидация входа и lightweight-подсчёт страниц (StAX, без docx4j).
|
||||||
|
- Дефолтов лимитов в ядре нет (`WordPdfSettings` упразднён): лимиты входа всегда приходят с вызовом через `ConvertOptions`, производные пороги считает `WordPdfValidator.max*` (см. таблицу выше).
|
||||||
|
- `wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java` — замена диаграмм/SmartArt/OMML-формул на PNG; владеет `MAX_EXTENT_EMU` и деградацией при падении рендера (формула — текст вместо удаления).
|
||||||
|
- `wordpdf-app/src/main/resources/application.properties` — multipart 100MB (`max-file-size`/`max-request-size` + `file-size-threshold=2MB` — части крупнее 2 МБ на диск, не в память; в тон gateway `client_max_body_size 100m`), `wordpdf.convert-timeout=2m`, пустой `wordpdf.api-key`, `server.forward-headers-strategy=framework` (префикс прод-прокси для springdoc) + `springdoc.swagger-ui.persist-authorization=true`; `wordpdf.max-mb`/`max-pages` здесь намеренно нет.
|
||||||
|
- `wordpdf-app/pom.xml` — `spring-boot-maven-plugin` с **явной** execution `repackage` (в 4.1.1 сам не связывается, jar останется тонким); `slf4j-simple` исключён; `spring-boot-starter-webmvc` (Boot 4: переименован из starter-web) + `spring-boot-starter-actuator` (нужен HEALTHCHECK контейнера `/actuator/health`); тест-зависимости: `spring-boot-webmvc-test` (в Boot 4 автоконфиг MockMvc вынесен из starter-test), test-jar core.
|
||||||
|
- `wordpdf-core/pom.xml` — `maven-jar-plugin` execution `test-jar` (публикует фикстуры для app); JaCoCo execution `check` переопределён (LINE 0.90 + BRANCH 0.85).
|
||||||
|
- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, commons-compress `1.28.0`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox/fontbox `3.0.8` (`fontbox` — compile в core: глиф-движок `GlyphFont`; `pdfbox` — test в обоих модулях; commons-logging исключён, мост — `jcl-over-slf4j`), POI `5.5.1` (test), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; pluginManagement: compiler `3.16.0`, surefire `3.6.0` с `-Djava.awt.headless=true`, jar `3.5.1`, PMD `3.21.2` (движок PMD `6.55.0`), JaCoCo `0.8.15`; пустой дефолт `<argLine>` (для `-Djacoco.skip=true`).
|
||||||
|
- `pmd-ruleset.xml` — ruleset PMD (см. Code Conventions).
|
||||||
|
- `.ci/maven-settings.xml` — Maven-зеркало Nexus с URL из `${env.MAVEN_MIRROR_URL}` (общий файл CI-job'ов `java` и Containerfile; координаты стенда в репо не хранятся — Variable/build-arg).
|
||||||
|
- `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF.
|
||||||
|
- `gateway/nginx.conf` — единственный вход: `/api/`, `/swagger-ui`, `/v3/api-docs`, `/actuator` → `app:8080`, остальное → `web:80`; `client_max_body_size 100m` (без директивы upload режется HTML-413 шлюза вместо JSON-ошибки API); `proxy_read_timeout`/`proxy_send_timeout 300s` (дефолтные 60s рвут 2-минутные конвертации 504 раньше app-ного 504); `resolver 10.113.0.1` + `proxy_pass` через переменные (статический `proxy_pass` резолвит имя один раз при старте — gateway, поднявшийся раньше app, получал бы 502 до перезапуска); `X-Forwarded-For`/`-Proto`/`-Host` переписываются безусловно (`$remote_addr`/`$scheme`/`$host` — клиент не подставляет доверяемые Spring заголовки; `X-Forwarded-Prefix` проходит как есть — на нём base swagger-ui за внешним прокси). Тот же набор в прод-ренвере job `deploy` (`main.yml`, heredoc `NGINX`).
|
||||||
|
- `wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур; `ChartTypesDocxGenerator.java` — генератор `chart-types.docx`.
|
||||||
|
- `wordpdf-web/vite.local.config.ts` — легаси-одноразовщик (прокси `/api` → :8091), в `tsconfig.node.json` не включён; кандидат на удаление, не тиражировать паттерн. Корневые `javac.*.args` — мусор пробной компиляции (gitignored), тоже кандидат на удаление.
|
||||||
|
|
||||||
|
## Development Commands (детали)
|
||||||
|
|
||||||
|
Бутстрап toolchain: `sh bootstrap.sh` (Windows: `powershell -ExecutionPolicy Bypass -File .\bootstrap.ps1`) — ставит project-local mise в `./.mise/` (gitignored, в систему ничего не ставится) и инструменты из корневого `mise.toml`. Дальше — через `./mise.sh` / `.\mise.ps1` (Windows) либо `eval "$(./.mise/bin/mise activate bash)"`.
|
||||||
|
|
||||||
|
Точечный запуск одного теста:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mvn -pl wordpdf-core test -Dtest=WordPdfConverterTest#pageNumbers_recomputedNotCached
|
||||||
|
mvn -pl wordpdf-app -am test -Dtest=ConvertControllerTest#convertSample_returnsPdf
|
||||||
|
```
|
||||||
|
|
||||||
|
### Пересоздание фикстур
|
||||||
|
|
||||||
|
Пересоздать 10 фикстур (POI, test scope; `charts-smartart.docx` и `ole-embedded.docx` НЕ генерируются — созданы вручную, не перезаписывать; `chart-types.docx` — `ChartTypesDocxGenerator`):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mvn -pl wordpdf-core test-compile -Dmdep.outputFile=/tmp/cp.txt dependency:build-classpath -q
|
||||||
|
java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
|
||||||
|
ru.pjandro.wordpdf.SampleDocxGenerator wordpdf-core/src/test/resources/samples
|
||||||
|
```
|
||||||
|
|
||||||
|
### Перевендоривание XSL-FO-стилиста
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Перевендорить XSL-FO-стилист после апгрейда docx4j (этого потребует гейт vendoredXsltTracksJarCopy):
|
||||||
|
unzip -p ~/.m2/repository/org/docx4j/docx4j-export-fo/<версия>/docx4j-export-fo-<версия>.jar \
|
||||||
|
org/docx4j/convert/out/fo/docx2fo.xslt > wordpdf-core/src/main/resources/xslt/docx2fo.xslt
|
||||||
|
# затем перенести AUDIT-FIX-патчи (position → baseline-shift; AUDIT-FIX-2 move/bdo/dir — образец в комментарии самого файла)
|
||||||
|
```
|
||||||
|
|
||||||
|
Задачи mise: `verify`, `app-package`, `app-run`, `web-install`, `web-build`, `web-lint`, `web-dev`, `prod-tests`. Venv прод-автотестов `prod-autotests/.venv` mise создаёт сам (`[env]` в `mise.toml`).
|
||||||
|
|
||||||
|
### «Запусти тестовый сервер» (полный текст)
|
||||||
|
|
||||||
|
**«Запусти тестовый сервер» (термин пользователя)** = полный dev-стенд, НЕ `java -jar`: `podman-compose -f compose.dev.yml up -d --build --force-recreate` — все контейнеры (app+web+gateway) с полной пересборкой образов. Обязательные свойства после запуска: фронт доступен **без API-ключа** (compose.dev.yml не задаёт `WORDPDF_API_KEY` → `wordpdf.api-key` пуст → `ApiKeyFilter` прозрачен) и **с других ПК сети** — вход `http://<LAN-IP хоста>:9011` (`hostname -I` на хосте), не `localhost`. Проверить: `podman-compose -f compose.dev.yml ps` (контейнеры healthy) и `curl -s -o /dev/null -w '%{http_code}' http://<LAN-IP>:9011/` = 200.
|
||||||
|
|
||||||
|
## REST API (детали bullet'ов)
|
||||||
|
|
||||||
|
Единственный эндпоинт `POST /api/v1/convert`: multipart-поле `file` + факультативные query/form-параметры `errorOnCharts`/`errorOnSmartArt`/`errorOnOle` (дефолт каждого — `false`) и `maxMb`/`maxPages` (лимиты входа, см. «Лимиты входа» ниже). Ответ — `application/pdf`, `Content-Disposition: attachment; filename*=UTF-8''…`. Проверка `.docx`/`.doc`-расширения — в `ConvertController` (ошибочный текст 400 — контракт с фронтом); `ConversionService.safeBaseName` — единый источник имени для файла, заголовка ответа и PDF-title (срезает оба расширения; разрешены `[\p{L}\p{N} ._-]`, пустое → `document`). Error-флаги диаграмм/SmartArt/OLE на `.doc` не срабатывают (BLIP-плейсхолдеры → картинки, см. «Мост») — описано в `@Operation`.
|
||||||
|
|
||||||
|
Полная карта ответов:
|
||||||
|
|
||||||
|
| HTTP | Исключение/источник |
|
||||||
|
|---|---|
|
||||||
|
| 400 | `ValidationException`, `BadRequestException`, `MethodArgumentTypeMismatchException`, `MissingServletRequestPartException`, `MissingServletRequestParameterException` |
|
||||||
|
| 401 | `ApiKeyFilter` (пишет сам) |
|
||||||
|
| 404 / 405 / 415 | `NoResourceFoundException` / `HttpRequestMethodNotSupportedException` / `HttpMediaTypeNotSupportedException` |
|
||||||
|
| 413 | `MaxUploadSizeExceededException` |
|
||||||
|
| 422 | `DrawingRejectedException` |
|
||||||
|
| 500 | `ConversionFailedException` |
|
||||||
|
| 503 | `ConversionRejectedException` |
|
||||||
|
| 504 | `ConversionTimeoutException` |
|
||||||
|
|
||||||
|
- **Ключ доступа**: `ApiKeyFilter` сверяет заголовок `X-API-Key` (`ApiKeyFilter.HEADER`) со свойством `wordpdf.api-key` (env `WORDPDF_API_KEY`, сравнение `MessageDigest.isEqual`). Пустое свойство = аутентификация выключена (dev `java -jar`, тесты). Без ключа открыты `OPEN_PREFIXES` = `/actuator/`, `/swagger-ui`, `/v3/api-docs` — матч по пути **без** forwarded-contextPath (`getRequestURI()` минус `getContextPath()`; иначе под `X-Forwarded-Prefix` HEALTHCHECK получил бы 401). Пути с точечными сегментами (`..`/`%2e`) открытыми не считаются никогда.
|
||||||
|
- **Очередь**: конвертации сериализованы однопоточным `ThreadPoolExecutor` (`ConversionService.QUEUE_CAPACITY = 16`, переполнение → 503): ядро мутирует глобальный реестр `PhysicalFonts` и **сериализует конвертации монитором класса `WordPdfConverter.class`**; однопоточность воркера — ради 503/timeout. Головой очереди конструктор ставит `WordPdfConverter.warmup()` — прогрев ядра минимальным in-code docx + растром (~1,5–2,5 с, Future никто не забирает, warmup не бросает): первый реальный запрос после деплоя — за прогретым ядром (замер 2026-11: 0,13 с против 1,74 с на `main`), запросы периода прогрева ждут в очереди штатно. `future.cancel(true)` при таймауте не останавливает FOP мгновенно — осознанный компромисс.
|
||||||
|
- **Лимиты входа**: `wordpdf.max-mb`/`wordpdf.max-pages` (env `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES`) — дефолт эндпоинта, `@Value` в `ConvertController` с литеральными дефолтами 5/100; значение свойства ≤ 0 → `IllegalStateException` на старте. Параметры запроса `maxMb`/`maxPages` переопределяют дефолт в обе стороны (значения ≤ 0 → 400), верхнего серверного потолка нет — пороги распаковки/записей/растров растут вместе с ними. Ключи в `application.properties` **не объявлены** — пустое значение затенит дефолт `@Value`.
|
||||||
|
|
||||||
|
- **SPA**: вся сеть в `wordpdf-web/src/api.ts` (компоненты `fetch` не вызывают); ключ в `localStorage` (`wordpdf.api.key`), при 401 очищается, экран `ApiKeyGate` (`UnauthorizedError` — наследник `ApiError`, проверяется раньше); гейт показывается только когда `probeApiKey()` (GET /api/v1/convert → 401) подтвердил требование ключа. Запросы на `${import.meta.env.BASE_URL}api/...` (vite `base` из `VITE_BASE`, дефолт `/`) — CORS не нужен (dev: vite-proxy → :8080; prod: nginx под префиксом `/pdf-converter/`). Три переключателя error-флагов в форме («Диаграммы», «SmartArt», «OLE-объекты», дефолт — все выключены). DropZone принимает `.docx,.doc` (`accept` + текст зоны).
|
||||||
|
|
||||||
|
## Детали конвенций, рантайма и гейтов
|
||||||
|
|
||||||
|
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчик картинок (`imageCount`/`distinctImageCount` — SMask игнорируется). Негативные маркеры: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах).
|
||||||
|
|
||||||
|
PMD: `failurePriority` в плагине не задан — на практике `verify` валит нарушение любой приоритетности; закрытый список правил — единственный источник `pmd-ruleset.xml` (в AGENTS.md не дублируется). Четыре правила `*MustUseBraces` деприкейтед в 6.55.0 — предупреждения «Discontinue using…» в логе verify ожидаемы.
|
||||||
|
|
||||||
|
- Нормализаторы — единый контракт `internal/DocxNormalizer`; константа `STEP` только у `DocxRewritePipeline` (сам собирает цепочку); цепочка `WordPdfConverter.normalizers()` = `DocxRewritePipeline.STEP` (правила 1–11 одним zip-проходом) + лямбда `OleObjectNormalizer`; нечего менять → **тот же массив**; package-private хук `static String rewrite(String xml)` для юнит-тестов (возвращает `null` при отсутствии изменений; есть у 11 из 12 — у многочастного `OleObjectNormalizer` нет); у `StrictOoxmlNormalizer` есть также `rewritePart(entryName, xml)`, у `TableIndentNormalizer` — `rewritePart(name, xml, band)` (per-part-логика, хуки пайплайна); правятся только части `word/*.xml`.
|
||||||
|
|
||||||
|
- Классы в `internal` — package-private; `public` только контракт наружу: `DocxNormalizer`, `DocxRewritePipeline`(+`STEP`), `OleObjectNormalizer`, `FopFallbackFonts`(+`declare`), `LayoutPostRenderer`(+`register`), `DependencyGuard`(+`check`) и `DrawingPreRenderer`(+`run`); `rewrite`-хуки и карты — package-private; в `wordpdf-app` всё package-private кроме `WordPdfApplication`.
|
||||||
|
|
||||||
|
- Гейт JaCoCo `0.8.15`: `jacoco:check` (правило BUNDLE, LINE COVEREDRATIO `0.90` — обоих модулей; в `wordpdf-core/pom.xml` execution `check` переопределён и добавляет BRANCH COVEREDRATIO `0.85` — только для core) на `verify`; агент подключается в surefire через `argLine` = `@{argLine} -Djava.awt.headless=true` (свойство `argLine` в корневом pom по умолчанию пусто и перезаписывается `prepare-agent` — `mvn test -Djacoco.skip=true` без агента работоспособно); `report` и `check` оба на `verify`, report раньше — при провале порога отчёт уже на диске; отчёты `target/site/jacoco/` (html+xml, xml нужен CI-сводке). Плотность покрытия держат тесты, а не заглушки: промахи в основном недостижимые IOException/catch-ветки (`GlyphFont`, `BundledFonts`) и защитные ветви сканеров нормализаторов/валидатора.
|
||||||
|
- Счётчики тестов и описание блока аудита .docx 2026-11 — `docs/agent/testing.md`. JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true`; только `Assertions` (Mockito/AssertJ не использовать; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`), тестовые классы package-private, зеркалят main-пакеты; только `@Test` + два `@BeforeAll` (warm-up шрифтов в `GlyphCoverageNormalizerTest` и `BundledFonts.init()` в `BundledFontsTest`) + `@AfterEach drainWorker` в `ConversionTimeoutTest` (дренировать отменённый FOP-рендер до следующего класса — гонка глобального `PhysicalFonts`).
|
||||||
|
|
||||||
|
- Фронт: Node `^20.19.0 || >=22.12.0` (engines vite/rolldown/oxlint из `package-lock.json` — в `package.json` секции `engines` нет), npm с закоммиченным `package-lock.json` (`npm ci`); vite `^8.3`, React `^19.2`, TS `~6.0` (**`strict` нигде не включён** — `npm run build` не является strict-гейтом), Tailwind `^4.3`, oxlint `^1.81`; сборка web-образа на `node:24-alpine`.
|
||||||
|
- Контейнеры (podman/buildah): `FROM` только FQDN (`docker.io/library/...` — short-name не резолвится без `unqualified-search-registries`); buildah подмешивает хостовые прокси-переменные в `RUN`/`HEALTHCHECK` — обнулять `HTTP_PROXY= http_proxy= …` **на самой команде** (ENV не перебивает). Chart-движку нужен только модуль `java.desktop` (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox (`fonts/GlyphFont`), проверено на musl-стенде без libfontconfig/`/etc/fonts`.
|
||||||
|
|
||||||
|
- Исполняемый jar бэкенда проверять только `java -jar` (тесты идут по classpath и repackage-специфику не видят; `BundledFontsTest#listedFilesCoverAllTtfInResources` требует `file:`-протокол classpath — только surefire, не fat-jar).
|
||||||
|
|
||||||
|
## Шрифты (детали)
|
||||||
|
|
||||||
|
`DISPLAY_NAMES` — обратный маппинг lowercase→отображаемое имя для `documentFontName` (пишет `GlyphCoverageNormalizer` в `w:rFonts`). `BundledFontAliases.bundledFamily` — public-хук «имя шрифта из docx → бандл-семейство или fallback» (пользуется chart/math-движком и покрытием); вынесен из `BundledFontMapper`, чтобы обращение к статике не тянуло `BestMatchingMapper.<clinit>` (скан classpath вне гейта свойств `docx4j.fonts.discover*`, которые выставляет `WordPdfConverter.<clinit>`). `GlyphFont` — глиф-движок на fontbox (метрики + растеризация глифов для chart-движка и покрытия глифов); читает TTF **напрямую из classpath** `fonts/<file>` (не из temp-каталога `BundledFonts`), кэш по `family/variant`, `of()` возвращает `null` для неизвестного семейства; `java.awt.Font` из рантайм-пути убран, AWT остаётся только как геометрия Graphics2D.
|
||||||
@@ -0,0 +1,35 @@
|
|||||||
|
> читать при правке/добавлении тестов. Авторитетно наравне с AGENTS.md.
|
||||||
|
|
||||||
|
### Счётчики (2026-11)
|
||||||
|
|
||||||
|
- 63 тестовых классов / 1004 теста: core 57/956 (`internal/doc/` 17/256, `internal/chart/` 18/301, `WordPdfConverterTest` 87), app 6/48 (ConvertController 26, ApiKeyFilter 8, ConversionService 5, ApiExceptionHandler 5, ConvertLimits 3, ConversionTimeout 1). Обновлять при изменении набора.
|
||||||
|
|
||||||
|
### Пиксели, метрики шрифтов, стенд без fontconfig
|
||||||
|
|
||||||
|
- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word (экспорт 300 dpi, числа зашиты в тесты), допуски `assertRatio` <0.06 (`PiePainterTest`, `CartesianPainterTest`) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px, перцентильные коридоры яркости, «серый» px — разброс каналов `GRAY_MAX_SPREAD=25`; исключение — структурная проверка чернил в `GlyphFontTest`. Эталонные файлы — `develop/`, вне git. Хелперы chart-тестов (`render`, `countColor`, `assertRatio`, `paint`) продублированы по классам — общего test-util нет.
|
||||||
|
|
||||||
|
- `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar`. `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig.
|
||||||
|
|
||||||
|
### Фикстуры
|
||||||
|
|
||||||
|
- Фикстуры — закоммиченные `samples/*.docx` + `samples/*.doc` (13 + 12; в тестах не генерировать; `.docx` все ECMA-conformant по `docs/standards/docx/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код; `.doc` — эталоны заказчика, конвертируются мостом): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`; in-memory `.doc` — POIFS (`POIFSFileSystem`) вокруг крафтовых WordDocument/1Table/Data (`DocToDocxFormattingTest`). Ключевые: `too-many-pages` (150 явных разрывов → 151; `.doc`-пара — кэш PageCount=150 → 400 «не менее 151»), `stale-cache` (docx: кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak` → 400; doc: кэш 5 → конвертируется — семантика запинена), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject; `.doc`-пара — 3 BLIP-fallback → 3 картинки), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject` и VML-плейсхолдером `media/fallback.png` — ручная, генератором не перезаписывать; `.doc`-пара — OLE-fallback BLIP → 1 картинка), `chart-types` (14 графиков: 9 типов + ofPie-pie + lineChart stacked + `c:wireframe` + combo barChart+lineChart на вторичной `c:valAx` pos="r"; пересоздание — `ChartTypesDocxGenerator`; `.doc`-аналога нет), `doc-formats.doc` (2 страницы — лимит страниц на .doc-пути).
|
||||||
|
|
||||||
|
### Юниты
|
||||||
|
|
||||||
|
- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`). Исключение — `OleObjectNormalizerTest`: многочастный нормализатор без `rewrite`-хука, тесты только через `normalize` на in-memory zip.
|
||||||
|
|
||||||
|
- Юниты моста (`internal/doc/`): `CfbReaderTest` строит крафтовый CFB-байтстрим (сектор 512/mini 64: FAT/DIFAT/miniFAT/directory руками) и бьёт все guard-ветки (циклы FAT/DIFAT/MiniFAT, ссылки за файл, обрезанные потоки, root без mini stream, мусор в directory); `SummaryInfoTest` — крафтовый PropertySetStream (пинит **относительность offset от начала PropertySet**, реальные фикстуры её не различают); `PieceTableTest`/`ChpxIndexTest`/`PapxIndexTest` (в т.ч. `istdFor`: istd из UpxPapx, пустой grpprl ≠ null, bOffset=0 → дефолтные свойства при сохранённой границе)/`SectionsTest`/`FibHeaderTest` (пара fcStshf)/`GrpprlTest` (в т.ч. спец-длины: двухбайтовый cb у sprmTDefTable при operand >255 Б, у 0xC60D cb=0xFF — обрыв, у 0xC615 cb=0xFF — длина по формуле §2.9.182 (`scan_pChgTabsSentinel_lengthByFormula`))/`FontTableTest`/`HeadersTest`/`OfficeArtTest`/`PrcDataTest` — byte[]-конструкции in memory (`PrcDataTest`: разворачивание huge-PAPX/PTableProps на позиции указателя, union цепочки с легаси-зеркалом, guard'ы — cb-капа 0x3FA2, ptr за Data, цикл A→B→A); `StylesTest` — крафтовый STSH (LPStd/LPUpx): цепочка base→derived, цикл → пустая таблица, чужой stk/битый STSH нисходительны; `TablesTest` — крафтовый TAP: сетка TDefTable (XAS со знаком), границы Brc (cv fAuto) и Brc80 (ico, приоритет 0xD613), выравнивание sprmTJc/sprmTJc90 (u16, приоритет современного, 0 → null), деградация при битом TDefTable; `ListsTest` — крафтовые PlfLst/PlfLfo байтстримом (счёт LVL по fSimpleList 1/9, плейсхолдеры xst → `%{n+1}` и литеральный `%` → `%%`, MSONFC→ST_NumberFormat вкл. экзотика→decimal, ixchFollow→`w:suff`, grpprl уровня → `w:ind`/`w:rFonts`, LFOLVL fStartAt/fFormatting, обрыв LVL-массива, lsid без LSTF, нулевые lcb); `DocToDocxFormattingTest` — полный синтетический .doc через POIFS (крафтовые FIB/Clx/FKP-страницы: полные CHPX/PAPX-свойства, STSH-цепочка с переопределением и победой direct, spacing/tabs, таблица TTP+TDefTable+Brc с деградацией строки без сетки и многострочной ячейкой, колонтитук со стилевым jc, табы колонтитука из стиля sprmPChgTabs (`styleTabsChg_reachesFooterPart`/`styleTabsChgDel_removesStop`: прямой del с rgdxaClose вырезает stop стиля), таблица в odd footer со sprmTJc (`footerTable_jcCenterEmitted`: guard-¶ отдельным абзацем после строки, как в реальных Plcfhdd), знаки, поле в основном тексте, picLocation=0, 0Table, отсутствие табличного потока, списки: `listParagraphs_getNumPrAndNumberingPart` (sprmPIlfo/sprmPIlvl в PAPX → `w:numPr` + `word/numbering.xml` c `w:num`/Override/rels), `listCancelledByDirectZero_noNumPr` (ilfo стиля, перекрытый прямым 0), `ilvlSkipValue_noNumPr` (ilvl=0x0C), `missingListTables_degradeToPlain` (нулевые FIB-пары 73/74 — ни numbering-части, ни numPr)). Doc-регрессии конвертера — общие assert-хелперы docx-пар: `assertCyrillicAndStyles`/`assertPageNumbers`/`assertTableImage`/`assertOleObjectsRemoved`/`assertDrawingsBecomeImages`/`assertTooManyPages`/`assertExoticGlyphs` вызываются с `ru-plain.doc`/`page-numbers.doc`/`ru-table-image.doc`/`ole-embedded.doc`/`charts-smartart.doc`/`too-many-pages.doc`/`exotic-glyphs.doc` (тесты-пары называются по docx-имени, внутри зовут оба формата); `WordPdfValidatorTest#checkPageCountDoc_*` + `ConvertControllerTest` (`.doc` upload, `nonDocxFilename_rejected`).
|
||||||
|
|
||||||
|
- App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); четыре контекста — `ConvertControllerTest` (пин `wordpdf.api-key=` — HTTP-контексты явно пиныт пустой ключ: mise подмешивает корневой `.env` в окружение тасок, ambient `WORDPDF_API_KEY` иначе дал бы 401 во всех MockMvc-тестах), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest` (`@TestPropertySource` max-mb/max-pages), `ConversionTimeoutTest` (`@TestPropertySource` convert-timeout=1ms) — четыре разных набора свойств = четыре кэшированных контекста (отдельные классы, не `@Nested`: `@Nested` + `@TestPropertySource` не даёт отдельного контекста); `ConversionServiceTest`/`ApiExceptionHandlerTest` — без Spring-контекста (прямые юниты).
|
||||||
|
|
||||||
|
- UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9.1.1 + requests 2.34.2, 31 проверка — 27 под маркером `needs_key` (SKIP без ключа; включая `.doc`-фикстуры обоих путей — растры/OLE и границы страниц), 4 открытых: health/SPA-root/swagger/spec; env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода.
|
||||||
|
|
||||||
|
### Регрессивные записи, не выводимые из кода
|
||||||
|
|
||||||
|
Остальные пары `XxxNormalizerTest`↔`тест-в-конвейере` и юнит-перечисления воспроизводятся грепом по javadoc-ссылкам «Регрессия — Test#имя, фикстура …» (конвенция в AGENTS.md) и удалены отсюда намеренно. Здесь — только записи без javadoc-якорей:
|
||||||
|
|
||||||
|
- `lineRuleAuto_wordSingleLinePitch` — пинит метрический шаг «single» (13.4277pt) от псевдофиксов раскладки; `carlitoAutoBlock_untouched` — блок без явного `w:line` не трогается.
|
||||||
|
- `vendoredXsltTracksJarCopy` — дрейф-гейт: вне AUDIT-FIX-регионов вендорный `docx2fo.xslt` обязан быть побайтно равен стилисту из jar'а docx4j-export-fo (при апгрейде docx4j — перевендорить и перенести патчи).
|
||||||
|
- Крафт POIFS (закоммиченных фикстур нет, крафт продублирован в `WordPdfConverterTest`): `ListsTest`+`DocToDocxFormattingTest#list*`↔`docLists_numberingAndBulletsRendered` (синтетический .doc со списками → PDF: `1.` `2.` `a)` `b)` `•`, ни одного `#`; фикстур со списками нет — крафт POIFS продублирован в `WordPdfConverterTest`), `PrcDataTest`+`DocToDocxFormattingTest#hugePapxRowMark_closesRowWithGridFromPrcData` (TTP-абзац с grpprl в PrcData Data-потока → `w:tbl`/`w:tr`/сетка из цепочки; фикстуры нет — `docTest.doc` заказчика не коммитим, крафт POIFS продублирован), `SectionsTest`+`HeadersTest`+`DocToDocxFormattingTest#twoSections*/sectionBreakInTable*`↔`docMultiSection_perSectionHeaders` (двухсекционный .doc → PDF: стр. 1 — ШАПКА-1+ПОДВАЛ-1, стр. 2 — ШАПКА-2 + унаследованный ПОДВАЛ-1, ни одной `#`; крафт POIFS продублирован в `WordPdfConverterTest`), `ChpxIndexTest#zeroOffset_defaultPropsBoundaryKept`+`DocToDocxFormattingTest#runFlags_*/keepNextKeepLines_*/sectLandscapePgNumCols_*/sectUnevenCols_*/cellVertAlign_*/drawnObject_*`+`SectionsTest#orientationPgNumColumns_applied/unevenColumns_perIndexWidths/restartWithoutStart_clampsToOne`+`TablesTest#vertAlign_*`↔`WordPdfConverterTest#docClassD_landscapeHiddenDelCaps/#docClassD_pageNumberRestartLowerRoman/#docClassD_twoColumnsBreak/#docClassD_drawnObjectBecomesImage` (закрытие пробелов класса D: vanish-фильтр/правки/caps/position/keep, landscape+pgNumType, колонки+column break, vAlign, 0x08→inline-картинка; фикстур нет — крафт POIFS продублирован в обоих тестовых классах).
|
||||||
|
- Синтетика через общий хелпер `docx(docXmlns, body, sect, rels, overrides, parts)`: AUDIT-FIX-2↔`movedRevision_textPrinted`/`bdoDir_textPrinted` (фикстур нет — синтетический docx через общий хелпер `docx(docXmlns, body, sect, rels, overrides, parts)`); пиннинг аудита .docx↔`footnote_rendersAtPageBottom`, `endnote_rendersAtDocumentEnd`, `docxHyperlink_uriAnnotation`, `pageRefField_liveNotCached` (кэш 9001/7777 заменён живым номером), `dateField_notStaleCache` (кэш 01.02.2003 заменён текущей датой), `titlePg_firstPageHeader`, `vMergeCell_spansRows`, `sdtContent_rendered`, `drawingTextBox_textPrinted`, `ommlMath_renderedAsPng` (пиксели: +150 тёмных px@150dpi сверх текста, текст формулы не извлекается), `ommlMathUnsupported_flattenedToText`, `highlightAndShading_backgroundDrawn` (жёлтые px >0 против baseline 0), аудит [MS-DOC] моста 2026-11: `GrpprlTest#tInsertOperand_skippedBySpra`/`tInsertOperand_truncated_aborts` (sprmTInsert — 4 байта, хвост TAP не рассинхронизирован), `TablesTest#cellPadding_*` + `DocToDocxFormattingTest#cellMargins_becomeTcMar` ↔ `WordPdfConverterTest#tableTcMar_textInsetLikeWord` (CSSA→w:tcMar, пайплайн красит поля ячейки как tblCellMar — текст на margin+padding), `StylesTest#characterStyle_stk3_chainViaCharChain`/`charChain_nonCharacterStk_empty` + `DocToDocxFormattingTest#charStyle_viaIstd_mergesUnderDirect` (sprmCIstd: символьная chpx-цепочка между стилевой и прямыми, direct wins), `DocToDocxFormattingTest#runHighlightAndShading_inRPr`/`runShadingPattern_degradesToBackFill`/`paraShd_inPPrBeforeJc` ↔ `docHighlightAndShading_yellowPixels` (Ico→ST_HighlightColor; w:shd в форме FOP val="clear"+fill; паттерн→cvBack), `SectionsTest#titlePage_flagFromSepx` + `DocToDocxFormattingTest#titlePage_emittedAfterCols` ↔ `docTitlePage_firstHeaderOnlyFirstPage` (sprmSFTitlePage + first-слоты Plcfhdd → headerReference type="first", первая страница — только first-шапка)..
|
||||||
|
- App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed`, `corruptNotAZip_rejected`, `plainZipNotDocx_rejected`, `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName`, `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey`, `dotSegmentOpenPrefix_rejected`, `errorFlagNotBoolean_rejected`, `methodNotSupportedReturns405`/`badContentTypeReturns415`.
|
||||||
@@ -0,0 +1,52 @@
|
|||||||
|
# Аутентификация
|
||||||
|
|
||||||
|
## Ключ доступа
|
||||||
|
|
||||||
|
Все запросы, кроме открытых путей, требуют заголовок:
|
||||||
|
|
||||||
|
```
|
||||||
|
X-API-Key: <ключ>
|
||||||
|
```
|
||||||
|
|
||||||
|
Ключ сверяется со свойством сервера `wordpdf.api-key` (env `WORDPDF_API_KEY`).
|
||||||
|
Сравнение — `MessageDigest.isEqual` (защита от timing-атак). **Пустое свойство =
|
||||||
|
аутентификация выключена** — так работают `java -jar` и dev-стенд (:9011).
|
||||||
|
|
||||||
|
Без ключа или с неверным:
|
||||||
|
|
||||||
|
```
|
||||||
|
HTTP 401
|
||||||
|
{"error":"Ключ доступа не передан или неверен (заголовок X-API-Key)"}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Открытые пути
|
||||||
|
|
||||||
|
Без ключа всегда доступны (матч по **префиксу со слэшем**, без учёта
|
||||||
|
forwarded-contextPath):
|
||||||
|
|
||||||
|
|Префикс|Что|
|
||||||
|
|---|---|
|
||||||
|
|`/actuator/`|health-checks Spring Boot|
|
||||||
|
|`/swagger-ui`|Swagger UI|
|
||||||
|
|`/v3/api-docs`|OpenAPI-спек|
|
||||||
|
|
||||||
|
!!! warning "Точечные сегменты обходят открытие"
|
||||||
|
Пути с точечными сегментами (`..` или их URL-код `%2e`) **никогда** не считаются
|
||||||
|
открытыми: запрос вида `/actuator/../api/v1/convert` потребует ключ даже на
|
||||||
|
открытом префиксе. Это защита от обхода фильтра через нормализацию пути.
|
||||||
|
|
||||||
|
## Где задаётся ключ
|
||||||
|
|
||||||
|
|Среда|Как|
|
||||||
|
|---|---|
|
||||||
|
|`java -jar`|`wordpdf.api-key=` пусто — auth выключен; включить: `--wordpdf.api-key=…` или env `WORDPDF_API_KEY`|
|
||||||
|
|prod-like стенд (:9010)|обязателен `.env` с `WORDPDF_API_KEY` (fail-closed: без него стек не поднимется), шаблон — `.env.example`|
|
||||||
|
|прод|env-переменная контейнера из Gitea Secret (в репозитории и на диске ключа нет)|
|
||||||
|
|
||||||
|
Сгенерировать ключ: `openssl rand -hex 32`.
|
||||||
|
|
||||||
|
## Как фронтенд узнаёт про ключ
|
||||||
|
|
||||||
|
SPA при старте опрашивает сервис (`probeApiKey()`, `GET /api/v1/convert`): 401 —
|
||||||
|
сервер требует ключ, показывается экран ввода; иначе — интерфейс открывается сразу.
|
||||||
|
Введённый ключ хранится в `localStorage` браузера и стирается при ответе 401.
|
||||||
@@ -0,0 +1,45 @@
|
|||||||
|
# Эндпоинт конвертации
|
||||||
|
|
||||||
|
```
|
||||||
|
POST /api/v1/convert
|
||||||
|
```
|
||||||
|
|
||||||
|
Тело запроса — `multipart/form-data` с обязательным полем **`file`**: файл `.docx`
|
||||||
|
(OOXML) или `.doc` (Word 97–2003, переносится мостом в .docx в памяти). Файлы других
|
||||||
|
расширений отклоняются 400.
|
||||||
|
|
||||||
|
## Факультативные query/form-параметры
|
||||||
|
|
||||||
|
Параметры можно передать в query-строке или как form-поля.
|
||||||
|
|
||||||
|
|Параметр|Тип|Дефолт|Действие|
|
||||||
|
|---|---|---|---|
|
||||||
|
|`errorOnCharts`|Boolean|`false`|при `true` диаграммы в документе отменяют конвертацию (422); диаграммы конвертируются в растры всегда|
|
||||||
|
|`errorOnSmartArt`|Boolean|`false`|при `true` SmartArt отменяет конвертацию (422)|
|
||||||
|
|`errorOnOle`|Boolean|`false`|при `true` OLE-объекты отменяют конвертацию (422); при `false` OLE-объекты тихо удаляются, картинка-плейсхолдер сохраняется|
|
||||||
|
|`maxMb`|число|свойство сервера `wordpdf.max-mb` (5)|лимит размера входа в МБ; переопределяет серверный дефолт **в обе стороны**; `≤ 0` → 400|
|
||||||
|
|`maxPages`|число|свойство сервера `wordpdf.max-pages` (100)|лимит числа страниц; переопределяет в обе стороны; `≤ 0` → 400|
|
||||||
|
|
||||||
|
!!! note "На `.doc` error-флаги не срабатывают"
|
||||||
|
Плейсхолдеры диаграмм/SmartArt/OLE в бинарном формате — это BLIP-растры, мост
|
||||||
|
вставляет их картинками; векторные EMF/WMF/PICT пропускаются с warn. Флаги
|
||||||
|
работают только для `.docx`.
|
||||||
|
|
||||||
|
## Успешный ответ
|
||||||
|
|
||||||
|
```
|
||||||
|
HTTP 200
|
||||||
|
Content-Type: application/pdf
|
||||||
|
Content-Disposition: attachment; filename*=UTF-8''Документ.pdf
|
||||||
|
```
|
||||||
|
|
||||||
|
Имя файла берётся из `Content-Disposition` загруженного файла, санитизируется
|
||||||
|
(разрешены буквы, цифры, пробел и `._-`; кириллица разрешена; пустое имя → `document`)
|
||||||
|
и используется единожды для имени файла, заголовка ответа и заголовка PDF.
|
||||||
|
|
||||||
|
## Обработка
|
||||||
|
|
||||||
|
Задача ставится в однопоточную очередь воркеров (16 мест). Проверка размера —
|
||||||
|
синхронно до очереди. Конвертация дольше `wordpdf.convert-timeout` (2m) → 504,
|
||||||
|
очередь полна → 503. Полная таблица ответов — [Коды ошибок](errors.md),
|
||||||
|
пороги — [Лимиты](limits.md).
|
||||||
@@ -0,0 +1,55 @@
|
|||||||
|
# Коды ошибок
|
||||||
|
|
||||||
|
Ошибки — JSON вида `{"error": "..."}`.
|
||||||
|
|
||||||
|
## Полная таблица
|
||||||
|
|
||||||
|
|Код|Смысл|
|
||||||
|
|---|---|
|
||||||
|
|200|PDF в теле ответа|
|
||||||
|
|400|некорректный вход (пустой / расширение не .docx/.doc / содержимое не zip и не CFB / зашифрованный .doc / больше лимита размера (`maxMb` или `wordpdf.max-mb`) / больше лимита страниц (`maxPages` или `wordpdf.max-pages`) / `maxMb`≤0 / `maxPages`≤0), отсутствующая часть `file`, некорректное значение error-флага|
|
||||||
|
|401|нет или неверен `X-API-Key`|
|
||||||
|
|404|неизвестный путь (в т.ч. `/v3/api-docs` при выключенном springdoc)|
|
||||||
|
|405|не-POST|
|
||||||
|
|413|тело запроса больше контейнерного лимита multipart (100 МБ; авторитетный лимит входа — `wordpdf.max-mb`, он даёт 400 раньше)|
|
||||||
|
|415|не-multipart тело|
|
||||||
|
|422|сработал error-флаг: в документе найдены диаграммы / SmartArt / OLE-объекты|
|
||||||
|
|500|ошибка ядра/рендера|
|
||||||
|
|503|очередь конвертации (16 мест) переполнена — повторить позже|
|
||||||
|
|504|конвертация дольше `wordpdf.convert-timeout` (по умолчанию 2m)|
|
||||||
|
|
||||||
|
## Фиксированные тексты
|
||||||
|
|
||||||
|
Тексты ниже — контракт с фронтендом, они не меняются:
|
||||||
|
|
||||||
|
|Код|Тело|
|
||||||
|
|---|---|
|
||||||
|
|401|`{"error":"Ключ доступа не передан или неверен (заголовок X-API-Key)"}`|
|
||||||
|
|404|`{"error":"Не найдено"}`|
|
||||||
|
|405|`{"error":"Метод не поддерживается"}`|
|
||||||
|
|415|`{"error":"Неподдерживаемый тип содержимого"}`|
|
||||||
|
|422 (диаграммы)|`{"error":"Конвертация отменена: в документе найдены диаграммы"}`|
|
||||||
|
|422 (SmartArt)|`{"error":"Конвертация отменена: в документе найден SmartArt"}`|
|
||||||
|
|422 (OLE)|`{"error":"Конвертация отменена: в документе найдены OLE-объекты"}`|
|
||||||
|
|500|`{"error":"Не удалось конвертировать документ"}`|
|
||||||
|
|
||||||
|
Другие 400-тексты параметризованы, например: `Файл не передан (multipart-поле «file»
|
||||||
|
обязательно)`, `Поддерживаются только .docx и .doc: <имя>`, `Файл больше <N> МБ: …`,
|
||||||
|
`Некорректное значение параметра «<имя>»`.
|
||||||
|
|
||||||
|
!!! info "500 — деталь только в лог"
|
||||||
|
Сообщения ядра (`ConversionException` и др.) логируются на сервере, наружу
|
||||||
|
всегда уходит фиксированный текст — внутренние детали не текут клиенту.
|
||||||
|
|
||||||
|
## Исключение → обработчик (для отладки)
|
||||||
|
|
||||||
|
|HTTP|Источник|
|
||||||
|
|---|---|
|
||||||
|
|400|`ValidationException`, `BadRequestException`, `MethodArgumentTypeMismatchException`, `MissingServletRequestPartException`|
|
||||||
|
|401|`ApiKeyFilter` (пишет ответ сам, до диспетчера)|
|
||||||
|
|404 / 405 / 415|`NoResourceFoundException` / `HttpRequestMethodNotSupportedException` / `HttpMediaTypeNotSupportedException`|
|
||||||
|
|413|`MaxUploadSizeExceededException`|
|
||||||
|
|422|`DrawingRejectedException`|
|
||||||
|
|500|`ConversionFailedException`|
|
||||||
|
|503|`ConversionRejectedException`|
|
||||||
|
|504|`ConversionTimeoutException`|
|
||||||
@@ -0,0 +1,74 @@
|
|||||||
|
# Примеры клиентов
|
||||||
|
|
||||||
|
Базовый адрес зависит от стенда: прод `https://pjandro.ru/pdf-converter/api/v1/convert`,
|
||||||
|
prod-like локально `http://localhost:9010/api/v1/convert`, dev `http://<LAN-IP>:9011/api/v1/convert`,
|
||||||
|
`java -jar` — `http://localhost:8080/api/v1/convert`.
|
||||||
|
|
||||||
|
## curl
|
||||||
|
|
||||||
|
Без ключа (сервер с выключенной аутентификацией):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
|
||||||
|
```
|
||||||
|
|
||||||
|
С ключом и error-флагом:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -H "X-API-Key: $WORDPDF_API_KEY" \
|
||||||
|
-F "file=@Отчёт.docx" \
|
||||||
|
"https://pjandro.ru/pdf-converter/api/v1/convert?errorOnOle=true&maxMb=10" \
|
||||||
|
-o out.pdf
|
||||||
|
```
|
||||||
|
|
||||||
|
## JavaScript (fetch)
|
||||||
|
|
||||||
|
```js
|
||||||
|
const form = new FormData();
|
||||||
|
form.append("file", fileInput.files[0], fileInput.files[0].name);
|
||||||
|
|
||||||
|
const resp = await fetch("/api/v1/convert", {
|
||||||
|
method: "POST",
|
||||||
|
headers: apiKey ? { "X-API-Key": apiKey } : {},
|
||||||
|
body: form,
|
||||||
|
});
|
||||||
|
|
||||||
|
if (!resp.ok) {
|
||||||
|
const { error } = await resp.json().catch(() => ({ error: resp.statusText }));
|
||||||
|
throw new Error(error);
|
||||||
|
}
|
||||||
|
|
||||||
|
// имя файла из Content-Disposition: attachment; filename*=UTF-8''%D0%9E%D1%82%D1%87%D1%91%D1%82.pdf
|
||||||
|
const cd = resp.headers.get("Content-Disposition") ?? "";
|
||||||
|
const m = cd.match(/filename\*=UTF-8''([^;]+)/i);
|
||||||
|
const name = m ? decodeURIComponent(m[1]) : "document.pdf";
|
||||||
|
|
||||||
|
const blobUrl = URL.createObjectURL(await resp.blob());
|
||||||
|
const a = Object.assign(document.createElement("a"), { href: blobUrl, download: name });
|
||||||
|
a.click();
|
||||||
|
URL.revokeObjectURL(blobUrl);
|
||||||
|
```
|
||||||
|
|
||||||
|
Обработка 401 — стереть сохранённый ключ и показать экран ввода; 422 — показать
|
||||||
|
`error` из тела (документ содержит диаграммы/SmartArt/OLE).
|
||||||
|
|
||||||
|
## Python (requests)
|
||||||
|
|
||||||
|
Таймаут обязан быть больше серверных 2 минут на чтение:
|
||||||
|
|
||||||
|
```python
|
||||||
|
import requests
|
||||||
|
|
||||||
|
resp = requests.post(
|
||||||
|
"https://pjandro.ru/pdf-converter/api/v1/convert",
|
||||||
|
headers={"X-API-Key": API_KEY} if API_KEY else {},
|
||||||
|
files={"file": open("doc.docx", "rb")},
|
||||||
|
params={"errorOnCharts": "false"},
|
||||||
|
timeout=(10, 180), # connect 10 c, read 180 c — больше серверных 2m
|
||||||
|
)
|
||||||
|
resp.raise_for_status()
|
||||||
|
with open("doc.pdf", "wb") as f:
|
||||||
|
f.write(resp.content)
|
||||||
|
```
|
||||||
|
|
||||||
|
Так же устроены прод-автотесты репозитория (`prod-autotests/`, pytest + requests).
|
||||||
@@ -0,0 +1,53 @@
|
|||||||
|
# REST API
|
||||||
|
|
||||||
|
Базовый путь — корень сервера; единственный эндпоинт:
|
||||||
|
|
||||||
|
```
|
||||||
|
POST /api/v1/convert
|
||||||
|
```
|
||||||
|
|
||||||
|
Quickstart — конвертировать документ и сохранить PDF (ключ доступа, если сервер его
|
||||||
|
требует, — в заголовке `X-API-Key`):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -H "X-API-Key: $WORDPDF_API_KEY" -F "file=@doc.docx" \
|
||||||
|
https://pjandro.ru/pdf-converter/api/v1/convert -o doc.pdf
|
||||||
|
```
|
||||||
|
|
||||||
|
Локальный бэкенд (`java -jar`, порт 8080, ключ выключен):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar
|
||||||
|
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
|
||||||
|
```
|
||||||
|
|
||||||
|
Успешный ответ — `200`, тело — байты PDF (`Content-Type: application/pdf`,
|
||||||
|
`Content-Disposition: attachment; filename*=UTF-8''…`).
|
||||||
|
|
||||||
|
## Документация в самом сервисе
|
||||||
|
|
||||||
|
|Что|Путь|Когда доступно|
|
||||||
|
|---|---|---|
|
||||||
|
|Swagger UI|`/swagger-ui.html`|пока включён springdoc|
|
||||||
|
|OpenAPI (JSON)|`/v3/api-docs`|пока включён springdoc|
|
||||||
|
|
||||||
|
На `java -jar` и dev-стенде (:9011) springdoc включён; на проде он также открыт
|
||||||
|
(проверяется автотестом `test_swagger_ui_open_without_key`). В локальном prod-like
|
||||||
|
compose-стеке springdoc выключен env-ами `SPRINGDOC_API_DOCS_ENABLED=false` и
|
||||||
|
`SPRINGDOC_SWAGGER_UI_ENABLED=false` (в этом случае `/v3/api-docs` отвечает 404).
|
||||||
|
|
||||||
|
## Разделы
|
||||||
|
|
||||||
|
- [Аутентификация](authentication.md) — ключ `X-API-Key`.
|
||||||
|
- [Эндпоинт конвертации](convert-endpoint.md) — параметры и ответ.
|
||||||
|
- [Коды ошибок](errors.md) — полная таблица и тексты.
|
||||||
|
- [Лимиты](limits.md) — размер, страницы, очередь, таймаут.
|
||||||
|
- [Примеры клиентов](examples.md) — curl, JavaScript, Python.
|
||||||
|
|
||||||
|
## Как устроена обработка
|
||||||
|
|
||||||
|
Конвертации сериализуются **одним воркером**: ядро мутирует глобальный реестр шрифтов,
|
||||||
|
поэтому все конвертации идут последовательно (очередь — 16 мест, переполнение → 503).
|
||||||
|
Головой очереди на старте стоит `warmup()` — прогрев ядра (~1,5–2,5 с), чтобы первый
|
||||||
|
запрос после деплоя не платил за инициализацию JAXB/XSLT/FOP. Проверка размера входа
|
||||||
|
выполняется синхронно, до постановки в очередь.
|
||||||
@@ -0,0 +1,47 @@
|
|||||||
|
# Лимиты
|
||||||
|
|
||||||
|
## Лимиты входа
|
||||||
|
|
||||||
|
|Свойство|Env|Дефолт|Смысл|
|
||||||
|
|---|---|---|---|
|
||||||
|
|`wordpdf.max-mb`|`WORDPDF_MAX_MB`|5|максимальный размер файла в МБ (MiB)|
|
||||||
|
|`wordpdf.max-pages`|`WORDPDF_MAX_PAGES`|100|максимальное число страниц|
|
||||||
|
|
||||||
|
Это **дефолт эндпоинта**: параметры запроса `maxMb`/`maxPages` переопределяют его
|
||||||
|
в обе стороны (значения `≤ 0` → 400; верхнего серверного потолка нет — защитные
|
||||||
|
пороги растут вместе с лимитами). Значение свойства сервера `≤ 0` — падение
|
||||||
|
приложения на старте (`IllegalStateException`).
|
||||||
|
|
||||||
|
## Производные защитные пороги
|
||||||
|
|
||||||
|
Остальные пороги выводятся из лимитов входа (`WordPdfValidator`), проверяются
|
||||||
|
до рендера, одним lightweight-сканом:
|
||||||
|
|
||||||
|
- распакованный размер архива;
|
||||||
|
- суммарный распакованный размер XML-частей;
|
||||||
|
- число записей zip и защита от дубликатов записей;
|
||||||
|
- площади растровых изображений (пиксели);
|
||||||
|
- размер `[Content_Types].xml` (жёсткие 8 МБ).
|
||||||
|
|
||||||
|
Превышение любого — `400` (в библиотеке — `ValidationException`).
|
||||||
|
|
||||||
|
## Потолок инфраструктуры — 100 МБ
|
||||||
|
|
||||||
|
`spring.servlet.multipart.max-file-size`/`max-request-size` = 100MB — потолок
|
||||||
|
контейнера, зеркалит `client_max_body_size 100m` nginx-шлюза. Тело больше — 413.
|
||||||
|
Логический лимит входа (`wordpdf.max-mb`, дефолт 5 МБ) отсекает раньше и даёт 400;
|
||||||
|
413 возможен только когда серверный лимит поднят администратором выше дефолта.
|
||||||
|
|
||||||
|
Части загрузки больше 2 МБ (`file-size-threshold=2MB`) сбрасываются на диск Tomcat —
|
||||||
|
heap держит только копию байтов одной сериализованной конвертации.
|
||||||
|
|
||||||
|
## Очередь и таймаут
|
||||||
|
|
||||||
|
|Параметр|Значение|Поведение|
|
||||||
|
|---|---|---|
|
||||||
|
|ёмкость очереди|16 мест|переполнение → **503** (повторить позже)|
|
||||||
|
|`wordpdf.convert-timeout`|`2m` (env `WORDPDF_CONVERT_TIMEOUT`)|конвертация дольше → **504** (задача отменяется)|
|
||||||
|
|
||||||
|
Конвертации исполняются строго последовательно одним воркером (ядро мутирует
|
||||||
|
глобальный реестр шрифтов); при таймауте `future.cancel(true)` не останавливает FOP
|
||||||
|
мгновенно — текущая конвертация дожигается, следующий запрос ждёт её в очереди.
|
||||||
@@ -0,0 +1,62 @@
|
|||||||
|
# Диаграммы, SmartArt, формулы
|
||||||
|
|
||||||
|
XSLT-экспорт docx4j диаграммы не умеет, поэтому `DrawingPreRenderer` (шаг 3.5
|
||||||
|
конвейера) **до** генерации XSL-FO заменяет `c:chart` / `dgm:relIds` / `m:oMath`
|
||||||
|
на PNG-картинки (`pic:pic`). Рендер — собственный Java2D-движок (`internal/chart`,
|
||||||
|
21 класс), без Word/LibreOffice/JEuclid; текст рисуется глифами fontbox (`GlyphFont`),
|
||||||
|
поэтому fontconfig серверу не нужен.
|
||||||
|
|
||||||
|
## Диаграммы
|
||||||
|
|
||||||
|
- Выход: PNG **300 dpi** (`ChartRenderer.DPI = 300`), размеры из `wp:extent` (EMU→pt).
|
||||||
|
- Поддерживаемые типы (`ChartSpec.Type`): `PIE`, `PIE3D`, `DOUGHNUT`, `BAR`,
|
||||||
|
`BAR_HORIZONTAL`, `LINE`, `AREA`, `SURFACE3D`, `AREA3D`, `BAR3D`, `LINE3D`,
|
||||||
|
`RADAR`, `SCATTER`, `BUBBLE`, `STOCK`, `OF_PIE`, `SURFACE` (+ `UNSUPPORTED`).
|
||||||
|
- **Combo** («Комбинированная», §21.2.2.145): несколько групп в одном plotArea
|
||||||
|
(bar+line/area), привязка по `c:axId`, вторичная ось значений справа; серии
|
||||||
|
масштабируются по своей оси.
|
||||||
|
- Стекинг `stacked`/`percentStacked` — ряды накопленной суммой.
|
||||||
|
- Геометрия/камера 3-D и пропорции откалиброваны по эталонным экспортам Word
|
||||||
|
(пиксельные тесты с допусками).
|
||||||
|
|
||||||
|
## Умные границы (враждебный XML)
|
||||||
|
|
||||||
|
|Бюджет|Значение|Поведение при превышении|
|
||||||
|
|---|---|---|
|
||||||
|
|`ChartRenderer.MAX_PIXELS`|16 777 216 (4096², 64 МБ ARGB)|`fitDpi` понижает эффективный dpi (24″-график: 300→≈171 dpi), геометрия не меняется|
|
||||||
|
|`ChartSpec.MAX_POINTS`|100 000|отказ **до** предвыделения списка|
|
||||||
|
|`ChartRenderer.MAX_TICKS`|1000|безумный шаг оси заменяется «красивым» 1/2/5·10ⁿ|
|
||||||
|
|`DrawingPreRenderer.MAX_EXTENT_EMU`|22 000 000 (≈24″)|объект **остаётся как есть** + warn (не удаляется)|
|
||||||
|
|бюджет chart/math-PNG на документ|128 MiB|объект удаляется + warn|
|
||||||
|
|
||||||
|
## Модель деградации
|
||||||
|
|
||||||
|
Битая/неподдерживаемая часть роняет не конвертацию, а объект:
|
||||||
|
|
||||||
|
|Ситуация|Исход|
|
||||||
|
|---|---|
|
||||||
|
|битая chart-часть / превышение бюджета PNG|объект удалён + warn|
|
||||||
|
|неподдерживаемая/битая OMML-формула|**текст** (конкатенация `m:t`) + warn — текст терять хуже|
|
||||||
|
|`wp:extent` вне диапазона/ноль|объект остаётся + warn (FOP молча потеряет)|
|
||||||
|
|`OutOfMemoryError`|не деградация — `ConversionException` (REST 500)|
|
||||||
|
|
||||||
|
## SmartArt
|
||||||
|
|
||||||
|
`SmartArtRenderer` рисует диаграмму по разметке [MS-ODRAWXML]/§21.4: узлы, макет,
|
||||||
|
связи; тот же DPI/`fitDpi`.
|
||||||
|
|
||||||
|
## Формулы OMML
|
||||||
|
|
||||||
|
Собственный растер: `MathModel` разбирает OMML (§22.1) в дерево боксов,
|
||||||
|
`MathRenderer` рисует его только бандл-шрифтами. Конструкции вне списка `SUPPORTED`
|
||||||
|
деградируют в текст ещё на шаге нормализации (правило 6). Inline-формула опускается
|
||||||
|
на нижний запас рана — FOP ставит инлайн-графику нижним краем на базу строки.
|
||||||
|
|
||||||
|
## Контрафт media-частей
|
||||||
|
|
||||||
|
PNG-части получают имена `/word/media/chart-N.png` (константа
|
||||||
|
`CHART_MEDIA_URI_PREFIX`); по этому префиксу `ChartImageHandler` отключает
|
||||||
|
пересжатие картинок в FOP — переименование молча вернёт «мыльный» ресемпл.
|
||||||
|
|
||||||
|
Глубина (пейнтеры, калибровки, спецификационные секции) —
|
||||||
|
[chart.md (репозиторий)](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/chart.md).
|
||||||
@@ -0,0 +1,61 @@
|
|||||||
|
# Мост .doc → .docx
|
||||||
|
|
||||||
|
Бинарный формат Word 97–2003 читается **собственным мостом** без внешних
|
||||||
|
зависимостей (POI остаётся test-scope): байты `.doc` парсятся по спецификациям
|
||||||
|
**[MS-DOC]** (сам документ) и **[MS-CFB]** (OLE2-контейнер), собираются in-memory
|
||||||
|
`.docx` — и дальше идут тем же конвейером, что и обычные docx.
|
||||||
|
|
||||||
|
## Точка входа
|
||||||
|
|
||||||
|
```java
|
||||||
|
DocToDocx.convert(byte[] docBytes, long maxMb) // → байты .docx (вызывает WordPdfConverter)
|
||||||
|
DocToDocx.countPages(byte[] docBytes) // → страницы по сырым байтам (вызывает валидатор)
|
||||||
|
```
|
||||||
|
|
||||||
|
Страницы `.doc` считаются **по сырым байтам до конвертации** (PageCount из
|
||||||
|
SummaryInformation, разрывы 0x0C, межсекционные разрывы, `pageBreakBefore`) —
|
||||||
|
тот же скан используется валидатором лимита страниц. Любой брак (не-CFB, шифрованный
|
||||||
|
документ, Word 6–95) → `ConversionException` (в REST — 400).
|
||||||
|
|
||||||
|
## Классы пакета `internal/doc` (18 top-level)
|
||||||
|
|
||||||
|
|Класс|Спецификация|Что делает|
|
||||||
|
|---|---|---|
|
||||||
|
|`CfbReader`|[MS-CFB] §2.2–2.6|FAT/DIFAT/miniFAT, directory; бюджеты против враждебного FAT, любой брак → `ConversionException`|
|
||||||
|
|`FibHeader`|[MS-DOC] §2.5.1|заголовок FIB: потоки 1Table/0Table, пары fc/lcb нужных индексов, сверка раскладок по nFib|
|
||||||
|
|`PieceTable`|§2.9.135|текст: куски CP1252/UTF-16LE, клампинг к `cbMac`, проверка aCP|
|
||||||
|
|`Grpprl`|§2.6.2|свойства форматирования (sprm'ы): bold/italic/шрифт/цвет/подсветка/заливка/отступы/табуляции|
|
||||||
|
|`ChpxIndex` / `PapxIndex`|§2.4.6|FKP-страницы символьных/абзацных свойств|
|
||||||
|
|`Styles`|§2.9.271|STSH: стилевые цепочки абзацев и символов (stk=1/2)|
|
||||||
|
|`Tables`|§2.6.3|TAP TTP-абзаца → сетка, границы, выравнивание таблицы|
|
||||||
|
|`Lists`|§2.9.200/.201|PlfLst/PlfLfo → `word/numbering.xml`|
|
||||||
|
|`Sections`|§2.8.26|PlcfSed → геометрия секций, ориентация, нумерация страниц, `titlePg`|
|
||||||
|
|`FontTable`|§2.9.286|SttbfFfn: индекс ftc → имя семейства|
|
||||||
|
|`SummaryInfo`|[MS-OLEPS]|`\x01SummaryInformation`: в т.ч. PageCount|
|
||||||
|
|`Headers`|§2.4.1|Plcfhdd: 6 колонтитуков на секцию → `headerN.xml`/`footerN.xml`|
|
||||||
|
|`OfficeArt`|[MS-ODRAW]|картинки: BLIP-хранилище (JPEG/PNG/TIFF/DIB/EMF/WMF/PICT)|
|
||||||
|
|`PrcData`|§2.9.210|разворачивание «огромных» grpprl, вынесенных за FKP-страницу|
|
||||||
|
|`DocToDocx`|—|оркестратор + вложенный `DocxBody` (сборка document.xml)|
|
||||||
|
|`DocxWriter`|—|мульти-частный zip: content-types, rels, numbering, headers, media|
|
||||||
|
|
||||||
|
17 из 18 классов package-private; наружу — только `DocToDocx`.
|
||||||
|
|
||||||
|
## Модель деградации (не падение)
|
||||||
|
|
||||||
|
|Объект в .doc|Поведение|
|
||||||
|
|---|---|
|
||||||
|
|OLE-внедрения (U+0001 в тексте)|плейсхолдер заменяется его же BLIP-картинкой|
|
||||||
|
|картинки JPEG/PNG/TIFF/DIB|переносятся дословно / через ImageIO в PNG|
|
||||||
|
|EMF/WMF/PICT|пропуск с warn (векторные растеризаторы не в контуре)|
|
||||||
|
|битые/неподдерживаемые конструкции|снисходительный разбор, объект исчезает или упрощается — текст не теряется|
|
||||||
|
|
||||||
|
Поэтому **error-флаги (`errorOnCharts`/`errorOnSmartArt`/`errorOnOle`) на `.doc` не
|
||||||
|
срабатывают**: OLE-вложения бинарного формата — это U+0001 с BLIP-плейсхолдером,
|
||||||
|
мост деградирует их в картинки, «OLE-объектов» в смысле docx-пути в результате нет.
|
||||||
|
|
||||||
|
## Сознательный остаток
|
||||||
|
|
||||||
|
Семантика рестартов списков (`fNoRestart`/`ilvlRestartLim`), `fLegal`,
|
||||||
|
AUTONUM-поля (трактуются как обычные списки), часть тонкостей объединённых ячеек —
|
||||||
|
осознанные упрощения вне контура; полный перечень —
|
||||||
|
[doc-bridge.md (репозиторий)](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/doc-bridge.md).
|
||||||
@@ -0,0 +1,63 @@
|
|||||||
|
# Шрифты
|
||||||
|
|
||||||
|
Конвертация не зависит от шрифтов системы: **30 TTF упакованы в jar**
|
||||||
|
`wordpdf-core/src/main/resources/fonts/`, выгружаются во временный каталог и
|
||||||
|
регистрируются в docx4j/FOP. Реестр шрифтов после каждой конвертации возвращается
|
||||||
|
к бандлу — шрифты, встроенные в чужие docx, не влияют на последующие документы.
|
||||||
|
`java.awt.Font` не используется (метрики и глифы — fontbox напрямую), поэтому
|
||||||
|
**fontconfig серверу не нужен**.
|
||||||
|
|
||||||
|
## Бандл
|
||||||
|
|
||||||
|
7 текстовых семейств по 4 начертания + 2 покрывающих (только regular):
|
||||||
|
|
||||||
|
|Семейство|Аналог MS-шрифта|Назначение|
|
||||||
|
|---|---|---|
|
||||||
|
|Carlito|Calibri|метрически совместимая замена|
|
||||||
|
|Caladea|Cambria|метрически совместимая замена|
|
||||||
|
|Arimo|Arial|метрически совместимая замена|
|
||||||
|
|Tinos|Times New Roman|метрически совместимая замена|
|
||||||
|
|Cousine|Courier New|метрически совместимая замена|
|
||||||
|
|DejaVu Sans / DejaVu Serif|—|fallback с гарантированной кириллицей|
|
||||||
|
|Noto Naskh Arabic|—|арабские дополнения U+07B1–U+08FF|
|
||||||
|
|Noto Sans Armenian|—|армянские знаки Unicode 16|
|
||||||
|
|
||||||
|
## Алиасы (`BundledFontAliases`)
|
||||||
|
|
||||||
|
Имена шрифтов из документа подменяются аналогами при конвертации:
|
||||||
|
|
||||||
|
|Имя в docx|Физический шрифт|
|
||||||
|
|---|---|
|
||||||
|
|Calibri|Carlito|
|
||||||
|
|Cambria|Caladea|
|
||||||
|
|Arial|Arimo|
|
||||||
|
|Times New Roman|Tinos|
|
||||||
|
|Courier New|Cousine|
|
||||||
|
|
||||||
|
## Fallback-цепочка
|
||||||
|
|
||||||
|
1. **Ран** идёт своим шрифтом (по `w:rFonts` + алиасам).
|
||||||
|
2. Знака нет в шрифте рана (тире «—», кавычки, U+2000–U+2EFF) — ран падает в
|
||||||
|
**DejaVu Sans** (FOP-фолбэк-семейства задекларированы всецело, шаг 4 конвейера).
|
||||||
|
3. Serif-раны ищут покрытие сначала в serif-семействах (DejaVu Serif, Tinos, Caladea).
|
||||||
|
4. Знака нет и там — `GlyphCoverageNormalizer` (правило 7) режет ран и каждой части
|
||||||
|
назначает покрывающее семейство: serif → DejaVu Serif, sans → DejaVu Sans,
|
||||||
|
экзотика → Noto.
|
||||||
|
5. Знака нет ни в одном шрифте бандла — остаётся `.notdef` (пустой бокс).
|
||||||
|
|
||||||
|
Все шрифты встраиваются в PDF как **подмножества** (кириллица и латиница
|
||||||
|
воспроизводятся на любом просмотрщике).
|
||||||
|
|
||||||
|
## Лицензии
|
||||||
|
|
||||||
|
|Шрифты|Лицензия|
|
||||||
|
|---|---|
|
||||||
|
|Arimo, Cousine, Tinos, Carlito, Caladea|SIL OFL 1.1 (`fonts/FONT-LICENSE.txt`)|
|
||||||
|
|DejaVu Sans / DejaVu Serif|SIL OFL 1.1 / Bitstream Vera (`fonts/DejaVu-LICENSE.txt`)|
|
||||||
|
|Noto Naskh Arabic, Noto Sans Armenian|SIL OFL 1.1 (`fonts/Noto-LICENSE.txt`)|
|
||||||
|
|
||||||
|
GPL-шрифты в бандл не добавляем намеренно (из-за этого два символа эталона —
|
||||||
|
U+2188/U+218A — остаются `.notdef`; см. [Ограничения](limitations.md)).
|
||||||
|
|
||||||
|
Новый шрифт = файл в `resources/fonts/` + запись в `BundledFonts.ENTRIES`
|
||||||
|
(синхронность проверяет `BundledFontsTest`).
|
||||||
@@ -0,0 +1,40 @@
|
|||||||
|
# Ограничения рендера
|
||||||
|
|
||||||
|
Конвертер **не является pixel-perfect рендером Word**: часть расхождений —
|
||||||
|
неустранимые невозможности связки docx4j + Apache FOP, а не упущения проекта.
|
||||||
|
|
||||||
|
## Что конвертируется приближённо
|
||||||
|
|
||||||
|
- Раскладка, поля и некоторые эффекты могут отличаться от Word (ограничения
|
||||||
|
FOP/docx4j по построению).
|
||||||
|
- Символы U+2000–U+2EFF (тире, кавычки): из шрифта рана, если в нём есть глиф,
|
||||||
|
иначе — из fallback-семейства DejaVu.
|
||||||
|
- Знаков, которых нет ни в одном шрифте бандла, это не касается: вместо них
|
||||||
|
остаётся `.notdef` (пустой бокс). В эталонном наборе таких два: U+2188 (ↈ) и
|
||||||
|
U+218A (↊) — глифы есть только в GNU FreeSerif под GPL, а бандл держится целиком
|
||||||
|
на SIL OFL.
|
||||||
|
- Поддержка таблиц/изображений — базовая (уровень docx4j/FOP).
|
||||||
|
- На `.doc` error-флаги диаграмм/SmartArt/OLE не срабатывают: BLIP-плейсхолдеры
|
||||||
|
бинарного формата — уже растры (вставляются картинками), EMF/WMF/PICT пропускаются
|
||||||
|
с warn — [Мост .doc](doc-bridge.md).
|
||||||
|
|
||||||
|
## Стоп-лист «не чинить»
|
||||||
|
|
||||||
|
До любой попытки «починить» расхождение с Word — сверьтесь со списком: это
|
||||||
|
невозможности движка, попытка фикса хуже самого расхождения.
|
||||||
|
|
||||||
|
|Конструкция|Что происходит|Почему не чинится|
|
||||||
|
|---|---|---|
|
||||||
|
|`w:jc="distribute"`|рендерится как left|межсимвольного распределения в FOP нет; `text-align-last` в форке отсутствует|
|
||||||
|
|`w:suff="tab"`|игнорируется (label через hanging-tab)|нужна per-item ширина; совпадает с поведением docx4j|
|
||||||
|
|`w:lvlJc`|игнорируется|—|
|
||||||
|
|кернинг|не применяется|—|
|
||||||
|
|`framePr` (обтекание)|не поддерживается|—|
|
||||||
|
|кэш полей `REF`/`SEQ`/`TOC`|печатается кэш из docx|живой пересчёт вне контура (`PAGE`/`NUMPAGES`/`PAGEREF`/`DATE` — пересчитываются)|
|
||||||
|
|руби (надстрочница)|надстрочная часть вырезается, база печатается|ruby-разметки в FOP нет; потеря текста хуже потери аннотации|
|
||||||
|
|`ptab`|не поддерживается|—|
|
||||||
|
|U+2188/U+218A|`.notdef`|GPL-шрифты не добавляем намеренно|
|
||||||
|
|`lineRule="auto"`|—|не «чинить»: метрический шаг пинен тестом|
|
||||||
|
|
||||||
|
Полный перечень с доказательствами по ECMA-376 —
|
||||||
|
[render-limitations.md (репозиторий)](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/render-limitations.md).
|
||||||
@@ -0,0 +1,68 @@
|
|||||||
|
# Архитектура
|
||||||
|
|
||||||
|
## Конвейер конвертации (шаги 0–7)
|
||||||
|
|
||||||
|
Единственный вход ядра — `WordPdfConverter.convert(byte[], String, ConvertOptions)`;
|
||||||
|
порядок шагов фиксирован и каждый обоснован:
|
||||||
|
|
||||||
|
|#|Шаг|Зачем|
|
||||||
|
|---|---|---|
|
||||||
|
|0|`DependencyGuard.check()`|API-проба commons-compress ≥ 1.25.0 — понятная ошибка вместо `NoSuchMethodError` внутри docx4j|
|
||||||
|
|1|`new BundledFontMapper()` → `BundledFonts.init()` → `restrictToBundled()`|реестр шрифтов = только бандл (+ встроенные в docx); системные сканы отключены гейт-свойствами; порядок строго такой, до `load()`|
|
||||||
|
|2|нормализаторы → `WordprocessingMLPackage.load`|12 правил переписывания байтов одним zip-проходом + OLE-вычистка (см. ниже)|
|
||||||
|
|3|`setFontMapper`|привязка имён шрифтов документа к физическим TTF|
|
||||||
|
|3.5|`DrawingPreRenderer.run`|диаграммы/SmartArt/OMML-формулы → PNG 300 dpi; **обязателен до `FOSettings`**, иначе FOP молча теряет диаграммы|
|
||||||
|
|4|`FOSettings` + `ChartImageHandler` + `FopFallbackFonts.declare`|FOP встраивает только задекларированные семейства; декларуются все бандл-семейства|
|
||||||
|
|4.25/4.5|`LayoutPostRenderer.register`, `setCustomXsltTemplates`|padding-компенсация таблиц; вендорный XSLT с AUDIT-FIX-патчами|
|
||||||
|
|5–6|общая `FopFactory` (DCL) → `Docx4J.toFO(..., FLAG_EXPORT_PREFER_XSL)`|XSL-FO → PDF|
|
||||||
|
|7|`finally`|сброс temp-шрифтов, сброс общих кешей картинок (иначе ~1,5 ГБ за 30 конвертаций), возврат реестра к бандлу|
|
||||||
|
|
||||||
|
Нормализаторы правил 1–11 (один zip-проход, порядок значим): strict→transitional,
|
||||||
|
`on/off`→`true/false`, Symbol/Wingdings→Unicode, поля `PAGE`/`NUMPAGES` →
|
||||||
|
`w:fldSimple` (пересчёт вместо кэша), невидимые символы, OMML-фолбэк, резка ранов
|
||||||
|
по покрытию глифов, отступ таблиц, `suff="space"`, скрытый текст, руби. Правило 12 —
|
||||||
|
`OleObjectNormalizer` (отдельным байтовым проходом).
|
||||||
|
|
||||||
|
Полное «что делает каждый шаг и почему именно так» —
|
||||||
|
[pipeline.md (репозиторий)](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/pipeline.md).
|
||||||
|
|
||||||
|
## Слои ядра (`wordpdf-core`)
|
||||||
|
|
||||||
|
|Слой|Содержимое|
|
||||||
|
|---|---|
|
||||||
|
|публичный API (`ru.pjandro.wordpdf`)|`WordPdfConverter`, `WordPdfValidator`, `ConvertOptions`, иерархия ошибок — см. [API библиотеки](../library/api.md)|
|
||||||
|
|`internal/`|нормализаторы (контракт `byte[] normalize(byte[])`), `FopFallbackFonts`, `LayoutPostRenderer`, `DependencyGuard`|
|
||||||
|
|`internal/doc/`|мост бинарного `.doc` → in-memory `.docx` — [Мост .doc](doc-bridge.md)|
|
||||||
|
|`internal/chart/`|Java2D-рендер диаграмм/SmartArt/формул → PNG — [Диаграммы](charts.md)|
|
||||||
|
|`fonts/`|бандл из 30 TTF, маппинг алиасов, `GlyphFont` (метрики/глифы через fontbox, без AWT) — [Шрифты](fonts.md)|
|
||||||
|
|
||||||
|
Всё, кроме публичного API, — package-private; контракт наружу не расширяется.
|
||||||
|
|
||||||
|
## Параллельность
|
||||||
|
|
||||||
|
`PhysicalFonts` docx4j — глобальный мутируемый реестр → **все конвертации
|
||||||
|
сериализованы монитором класса `WordPdfConverter.class`**. Приложение (`wordpdf-app`)
|
||||||
|
дополнительно держит однопоточный `ThreadPoolExecutor` с очередью 16 мест (переполнение
|
||||||
|
→ 503, timeout 2m → 504), головой очереди стоит `warmup()`.
|
||||||
|
|
||||||
|
## REST-конвейер приложения (`wordpdf-app`)
|
||||||
|
|
||||||
|
`POST /api/v1/convert` → `ApiKeyFilter` (401) → `ConvertController` (проверка
|
||||||
|
расширения/размера, параметры) → `ConversionService` (очередь, Future с таймаутом,
|
||||||
|
перевод исключений ядра в HTTP) → ядро. Обработчик исключений пишет JSON
|
||||||
|
`{"error": …}` — карта кодов в [REST API](../api/errors.md). В модуле 11 классов,
|
||||||
|
все package-private кроме `WordPdfApplication`.
|
||||||
|
|
||||||
|
## Веб-интерфейс (`wordpdf-web`)
|
||||||
|
|
||||||
|
React SPA; вся сеть — ровно две функции в `api.ts` (`convertDocx`, `probeApiKey`),
|
||||||
|
состояние — `useState` в `App.tsx`, store-библиотек нет. Запросы идут на тот же
|
||||||
|
путь `/api/...` относительно базы раздачи — CORS не нужен.
|
||||||
|
|
||||||
|
## Внешние поверхности
|
||||||
|
|
||||||
|
- `gateway/nginx.conf` — единственная наружная точка стендов (:9010/:9011):
|
||||||
|
`/api/`, `/swagger-ui`, `/v3/api-docs`, `/actuator` → app:8080, остальное → web;
|
||||||
|
[Эксплуатация: стенды](../operations/stack.md).
|
||||||
|
- Прод (`https://pjandro.ru/pdf-converter/`) рендерится job'ом `deploy` из
|
||||||
|
Gitea Variables — [Деплой](../operations/deployment.md).
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
# Как контрибьютить
|
||||||
|
|
||||||
|
## Ветка и PR
|
||||||
|
|
||||||
|
Репозиторий: `git.pjandro.ru:pjandro/java-word-pdf`. Защищённые ветки — `main`,
|
||||||
|
`master`, `dev`: прямо в них не коммитим.
|
||||||
|
|
||||||
|
1. Ветка от свежей `main` (`git switch -c <name>`).
|
||||||
|
2. Коммиты логическими блоками.
|
||||||
|
3. Перед push — полный гейт: `./mise.sh run verify`.
|
||||||
|
4. `git push -u origin <name>` → pull request в дефолтную ветку.
|
||||||
|
5. CI на PR: `java` (единственный `mvn clean verify` в контейнере без fontconfig +
|
||||||
|
сводка покрытия комментарием) и `web` (`npm ci`, build, lint) — оба required.
|
||||||
|
`macos-sim` — не required.
|
||||||
|
|
||||||
|
## Конвенции кода
|
||||||
|
|
||||||
|
- Классы `final`, приватный конструктор, только `static` (stateless, DI в ядре нет);
|
||||||
|
в `internal/**` — package-private, `public` только вызываемым извне пакета.
|
||||||
|
- Ошибки публичного API — только `ConversionException` (и подтипы); в chart —
|
||||||
|
деградация вместо падения.
|
||||||
|
- Javadoc на русском: «зачем» + ссылка на секцию спецификации (§17.3.2.24,
|
||||||
|
[MS-DOC] §2.6.1…) + что сломается без шага + регрессия в формате
|
||||||
|
`Регрессия — WordPdfConverterTest#имя, фикстура samples/….docx` (по этой строке
|
||||||
|
грепом восстанавливаются пары тестов).
|
||||||
|
- Модели — `record`; константы UPPER_SNAKE с javadoc-обоснованием числа.
|
||||||
|
- PMD-подавления (`@SuppressWarnings("PMD…")`, `// NOPMD`) запрещены.
|
||||||
|
- Логирование: `java.util.logging` — корневой пакет и `internal/`; SLF4J —
|
||||||
|
`internal/chart` и `wordpdf-app`; остальное молчит.
|
||||||
|
|
||||||
|
## Регрессивная конвенция (фикс бага)
|
||||||
|
|
||||||
|
Каждый фикс расхождения с Word оформляется полным набором:
|
||||||
|
|
||||||
|
```
|
||||||
|
нормализатор/рендерер → юнит на правило → тест во всём конвейере
|
||||||
|
→ javadoc-ссылка «Регрессия — Тест#имя, фикстура …»
|
||||||
|
```
|
||||||
|
|
||||||
|
Фикстуры для новых тестов не генерируются на лету и не перезаписываются:
|
||||||
|
`charts-smartart.docx` и `ole-embedded.docx` сделаны руками и **не перезаписываются
|
||||||
|
никогда**; все 12 `.doc` — эталоны заказчика.
|
||||||
|
|
||||||
|
## Критические инварианты (нарушение = битый вывод)
|
||||||
|
|
||||||
|
Прежде чем править ядро — прогнать глазами список (полный — `AGENTS.md`,
|
||||||
|
[repo-map](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/repo-map.md)):
|
||||||
|
|
||||||
|
- static-блок `WordPdfConverter` (sysprops `gsubFeatures=false`, отключение
|
||||||
|
сканов PhysicalFonts) — не удалять;
|
||||||
|
- `DrawingPreRenderer` обязан идти **до** `FOSettings`, иначе FOP молча теряет диаграммы;
|
||||||
|
- порядок нормализаторов правил 1–11 фиксирован;
|
||||||
|
- вендорный `docx2fo.xslt` — единственный XSL-стилист, дрейф-гейт
|
||||||
|
`vendoredXsltTracksJarCopy`;
|
||||||
|
- `slf4j-simple` обязателен в ядре;
|
||||||
|
- префикс `/word/media/chart-*` — контракт с `ChartImageHandler`;
|
||||||
|
- финальный `finally`-блок: temp-шрифты, кеши картинок, возврат реестра к бандлу.
|
||||||
|
|
||||||
|
## Документация сайта
|
||||||
|
|
||||||
|
Разделы сайта живут в `docs/` (кроме `docs/agent/`, `docs/standards/` — они не входят
|
||||||
|
в сайт). Правка/новая страница: обязательна запись в `nav` `mkdocs.yml` (иначе
|
||||||
|
strict-сборка падает). Проверка: `./mise.sh run docs-build`. Публикация —
|
||||||
|
[`docs-deploy`](../operations/docs-site.md).
|
||||||
@@ -0,0 +1,83 @@
|
|||||||
|
# Окружение разработчика
|
||||||
|
|
||||||
|
Требуется **Java 17**, **Maven 3.9.16**, **Node 24** (engines Vite: `^20.19.0 ||
|
||||||
|
>=22.12.0`), **Python 3.15** (прод-автотесты, сайт документации). Всё это ставит
|
||||||
|
project-local mise: сам бинарь — в `./.mise/bin` (gitignored), кеш инструментов —
|
||||||
|
в user-директории mise, **в систему ничего не устанавливается**. Версии пиныны
|
||||||
|
в `mise.toml`.
|
||||||
|
|
||||||
|
## Бутстрап (первая настройка)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sh bootstrap.sh # Linux / macOS: качает mise, ставит инструменты, npm ci SPA
|
||||||
|
```
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
powershell -ExecutionPolicy Bypass -File .\bootstrap.ps1 # Windows
|
||||||
|
```
|
||||||
|
|
||||||
|
Дальше команды — через обёртку `./mise.sh` (Windows: `.\mise.ps1`):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./mise.sh run verify # полный гейт перед push
|
||||||
|
./mise.sh exec -- mvn -v # любая команда с инструментами в PATH
|
||||||
|
./mise.sh tasks # список задач
|
||||||
|
```
|
||||||
|
|
||||||
|
Альтернатива — активировать mise в шелле и работать напрямую (`mvn`, `npm`, `python`):
|
||||||
|
`eval "$(./.mise/bin/mise activate bash)"`.
|
||||||
|
|
||||||
|
## Задачи mise
|
||||||
|
|
||||||
|
|Задача|Содержание|
|
||||||
|
|---|---|
|
||||||
|
|`verify`|`mvn clean verify` — тесты + PMD + JaCoCo (гейт перед push)|
|
||||||
|
|`verify-nofontconfig`|тот же verify в контейнере без fontconfig (как CI; требует podman/docker)|
|
||||||
|
|`mem-bench`|замер памяти конвейера (TSV пиков + JFR)|
|
||||||
|
|`app-package`|исполняемый jar бэкенда|
|
||||||
|
|`app-run`|бэкенд на :8080, ключ выключен (после `app-package`)|
|
||||||
|
|`web-install`|`npm ci` в `wordpdf-web`|
|
||||||
|
|`web-build`|гейт SPA: `tsc -b && vite build`|
|
||||||
|
|`web-lint`|oxlint|
|
||||||
|
|`web-dev`|SPA на :5173, vite-proxy на :8080|
|
||||||
|
|`prod-tests`|прод-автотесты; обязателен `WORDPDF_BASE_URL`, факультативно `WORDPDF_API_KEY`|
|
||||||
|
|`docs-install`|venv `docs/.venv` + `mkdocs-material`|
|
||||||
|
|`docs-serve`|локальный предпросмотр сайта на :8000 (live-reload)|
|
||||||
|
|`docs-build`|strict-сборка сайта в `site/` (битые ссылки/навигация = ошибка)|
|
||||||
|
|`docs-javadoc`|javadoc публичного API core в `wordpdf-core/target/site/apidocs`|
|
||||||
|
|`docs-deploy`|публикация сайта на rpi (:9012): javadoc + strict-build + rsync|
|
||||||
|
|
||||||
|
## Прямые команды (без задач)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mvn clean verify # все модули + тесты
|
||||||
|
mvn test -Djacoco.skip=true # тесты без агента покрытия
|
||||||
|
mvn -pl wordpdf-core test -Dtest=WordPdfConverterTest#pageNumbers_recomputedNotCached
|
||||||
|
mvn -pl wordpdf-app -am test # -am обязателен: app берёт фикстуры из test-jar core
|
||||||
|
mvn -pl wordpdf-app -am package # исполняемый jar → wordpdf-app/target/
|
||||||
|
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar # :8080, ключ выключен
|
||||||
|
|
||||||
|
npm ci && npm run build # в wordpdf-web/ (или задачи web-*)
|
||||||
|
npm run dev # SPA :5173, проксирует /api на :8080
|
||||||
|
```
|
||||||
|
|
||||||
|
## Стенды на контейнерах (podman)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# dev (:9011), без ключа, springdoc включён
|
||||||
|
podman-compose -f compose.dev.yml up -d --build --force-recreate
|
||||||
|
|
||||||
|
# prod-like (:9010), fail-closed: нужен .env с WORDPDF_API_KEY (шаблон .env.example)
|
||||||
|
cp .env.example .env # ключ: openssl rand -hex 32
|
||||||
|
podman-compose up -d --build
|
||||||
|
```
|
||||||
|
|
||||||
|
`--force-recreate` для dev обязателен: без него podman-compose пересоберёт образ,
|
||||||
|
но контейнеры оставит на старом jar. Наружу публикуется только nginx-gateway
|
||||||
|
(9010/9011), 8080 наружу не выставляется. Подробности —
|
||||||
|
[Стенды](../operations/stack.md).
|
||||||
|
|
||||||
|
!!! info "«Запусти тестовый сервер»"
|
||||||
|
Так в проекте называют dev-стенд (`compose.dev.yml`, `http://<LAN-IP>:9011`),
|
||||||
|
а не `java -jar`. Готовность — контейнеры healthy (`podman-compose -f
|
||||||
|
compose.dev.yml ps`) + корень SPA отвечает 200.
|
||||||
@@ -0,0 +1,71 @@
|
|||||||
|
# Тесты
|
||||||
|
|
||||||
|
## Гейты
|
||||||
|
|
||||||
|
Полный гейт перед push — `./mise.sh run verify` (= `mvn clean verify`); на `verify`
|
||||||
|
висят и валят сборку:
|
||||||
|
|
||||||
|
|Гейт|Порог|
|
||||||
|
|---|---|
|
||||||
|
|surefire (тесты)|все зелёные, `-Djava.awt.headless=true`|
|
||||||
|
|PMD (`pmd-ruleset.xml`)|любой приоритет нарушения валит; `includeTests=true`; **подавления запрещены** — чинить кодом|
|
||||||
|
|JaCoCo LINE|≥ 0.90 (оба модуля)|
|
||||||
|
|JaCoCo BRANCH|≥ 0.85 (только `wordpdf-core`)|
|
||||||
|
|
||||||
|
Провал — HTML/XML-отчёт уже в `target/site/jacoco/`. CI-эквивалент без fontconfig —
|
||||||
|
`./mise.sh run verify-nofontconfig`. `mvn test` PMD/JaCoCo-гейты не запускает.
|
||||||
|
|
||||||
|
## Стек и конвенции
|
||||||
|
|
||||||
|
- **JUnit 6** (`org.junit.jupiter`), **только `Assertions`** — Mockito/AssertJ
|
||||||
|
запрещены, их нет в pom (в app-тестах допустим inline-Hamcrest
|
||||||
|
`org.hamcrest.Matchers.containsString` в `andExpect`).
|
||||||
|
- Только `@Test` (исключения: два `@BeforeAll` прогрева шрифтов, `@AfterEach
|
||||||
|
drainWorker` в `ConversionTimeoutTest`); ни `@Nested`, ни `@ParameterizedTest`,
|
||||||
|
ни `@Disabled`, ни `assertAll`.
|
||||||
|
- Тестовые классы package-private, зеркалят main-пакеты.
|
||||||
|
- Именование: регрессионные — `объект_условие` (`pageNumbers_recomputedNotCached`),
|
||||||
|
юниты — camelCase (`pageFieldBecomesFldSimple`).
|
||||||
|
- Сообщения ассертов — по-русски, с наблюдаемым значением; литерал слева.
|
||||||
|
- Тестовых утилит нет — хелперы намеренно дублируются в классах.
|
||||||
|
|
||||||
|
## Фикстуры
|
||||||
|
|
||||||
|
Только закоммиченные `wordpdf-core/src/test/resources/samples/`: **13 `.docx` +
|
||||||
|
12 `.doc`** (`.doc` — эталоны заказчика). В тестах фикстуры **не генерировать**;
|
||||||
|
XSD-невалидную `.docx`-фикстуру правят, а не код
|
||||||
|
(`python3 docs/standards/docx/validate-fixtures.py …`). Синтетика в памяти разрешена:
|
||||||
|
docx — `ZipOutputStream` из литеральных XML, `.doc` — крафт `POIFSFileSystem`.
|
||||||
|
|
||||||
|
Ловушка загрузки: **core** грузит classloader-ресурсом без ведущего слэша
|
||||||
|
(`getResourceAsStream("samples/…")`), **app** — class-relative со слэшем
|
||||||
|
(`/samples/…`, ресурсы из test-jar core; отсюда обязательный `-am`).
|
||||||
|
|
||||||
|
## Как проверяется PDF
|
||||||
|
|
||||||
|
**Текстом, не растеризацией**: PDFBox 3 `PDFTextStripper` (нормализация пробелов);
|
||||||
|
негативные маркеры — `#` (.notdef) и `Helvetica` (фолбэк-шрифт FOP); имя шрифта
|
||||||
|
символа — приём `fontNameOf`; встроенные подмножества — обход ресурсов страниц
|
||||||
|
(`EAAAAA+Carlito-Bold`). Пиксели (BufferedImage, отношения к эталонам Word 300 dpi
|
||||||
|
с допусками) — только юниты chart-пейнтеров.
|
||||||
|
|
||||||
|
## App-тесты
|
||||||
|
|
||||||
|
4 набора свойств = 4 Spring-контекста: `ConvertControllerTest` (пин пустого
|
||||||
|
`wordpdf.api-key=`), `ApiKeyFilterTest`, `ConvertLimitsTest`, `ConversionTimeoutTest`;
|
||||||
|
`ConversionServiceTest`/`ApiExceptionHandlerTest` — без Spring. Проверяют HTTP-код,
|
||||||
|
заголовки, текст ошибки. Ловушка: mise инжектирует корневой `.env` в окружение задач
|
||||||
|
— ambient `WORDPDF_API_KEY` дал бы 401 во всех MockMvc-тестах, поэтому ключ пинится
|
||||||
|
свойствами контекста.
|
||||||
|
|
||||||
|
## Прод-автотесты
|
||||||
|
|
||||||
|
`prod-autotests/` (pytest + requests): 31 проверка против **живого** стенда —
|
||||||
|
4 открытые + 27 `needs_key` (SKIP без ключа). Конфигурация только env:
|
||||||
|
`WORDPDF_BASE_URL` (обязателен), `WORDPDF_API_KEY`, `WORDPDF_MAX_MB`/`MAX_PAGES`,
|
||||||
|
`WORDPDF_SAMPLES_DIR`. Таймауты `(10, 180)` — больше серверных 2m. Запуск:
|
||||||
|
`WORDPDF_BASE_URL=… ./mise.sh run prod-tests` (в CI гоняются job'ом `autotests`
|
||||||
|
после deploy).
|
||||||
|
|
||||||
|
Глубина (счётчики, пары «нормализатор ↔ тест», пиксельные допуски) —
|
||||||
|
[testing.md (репозиторий)](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/testing.md).
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
# Word → PDF конвертер
|
||||||
|
|
||||||
|
Конвертация **.docx/.doc → PDF** на чистой Java: `docx4j` 17.3.2 + форк `Apache FOP`
|
||||||
|
(`org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.6), **без LibreOffice и без Aspose**.
|
||||||
|
Бинарный `.doc` (Word 97–2003) читается собственным мостом [MS-DOC]/[MS-CFB]
|
||||||
|
и переносится в .docx в памяти — дальше идёт тем же конвейером. Шрифты упакованы
|
||||||
|
в jar: конвертация не зависит от шрифтов, установленных в системе, и работает
|
||||||
|
«из коробки» на голом сервере.
|
||||||
|
|
||||||
|
## Три поверхности
|
||||||
|
|
||||||
|
|Поверхность|Что это|Куда смотреть|
|
||||||
|
|---|---|---|
|
||||||
|
|Веб-интерфейс|React SPA: перетащил файл → предпросмотр PDF → скачивание. Публикация: `https://pjandro.ru/pdf-converter/`|[Пользователю](user.md)|
|
||||||
|
|REST API|`POST /api/v1/convert` (Spring Boot 4.1.1), ключ доступа, Swagger UI|[REST API](api/index.md)|
|
||||||
|
|Java-библиотека|`wordpdf-core`: `WordPdfConverter.convert(...)` — байты docx на входе, байты PDF на выходе|[Библиотека](library/getting-started.md)|
|
||||||
|
|
||||||
|
## Как это работает (схема)
|
||||||
|
|
||||||
|
```
|
||||||
|
.docx/.doc ──> валидация входа ──> (.doc: мост → .docx в памяти)
|
||||||
|
──> нормализация байтов ──> docx4j (WordprocessingMLPackage)
|
||||||
|
──> диаграммы → PNG ──> XSL-FO (вендорный XSLT) ──> Apache FOP ──> PDF (embedded-шрифты)
|
||||||
|
```
|
||||||
|
|
||||||
|
1. Вход проверяется до рендера (`WordPdfValidator`): размер → сигнатура байтов
|
||||||
|
(zip `PK\x03\x04` или CFB `D0 CF 11 E0`) → контейнер и страницы lightweight-сканом,
|
||||||
|
без зависимости от docx4j.
|
||||||
|
2. XML-части переписывает `DocxRewritePipeline` одним zip-проходом (12 правил
|
||||||
|
нормализации), затем OLE-объекты вычищает `OleObjectNormalizer`.
|
||||||
|
3. Документ загружается в `WordprocessingMLPackage`, привязывается `BundledFontMapper`.
|
||||||
|
4. Диаграммы и SmartArt предварительно растеризуются в PNG 300 dpi собственным
|
||||||
|
Java2D-движком (`DrawingPreRenderer`) — XSLT-экспорт docx4j их не умеет.
|
||||||
|
5. Экспорт в XSL-FO идёт вендорным стилем `docx2fo.xslt`; `Apache FOP` рендерит
|
||||||
|
PDF, встраивая подмножества шрифтов.
|
||||||
|
|
||||||
|
Полностью, с обоснованиями — [Архитектура](architecture/overview.md).
|
||||||
|
|
||||||
|
## Возможности
|
||||||
|
|
||||||
|
- RU/EN: кириллица и латиница встраиваются в PDF как embedded-подмножества.
|
||||||
|
- Частые MS-шрифты подменяются метрически совместимыми open-source аналогами
|
||||||
|
([Шрифты](architecture/fonts.md)).
|
||||||
|
- Диаграммы (17 типов, включая комбинированные) и SmartArt — PNG без Word/LibreOffice
|
||||||
|
([Диаграммы](architecture/charts.md)).
|
||||||
|
- `.doc`: текст, стили, таблицы, списки, колонтитуки, картинки — собственный мост
|
||||||
|
([Мост .doc](architecture/doc-bridge.md)).
|
||||||
|
|
||||||
|
## Ключевые версии
|
||||||
|
|
||||||
|
|Компонент|Версия|
|
||||||
|
|---|---|
|
||||||
|
|Java|17 (temurin)|
|
||||||
|
|docx4j|17.3.2|
|
||||||
|
|Apache FOP (форк `docx4j-fo-renderer*`)|2.11-docx4j.6|
|
||||||
|
|commons-compress|1.28.0 (минимум 1.25.0)|
|
||||||
|
|Spring Boot|4.1.1|
|
||||||
|
|springdoc|3.1.1|
|
||||||
|
|SPA|React 19.2 + TypeScript ~6.0 + Vite 8.3|
|
||||||
|
|
||||||
|
## Ссылки
|
||||||
|
|
||||||
|
- [Javadoc публичного API `wordpdf-core`](/apidocs/index.html)
|
||||||
|
- [Внутренние справочники репозитория](internal-guides.md) — для глубокой правки кода.
|
||||||
@@ -0,0 +1,39 @@
|
|||||||
|
# Внутренние справочники репозитория
|
||||||
|
|
||||||
|
Сайт покрывает «как пользоваться и как устроено». Для **глубокой правки кода**
|
||||||
|
в репозитории живут авторитетные справочники (`docs/agent/`, читаются наравне
|
||||||
|
с `AGENTS.md`) и закоммиченные спецификации форматов (`docs/standards/`).
|
||||||
|
В этот сайт они не включены (огромные тексты спецификаций) — ссылки ведут на Gitea.
|
||||||
|
|
||||||
|
## Справочники `docs/agent/`
|
||||||
|
|
||||||
|
|Документ|Читать при|
|
||||||
|
|---|---|
|
||||||
|
|[pipeline.md](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/pipeline.md)|правке конвейера `WordPdfConverter`, нормализаторов, валидатора; шаги 0–7 с обоснованиями, правила 1–12|
|
||||||
|
|[doc-bridge.md](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/doc-bridge.md)|правке моста `internal/doc`; классы ↔ секции [MS-DOC]/[MS-CFB], остаток моста|
|
||||||
|
|[chart.md](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/chart.md)|правке `internal/chart`; пейнтеры, калибровки по Word, защитные лимиты, §ECMA-376|
|
||||||
|
|[render-limitations.md](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/render-limitations.md)|любой попытке «починить» расхождение с Word — сначала стоп-лист|
|
||||||
|
|[testing.md](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/testing.md)|добавлении/правке тестов; счётчики, пиксельные допуски, фикстуры, конвенции|
|
||||||
|
|[ci-cd.md](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/ci-cd.md)|правке workflow'ов, Containerfile'ов, деплоя|
|
||||||
|
|[repo-map.md](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/repo-map.md)|поиске «где живёт X»: полная карта каталогов/файлов, REST-карта, конвенции|
|
||||||
|
|
||||||
|
## Спецификации `docs/standards/`
|
||||||
|
|
||||||
|
Нормативные тексты форматов, закоммиченные в репозиторий
|
||||||
|
(навигатор — `docs/standards/README.md`, ссылка в коде — с номером секции):
|
||||||
|
|
||||||
|
|Каталог|Содержимое|
|
||||||
|
|---|---|
|
||||||
|
|`ooxml/`|ECMA-376 Part 1 (PDF + md), [MS-OI29500], [MS-ODRAWXML], полные наборы XSD strict/transitional|
|
||||||
|
|`binary/`|[MS-CFB], [MS-OSHARED], [MS-ODRAW], [MS-OLEPS], [MS-OFFCRYPTO], [MS-OVBA], [MS-WMF], [MS-EMF]|
|
||||||
|
|`doc/`|[MS-DOC] — бинарный формат Word 97–2003|
|
||||||
|
|`docx/`|XSD-валидация фикстур (`validate-fixtures.py`)|
|
||||||
|
|
||||||
|
## Корневые документы
|
||||||
|
|
||||||
|
- [`AGENTS.md`](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/AGENTS.md) —
|
||||||
|
правила репозитория: конвейер, инварианты, команды, конвенции, гейты.
|
||||||
|
- [`README.md`](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/README.md) —
|
||||||
|
короткая точка входа в проект.
|
||||||
|
- [`GITEA-vars.md`](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/GITEA-vars.md) —
|
||||||
|
все Secrets/Variables CI и настройка branch protection.
|
||||||
@@ -0,0 +1,75 @@
|
|||||||
|
# API библиотеки
|
||||||
|
|
||||||
|
Публичный API мал и стабилен: два сервисных класса, один record, пять видов ошибок.
|
||||||
|
Javadoc каждого члена — [apidocs](/apidocs/index.html).
|
||||||
|
|
||||||
|
## `WordPdfConverter`
|
||||||
|
|
||||||
|
```java
|
||||||
|
public final class WordPdfConverter {
|
||||||
|
public static byte[] convert(byte[] docxBytes, String title, ConvertOptions options)
|
||||||
|
throws ConversionException;
|
||||||
|
public static synchronized void warmup();
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- `convert` — единственный путь конвертации (двухаргументной перегрузки **нет**).
|
||||||
|
Принимает байты `.docx` или `.doc` (маршрутизация по сигнатуре), возвращает байты PDF.
|
||||||
|
`title` — заголовок PDF. `options == null` → `ValidationException`.
|
||||||
|
- `warmup()` — идемпотентный прогрев конвейера; не бросает.
|
||||||
|
|
||||||
|
## `WordPdfValidator`
|
||||||
|
|
||||||
|
Те же проверки входа **без рендера** — например, для валидации загрузки до очереди:
|
||||||
|
|
||||||
|
```java
|
||||||
|
public static void checkInput(byte[] docxBytes, long maxMb) throws ValidationException;
|
||||||
|
public static void validate(byte[] docxBytes, ConvertOptions options) throws ValidationException;
|
||||||
|
```
|
||||||
|
|
||||||
|
Проверяются: непустота, размер (`maxMb`), сигнатура (zip/CFB), для docx — контейнер
|
||||||
|
(`[Content_Types].xml` с типом документа), производные пороги (распаковка, XML,
|
||||||
|
растры, записи zip), число страниц (lightweight-скан, без docx4j; для `.doc` —
|
||||||
|
по сырым байтам мостом).
|
||||||
|
|
||||||
|
## `ConvertOptions`
|
||||||
|
|
||||||
|
```java
|
||||||
|
public record ConvertOptions(boolean errorOnCharts, boolean errorOnSmartArt,
|
||||||
|
boolean errorOnOle, long maxMb, int maxPages) {}
|
||||||
|
```
|
||||||
|
|
||||||
|
**Порядок полей фиксирован.** `maxMb`/`maxPages` должны быть больше 0. Дефолтов
|
||||||
|
в ядре нет — значения задаёт вызывающий. Диаграммы/SmartArt конвертируются всегда;
|
||||||
|
флаги только отменяют конвертацию находкой.
|
||||||
|
|
||||||
|
## Ошибки
|
||||||
|
|
||||||
|
```
|
||||||
|
ConversionException (RuntimeException)
|
||||||
|
├── ValidationException — вход некорректен (не docx/doc, размер, страницы, битый zip…)
|
||||||
|
├── ChartsFoundException — errorOnCharts и найдены диаграммы
|
||||||
|
├── SmartArtFoundException — errorOnSmartArt и найден SmartArt
|
||||||
|
└── OleFoundException — errorOnOle и найдены OLE-объекты
|
||||||
|
```
|
||||||
|
|
||||||
|
Ловите `ConversionException` — он покрывает всё; `ValidationException` — отдельно,
|
||||||
|
когда хотите различать «пользователь прислал мусор» и «конвертер не смог».
|
||||||
|
|
||||||
|
## Инвариант параллельности
|
||||||
|
|
||||||
|
`convert` **потокобезопасен, но сериализован**: все конвертации идут под монитором
|
||||||
|
класса `WordPdfConverter.class` — ядро мутирует глобальный реестр шрифтов docx4j
|
||||||
|
(`PhysicalFonts`). Параллельные вызовы корректны, но исполняются последовательно;
|
||||||
|
собственный пул/очередь с отказом при переполнении — забота вызывающего
|
||||||
|
(так делает `wordpdf-app`: один воркер, очередь 16).
|
||||||
|
|
||||||
|
## Шрифты и окружение
|
||||||
|
|
||||||
|
- Шрифты выгружаются из jar во временный каталог; реестр после каждой конвертации
|
||||||
|
возвращается к бандлу — встроенные в чужие docx шрифты не «травят» последующие
|
||||||
|
конвертации.
|
||||||
|
- `java.awt.Font` не используется (глифы — fontbox напрямую): **fontconfig хосту не нужен**,
|
||||||
|
контейнер без `/etc/fonts` работает.
|
||||||
|
- Нужен SLF4J-провайдер (см. [первые шаги](getting-started.md)) — иначе текст
|
||||||
|
предупреждений попадает в PDF.
|
||||||
@@ -0,0 +1,66 @@
|
|||||||
|
# Зависимости потребителя
|
||||||
|
|
||||||
|
## commons-compress: единственная ловушка интеграции
|
||||||
|
|
||||||
|
Ядру (транзитивно, через docx4j) нужен `org.apache.commons:commons-compress`
|
||||||
|
**≥ 1.25.0**, рекомендован **1.28.0** — версию закрепляет POM `wordpdf-core`.
|
||||||
|
Симптом старой версии в classpath потребителя:
|
||||||
|
|
||||||
|
```
|
||||||
|
NoSuchMethodError: org.apache.commons.compress.archivers.zip.ZipArchiveEntry
|
||||||
|
org.apache.commons.compress.archivers.zip.ZipArchiveInputStream.getNextEntry()
|
||||||
|
```
|
||||||
|
|
||||||
|
До входа в docx4j теперь срабатывает guard (`DependencyGuard`): вместо мутного
|
||||||
|
`NoSuchMethodError` внутри docx4j — `ConversionException` с текстом, объясняющим,
|
||||||
|
какую версию закрепить.
|
||||||
|
|
||||||
|
### Maven: закреплять в `dependencyManagement`
|
||||||
|
|
||||||
|
BOM (например, Spring Boot 3.x) пинит свою версию commons-compress, а
|
||||||
|
`dependencyManagement` потребителя перекрывает транзитивные версии («nearest wins»)
|
||||||
|
— закреплять нужно именно в нём:
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<dependencyManagement>
|
||||||
|
<dependencies>
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.apache.commons</groupId>
|
||||||
|
<artifactId>commons-compress</artifactId>
|
||||||
|
<version>1.28.0</version>
|
||||||
|
</dependency>
|
||||||
|
</dependencies>
|
||||||
|
</dependencyManagement>
|
||||||
|
```
|
||||||
|
|
||||||
|
Диагностика:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mvn dependency:tree -Dincludes=org.apache.commons:commons-compress
|
||||||
|
```
|
||||||
|
|
||||||
|
### Gradle: достаточно не понижать
|
||||||
|
|
||||||
|
По умолчанию Gradle выбирает максимальную версию и конфликт разрешает сам —
|
||||||
|
guard не сработает и не нужен. Понижает версию только явный `constraints` /
|
||||||
|
`platform` / `resolutionStrategy`: уберите понижение либо закрепите нужную версию:
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
dependencies {
|
||||||
|
constraints {
|
||||||
|
implementation("org.apache.commons:commons-compress:1.28.0")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
(либо `resolutionStrategy.force("org.apache.commons:commons-compress:1.28.0")`).
|
||||||
|
Диагностика: `gradle dependencies --configuration runtimeClasspath`.
|
||||||
|
|
||||||
|
## Прочие транзитивные зависимости
|
||||||
|
|
||||||
|
|Артефакт|Зачем|Нужно ли трогать|
|
||||||
|
|---|---|---|
|
||||||
|
|`docx4j-export-fo` (+ форк FOP `docx4j-fo-renderer*`)|конвейер XSL-FO → PDF|нет|
|
||||||
|
|`slf4j-simple`|единственный SLF4J-провайдер из коробки — без провайдера docx4j пишет «TO HIDE THESE MESSAGES» в PDF|исключить, если у приложения свой провайдер|
|
||||||
|
|`jcl-over-slf4j`|мост commons-logging (pdfbox/fontbox) → slf4j|нет (`commons-logging` исключён)|
|
||||||
|
|`fontbox`|чтение TTF напрямую, без `java.awt.Font`|нет|
|
||||||
@@ -0,0 +1,72 @@
|
|||||||
|
# wordpdf-core: первые шаги
|
||||||
|
|
||||||
|
`wordpdf-core` — Java-библиотека конвертации `.docx`/`.doc` → PDF. Без LibreOffice,
|
||||||
|
без Aspose, без системных шрифтов: все TTF упакованы в jar.
|
||||||
|
|
||||||
|
## Подключение
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<dependency>
|
||||||
|
<groupId>ru.pjandro</groupId>
|
||||||
|
<artifactId>wordpdf-core</artifactId>
|
||||||
|
<version>1.0.0</version>
|
||||||
|
</dependency>
|
||||||
|
```
|
||||||
|
|
||||||
|
Требуется **Java 17**. Единственный обязательный аспект интеграции — версия
|
||||||
|
`commons-compress` (см. [Зависимости](dependencies.md)).
|
||||||
|
|
||||||
|
## Минимальный пример
|
||||||
|
|
||||||
|
```java
|
||||||
|
import ru.pjandro.wordpdf.WordPdfConverter;
|
||||||
|
import java.nio.file.Files;
|
||||||
|
import java.nio.file.Path;
|
||||||
|
|
||||||
|
byte[] docx = Files.readAllBytes(Path.of("doc.docx"));
|
||||||
|
byte[] pdf = WordPdfConverter.convert(docx, "doc",
|
||||||
|
new ru.pjandro.wordpdf.ConvertOptions(false, false, false, 5, 100));
|
||||||
|
Files.write(Path.of("out.pdf"), pdf);
|
||||||
|
```
|
||||||
|
|
||||||
|
Второй аргумент — заголовок PDF (пустой/`null` — без заголовка). Работа с файлами —
|
||||||
|
забота вызывающего: ядро пути не принимает, только байты.
|
||||||
|
|
||||||
|
Формат входа определяется **по сигнатуре байтов**, расширение имени файла ядру
|
||||||
|
неизвестно:
|
||||||
|
|
||||||
|
|Сигнатура|Маршрут|
|
||||||
|
|---|---|
|
||||||
|
|`PK\x03\x04`|zip → OOXML-путь (docx4j)|
|
||||||
|
|`D0 CF 11 E0 A1 B1 1A E1`|CFB → мост .doc → .docx в памяти → тот же конвейер|
|
||||||
|
|
||||||
|
## Опции конвертации
|
||||||
|
|
||||||
|
`ConvertOptions` — record из пяти полей (детали в [API библиотеки](api.md)):
|
||||||
|
error-флаги диаграмм/SmartArt/OLE и лимиты размера/страниц. Дефолтов в ядре нет —
|
||||||
|
все пять значений задаёт вызывающий:
|
||||||
|
|
||||||
|
```java
|
||||||
|
// отменить конвертацию, если в документе есть диаграммы; лимиты 10 МБ / 200 страниц
|
||||||
|
var opts = new ConvertOptions(true, false, false, 10, 200);
|
||||||
|
byte[] pdf = WordPdfConverter.convert(bytes, "Отчёт", opts);
|
||||||
|
```
|
||||||
|
|
||||||
|
## Прогрев
|
||||||
|
|
||||||
|
Первая конвертация после старта JVM стоит ~1,3–1,7 с (инициализация JAXB/XSLT/FOP).
|
||||||
|
`WordPdfConverter.warmup()` прогоняет весь конвейер на минимальном встроенном docx
|
||||||
|
и идемпотентен (повторные вызовы — no-op); бросать не должен никогда — решение
|
||||||
|
о реакции на сбой прогревает код. Вызывайте на старте приложения, если не хотите,
|
||||||
|
чтобы первый пользователь платил за инициализацию:
|
||||||
|
|
||||||
|
```java
|
||||||
|
WordPdfConverter.warmup(); // ~1,5–2,5 с, один раз при старте
|
||||||
|
```
|
||||||
|
|
||||||
|
## Провайдер логов
|
||||||
|
|
||||||
|
В classpath потребителя **обязан быть SLF4J-провайдер**. Без него docx4j пишет
|
||||||
|
предупреждение «TO HIDE THESE MESSAGES…» **прямо в выходной PDF**. В jar `wordpdf-core`
|
||||||
|
для этого включён `slf4j-simple`; если ваше приложение приносит свой провайдер
|
||||||
|
(logback и т.п.) — исключите `slf4j-simple` из транзитивных зависимостей.
|
||||||
@@ -0,0 +1,52 @@
|
|||||||
|
# Конфигурация сервера (`wordpdf-app`)
|
||||||
|
|
||||||
|
## Свойства и env
|
||||||
|
|
||||||
|
|Свойство|Env|Дефолт|Смысл|
|
||||||
|
|---|---|---|---|
|
||||||
|
|`wordpdf.api-key`|`WORDPDF_API_KEY`|пусто|ключ заголовка `X-API-Key`; пусто = аутентификация выключена|
|
||||||
|
|`wordpdf.max-mb`|`WORDPDF_MAX_MB`|5 (литерал `@Value`)|дефолтный лимит размера входа, МБ (MiB); ≤ 0 на старте → `IllegalStateException`|
|
||||||
|
|`wordpdf.max-pages`|`WORDPDF_MAX_PAGES`|100 (литерал `@Value`)|дефолтный лимит страниц; ≤ 0 → падение на старте|
|
||||||
|
|`wordpdf.convert-timeout`|`WORDPDF_CONVERT_TIMEOUT`|`2m`|таймаут одной конвертации (Duration) → 504|
|
||||||
|
|`spring.servlet.multipart.max-file-size` / `max-request-size`|—|`100MB`|потолок контейнера, зеркалит nginx `client_max_body_size 100m`|
|
||||||
|
|`spring.servlet.multipart.file-size-threshold`|—|`2MB`|части больше — на диск Tomcat (heap держит только копию одной сериализованной конвертации)|
|
||||||
|
|`server.forward-headers-strategy`|—|`framework`|работа за префикс-срезающим прокси (`X-Forwarded-*`); `native` не понимает `X-Forwarded-Prefix`|
|
||||||
|
|`springdoc.api-docs.enabled`|`SPRINGDOC_API_DOCS_ENABLED`|`true`|OpenAPI-спек; `false` → `/v3/api-docs` отдаёт 404|
|
||||||
|
|`springdoc.swagger-ui.enabled`|`SPRINGDOC_SWAGGER_UI_ENABLED`|`true`|Swagger UI|
|
||||||
|
|`springdoc.swagger-ui.persist-authorization`|—|`true`|не требовать ключ заново после перезагрузки страницы UI|
|
||||||
|
|
||||||
|
Ограничитель очереди (16 мест) — константа `ConversionService.QUEUE_CAPACITY`,
|
||||||
|
не конфигурируется.
|
||||||
|
|
||||||
|
!!! warning "Не объявляйте `wordpdf.max-mb`/`max-pages` в `application.properties`"
|
||||||
|
Дефолты 5/100 живут литералами `@Value` в `ConvertController`. Пустое значение
|
||||||
|
ключа в properties **затенит** литерал и сломает старт. Либо не объявляйте
|
||||||
|
(тогда дефолт), либо конкретное число.
|
||||||
|
|
||||||
|
## Примеры запуска
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# ключ + лимиты через env
|
||||||
|
WORDPDF_API_KEY=$(openssl rand -hex 32) WORDPDF_MAX_MB=10 \
|
||||||
|
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar
|
||||||
|
|
||||||
|
# или аргументами
|
||||||
|
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar \
|
||||||
|
--wordpdf.api-key=secret --wordpdf.convert-timeout=3m
|
||||||
|
```
|
||||||
|
|
||||||
|
В prod-like compose-стеке `WORDPDF_API_KEY` читается из `.env` (fail-closed:
|
||||||
|
`${WORDPDF_API_KEY:?}` — без него стек не поднимается), на проде ключ приходит
|
||||||
|
только из Gitea Secret через окружение контейнера.
|
||||||
|
|
||||||
|
## Что задала не я, а инфраструктура
|
||||||
|
|
||||||
|
|Параметр|Где|Значение|
|
||||||
|
|---|---|---|
|
||||||
|
|`client_max_body_size`|`gateway/nginx.conf`|`100m`|
|
||||||
|
|proxy_read timeout|`gateway/nginx.conf`|300 с|
|
||||||
|
|heap контейнера app|`Containerfile` (ENTRYPOINT)|`-Xms2g -Xmx2g`; лимит `mem_limit: 3g` — в compose|
|
||||||
|
|`VITE_BASE`|build-arg образа web|`/pdf-converter/` (путь публикации на проде)|
|
||||||
|
|
||||||
|
Значение `maxMb`/`maxPages` конкретного стенда прод-автотесты читают из
|
||||||
|
`WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (на проде — 5/100).
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
# Деплой (прод)
|
||||||
|
|
||||||
|
Наружный вход прода — **`https://pjandro.ru/pdf-converter/`** (пользовательский
|
||||||
|
nginx режет префикс и проксирует на стек конвертера). Публикация полностью
|
||||||
|
автоматизрована: **push в `main` → Gitea Actions**.
|
||||||
|
|
||||||
|
## Пайплайн `main.yml`
|
||||||
|
|
||||||
|
```
|
||||||
|
java + web (тесты/гейты) ──> images-app + images-web (build+push в реестр)
|
||||||
|
──> deploy (рендер прод-стека, pull, up, health-гейты, автооткат)
|
||||||
|
──> autotests (pytest против живого прода; провал → rollback)
|
||||||
|
```
|
||||||
|
|
||||||
|
1. **`java` / `web`** — те же гейты, что на PR (`mvn clean verify` в контейнере
|
||||||
|
без fontconfig; `npm ci`/build/lint).
|
||||||
|
2. **`images-app` / `images-web`** — сборка Containerfile в Nexus-реестр, теги
|
||||||
|
`prod` + неизменяемый `sha-<7 символов>`; web печётся с
|
||||||
|
`VITE_BASE=/pdf-converter/` (путь публикации запекается в образ).
|
||||||
|
3. **`deploy`** — job **рендерит** `docker-compose.yml` и `nginx.conf` в директорию
|
||||||
|
деплоя из Gitea Variables (прод-хост не хранит ни конфигураций, ни секретов;
|
||||||
|
API-ключ — из Secret через окружение деплоя, на диск не пишется), затем
|
||||||
|
login/pull/`up -d --force-recreate app web`, гейты healthy + recreate gateway.
|
||||||
|
Единственное состояние на проде — `.rollback.env` (image id предыдущего рана).
|
||||||
|
4. **`autotests`** — 31 pytest-проверка против живого стенда; провал → откат
|
||||||
|
на образ из `.rollback.env`.
|
||||||
|
|
||||||
|
## Где креды и координаты
|
||||||
|
|
||||||
|
Всё вне репозитория — **Gitea Actions Variables/Secrets** (полный список и настройка
|
||||||
|
branch protection: [`GITEA-vars.md`](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/GITEA-vars.md)).
|
||||||
|
Прод-ключ `WORDPDF_API_KEY` — только Secret. В репо и на диске прод-хоста ключа нет.
|
||||||
|
|
||||||
|
## Ручные операции
|
||||||
|
|
||||||
|
!!! warning "Перед ручным перезапуском прода"
|
||||||
|
Прочитать `/home/pjandro/prod/java-word-pdf/DEPLOY.md` (живёт на прод-хосте,
|
||||||
|
вне репозитория) — там актуальные координаты и процедура. Ручных скриптов
|
||||||
|
деплоя в репозитории нет и не заводить.
|
||||||
|
|
||||||
|
Прод-образ/`compose` правятся только через CI-рендер; копий прод-стека на хосте
|
||||||
|
или в репо быть не должно.
|
||||||
|
|
||||||
|
## Проверка после деплоя
|
||||||
|
|
||||||
|
CI сам докладывает по job'ам (`/actions/runs/<id>/jobs`); руками:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -sf https://pjandro.ru/pdf-converter/actuator/health # 200 {"status":"UP"}
|
||||||
|
curl -s -o /dev/null -w '%{http_code}\n' https://pjandro.ru/pdf-converter/ # 200 SPA
|
||||||
|
```
|
||||||
|
|
||||||
|
Глубина (нюансы runner'ов, `DOCKER_BUILDKIT=0`, реестр, rollback-механика) —
|
||||||
|
[ci-cd.md (репозиторий)](http://git.pjandro.ru/pjandro/java-word-pdf/src/branch/main/docs/agent/ci-cd.md).
|
||||||
@@ -0,0 +1,88 @@
|
|||||||
|
# Этот сайт документации
|
||||||
|
|
||||||
|
Статический сайт (MkDocs Material) собирается из `docs/` этого репозитория и
|
||||||
|
раздаётся nginx-контейнером на rpi-хосте LAN-сервера:
|
||||||
|
|
||||||
|
- адрес: **`http://192.168.88.23:9012/`** (LAN; наружу не публикуется);
|
||||||
|
- статика: `/home/pjandro/srv/wordpdf-docs/` (rsync без рестарта контейнера);
|
||||||
|
- javadoc публичного API: [`/apidocs/index.html`](/apidocs/index.html).
|
||||||
|
|
||||||
|
## Публикация (с хоста, из репозитория)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./mise.sh run docs-install # разово: venv docs/.venv + mkdocs-material
|
||||||
|
./mise.sh run docs-deploy # javadoc → strict-build → rsync в ~/srv/wordpdf-docs
|
||||||
|
```
|
||||||
|
|
||||||
|
`docs-deploy` выполняет фиксированный порядок: `mvn javadoc:javadoc` → копия
|
||||||
|
`wordpdf-core/target/site/apidocs` → `docs/apidocs` → `mkdocs build --strict` →
|
||||||
|
`rsync -a --delete site/ ~/srv/wordpdf-docs/`. **Рестарт сервиса не нужен** —
|
||||||
|
nginx раздаёт файлы с смонтированного тома. Strict-сборка ловит битые ссылки и
|
||||||
|
страницы вне `nav`.
|
||||||
|
|
||||||
|
Dev-цикл: `./mise.sh run docs-serve` → `http://127.0.0.1:8000/` (live-reload).
|
||||||
|
|
||||||
|
## Сервис отдачи
|
||||||
|
|
||||||
|
Rootless podman (nginx-контейнер) под user-systemd (`linger=yes`). Юнит
|
||||||
|
`~/.config/systemd/user/wordpdf-docs.service` (вне git; канон текста — здесь):
|
||||||
|
|
||||||
|
```ini
|
||||||
|
[Unit]
|
||||||
|
Description=Word PDF — сайт документации (nginx static, :9012)
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
# podman run без -d — foreground, systemd видит основной процесс
|
||||||
|
ExecStart=/usr/bin/podman run --name wordpdf-docs --replace -p 9012:80 -v /home/pjandro/srv/wordpdf-docs:/usr/share/nginx/html:ro docker.io/library/nginx:alpine
|
||||||
|
ExecStopPost=/usr/bin/podman rm -f wordpdf-docs
|
||||||
|
Restart=on-failure
|
||||||
|
RestartSec=5
|
||||||
|
TimeoutStopSec=30
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=default.target
|
||||||
|
```
|
||||||
|
|
||||||
|
Разовая установка (на хосте `192.168.88.23`):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
podman pull docker.io/library/nginx:alpine
|
||||||
|
install -d /home/pjandro/srv/wordpdf-docs
|
||||||
|
systemctl --user daemon-reload
|
||||||
|
systemctl --user enable --now wordpdf-docs.service
|
||||||
|
```
|
||||||
|
|
||||||
|
Проверка/управление:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
systemctl --user status wordpdf-docs.service
|
||||||
|
journalctl --user -u wordpdf-docs.service -n 50
|
||||||
|
curl -sf -o /dev/null -w '%{http_code}\n' http://127.0.0.1:9012/
|
||||||
|
```
|
||||||
|
|
||||||
|
Порт 9012: соседние 9010/9011 заняты стендами конвертера (конвенция сети), 8000 —
|
||||||
|
dev-preview. Наружу (wan) не публикуем; наружный nginx `pjandro.ru` при желании
|
||||||
|
добавит владелец сервера отдельно.
|
||||||
|
|
||||||
|
## Почему не Gitea Pages
|
||||||
|
|
||||||
|
Публиковать на инстансе `git.pjandro.ru` (Gitea 1.26.4) проверенным способом «Pages»
|
||||||
|
нельзя — встроенного Pages в этой сборке нет:
|
||||||
|
|
||||||
|
- в swagger инстанса отсутствует эндпоинт `/repos/{owner}/{repo}/pages`,
|
||||||
|
в config cheat sheet — `ENABLE_PAGES`/`PAGES_DOMAIN`;
|
||||||
|
- FAQ инстанса: «Gitea doesn't provide a built-in Pages server»;
|
||||||
|
- в Gitea Actions игнорируется `jobs.*.environment`, не поддерживаются scopes
|
||||||
|
`pages`/`deployments`; тандем `upload-pages-artifact` + `deploy-pages`
|
||||||
|
неработоспособен (`upload-artifact@v4` не поддерживается, `@v3` подвешивается).
|
||||||
|
|
||||||
|
Поэтому публикация — локальная задача `docs-deploy` на том же хосте, где живёт
|
||||||
|
сервис; CI не участвует (docs-файлы не требуют гейтов).
|
||||||
|
|
||||||
|
## Что входит в сайт / не входит
|
||||||
|
|
||||||
|
В сайт попадают все страницы `docs/`, **кроме** `docs/agent/`, `docs/standards/`
|
||||||
|
и `docs/requirements.txt` (`exclude_docs` в `mkdocs.yml`) — это внутренние
|
||||||
|
справочники и спецификации, на них ведут внешние ссылки на Gitea
|
||||||
|
([Внутренние справочники](../internal-guides.md)). Каталог `docs/apidocs/`
|
||||||
|
(gitignored) заполняется задачей `docs-deploy` и копируется mkdocs как статика.
|
||||||
@@ -0,0 +1,61 @@
|
|||||||
|
# Стенды и топология
|
||||||
|
|
||||||
|
Наружу публикуется **только nginx-gateway**; контейнер `app` (:8080) наружу не
|
||||||
|
выставляется никогда. Порты стендов зафиксированы конвенцией сети.
|
||||||
|
|
||||||
|
|Стенд|Файл|Вход|Ключ доступа|springdoc|
|
||||||
|
|---|---|---|---|---|
|
||||||
|
|prod|`docker-compose.yml` (рендерится CI)|`https://pjandro.ru/pdf-converter/`|обязателен (Gitea Secret)|открыт|
|
||||||
|
|prod-like (локально)|`compose.yml`|`http://localhost:9010/`|fail-closed: `.env` с `WORDPDF_API_KEY`|выключен env-ами|
|
||||||
|
|dev|`compose.dev.yml`|`http://<LAN-IP>:9011/`|выключен|включён|
|
||||||
|
|без контейнеров|`java -jar` + `npm run dev`|`:8080` + `:5173`|выключен|включён|
|
||||||
|
|
||||||
|
## Gateway (prod-like/dev)
|
||||||
|
|
||||||
|
`gateway/nginx.conf`: `client_max_body_size 100m`, таймауты прокси 300 с,
|
||||||
|
`resolver` привязан literal-ом к шлюзу docker-сети стенда (10.113.0.1 / 10.112.0.1 —
|
||||||
|
не путать при копировании).
|
||||||
|
|
||||||
|
Маршруты:
|
||||||
|
|
||||||
|
|Location|Куда|
|
||||||
|
|---|---|
|
||||||
|
|`/api/`|`app:8080` (URI передаётся как есть)|
|
||||||
|
|`/swagger-ui`, `/v3/api-docs`, `/actuator`|`app:8080`|
|
||||||
|
|`/` (остальное)|`web` — чистая статика SPA|
|
||||||
|
|
||||||
|
`proxy_pass` через переменную + `resolver` — чтобы DNS-имя контейнера резолвилось
|
||||||
|
на каждый запрос, а не один раз при старте nginx.
|
||||||
|
|
||||||
|
## Подъём
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# dev (:9011) — «тестовый сервер» проекта
|
||||||
|
podman-compose -f compose.dev.yml up -d --build --force-recreate
|
||||||
|
|
||||||
|
# prod-like (:9010) — нужен .env с WORDPDF_API_KEY (fail-closed), шаблон .env.example
|
||||||
|
cp .env.example .env # WORDPDF_API_KEY: openssl rand -hex 32
|
||||||
|
podman-compose up -d --build
|
||||||
|
```
|
||||||
|
|
||||||
|
!!! warning "--force-recreate"
|
||||||
|
Без него podman-compose пересоберёт образ, но контейнеры оставит на старом —
|
||||||
|
будет крутиться jar прошлой сборки.
|
||||||
|
|
||||||
|
## Прод
|
||||||
|
|
||||||
|
Прод-стек (`docker-compose.yml` + прод `nginx.conf`) **не хранится ни на хосте, ни в
|
||||||
|
репозитории** — job `deploy` в CI рендерит их из Gitea Variables (ключ — из Secret,
|
||||||
|
на диск не пишется), затем pull/`up -d --force-recreate`/health-гейты/автооткат.
|
||||||
|
Копии прод-конфигов на хосте/в репо — нарушение конвенции. Подробности —
|
||||||
|
[Деплой](deployment.md).
|
||||||
|
|
||||||
|
## Порты (конвенция)
|
||||||
|
|
||||||
|
|Порт|Кто|
|
||||||
|
|---|---|
|
||||||
|
|9010|prod-like gateway|
|
||||||
|
|9011|dev gateway|
|
||||||
|
|9012|сайт документации (nginx static, [Docs-сайт](docs-site.md))|
|
||||||
|
|8080|`java -jar` бэкенд (только localhost)|
|
||||||
|
|5173|vite dev-сервер SPA|
|
||||||
@@ -0,0 +1,74 @@
|
|||||||
|
# Troubleshooting
|
||||||
|
|
||||||
|
Симптом → причина → действие. Только подтверждённое поведение стендов.
|
||||||
|
|
||||||
|
## 401 «Ключ доступа не передан или неверен»
|
||||||
|
|
||||||
|
- Забыт заголовок `X-API-Key` / ключ не совпадает со `WORDPDF_API_KEY` сервера.
|
||||||
|
- Prod-like стенд не поднимается без `.env` — это fail-closed (`${WORDPDF_API_KEY:?}`),
|
||||||
|
не баг.
|
||||||
|
- Запрос идёт через точечный сегмент (`/actuator/../api/...`) — открытые префиксы
|
||||||
|
с `..`/`%2e` ключем не обходятся, так и задумано.
|
||||||
|
- Фронт: экран ключа не появляется, хотя сервер его требует? Проверьте, что
|
||||||
|
`probeApiKey()` дошёл до сервера (network-вкладка); ключ из localStorage
|
||||||
|
стирается при 401.
|
||||||
|
|
||||||
|
## 422 «Конвертация отменена: … найдены диаграммы/SmartArt/OLE-объекты»
|
||||||
|
|
||||||
|
Не ошибка — сработал включённый error-флаг запроса. Снимите `errorOnCharts`/
|
||||||
|
`errorOnSmartArt`/`errorOnOle` (по умолчанию выключены). На `.doc` флаги не
|
||||||
|
срабатывают в принципе (плейсхолдеры — растры).
|
||||||
|
|
||||||
|
## 503
|
||||||
|
|
||||||
|
Очередь конвертации (16 мест) полна: воркер один, все конвертации сериализованы.
|
||||||
|
Повторите позже. Систематически — увеличивайте время ответа вниз (документы
|
||||||
|
поменьше) или масштабируйте количество экземпляров за балансировщиком (каждый
|
||||||
|
со своей очередью).
|
||||||
|
|
||||||
|
## 504
|
||||||
|
|
||||||
|
Конвертация дольше `wordpdf.convert-timeout` (2m). Уменьшите документ (много
|
||||||
|
больших растров/диаграмм) или поднимите таймаут серверу. Учтите: отменённая
|
||||||
|
конвертация дожигается, следующий запрос ждёт её в очереди.
|
||||||
|
|
||||||
|
## 413
|
||||||
|
|
||||||
|
Тело больше контейнерного потолка multipart (100 МБ) или nginx `client_max_body_size
|
||||||
|
100m` — обе границы стоят 100 МБ. Логический лимит входа (`wordpdf.max-mb`, дефолт
|
||||||
|
5 МБ) отсекает раньше и даёт 400, так что 413 — это когда серверный лимит поднят
|
||||||
|
выше 100 МБ бессмысленно либо запрос идёт мимо ожидаемого пути. Файл реально меньше,
|
||||||
|
но 413? Проверьте, не режет ли промежуточный прокси.
|
||||||
|
|
||||||
|
## В PDF напечатано «...TO HIDE THESE MESSAGES...»
|
||||||
|
|
||||||
|
В classpath нет SLF4J-провайдера — docx4j пишет предупреждения прямо в PDF.
|
||||||
|
Для библиотеки: оставить `slf4j-simple` (в транзитивах `wordpdf-core`) или принести
|
||||||
|
свой провайдер. Для app: `slf4j-simple` исключён в пользу logback — если логическая
|
||||||
|
конфигурация app сломана и SLF4J не инициализирован, верните провайдер.
|
||||||
|
|
||||||
|
## Картинки диаграмм «мыльные» (ресемпл)
|
||||||
|
|
||||||
|
Нарушен контракт префикса media-частей `/word/media/chart-*`: по нему
|
||||||
|
`ChartImageHandler` отключает пересжатие PNG в FOP. Если части переименованы
|
||||||
|
ручной правкой — верните префикс (`DrawingPreRenderer.CHART_MEDIA_URI_PREFIX`).
|
||||||
|
|
||||||
|
## Вместо знаков — `#` или пустые боксы
|
||||||
|
|
||||||
|
- `#` — глифа нет ни в шрифте ранa, ни в fallback, и не сработала резка по покрытию
|
||||||
|
(для docx-пута это регрессия — заведите issue с документом).
|
||||||
|
- Пустой бокс `.notdef` для U+2188/U+218A — известное ограничение OFL-бандла, не чинится.
|
||||||
|
- «Битый»/подменённый шрифт в целом — проверьте алиасы (`Calibri→Carlito` и т.д.,
|
||||||
|
[Шрифты](../architecture/fonts.md)): подмена метрически совместима и ожидаема.
|
||||||
|
|
||||||
|
## Стенд крутит старый код после пересборки
|
||||||
|
|
||||||
|
podman-compose пересобрал образ, но контейнеры остались на старом — перезапустите
|
||||||
|
с `--force-recreate` ([Стенды](stack.md)).
|
||||||
|
|
||||||
|
## `.doc` не конвертируется (400)
|
||||||
|
|
||||||
|
Проверьте сигнатуру: `D0 CF 11 E0 A1 B1 1A E1`. Word 6–95 и зашифрованные (Office 95
|
||||||
|
password) документы мостом не поддерживаются → 400/`ValidationException`. Расширение
|
||||||
|
`.doc` при zip-содержимом (переименованный docx) маршрутизируется по байтам — это
|
||||||
|
не ошибка.
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
mkdocs-material==9.8.2
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
# Нормативная документация форматов Office
|
||||||
|
|
||||||
|
Источник истины по форматам документов, которые принимает конвертер (`.docx`/`.doc`), и по соседним форматам того же семейства (`.xlsx`/`.xls`, `.pptx`/`.ppt`). Правило репозитория: любое решение про уже существующий формат — по спецификациям отсюда, а не по памяти или догадкам; ссылка на спецификацию — **с номером секции** (см. `AGENTS.md` «Documentation FIRST»).
|
||||||
|
|
||||||
|
### Формат → директория
|
||||||
|
|
||||||
|
|Формат|Специфика формата|Общее окружение|
|
||||||
|
|---|---|---|
|
||||||
|
|`.doc` (Word 97–2003, бинарный OLE2)|`doc/` ([MS-DOC])|`binary/` (CFB-контейнер, OLEPS-метаданные, ODRAW-рисунки, OFFCRYPTO, OVBA, WMF/EMF; общие типы — [MS-OSHARED] в `binary/`)|
|
||||||
|
|`.docx` (Word OOXML)|`docx/` (валидатор фикстур)|`ooxml/` (ECMA-376 Part 1 §17 WordprocessingML + XSD; [MS-OI29500], [MS-ODRAWXML])|
|
||||||
|
|`.xls` (Excel 97–2003, бинарный OLE2)|`xls/` ([MS-XLS])|`binary/` (то же окружение, что у .doc)|
|
||||||
|
|`.xlsx` (Excel OOXML)|`xlsx/` ([MS-XLSX])|`ooxml/` (ECMA-376 Part 1 §18 SpreadsheetML + `sml.xsd`; [MS-OI29500], [MS-ODRAWXML])|
|
||||||
|
|`.ppt` (PowerPoint 97–2003, бинарный OLE2)|`ppt/` ([MS-PPT])|`binary/` (то же окружение, что у .doc)|
|
||||||
|
|`.pptx` (PowerPoint OOXML)|`pptx/` (навигатор: MS-расширения для .pptx не публикуется)|`ooxml/` (ECMA-376 Part 1 §13 — части PresentationML, §19 — Reference Material + `pml.xsd`; [MS-OI29500], [MS-ODRAWXML])|
|
||||||
|
|
||||||
|
Схемы ECMA-376 покрывают PowerPoint полностью: части пакета — §13, элементы — §19 (оба в PDF и `ecma376-part1-5th.md` в `ooxml/`), специфика бинарного .ppt — [MS-PPT] в `ppt/`; отдельного MS-документа-расширения для .pptx Microsoft не публикует (`[MS-PPTX]` — 404, `[MS-PPTSB]` снят с публикации).
|
||||||
|
|
||||||
|
### Как искать по номеру секции
|
||||||
|
|
||||||
|
|Семейство файлов|Что искать|Как|
|
||||||
|
|---|---|---|
|
||||||
|
|`doc/ms-doc.md`, `xls/ms-xls.md`|номер вида §2.9.38|заголовки в теле без номеров (автонумерация Word теряется при конвертации) — грепом по строкам оглавления: `grep -n "^\[2\.9\.38 " doc/ms-doc.md`, `grep -n "^\[2\.4\.21 " xls/ms-xls.md`|
|
||||||
|
|`ooxml/ecma376-part1-5th.md`|номер вида §18.3.1.53|по нумерованным заголовкам в теле: `grep -n "^18\.3\.1" ooxml/ecma376-part1-5th.md` (пример строки: `18.3.1.53 is (Rich Text Inline)`)|
|
||||||
|
|`ooxml/ms-oi29500.md`|комментарий Office к Part 1|указатели вида `§2.17.3.3.13` (→ Part 1 §17.3.3.13)|
|
||||||
|
|`binary/*.md`, `xlsx/ms-xlsx.md`|номер вида §2.2|тот же приём оглавления: `grep -n "^\[2\.2 " xlsx/ms-xlsx.md`|
|
||||||
|
|`ppt/ms-ppt.md`|номер вида §2.9.42 или имя записи|оглавление даёт пару «номер → якорь»: `grep -n "^\[2\.9\.42 " ppt/ms-ppt.md`; заголовки в теле без номеров, но названы именем типа: `grep -n "^#\+ TextCharsAtom" ppt/ms-ppt.md`|
|
||||||
|
|
||||||
|
### Конвенции
|
||||||
|
|
||||||
|
- Первичен оригинал — `.docx`/`.pdf` в таблицах «Источники»; `.md` — производные извлечения, их SHA-256 справочные (сменишь инструмент — сменится SHA).
|
||||||
|
- Регенерация — dated `.docx` с CDN (два хоста: у office_protocols-документов путь с сегментом `/files/`, у windows_protocols — без) + `pandoc -t gfm-raw_html --wrap=none`; плейсхолдеры `[TABLE]` (packet diagram'ы) и «full»-конверты с HTML-таблицами (`-t gfm`) описаны в README'ах каталогов. Исключение: `ppt/ms-ppt.md` сразу делается `-t gfm` — packet diagram'ы там сохранены HTML-таблицами, `[TABLE]` нет, «full»-файл не заведён.
|
||||||
|
- ECMA-376 `.md` — из PDF (`pdftotext -layout` + постобработка), XSD — из официальных ECMA-архивов: `ooxml/README.md`.
|
||||||
|
- Валидация `.docx`-фикстур по transitional-XSD — `docx/validate-fixtures.py`, см. `docx/README.md`.
|
||||||
@@ -0,0 +1,61 @@
|
|||||||
|
# Нормативная документация общего OLE2-окружения (.doc/.xls/.ppt)
|
||||||
|
|
||||||
|
Справочный комплект вокруг бинарных форматов Office 97–2003: контейнер и его служебные потоки (CFB, property sets, OfficeArt-рисунки, шифрование, VBA, метафайлы) общие для Word, Excel и PowerPoint — правки по документам ниже, а не по догадкам. Специфика форматов: Word — `../doc/README.md` ([MS-DOC]), Excel — `../xls/README.md` ([MS-XLS]), PowerPoint — `../ppt/README.md` ([MS-PPT]). Документация OOXML — `../ooxml/README.md`.
|
||||||
|
|
||||||
|
SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (poppler/pandoc), при регенерации другим инструментом могут измениться; первичен docx в таблице «Источники».
|
||||||
|
|
||||||
|
Метка `[TABLE]` в `.md` — таблицы битовых макетов (packet diagram) со span-ячейками: конверсионная команда `-t gfm-raw_html` отключает HTML-fallback pandoc, и такие таблицы не выразимы в GFM; все поля описаны текстом сразу за плейсхолдером.
|
||||||
|
|
||||||
|
### Источники
|
||||||
|
|
||||||
|
|Файл|Документ|Редакция/дата|URL|SHA-256|
|
||||||
|
|---|---|---|---|---|
|
||||||
|
|`ms-cfb.md`|[MS-CFB] «Compound File Binary File Format» — OLE2-контейнер .doc/.xls (заголовок, FAT/MiniFAT, directory entries, потоки)|13.0 (261026, октябрь 2026)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-CFB/%5bMS-CFB%5d-261026.docx|`84d0f9f282aa00dac631a575514264b6bc1f3cec1b9c8fed095e12f7cc042913`|
|
||||||
|
|`ms-oshared.md`|[MS-OSHARED] «Office Common Data Types and Objects Structures» — общие типы MS-DOC/MS-PPT/MS-XLS (MSONFC/FilePointer/FixedPoint, тулбары TBC, property sets, RefEdit, VBA-подпись)|11.1 (251113, ноябрь 2025)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OSHARED/%5bMS-OSHARED%5d-251113.docx|`ccac510af0266a0804f6a242b08bc4df2f6d1f5b27935c113609b4faf198cb57`|
|
||||||
|
|`ms-odraw.md`|[MS-ODRAW] «Office Drawing Binary File Format» — бинарные рисунки OfficeArt (картинки/фигуры внутри .doc/.xls)|12.4 (250819, август 2025)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-ODRAW/%5bMS-ODRAW%5d-250819.docx|`f7b9b19222ca8b22ab773846a0c7ff4fa1898e391fff1b3ce41ca3b528f36cf6`|
|
||||||
|
|`ms-oleps.md`|[MS-OLEPS] «Object Linking and Embedding (OLE) Property Set Data Structures» — метаданные-потоки `\x05SummaryInformation`/`\x05DocumentSummaryInformation`|9.0 (240423, апрель 2024)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-OLEPS/%5bMS-OLEPS%5d-240423.docx|`ff255baa60ef6002a62f632ffc71e7c0cb0d7a72273d844e85efb97557c0e107`|
|
||||||
|
|`ms-offcrypto.md`|[MS-OFFCRYPTO] «Office Document Cryptography Structure» — шифрование документов (CryptoAPI-обёртка .doc/.xls, agile .docx/.xlsx)|14.0 (260217, февраль 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OFFCRYPTO/%5bMS-OFFCRYPTO%5d-260217.docx|`70836fa126b785efcc4e223480bd938e57c45799129d47ef6c8c3524a5a1dfdf`|
|
||||||
|
|`ms-ovba.md`|[MS-OVBA] «Office VBA File Format Structure» — VBA-проект (макросы) в CFB-потоках|15.0 (260519, май 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OVBA/%5bMS-OVBA%5d-260519.docx|`a9c32389ff0f03341f73a141f14269f7aae71c35af8c375e37be0cb013e706af`|
|
||||||
|
|`ms-wmf.md`|[MS-WMF] «Windows Metafile Format» — записи метафайла (встраиваемые картинки .doc/.xls)|18.0 (240423, апрель 2024)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-WMF/%5bMS-WMF%5d-240423.docx|`f7fc5dfb2ffa671c81badea2a983b62c215bb10aad4fc1d04d6d9ff3df00a262`|
|
||||||
|
|`ms-emf.md`|[MS-EMF] «Enhanced Metafile Format» — записи расширенного метафайла|18.0 (240423, апрель 2024)|https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net/MS-EMF/%5bMS-EMF%5d-240423.docx|`dcb97229d0201556c3f21b07f32388363a80348f0ce87fbe308e4b3048a29c3f`|
|
||||||
|
|
||||||
|
### Что где искать
|
||||||
|
|
||||||
|
- **Контейнер .doc/.xls (OLE2/CFB)** — `ms-cfb.md`: §2.2 Compound File Header (сигнатура `D0 CF 11 E0 A1 B1 1A E1` — предикат бинарного входа в `WordPdfValidator`), §2.3–2.5 FAT/Mini FAT/DIFAT-секторы, §2.6 Directory Sectors — где лежат потоки `WordDocument`/`1Table` (MS-DOC §2.1) и `Workbook` (MS-XLS §2.1.7.20). Тот же контейнер образуют шифрованные OOXML-файлы (`EncryptedPackage`-поток, MS-OFFCRYPTO §2.3.4.4).
|
||||||
|
- **Общие типы Office** — `ms-oshared.md`: §2.2 Data Types (MSONFC §2.2.1.3, FilePointer, FixedPoint), §2.3 Common Objects (Toolbar Customization §2.3.1, VBA Digital Signature §2.3.2 — `WordSignBlob`, Property Set Storage §2.3.3, RefEdit Control §2.3.5) — за этим, а не за форматом конкретного файла, MS-DOC и MS-XLS цитируют MS-OSHARED.
|
||||||
|
- **Рисунки OfficeArt (и .doc, и .xls)** — `ms-odraw.md`: §2.2 записи OfficeArt: корень файла `OfficeArtDggContainer` §2.2.12, `OfficeArtSpContainer` §2.2.14, BLIP-картинки §2.2.23–2.2.30; MS-DOC отсылает сюда за содержимым `Data`-потока рисунков, MS-XLS — за картинками/объектами листов.
|
||||||
|
- **Метаданные .doc/.xls** — `ms-oleps.md`: §2.20 PropertySet, §2.21 PropertySetStream, §2.23 имена потоков/хранилищ, §2.25 Well-Known Property Set Formats — аналог `docProps/core|app.xml` для OOXML (заголовок, автор, счётчики страниц — кэш PageCount в мосте .doc).
|
||||||
|
- **Шифрование** — `ms-offcrypto.md`: §2.3.5 Office Binary Document RC4 CryptoAPI (обёртка .doc/.xls), §2.3.4 ECMA-376 Document Encryption (Standard/Extensible = agile, `EncryptedPackage` §2.3.4.4); шифрованный вход нечитаем — распознавание по CFB-потокам `EncryptedStream` (в .doc) и `encryption` (в .xls — MS-XLS §2.1.7.6).
|
||||||
|
- **Макросы (VBA)** — `ms-ovba.md`: §2.2 File Structure (корневое хранилище `_VBA_PROJECT_CUR` §2.2.1, `_VBA_PROJECT`-поток §2.2.3, `dir`-поток §2.2.4, модули §2.2.5), §2.4.1 сжатие, §2.4.3 Data Encryption (обфускация модулей) — что пропускать при разборе .doc/.xls (в .xls хранилище — MS-XLS §2.1.7.18).
|
||||||
|
- **Метафайлы-картинки** — `ms-wmf.md` / `ms-emf.md`: §2.3 записи (WMF/EMF — один и тот же набор типов записей, EMF расширенный); частый формат inline-изображений в бинарных документах (BLIP-типы `OfficeArtBlipWMF`/`OfficeArtBlipEMF` §2.2.24–2.2.25 MS-ODRAW).
|
||||||
|
|
||||||
|
### Регенерация
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Окружение — dated-.docx с лендингов (при 404 — самый свежий из таблицы
|
||||||
|
# «Published Version»). Два CDN: у windows_protocols-документов (CFB, OLEPS,
|
||||||
|
# WMF, EMF) путь БЕЗ сегмента /files/.
|
||||||
|
O="https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files"
|
||||||
|
W="https://winprotocoldocs-bhdugrdyduf5h2e4.b02.azurefd.net"
|
||||||
|
curl -sSL -o /tmp/ms-cfb.docx "$W/MS-CFB/%5bMS-CFB%5d-261026.docx"
|
||||||
|
curl -sSL -o /tmp/ms-oshared.docx "$O/MS-OSHARED/%5bMS-OSHARED%5d-251113.docx"
|
||||||
|
curl -sSL -o /tmp/ms-odraw.docx "$O/MS-ODRAW/%5bMS-ODRAW%5d-250819.docx"
|
||||||
|
curl -sSL -o /tmp/ms-oleps.docx "$W/MS-OLEPS/%5bMS-OLEPS%5d-240423.docx"
|
||||||
|
curl -sSL -o /tmp/ms-offcrypto.docx "$O/MS-OFFCRYPTO/%5bMS-OFFCRYPTO%5d-260217.docx"
|
||||||
|
curl -sSL -o /tmp/ms-ovba.docx "$O/MS-OVBA/%5bMS-OVBA%5d-260519.docx"
|
||||||
|
curl -sSL -o /tmp/ms-wmf.docx "$W/MS-WMF/%5bMS-WMF%5d-240423.docx"
|
||||||
|
curl -sSL -o /tmp/ms-emf.docx "$W/MS-EMF/%5bMS-EMF%5d-240423.docx"
|
||||||
|
for n in ms-cfb ms-oshared ms-odraw ms-oleps ms-offcrypto ms-ovba ms-wmf ms-emf; do
|
||||||
|
pandoc "/tmp/$n.docx" -t gfm-raw_html --wrap=none -o "docs/standards/binary/$n.md"
|
||||||
|
done
|
||||||
|
|
||||||
|
# Лендинги (свежий dated .docx — в таблице «Published Version»):
|
||||||
|
# MS-CFB https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-cfb/53989ce4-7b05-4f8d-829b-d08d6148375b
|
||||||
|
# MS-OSHARED https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-oshared/d93502fa-5b8f-4f47-a3fe-5574046f4b8d
|
||||||
|
# MS-ODRAW https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-odraw/8560795e-7759-4745-838f-f7f2ef2f1872
|
||||||
|
# MS-OLEPS https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-oleps/bf7aeae8-c47a-4939-9f45-700158dac3bc
|
||||||
|
# MS-OFFCRYPTO https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-offcrypto/3c34d72a-1a61-4b52-a893-196f9157f083
|
||||||
|
# MS-OVBA https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-ovba/575462ba-bf67-4190-9fac-c275523c75fc
|
||||||
|
# MS-WMF https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-wmf/4813e7fd-52d0-4f42-965f-228c8b7488d2
|
||||||
|
# MS-EMF https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-emf/91c257d7-c39d-4a36-9b1f-63e3f73d30ca
|
||||||
|
```
|
||||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because one or more lines are too long
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,34 @@
|
|||||||
|
# Нормативная документация бинарного .doc (Word 97–2003)
|
||||||
|
|
||||||
|
Справочный комплект формата бинарного .doc: источник истины по его потокам и структурам (FIB, CHPX/PAPX, piece table, TAP/секции, колонтитуки) — правки по документам ниже, а не по догадкам. Конвертер принимает .doc через собственный мост `internal/doc` — всё здесь нормативно для моста. Общее OLE2-окружение (CFB-контейнер, property sets, OfficeArt, шифрование, VBA, метафайлы, общие типы MS-OSHARED) — `../binary/README.md`; документация OOXML — `../ooxml/README.md`.
|
||||||
|
|
||||||
|
SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (poppler/pandoc), при регенерации другим инструментом могут измениться; первичен docx в таблице «Источники».
|
||||||
|
|
||||||
|
Метка `[TABLE]` в `.md` — таблицы битовых макетов (packet diagram) со span-ячейками: конверсионная команда `-t gfm-raw_html` отключает HTML-fallback pandoc, и такие таблицы не выразимы в GFM; все поля описаны текстом сразу за плейсхолдером (одинаково во всех файлах, включая `ms-doc.md`).
|
||||||
|
|
||||||
|
### Источники
|
||||||
|
|
||||||
|
|Файл|Документ|Редакция/дата|URL|SHA-256|
|
||||||
|
|---|---|---|---|---|
|
||||||
|
|`ms-doc.md`|[MS-DOC] «Word (.doc) Binary File Format» — бинарный формат .doc Word 97–2003 (WordDocument/1Table-потоки, FIB, CHPX/PAPX, Clx/PlcPcd/Pcd — «piece table»)|12.5 (260217, февраль 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-DOC/%5bMS-DOC%5d-260217.docx|`c2886120e92aa2790a5603156fb0ca8b23151d58476592fef3ede7fb6841ee7d`|
|
||||||
|
|`ms-doc-full.md`|Тот же [MS-DOC] 12.5, полный конверт **с** HTML-packet-diagram'ами (`-t gfm`, raw_html включён): битовые макеты §2.4/§2.6/§2.9 и таблицы sprm §2.6.1–2.6.3 — то, что в `ms-doc.md` свёрнуто в `[TABLE]`|12.5 (260217, февраль 2026)|тот же dated-.docx, что `ms-doc.md`|`35cbcd5b5228cf02200008c2145d941e66dbf8a9e296305745d2bdc099c8a5ad`|
|
||||||
|
|`ms-doc.docx`|Оригинальный dated-.docx [MS-DOC] 12.5 (первичный источник двух `.md`-конвертов)|12.5 (260217)|тот же URL, что `ms-doc.md`|—|
|
||||||
|
|
||||||
|
### Что где искать
|
||||||
|
|
||||||
|
- **Бинарный .doc (Word 97–2003)** — `ms-doc.md`: §2.1 File Structure (WordDocument-, 1Table/0Table-, Data-потоки), §2.5 FIB (FibBase, флага), §2.8–2.9 структуры данных (Chpx §2.9.32, PapxFkp, Grpprl, Clx §2.9.38, PlcPcd §2.8.35, Pcd), §3 Structure Examples, §6 Change Tracking; поиск по номерам секций — по строкам оглавления вида `[2.9.38 Clx …]` (заголовки в теле без номеров — автонумерация Word потерялась при извлечении).
|
||||||
|
|
||||||
|
### Регенерация
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# ms-doc.md — свежий dated-.docx [MS-DOC] с лендинга
|
||||||
|
# https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-doc/ccd7b486-7881-484c-a137-51170af7cc22
|
||||||
|
curl -sSL -o /tmp/msdoc.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-DOC/%5bMS-DOC%5d-260217.docx"
|
||||||
|
pandoc /tmp/msdoc.docx -t gfm-raw_html --wrap=none -o docs/standards/doc/ms-doc.md
|
||||||
|
|
||||||
|
# ms-doc-full.md — тот же dated-.docx, но raw_html ВКЛЮЧЁН: packet diagram'ы и
|
||||||
|
# таблицы sprm (§2.6.1–2.6.3) остаются HTML-таблицами вместо [TABLE]-плейсхолдеров.
|
||||||
|
pandoc /tmp/msdoc.docx -t gfm --wrap=none -o docs/standards/doc/ms-doc-full.md
|
||||||
|
|
||||||
|
# Обновлённый dated-.docx при этом перекладывается в ms-doc.docx (первичный источник).
|
||||||
|
```
|
||||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,32 @@
|
|||||||
|
# Документация формата .docx в этом репозитории
|
||||||
|
|
||||||
|
Здесь — только специфика WordprocessingML-пайплайна этого репозитория: нормативная база OOXML (ECMA-376 Part 1 §17, XSD `wml.xsd`, комментарии Word [MS-OI29500], расширения [MS-ODRAWXML]) живёт в `../ooxml/README.md` — там же таблицы «Источники» с SHA и команды регенерации. Нормативная база моста .doc — `../doc/README.md` + `../binary/README.md`.
|
||||||
|
|
||||||
|
### Источники
|
||||||
|
|
||||||
|
|Файл|Документ|Редакция/дата|URL|SHA-256|
|
||||||
|
|---|---|---|---|---|
|
||||||
|
|`validate-fixtures.py`|Валидатор `.docx`-фикстур (lxml + переходные XSD из `../ooxml/schema/transitional/`)|—|—|—|
|
||||||
|
|
||||||
|
### Что где искать
|
||||||
|
|
||||||
|
- **Нормативная разметка .docx** (`w:r`/`w:t`, таблицы §17.4, `w:position` §17.3.2.24, `mc:AlternateContent` §15.2.15, `xml:space` §5.1.2) — `../ooxml/ecma376-part1-5th.md` и `../ooxml/schema/transitional/wml.xsd`; поведение Word — `../ooxml/ms-oi29500.md`.
|
||||||
|
- **Диаграммы/SmartArt/пресет-геометрия** — `../ooxml/README.md` (§21.2/§21.3/§21.4, Annex D).
|
||||||
|
- **Валидация фикстур** — см. ниже.
|
||||||
|
|
||||||
|
### Валидация фикстур
|
||||||
|
|
||||||
|
`samples/*.docx` обязаны быть ECMA-conformant (фикстуры — источник истины по входу,
|
||||||
|
код под них не подгоняется). Проверка — `docx/validate-fixtures.py` (lxml + схемы
|
||||||
|
`../ooxml/schema/transitional/`):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources/samples/*.docx
|
||||||
|
```
|
||||||
|
|
||||||
|
Допущения валидатора (оба по Part 1): `xml:space` — предопределённый атрибут
|
||||||
|
§5.1.2, схемам подмешивается импорт XML-namespace; `mc:AlternateContent`/
|
||||||
|
`mc:Ignorable` (§15.2.15) — валидируется Fallback-ветка, атрибуты и элементы
|
||||||
|
ignorable-namespace'ов снимаются. Не маппятся (вне ECMA, осознанно):
|
||||||
|
`word/charts/style*.xml`/`colors*.xml` (c14/chartStyle, MS-расширение),
|
||||||
|
`word/diagrams/drawing*.xml` (`dsp:`, [MS-ODRAWXML]).
|
||||||
Executable
+164
@@ -0,0 +1,164 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
"""Валидация XML-частей samples/*.docx против XSD ECMA-376 (transitional).
|
||||||
|
|
||||||
|
Схемы — docs/standards/ooxml/schema/transitional/ (полный набор ECMA-376 5-го изд.).
|
||||||
|
wml.xsd — word/*.xml (document/styles/settings/header/footer/...);
|
||||||
|
dml-chart.xsd — word/charts/chart*.xml; dml-diagram.xsd — word/diagrams/*;
|
||||||
|
dml-main.xsd — word/theme/theme*.xml.
|
||||||
|
|
||||||
|
Два допущения, оба по ECMA-376 Part 1:
|
||||||
|
* xml:space — wml.xsd/shared-math.xsd ссылаются на атрибут xml:space без
|
||||||
|
импорта XML-namespace (§5.1.2: xml:* — предопределённые атрибуты);
|
||||||
|
XSD-линтеру нужен явный импорт — подмешиваем xml.xsd в копию схемы в tmp.
|
||||||
|
* mc:AlternateContent (§15.2.15) — MC-элементы допускаются в любом
|
||||||
|
расширяемом содержимом и не моделируются схемой; валидируем Fallback-
|
||||||
|
ветку (Choice — расширение, необязательное для conformant-чтения).
|
||||||
|
"""
|
||||||
|
import os, re, sys, shutil, tempfile, zipfile
|
||||||
|
from lxml import etree
|
||||||
|
|
||||||
|
REPO = os.path.dirname(os.path.abspath(__file__))
|
||||||
|
SCHEMA_DIR = os.path.join(REPO, os.pardir, "ooxml", "schema", "transitional")
|
||||||
|
|
||||||
|
XML_XSD = """<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
targetNamespace="http://www.w3.org/XML/1998/namespace">
|
||||||
|
<xsd:attribute name="space"><xsd:simpleType>
|
||||||
|
<xsd:restriction base="xsd:NMTOKEN"><xsd:enumeration value="default"/>
|
||||||
|
<xsd:enumeration value="preserve"/></xsd:restriction>
|
||||||
|
</xsd:simpleType></xsd:attribute>
|
||||||
|
<xsd:attribute name="lang" type="xsd:language"/>
|
||||||
|
<xsd:attribute name="base" type="xsd:anyURI"/>
|
||||||
|
<xsd:attribute name="id" type="xsd:ID"/>
|
||||||
|
</xsd:schema>
|
||||||
|
"""
|
||||||
|
|
||||||
|
_cache = {}
|
||||||
|
_tmp = None
|
||||||
|
|
||||||
|
|
||||||
|
def tmpdir():
|
||||||
|
global _tmp
|
||||||
|
if _tmp is None:
|
||||||
|
_tmp = tempfile.mkdtemp(prefix="ecma-xsd-")
|
||||||
|
shutil.copytree(SCHEMA_DIR, _tmp, dirs_exist_ok=True)
|
||||||
|
with open(os.path.join(_tmp, "xml.xsd"), "w") as f:
|
||||||
|
f.write(XML_XSD)
|
||||||
|
for name in ("wml.xsd", "shared-math.xsd"):
|
||||||
|
p = os.path.join(_tmp, name)
|
||||||
|
s = open(p).read()
|
||||||
|
if 'schemaLocation="xml.xsd"' not in s:
|
||||||
|
if "xmlns:xml=" not in s:
|
||||||
|
s = re.sub(r"(<xsd:schema\b[^>]*)(>)",
|
||||||
|
r'\1 xmlns:xml="http://www.w3.org/XML/1998/namespace"\2', s, count=1)
|
||||||
|
s = re.sub(r"(<xsd:schema\b[^>]*>)",
|
||||||
|
r'\1<xsd:import namespace="http://www.w3.org/XML/1998/namespace"'
|
||||||
|
r' schemaLocation="xml.xsd"/>', s, count=1)
|
||||||
|
with open(p, "w") as f:
|
||||||
|
f.write(s)
|
||||||
|
return _tmp
|
||||||
|
|
||||||
|
|
||||||
|
def schema_for(name):
|
||||||
|
if re.match(r"word/(document|footnotes|endnotes|styles|settings|fontTable"
|
||||||
|
r"|webSettings|numbering|(?:header|footer)\d+)\.xml$", name):
|
||||||
|
return "wml.xsd"
|
||||||
|
if re.match(r"word/charts/chart\d+\.xml$", name):
|
||||||
|
return "dml-chart.xsd"
|
||||||
|
# drawing*.xml — dsp: (2008 diagram drawing, [MS-ODRAWXML]) — вне ECMA, не маппится.
|
||||||
|
if re.match(r"word/diagrams/(data|layout|quickStyle|colors)\d+\.xml$", name):
|
||||||
|
return "dml-diagram.xsd"
|
||||||
|
if re.match(r"word/theme/theme\d+\.xml$", name):
|
||||||
|
return "dml-main.xsd"
|
||||||
|
return None
|
||||||
|
|
||||||
|
|
||||||
|
MC = "{http://schemas.openxmlformats.org/markup-compatibility/2006}"
|
||||||
|
|
||||||
|
|
||||||
|
def strip_mc(el):
|
||||||
|
"""MC-обработка по ECMA-376 §15.2.15 перед XSD-валидацией.
|
||||||
|
|
||||||
|
* mc:AlternateContent -> mc:Fallback-дети (§15.2.15.2);
|
||||||
|
* mc:Ignorable (§15.2.15.1) — перечисленные префиксы: consumer, не
|
||||||
|
понимающий namespace, ОБЯЗАН игнорировать его атрибуты и элементы ->
|
||||||
|
снимаем атрибуты и вырезаем элементы этих namespace'ов;
|
||||||
|
* сами mc:*-атрибуты (Ignorable/Preserve/ProcessAttributes) — не часть
|
||||||
|
схемы, снимаем.
|
||||||
|
"""
|
||||||
|
ignorable = set()
|
||||||
|
for e in el.iter():
|
||||||
|
ig = e.get(f"{MC}Ignorable")
|
||||||
|
if ig:
|
||||||
|
for tok in ig.split():
|
||||||
|
ns = e.nsmap.get(tok)
|
||||||
|
if ns:
|
||||||
|
ignorable.add(ns)
|
||||||
|
for e in el.iter():
|
||||||
|
for a in list(e.attrib):
|
||||||
|
ns = a[1:a.index("}")] if a.startswith("{") else ""
|
||||||
|
if a.startswith(MC) or ns in ignorable:
|
||||||
|
del e.attrib[a]
|
||||||
|
for ns in ignorable:
|
||||||
|
for e in list(el.iter(f"{{{ns}}}*")):
|
||||||
|
parent = e.getparent()
|
||||||
|
if parent is not None:
|
||||||
|
parent.remove(e)
|
||||||
|
for ac in list(el.iter(f"{MC}AlternateContent")):
|
||||||
|
parent = ac.getparent()
|
||||||
|
if parent is None:
|
||||||
|
continue
|
||||||
|
fb = ac.find(f"{MC}Fallback")
|
||||||
|
idx = list(parent).index(ac)
|
||||||
|
parent.remove(ac)
|
||||||
|
if fb is not None:
|
||||||
|
for i, child in enumerate(list(fb)):
|
||||||
|
parent.insert(idx + i, child)
|
||||||
|
|
||||||
|
|
||||||
|
def get_schema(fname):
|
||||||
|
if fname not in _cache:
|
||||||
|
_cache[fname] = etree.XMLSchema(etree.parse(os.path.join(tmpdir(), fname)))
|
||||||
|
return _cache[fname]
|
||||||
|
|
||||||
|
|
||||||
|
def validate(docx):
|
||||||
|
problems, skipped = [], []
|
||||||
|
with zipfile.ZipFile(docx) as z:
|
||||||
|
for name in z.namelist():
|
||||||
|
if not name.endswith(".xml"):
|
||||||
|
continue
|
||||||
|
sf = schema_for(name)
|
||||||
|
if sf is None:
|
||||||
|
if name.startswith("word/") and "rels" not in name:
|
||||||
|
skipped.append(name)
|
||||||
|
continue
|
||||||
|
try:
|
||||||
|
doc = etree.fromstring(z.read(name))
|
||||||
|
except etree.XMLSyntaxError as e:
|
||||||
|
problems.append((name, f"not well-formed: {e}"))
|
||||||
|
continue
|
||||||
|
strip_mc(doc)
|
||||||
|
try:
|
||||||
|
schema = get_schema(sf)
|
||||||
|
except Exception as e:
|
||||||
|
problems.append((name, f"schema load failed: {e}"))
|
||||||
|
continue
|
||||||
|
if not schema.validate(doc):
|
||||||
|
for err in schema.error_log:
|
||||||
|
problems.append((name, f"{err.message} (line {err.line})"))
|
||||||
|
return problems, skipped
|
||||||
|
|
||||||
|
|
||||||
|
rc = 0
|
||||||
|
for docx in sys.argv[1:]:
|
||||||
|
problems, skipped = validate(docx)
|
||||||
|
print(("OK " if not problems else "FAIL ") + os.path.basename(docx)
|
||||||
|
+ (f" (без XSD: {', '.join(skipped)})" if skipped else ""))
|
||||||
|
for name, msg in problems[:40]:
|
||||||
|
print(f" {name}: {msg}")
|
||||||
|
if len(problems) > 40:
|
||||||
|
print(f" ... ещё {len(problems)-40}")
|
||||||
|
if problems:
|
||||||
|
rc = 1
|
||||||
|
sys.exit(rc)
|
||||||
File diff suppressed because one or more lines are too long
@@ -0,0 +1,53 @@
|
|||||||
|
# Нормативная документация OOXML (общая для .docx/.xlsx/.pptx)
|
||||||
|
|
||||||
|
Источник истины для chart-движка (`wordpdf-core/.../internal/chart/`), нормализаторов и любого правки OOXML-разметки: любые правки диаграмм/SmartArt/представления docx/xlsx — по документам ниже, а не по догадкам. Правило закреплено в `AGENTS.md` (секции «Chart/SmartArt-движок», «Нормализаторы»). Здесь — только кросс-форматная часть ECMA-376 и Office-комментарии; специфика WordprocessingML-пайплайна и валидация фикстур — `../docx/README.md`, SpreadsheetML-расширения Excel — `../xlsx/README.md`, PresentationML (.pptx) — `../pptx/README.md`. Документация бинарного .doc — `../doc/README.md`, бинарного .xls — `../xls/README.md`, бинарного .ppt — `../ppt/README.md`.
|
||||||
|
|
||||||
|
SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (poppler/pandoc), при регенерации другим инструментом могут измениться; первичен PDF/docx в таблице «Источники».
|
||||||
|
|
||||||
|
### Источники
|
||||||
|
|
||||||
|
|Файл|Документ|Редакция/дата|URL|SHA-256|
|
||||||
|
|---|---|---|---|---|
|
||||||
|
|`ECMA-376-1_5th_edition_december_2016.pdf`|ECMA-376 Part 1 «Fundamentals and Markup Language Reference»|5-е изд., декабрь 2016|https://ecma-international.org/wp-content/uploads/ECMA-376-1_5th_edition_december_2016.pdf|`7cccfd0ad0e2ef89316acece15e44a8a088d0603ce4bba4e7b0361b50d13a37d`|
|
||||||
|
|`ecma376-part1-5th.md`|Тот же текст, извлечённый из PDF (поиск по номерам секций)|5-е изд.|производный (см. регенерацию)|`86af445c080d9a481eaa426fc1721d50a1c4eff875535f9d03fe93d2b95b21b6`|
|
||||||
|
|`ms-oi29500.md`|[MS-OI29500] «Office Implementation Information for ISO/IEC-29500 Standards» — как Word/Excel реально пишут docx/xlsx (§2.1 — комментарий к Part 1, §3.1 — к Part 4)|260818 (август 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OI29500/%5bMS-OI29500%5d-260818.docx|`3e3eabb060a3772d096f001e7fee682fc4be12a2dd55ea360430fff14dd5845d`|
|
||||||
|
|`ms-odrawxml.md`|[MS-ODRAWXML] «Office Drawing Extensions to Office Open XML» — расширения Word/Excel для чартов (ChartEx, стили/цвета)|261006 (октябрь 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-ODRAWXML/%5bMS-ODRAWXML%5d-261006.docx|`f5a2517c4984b2ba2f0ade504bd0c9660c74f619290910a9b491c0f2ca9db64a`|
|
||||||
|
|`schema/strict/`|Полный набор XSD Strict (21 файл: `wml`/`sml`/`pml`/`dml-*`/`shared-*`)|5-е изд.|вложенный `OfficeOpenXML-XMLSchema-Strict.zip` в https://ecma-international.org/wp-content/uploads/ECMA-376-1_5th_edition_december_2016.zip|`9d0bcad9cf06054785b03762fcfadbf6bab7e54a5f9d69434e34b7fd464d4129` (zip)|
|
||||||
|
|`schema/transitional/`|Полный набор XSD Transitional (26 файлов, +5 `vml-*`)|5-е изд.|вложенный `OfficeOpenXML-XMLSchema-Transitional.zip` в https://ecma-international.org/wp-content/uploads/ECMA-376-4_5th_edition_december_2016.zip|`bd25da1109f73762356596918bf5ff8b74a1331642dba5f1c1d1dfc6bed34ecd` (zip)|
|
||||||
|
|
||||||
|
### Что где искать
|
||||||
|
|
||||||
|
- **WordprocessingML (.docx)** — ECMA-376 §17 (текст/раны/свойства — §17.3, таблицы — §17.4; например `w:position` — §17.3.2.24) + `schema/transitional/wml.xsd`.
|
||||||
|
- **SpreadsheetML (.xlsx)** — ECMA-376 §18 (§18.2 workbook, §18.3 worksheet, §18.4 styles, §18.5 sharedStrings, §18.6 drawing) + `schema/transitional/sml.xsd`, `dml-spreadsheetDrawing.xsd`; поиск: `grep -n "^18\.3\.1" ecma376-part1-5th.md`. Расширения Excel — `../xlsx/ms-xlsx.md`.
|
||||||
|
- **PresentationML (.pptx)** — части пакета: ECMA-376 §13 (§13.2 Package Structure, §13.3.6 Presentation Part, §13.3.8 Slide Part, §13.3.9 Slide Layout Part, §13.3.10 Slide Master Part…), семантика элементов `p:`: §19 «PresentationML Reference Material» (§19.2 presentation properties, §19.3 slides, §19.5 animation) + `schema/transitional/pml.xsd` (он же в `schema/strict/`); поиск: `grep -n "^13\.3\.[0-9]" ecma376-part1-5th.md`, `grep -n "^19\.3" ecma376-part1-5th.md`. Навигатор по формату — `../pptx/README.md`, бинарный .ppt — `../ppt/README.md`.
|
||||||
|
- **Диаграммы (`c:chart`)** — ECMA-376 §21.2 (`grep -n "^21.2" ecma376-part1-5th.md`; каждый элемент — секция вида `21.2.2.132 overlay (Overlay)`) + `schema/transitional/dml-chart.xsd` (он же в `schema/strict/`); расширения Word — `ms-odrawxml.md`.
|
||||||
|
- **Chart Drawings (`c:drawing`)** — ECMA-376 §21.3.
|
||||||
|
- **Диаграммы-схемы SmartArt (`dgm:`)** — ECMA-376 §21.4 + `schema/transitional/dml-diagram.xsd`. Кэш разложенной схемы (`word/diagrams/drawing1.xml`, relationship `…/office/2007/relationships/diagramDrawing`) — проприетарный MS-формат (`dsp:`, [MS-ODRAWXML]), нормативного ECMA-XSD нет; authoritative источник фактической геометрии — сам `dsp:drawing`.
|
||||||
|
- **Пресет-геометрия (`a:prstGeom`)** — ECMA-376 Annex D; машинная копия таблицы пресетов — `wordpdf-core/src/test/resources/geom/presetShapeDefinitions.xml` (синхрон пинит `PresetGeometryTest#tableMatchesEcmaXml`).
|
||||||
|
- **Поведение Office (что Word/Excel реально пишут: `w:r`/`w:t`/`lastRenderedPageBreak`, текстбоксы, чарты; комментарии и к SpreadsheetML)** — `ms-oi29500.md` (указатели на секции Part 1, напр. §2.17.3.3.13 → Part 1 §17.3.3.13).
|
||||||
|
|
||||||
|
### Регенерация
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# ecma376-part1-5th.md — из PDF в репозитории (постобработка: выбросить строки
|
||||||
|
# `^\s*\d{1,4}\s*$` (номера страниц), `^ECMA-376 Part 1\s*$` (колонтитул),
|
||||||
|
# строки с `.....` (точки оглавления); остальной текст — как есть)
|
||||||
|
pdftotext -layout docs/standards/ooxml/ECMA-376-1_5th_edition_december_2016.pdf /tmp/p1.txt
|
||||||
|
|
||||||
|
# ms-oi29500.md / ms-odrawxml.md — свежие dated-.docx с learn.microsoft.com
|
||||||
|
# (при 404 — самый свежий .docx со страниц лендингов:
|
||||||
|
# https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oi29500/1fd4a662-8623-49c0-82f0-18fa91b413b8
|
||||||
|
# https://learn.microsoft.com/en-us/openspecs/office_standards/ms-odrawxml/06cff208-c6e1-4db7-bb68-665135e5f0de)
|
||||||
|
curl -sSL -o /tmp/oi29500.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OI29500/%5bMS-OI29500%5d-260818.docx"
|
||||||
|
curl -sSL -o /tmp/odrawxml.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-ODRAWXML/%5bMS-ODRAWXML%5d-261006.docx"
|
||||||
|
pandoc /tmp/oi29500.docx -t gfm-raw_html --wrap=none -o docs/standards/ooxml/ms-oi29500.md
|
||||||
|
pandoc /tmp/odrawxml.docx -t gfm-raw_html --wrap=none -o docs/standards/ooxml/ms-odrawxml.md
|
||||||
|
|
||||||
|
# schema/strict/ и schema/transitional/ — полные наборы из официальных ECMA-архивов
|
||||||
|
curl -sSL -o /tmp/p1.zip "https://ecma-international.org/wp-content/uploads/ECMA-376-1_5th_edition_december_2016.zip"
|
||||||
|
unzip -o /tmp/p1.zip "OfficeOpenXML-XMLSchema-Strict.zip" -d /tmp/
|
||||||
|
unzip -o -d docs/standards/ooxml/schema/strict /tmp/OfficeOpenXML-XMLSchema-Strict.zip "*.xsd"
|
||||||
|
curl -sSL -o /tmp/p4.zip "https://ecma-international.org/wp-content/uploads/ECMA-376-4_5th_edition_december_2016.zip"
|
||||||
|
unzip -o /tmp/p4.zip "OfficeOpenXML-XMLSchema-Transitional.zip" -d /tmp/
|
||||||
|
unzip -o -d docs/standards/ooxml/schema/transitional /tmp/OfficeOpenXML-XMLSchema-Transitional.zip "*.xsd"
|
||||||
|
```
|
||||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because one or more lines are too long
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,144 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns:a="http://purl.oclc.org/ooxml/drawingml/main"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/drawingml/chartDrawing"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/drawingml/chartDrawing" elementFormDefault="qualified">
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/drawingml/main" schemaLocation="dml-main.xsd"/>
|
||||||
|
<xsd:complexType name="CT_ShapeNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvSpPr" type="a:CT_NonVisualDrawingShapeProps" minOccurs="1" maxOccurs="1"
|
||||||
|
/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Shape">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvSpPr" type="CT_ShapeNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="txBody" type="a:CT_TextBody" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="textlink" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fLocksText" type="xsd:boolean" use="optional" default="true"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_ConnectorNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvCxnSpPr" type="a:CT_NonVisualConnectorProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Connector">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvCxnSpPr" type="CT_ConnectorNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_PictureNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvPicPr" type="a:CT_NonVisualPictureProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Picture">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvPicPr" type="CT_PictureNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="blipFill" type="a:CT_BlipFillProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional" default=""/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GraphicFrameNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGraphicFramePr" type="a:CT_NonVisualGraphicFrameProperties"
|
||||||
|
minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GraphicFrame">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvGraphicFramePr" type="CT_GraphicFrameNonVisual" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
<xsd:element name="xfrm" type="a:CT_Transform2D" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GroupShapeNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGrpSpPr" type="a:CT_NonVisualGroupDrawingShapeProps" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GroupShape">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvGrpSpPr" type="CT_GroupShapeNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="grpSpPr" type="a:CT_GroupShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element name="sp" type="CT_Shape"/>
|
||||||
|
<xsd:element name="grpSp" type="CT_GroupShape"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicFrame"/>
|
||||||
|
<xsd:element name="cxnSp" type="CT_Connector"/>
|
||||||
|
<xsd:element name="pic" type="CT_Picture"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_ObjectChoices">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="sp" type="CT_Shape"/>
|
||||||
|
<xsd:element name="grpSp" type="CT_GroupShape"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicFrame"/>
|
||||||
|
<xsd:element name="cxnSp" type="CT_Connector"/>
|
||||||
|
<xsd:element name="pic" type="CT_Picture"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:simpleType name="ST_MarkerCoordinate">
|
||||||
|
<xsd:restriction base="xsd:double">
|
||||||
|
<xsd:minInclusive value="0.0"/>
|
||||||
|
<xsd:maxInclusive value="1.0"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Marker">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="x" type="ST_MarkerCoordinate" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="y" type="ST_MarkerCoordinate" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_RelSizeAnchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="from" type="CT_Marker"/>
|
||||||
|
<xsd:element name="to" type="CT_Marker"/>
|
||||||
|
<xsd:group ref="EG_ObjectChoices"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_AbsSizeAnchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="from" type="CT_Marker"/>
|
||||||
|
<xsd:element name="ext" type="a:CT_PositiveSize2D"/>
|
||||||
|
<xsd:group ref="EG_ObjectChoices"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_Anchor">
|
||||||
|
<xsd:choice>
|
||||||
|
<xsd:element name="relSizeAnchor" type="CT_RelSizeAnchor"/>
|
||||||
|
<xsd:element name="absSizeAnchor" type="CT_AbsSizeAnchor"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:complexType name="CT_Drawing">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:group ref="EG_Anchor" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
</xsd:schema>
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,9 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/drawingml/lockedCanvas"
|
||||||
|
xmlns:a="http://purl.oclc.org/ooxml/drawingml/main"
|
||||||
|
xmlns:r="http://purl.oclc.org/ooxml/officeDocument/relationships" elementFormDefault="qualified"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/drawingml/lockedCanvas">
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/drawingml/main" schemaLocation="dml-main.xsd"/>
|
||||||
|
<xsd:element name="lockedCanvas" type="a:CT_GvmlGroupShape"/>
|
||||||
|
</xsd:schema>
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,22 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/drawingml/picture"
|
||||||
|
xmlns:a="http://purl.oclc.org/ooxml/drawingml/main" elementFormDefault="qualified"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/drawingml/picture">
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/drawingml/main" schemaLocation="dml-main.xsd"/>
|
||||||
|
<xsd:complexType name="CT_PictureNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvPicPr" type="a:CT_NonVisualPictureProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Picture">
|
||||||
|
<xsd:sequence minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="nvPicPr" type="CT_PictureNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="blipFill" type="a:CT_BlipFillProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="pic" type="CT_Picture"/>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,184 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns:a="http://purl.oclc.org/ooxml/drawingml/main"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/drawingml/spreadsheetDrawing"
|
||||||
|
xmlns:r="http://purl.oclc.org/ooxml/officeDocument/relationships"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/drawingml/spreadsheetDrawing"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/drawingml/main" schemaLocation="dml-main.xsd"/>
|
||||||
|
<xsd:import schemaLocation="shared-relationshipReference.xsd"
|
||||||
|
namespace="http://purl.oclc.org/ooxml/officeDocument/relationships"/>
|
||||||
|
<xsd:element name="from" type="CT_Marker"/>
|
||||||
|
<xsd:element name="to" type="CT_Marker"/>
|
||||||
|
<xsd:complexType name="CT_AnchorClientData">
|
||||||
|
<xsd:attribute name="fLocksWithSheet" type="xsd:boolean" use="optional" default="true"/>
|
||||||
|
<xsd:attribute name="fPrintsWithSheet" type="xsd:boolean" use="optional" default="true"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_ShapeNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvSpPr" type="a:CT_NonVisualDrawingShapeProps" minOccurs="1" maxOccurs="1"
|
||||||
|
/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Shape">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvSpPr" type="CT_ShapeNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="txBody" type="a:CT_TextBody" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="textlink" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fLocksText" type="xsd:boolean" use="optional" default="true"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_ConnectorNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvCxnSpPr" type="a:CT_NonVisualConnectorProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Connector">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvCxnSpPr" type="CT_ConnectorNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_PictureNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvPicPr" type="a:CT_NonVisualPictureProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Picture">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvPicPr" type="CT_PictureNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="blipFill" type="a:CT_BlipFillProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional" default=""/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GraphicalObjectFrameNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGraphicFramePr" type="a:CT_NonVisualGraphicFrameProperties"
|
||||||
|
minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GraphicalObjectFrame">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvGraphicFramePr" type="CT_GraphicalObjectFrameNonVisual" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
<xsd:element name="xfrm" type="a:CT_Transform2D" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GroupShapeNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGrpSpPr" type="a:CT_NonVisualGroupDrawingShapeProps" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GroupShape">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvGrpSpPr" type="CT_GroupShapeNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="grpSpPr" type="a:CT_GroupShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element name="sp" type="CT_Shape"/>
|
||||||
|
<xsd:element name="grpSp" type="CT_GroupShape"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicalObjectFrame"/>
|
||||||
|
<xsd:element name="cxnSp" type="CT_Connector"/>
|
||||||
|
<xsd:element name="pic" type="CT_Picture"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_ObjectChoices">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="sp" type="CT_Shape"/>
|
||||||
|
<xsd:element name="grpSp" type="CT_GroupShape"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicalObjectFrame"/>
|
||||||
|
<xsd:element name="cxnSp" type="CT_Connector"/>
|
||||||
|
<xsd:element name="pic" type="CT_Picture"/>
|
||||||
|
<xsd:element name="contentPart" type="CT_Rel"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:complexType name="CT_Rel">
|
||||||
|
<xsd:attribute ref="r:id" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_ColID">
|
||||||
|
<xsd:restriction base="xsd:int">
|
||||||
|
<xsd:minInclusive value="0"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_RowID">
|
||||||
|
<xsd:restriction base="xsd:int">
|
||||||
|
<xsd:minInclusive value="0"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Marker">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="col" type="ST_ColID"/>
|
||||||
|
<xsd:element name="colOff" type="a:ST_Coordinate"/>
|
||||||
|
<xsd:element name="row" type="ST_RowID"/>
|
||||||
|
<xsd:element name="rowOff" type="a:ST_Coordinate"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_EditAs">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="twoCell"/>
|
||||||
|
<xsd:enumeration value="oneCell"/>
|
||||||
|
<xsd:enumeration value="absolute"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_TwoCellAnchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="from" type="CT_Marker"/>
|
||||||
|
<xsd:element name="to" type="CT_Marker"/>
|
||||||
|
<xsd:group ref="EG_ObjectChoices"/>
|
||||||
|
<xsd:element name="clientData" type="CT_AnchorClientData" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="editAs" type="ST_EditAs" use="optional" default="twoCell"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_OneCellAnchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="from" type="CT_Marker"/>
|
||||||
|
<xsd:element name="ext" type="a:CT_PositiveSize2D"/>
|
||||||
|
<xsd:group ref="EG_ObjectChoices"/>
|
||||||
|
<xsd:element name="clientData" type="CT_AnchorClientData" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_AbsoluteAnchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="pos" type="a:CT_Point2D"/>
|
||||||
|
<xsd:element name="ext" type="a:CT_PositiveSize2D"/>
|
||||||
|
<xsd:group ref="EG_ObjectChoices"/>
|
||||||
|
<xsd:element name="clientData" type="CT_AnchorClientData" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_Anchor">
|
||||||
|
<xsd:choice>
|
||||||
|
<xsd:element name="twoCellAnchor" type="CT_TwoCellAnchor"/>
|
||||||
|
<xsd:element name="oneCellAnchor" type="CT_OneCellAnchor"/>
|
||||||
|
<xsd:element name="absoluteAnchor" type="CT_AbsoluteAnchor"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:complexType name="CT_Drawing">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:group ref="EG_Anchor" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="wsDr" type="CT_Drawing"/>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,283 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns:a="http://purl.oclc.org/ooxml/drawingml/main"
|
||||||
|
xmlns:w="http://purl.oclc.org/ooxml/wordprocessingml/main"
|
||||||
|
xmlns:dpct="http://purl.oclc.org/ooxml/drawingml/picture"
|
||||||
|
xmlns:r="http://purl.oclc.org/ooxml/officeDocument/relationships"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/drawingml/wordprocessingDrawing"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/drawingml/wordprocessingDrawing"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/drawingml/main" schemaLocation="dml-main.xsd"/>
|
||||||
|
<xsd:import schemaLocation="wml.xsd" namespace="http://purl.oclc.org/ooxml/wordprocessingml/main"/>
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/drawingml/picture" schemaLocation="dml-picture.xsd"/>
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/officeDocument/relationships" schemaLocation="shared-relationshipReference.xsd"/>
|
||||||
|
<xsd:complexType name="CT_EffectExtent">
|
||||||
|
<xsd:attribute name="l" type="a:ST_Coordinate" use="required"/>
|
||||||
|
<xsd:attribute name="t" type="a:ST_Coordinate" use="required"/>
|
||||||
|
<xsd:attribute name="r" type="a:ST_Coordinate" use="required"/>
|
||||||
|
<xsd:attribute name="b" type="a:ST_Coordinate" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_WrapDistance">
|
||||||
|
<xsd:restriction base="xsd:unsignedInt"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Inline">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="extent" type="a:CT_PositiveSize2D"/>
|
||||||
|
<xsd:element name="effectExtent" type="CT_EffectExtent" minOccurs="0"/>
|
||||||
|
<xsd:element name="docPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGraphicFramePr" type="a:CT_NonVisualGraphicFrameProperties"
|
||||||
|
minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="distT" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distB" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distL" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distR" type="ST_WrapDistance" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_WrapText">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="bothSides"/>
|
||||||
|
<xsd:enumeration value="left"/>
|
||||||
|
<xsd:enumeration value="right"/>
|
||||||
|
<xsd:enumeration value="largest"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_WrapPath">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="start" type="a:CT_Point2D" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="lineTo" type="a:CT_Point2D" minOccurs="2" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="edited" type="xsd:boolean" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WrapNone"/>
|
||||||
|
<xsd:complexType name="CT_WrapSquare">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="effectExtent" type="CT_EffectExtent" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="wrapText" type="ST_WrapText" use="required"/>
|
||||||
|
<xsd:attribute name="distT" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distB" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distL" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distR" type="ST_WrapDistance" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WrapTight">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="wrapPolygon" type="CT_WrapPath" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="wrapText" type="ST_WrapText" use="required"/>
|
||||||
|
<xsd:attribute name="distL" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distR" type="ST_WrapDistance" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WrapThrough">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="wrapPolygon" type="CT_WrapPath" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="wrapText" type="ST_WrapText" use="required"/>
|
||||||
|
<xsd:attribute name="distL" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distR" type="ST_WrapDistance" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WrapTopBottom">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="effectExtent" type="CT_EffectExtent" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="distT" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distB" type="ST_WrapDistance" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_WrapType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="wrapNone" type="CT_WrapNone" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="wrapSquare" type="CT_WrapSquare" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="wrapTight" type="CT_WrapTight" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="wrapThrough" type="CT_WrapThrough" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="wrapTopAndBottom" type="CT_WrapTopBottom" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:simpleType name="ST_PositionOffset">
|
||||||
|
<xsd:restriction base="xsd:int"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_AlignH">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="left"/>
|
||||||
|
<xsd:enumeration value="right"/>
|
||||||
|
<xsd:enumeration value="center"/>
|
||||||
|
<xsd:enumeration value="inside"/>
|
||||||
|
<xsd:enumeration value="outside"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_RelFromH">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="margin"/>
|
||||||
|
<xsd:enumeration value="page"/>
|
||||||
|
<xsd:enumeration value="column"/>
|
||||||
|
<xsd:enumeration value="character"/>
|
||||||
|
<xsd:enumeration value="leftMargin"/>
|
||||||
|
<xsd:enumeration value="rightMargin"/>
|
||||||
|
<xsd:enumeration value="insideMargin"/>
|
||||||
|
<xsd:enumeration value="outsideMargin"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_PosH">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="align" type="ST_AlignH" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="posOffset" type="ST_PositionOffset" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="relativeFrom" type="ST_RelFromH" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_AlignV">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="top"/>
|
||||||
|
<xsd:enumeration value="bottom"/>
|
||||||
|
<xsd:enumeration value="center"/>
|
||||||
|
<xsd:enumeration value="inside"/>
|
||||||
|
<xsd:enumeration value="outside"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_RelFromV">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="margin"/>
|
||||||
|
<xsd:enumeration value="page"/>
|
||||||
|
<xsd:enumeration value="paragraph"/>
|
||||||
|
<xsd:enumeration value="line"/>
|
||||||
|
<xsd:enumeration value="topMargin"/>
|
||||||
|
<xsd:enumeration value="bottomMargin"/>
|
||||||
|
<xsd:enumeration value="insideMargin"/>
|
||||||
|
<xsd:enumeration value="outsideMargin"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_PosV">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="align" type="ST_AlignV" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="posOffset" type="ST_PositionOffset" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="relativeFrom" type="ST_RelFromV" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Anchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="simplePos" type="a:CT_Point2D"/>
|
||||||
|
<xsd:element name="positionH" type="CT_PosH"/>
|
||||||
|
<xsd:element name="positionV" type="CT_PosV"/>
|
||||||
|
<xsd:element name="extent" type="a:CT_PositiveSize2D"/>
|
||||||
|
<xsd:element name="effectExtent" type="CT_EffectExtent" minOccurs="0"/>
|
||||||
|
<xsd:group ref="EG_WrapType"/>
|
||||||
|
<xsd:element name="docPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGraphicFramePr" type="a:CT_NonVisualGraphicFrameProperties"
|
||||||
|
minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="distT" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distB" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distL" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distR" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="simplePos" type="xsd:boolean"/>
|
||||||
|
<xsd:attribute name="relativeHeight" type="xsd:unsignedInt" use="required"/>
|
||||||
|
<xsd:attribute name="behindDoc" type="xsd:boolean" use="required"/>
|
||||||
|
<xsd:attribute name="locked" type="xsd:boolean" use="required"/>
|
||||||
|
<xsd:attribute name="layoutInCell" type="xsd:boolean" use="required"/>
|
||||||
|
<xsd:attribute name="hidden" type="xsd:boolean" use="optional"/>
|
||||||
|
<xsd:attribute name="allowOverlap" type="xsd:boolean" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_TxbxContent">
|
||||||
|
<xsd:group ref="w:EG_BlockLevelElts" minOccurs="1" maxOccurs="unbounded"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_TextboxInfo">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="txbxContent" type="CT_TxbxContent" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="id" type="xsd:unsignedShort" use="optional" default="0"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_LinkedTextboxInformation">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="id" type="xsd:unsignedShort" use="required"/>
|
||||||
|
<xsd:attribute name="seq" type="xsd:unsignedShort" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WordprocessingShape">
|
||||||
|
<xsd:sequence minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="cNvSpPr" type="a:CT_NonVisualDrawingShapeProps" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvCnPr" type="a:CT_NonVisualConnectorProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="1">
|
||||||
|
<xsd:element name="txbx" type="CT_TextboxInfo" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="linkedTxbx" type="CT_LinkedTextboxInformation" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:element name="bodyPr" type="a:CT_TextBodyProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="normalEastAsianFlow" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GraphicFrame">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvFrPr" type="a:CT_NonVisualGraphicFrameProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
<xsd:element name="xfrm" type="a:CT_Transform2D" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WordprocessingContentPartNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvContentPartPr" type="a:CT_NonVisualContentPartProperties" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WordprocessingContentPart">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvContentPartPr" type="CT_WordprocessingContentPartNonVisual" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="xfrm" type="a:CT_Transform2D" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="bwMode" type="a:ST_BlackWhiteMode" use="optional"/>
|
||||||
|
<xsd:attribute ref="r:id" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WordprocessingGroup">
|
||||||
|
<xsd:sequence minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGrpSpPr" type="a:CT_NonVisualGroupDrawingShapeProps" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
<xsd:element name="grpSpPr" type="a:CT_GroupShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element ref="wsp"/>
|
||||||
|
<xsd:element name="grpSp" type="CT_WordprocessingGroup"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicFrame"/>
|
||||||
|
<xsd:element ref="dpct:pic"/>
|
||||||
|
<xsd:element name="contentPart" type="CT_WordprocessingContentPart"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WordprocessingCanvas">
|
||||||
|
<xsd:sequence minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="bg" type="a:CT_BackgroundFormatting" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="whole" type="a:CT_WholeE2oFormatting" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element ref="wsp"/>
|
||||||
|
<xsd:element ref="dpct:pic"/>
|
||||||
|
<xsd:element name="contentPart" type="CT_WordprocessingContentPart"/>
|
||||||
|
<xsd:element ref="wgp"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicFrame"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="wpc" type="CT_WordprocessingCanvas"/>
|
||||||
|
<xsd:element name="wgp" type="CT_WordprocessingGroup"/>
|
||||||
|
<xsd:element name="wsp" type="CT_WordprocessingShape"/>
|
||||||
|
<xsd:element name="inline" type="CT_Inline"/>
|
||||||
|
<xsd:element name="anchor" type="CT_Anchor"/>
|
||||||
|
</xsd:schema>
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,28 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/officeDocument/characteristics"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/officeDocument/characteristics"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:complexType name="CT_AdditionalCharacteristics">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="characteristic" type="CT_Characteristic" minOccurs="0"
|
||||||
|
maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Characteristic">
|
||||||
|
<xsd:attribute name="name" type="xsd:string" use="required"/>
|
||||||
|
<xsd:attribute name="relation" type="ST_Relation" use="required"/>
|
||||||
|
<xsd:attribute name="val" type="xsd:string" use="required"/>
|
||||||
|
<xsd:attribute name="vocabulary" type="xsd:anyURI" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_Relation">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="ge"/>
|
||||||
|
<xsd:enumeration value="le"/>
|
||||||
|
<xsd:enumeration value="gt"/>
|
||||||
|
<xsd:enumeration value="lt"/>
|
||||||
|
<xsd:enumeration value="eq"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:element name="additionalCharacteristics" type="CT_AdditionalCharacteristics"/>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,144 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/officeDocument/bibliography"
|
||||||
|
xmlns:s="http://purl.oclc.org/ooxml/officeDocument/sharedTypes"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/officeDocument/bibliography"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/officeDocument/sharedTypes"
|
||||||
|
schemaLocation="shared-commonSimpleTypes.xsd"/>
|
||||||
|
<xsd:simpleType name="ST_SourceType">
|
||||||
|
<xsd:restriction base="s:ST_String">
|
||||||
|
<xsd:enumeration value="ArticleInAPeriodical"/>
|
||||||
|
<xsd:enumeration value="Book"/>
|
||||||
|
<xsd:enumeration value="BookSection"/>
|
||||||
|
<xsd:enumeration value="JournalArticle"/>
|
||||||
|
<xsd:enumeration value="ConferenceProceedings"/>
|
||||||
|
<xsd:enumeration value="Report"/>
|
||||||
|
<xsd:enumeration value="SoundRecording"/>
|
||||||
|
<xsd:enumeration value="Performance"/>
|
||||||
|
<xsd:enumeration value="Art"/>
|
||||||
|
<xsd:enumeration value="DocumentFromInternetSite"/>
|
||||||
|
<xsd:enumeration value="InternetSite"/>
|
||||||
|
<xsd:enumeration value="Film"/>
|
||||||
|
<xsd:enumeration value="Interview"/>
|
||||||
|
<xsd:enumeration value="Patent"/>
|
||||||
|
<xsd:enumeration value="ElectronicSource"/>
|
||||||
|
<xsd:enumeration value="Case"/>
|
||||||
|
<xsd:enumeration value="Misc"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_NameListType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="Person" type="CT_PersonType" minOccurs="1" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_PersonType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="Last" type="s:ST_String" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
<xsd:element name="First" type="s:ST_String" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
<xsd:element name="Middle" type="s:ST_String" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_NameType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="NameList" type="CT_NameListType" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_NameOrCorporateType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="1">
|
||||||
|
<xsd:element name="NameList" type="CT_NameListType" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="Corporate" minOccurs="1" maxOccurs="1" type="s:ST_String"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_AuthorType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element name="Artist" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Author" type="CT_NameOrCorporateType"/>
|
||||||
|
<xsd:element name="BookAuthor" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Compiler" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Composer" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Conductor" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Counsel" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Director" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Editor" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Interviewee" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Interviewer" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Inventor" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Performer" type="CT_NameOrCorporateType"/>
|
||||||
|
<xsd:element name="ProducerName" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Translator" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Writer" type="CT_NameType"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_SourceType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element name="AbbreviatedCaseNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="AlbumTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Author" type="CT_AuthorType"/>
|
||||||
|
<xsd:element name="BookTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Broadcaster" type="s:ST_String"/>
|
||||||
|
<xsd:element name="BroadcastTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="CaseNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="ChapterNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="City" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Comments" type="s:ST_String"/>
|
||||||
|
<xsd:element name="ConferenceName" type="s:ST_String"/>
|
||||||
|
<xsd:element name="CountryRegion" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Court" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Day" type="s:ST_String"/>
|
||||||
|
<xsd:element name="DayAccessed" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Department" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Distributor" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Edition" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Guid" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Institution" type="s:ST_String"/>
|
||||||
|
<xsd:element name="InternetSiteTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Issue" type="s:ST_String"/>
|
||||||
|
<xsd:element name="JournalName" type="s:ST_String"/>
|
||||||
|
<xsd:element name="LCID" type="s:ST_Lang"/>
|
||||||
|
<xsd:element name="Medium" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Month" type="s:ST_String"/>
|
||||||
|
<xsd:element name="MonthAccessed" type="s:ST_String"/>
|
||||||
|
<xsd:element name="NumberVolumes" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Pages" type="s:ST_String"/>
|
||||||
|
<xsd:element name="PatentNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="PeriodicalTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="ProductionCompany" type="s:ST_String"/>
|
||||||
|
<xsd:element name="PublicationTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Publisher" type="s:ST_String"/>
|
||||||
|
<xsd:element name="RecordingNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="RefOrder" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Reporter" type="s:ST_String"/>
|
||||||
|
<xsd:element name="SourceType" type="ST_SourceType"/>
|
||||||
|
<xsd:element name="ShortTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="StandardNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="StateProvince" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Station" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Tag" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Theater" type="s:ST_String"/>
|
||||||
|
<xsd:element name="ThesisType" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Title" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Type" type="s:ST_String"/>
|
||||||
|
<xsd:element name="URL" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Version" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Volume" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Year" type="s:ST_String"/>
|
||||||
|
<xsd:element name="YearAccessed" type="s:ST_String"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="Sources" type="CT_Sources"/>
|
||||||
|
<xsd:complexType name="CT_Sources">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="Source" type="CT_SourceType" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="SelectedStyle" type="s:ST_String"/>
|
||||||
|
<xsd:attribute name="StyleName" type="s:ST_String"/>
|
||||||
|
<xsd:attribute name="URI" type="s:ST_String"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,125 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/officeDocument/sharedTypes"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/officeDocument/sharedTypes"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:simpleType name="ST_Lang">
|
||||||
|
<xsd:restriction base="xsd:string"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_HexColorRGB">
|
||||||
|
<xsd:restriction base="xsd:hexBinary">
|
||||||
|
<xsd:length value="3" fixed="true"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_Panose">
|
||||||
|
<xsd:restriction base="xsd:hexBinary">
|
||||||
|
<xsd:length value="10"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_CalendarType">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="gregorian"/>
|
||||||
|
<xsd:enumeration value="gregorianUs"/>
|
||||||
|
<xsd:enumeration value="gregorianMeFrench"/>
|
||||||
|
<xsd:enumeration value="gregorianArabic"/>
|
||||||
|
<xsd:enumeration value="hijri"/>
|
||||||
|
<xsd:enumeration value="hebrew"/>
|
||||||
|
<xsd:enumeration value="taiwan"/>
|
||||||
|
<xsd:enumeration value="japan"/>
|
||||||
|
<xsd:enumeration value="thai"/>
|
||||||
|
<xsd:enumeration value="korea"/>
|
||||||
|
<xsd:enumeration value="saka"/>
|
||||||
|
<xsd:enumeration value="gregorianXlitEnglish"/>
|
||||||
|
<xsd:enumeration value="gregorianXlitFrench"/>
|
||||||
|
<xsd:enumeration value="none"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_Guid">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:pattern value="\{[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}\}"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_OnOff">
|
||||||
|
<xsd:union memberTypes="xsd:boolean"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_String">
|
||||||
|
<xsd:restriction base="xsd:string"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_XmlName">
|
||||||
|
<xsd:restriction base="xsd:NCName">
|
||||||
|
<xsd:minLength value="1"/>
|
||||||
|
<xsd:maxLength value="255"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_UnsignedDecimalNumber">
|
||||||
|
<xsd:restriction base="xsd:unsignedLong"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_TwipsMeasure">
|
||||||
|
<xsd:union memberTypes="ST_UnsignedDecimalNumber ST_PositiveUniversalMeasure"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_VerticalAlignRun">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="baseline"/>
|
||||||
|
<xsd:enumeration value="superscript"/>
|
||||||
|
<xsd:enumeration value="subscript"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_Xstring">
|
||||||
|
<xsd:restriction base="xsd:string"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_XAlign">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="left"/>
|
||||||
|
<xsd:enumeration value="center"/>
|
||||||
|
<xsd:enumeration value="right"/>
|
||||||
|
<xsd:enumeration value="inside"/>
|
||||||
|
<xsd:enumeration value="outside"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_YAlign">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="inline"/>
|
||||||
|
<xsd:enumeration value="top"/>
|
||||||
|
<xsd:enumeration value="center"/>
|
||||||
|
<xsd:enumeration value="bottom"/>
|
||||||
|
<xsd:enumeration value="inside"/>
|
||||||
|
<xsd:enumeration value="outside"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_ConformanceClass">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="strict"/>
|
||||||
|
<xsd:enumeration value="transitional"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_UniversalMeasure">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:pattern value="-?[0-9]+(\.[0-9]+)?(mm|cm|in|pt|pc|pi)"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_PositiveUniversalMeasure">
|
||||||
|
<xsd:restriction base="ST_UniversalMeasure">
|
||||||
|
<xsd:pattern value="[0-9]+(\.[0-9]+)?(mm|cm|in|pt|pc|pi)"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_Percentage">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:pattern value="-?[0-9]+(\.[0-9]+)?%"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_FixedPercentage">
|
||||||
|
<xsd:restriction base="ST_Percentage">
|
||||||
|
<xsd:pattern value="-?((100)|([0-9][0-9]?))(\.[0-9][0-9]?)?%"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_PositivePercentage">
|
||||||
|
<xsd:restriction base="ST_Percentage">
|
||||||
|
<xsd:pattern value="[0-9]+(\.[0-9]+)?%"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_PositiveFixedPercentage">
|
||||||
|
<xsd:restriction base="ST_Percentage">
|
||||||
|
<xsd:pattern value="((100)|([0-9][0-9]?))(\.[0-9][0-9]?)?%"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,25 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/officeDocument/customXml"
|
||||||
|
xmlns:s="http://purl.oclc.org/ooxml/officeDocument/sharedTypes"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/officeDocument/customXml"
|
||||||
|
elementFormDefault="qualified" attributeFormDefault="qualified" blockDefault="#all">
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/officeDocument/sharedTypes"
|
||||||
|
schemaLocation="shared-commonSimpleTypes.xsd"/>
|
||||||
|
<xsd:complexType name="CT_DatastoreSchemaRef">
|
||||||
|
<xsd:attribute name="uri" type="xsd:string" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_DatastoreSchemaRefs">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="schemaRef" type="CT_DatastoreSchemaRef" minOccurs="0" maxOccurs="unbounded"
|
||||||
|
/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_DatastoreItem">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="schemaRefs" type="CT_DatastoreSchemaRefs" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="itemID" type="s:ST_Guid" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="datastoreItem" type="CT_DatastoreItem"/>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/schemaLibrary/main"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/schemaLibrary/main" attributeFormDefault="qualified"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:complexType name="CT_Schema">
|
||||||
|
<xsd:attribute name="uri" type="xsd:string" default=""/>
|
||||||
|
<xsd:attribute name="manifestLocation" type="xsd:string"/>
|
||||||
|
<xsd:attribute name="schemaLocation" type="xsd:string"/>
|
||||||
|
<xsd:attribute name="schemaLanguage" type="xsd:token"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_SchemaLibrary">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="schema" type="CT_Schema" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="schemaLibrary" type="CT_SchemaLibrary"/>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,59 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/officeDocument/customProperties"
|
||||||
|
xmlns:vt="http://purl.oclc.org/ooxml/officeDocument/docPropsVTypes"
|
||||||
|
xmlns:s="http://purl.oclc.org/ooxml/officeDocument/sharedTypes"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/officeDocument/customProperties" blockDefault="#all"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/officeDocument/docPropsVTypes"
|
||||||
|
schemaLocation="shared-documentPropertiesVariantTypes.xsd"/>
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/officeDocument/sharedTypes"
|
||||||
|
schemaLocation="shared-commonSimpleTypes.xsd"/>
|
||||||
|
<xsd:element name="Properties" type="CT_Properties"/>
|
||||||
|
<xsd:complexType name="CT_Properties">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="property" minOccurs="0" maxOccurs="unbounded" type="CT_Property"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Property">
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element ref="vt:vector"/>
|
||||||
|
<xsd:element ref="vt:array"/>
|
||||||
|
<xsd:element ref="vt:blob"/>
|
||||||
|
<xsd:element ref="vt:oblob"/>
|
||||||
|
<xsd:element ref="vt:empty"/>
|
||||||
|
<xsd:element ref="vt:null"/>
|
||||||
|
<xsd:element ref="vt:i1"/>
|
||||||
|
<xsd:element ref="vt:i2"/>
|
||||||
|
<xsd:element ref="vt:i4"/>
|
||||||
|
<xsd:element ref="vt:i8"/>
|
||||||
|
<xsd:element ref="vt:int"/>
|
||||||
|
<xsd:element ref="vt:ui1"/>
|
||||||
|
<xsd:element ref="vt:ui2"/>
|
||||||
|
<xsd:element ref="vt:ui4"/>
|
||||||
|
<xsd:element ref="vt:ui8"/>
|
||||||
|
<xsd:element ref="vt:uint"/>
|
||||||
|
<xsd:element ref="vt:r4"/>
|
||||||
|
<xsd:element ref="vt:r8"/>
|
||||||
|
<xsd:element ref="vt:decimal"/>
|
||||||
|
<xsd:element ref="vt:lpstr"/>
|
||||||
|
<xsd:element ref="vt:lpwstr"/>
|
||||||
|
<xsd:element ref="vt:bstr"/>
|
||||||
|
<xsd:element ref="vt:date"/>
|
||||||
|
<xsd:element ref="vt:filetime"/>
|
||||||
|
<xsd:element ref="vt:bool"/>
|
||||||
|
<xsd:element ref="vt:cy"/>
|
||||||
|
<xsd:element ref="vt:error"/>
|
||||||
|
<xsd:element ref="vt:stream"/>
|
||||||
|
<xsd:element ref="vt:ostream"/>
|
||||||
|
<xsd:element ref="vt:storage"/>
|
||||||
|
<xsd:element ref="vt:ostorage"/>
|
||||||
|
<xsd:element ref="vt:vstream"/>
|
||||||
|
<xsd:element ref="vt:clsid"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:attribute name="fmtid" use="required" type="s:ST_Guid"/>
|
||||||
|
<xsd:attribute name="pid" use="required" type="xsd:int"/>
|
||||||
|
<xsd:attribute name="name" use="optional" type="xsd:string"/>
|
||||||
|
<xsd:attribute name="linkTarget" use="optional" type="xsd:string"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,56 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/officeDocument/extendedProperties"
|
||||||
|
xmlns:vt="http://purl.oclc.org/ooxml/officeDocument/docPropsVTypes"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/officeDocument/extendedProperties"
|
||||||
|
elementFormDefault="qualified" blockDefault="#all">
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/officeDocument/docPropsVTypes"
|
||||||
|
schemaLocation="shared-documentPropertiesVariantTypes.xsd"/>
|
||||||
|
<xsd:element name="Properties" type="CT_Properties"/>
|
||||||
|
<xsd:complexType name="CT_Properties">
|
||||||
|
<xsd:all>
|
||||||
|
<xsd:element name="Template" minOccurs="0" maxOccurs="1" type="xsd:string"/>
|
||||||
|
<xsd:element name="Manager" minOccurs="0" maxOccurs="1" type="xsd:string"/>
|
||||||
|
<xsd:element name="Company" minOccurs="0" maxOccurs="1" type="xsd:string"/>
|
||||||
|
<xsd:element name="Pages" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
<xsd:element name="Words" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
<xsd:element name="Characters" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
<xsd:element name="PresentationFormat" minOccurs="0" maxOccurs="1" type="xsd:string"/>
|
||||||
|
<xsd:element name="Lines" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
<xsd:element name="Paragraphs" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
<xsd:element name="Slides" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
<xsd:element name="Notes" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
<xsd:element name="TotalTime" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
<xsd:element name="HiddenSlides" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
<xsd:element name="MMClips" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
<xsd:element name="ScaleCrop" minOccurs="0" maxOccurs="1" type="xsd:boolean"/>
|
||||||
|
<xsd:element name="HeadingPairs" minOccurs="0" maxOccurs="1" type="CT_VectorVariant"/>
|
||||||
|
<xsd:element name="TitlesOfParts" minOccurs="0" maxOccurs="1" type="CT_VectorLpstr"/>
|
||||||
|
<xsd:element name="LinksUpToDate" minOccurs="0" maxOccurs="1" type="xsd:boolean"/>
|
||||||
|
<xsd:element name="CharactersWithSpaces" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
<xsd:element name="SharedDoc" minOccurs="0" maxOccurs="1" type="xsd:boolean"/>
|
||||||
|
<xsd:element name="HyperlinkBase" minOccurs="0" maxOccurs="1" type="xsd:string"/>
|
||||||
|
<xsd:element name="HLinks" minOccurs="0" maxOccurs="1" type="CT_VectorVariant"/>
|
||||||
|
<xsd:element name="HyperlinksChanged" minOccurs="0" maxOccurs="1" type="xsd:boolean"/>
|
||||||
|
<xsd:element name="DigSig" minOccurs="0" maxOccurs="1" type="CT_DigSigBlob"/>
|
||||||
|
<xsd:element name="Application" minOccurs="0" maxOccurs="1" type="xsd:string"/>
|
||||||
|
<xsd:element name="AppVersion" minOccurs="0" maxOccurs="1" type="xsd:string"/>
|
||||||
|
<xsd:element name="DocSecurity" minOccurs="0" maxOccurs="1" type="xsd:int"/>
|
||||||
|
</xsd:all>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_VectorVariant">
|
||||||
|
<xsd:sequence minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element ref="vt:vector"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_VectorLpstr">
|
||||||
|
<xsd:sequence minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element ref="vt:vector"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_DigSigBlob">
|
||||||
|
<xsd:sequence minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element ref="vt:blob"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,195 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/officeDocument/docPropsVTypes"
|
||||||
|
xmlns:s="http://purl.oclc.org/ooxml/officeDocument/sharedTypes"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/officeDocument/docPropsVTypes" blockDefault="#all"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/officeDocument/sharedTypes"
|
||||||
|
schemaLocation="shared-commonSimpleTypes.xsd"/>
|
||||||
|
<xsd:simpleType name="ST_VectorBaseType">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="variant"/>
|
||||||
|
<xsd:enumeration value="i1"/>
|
||||||
|
<xsd:enumeration value="i2"/>
|
||||||
|
<xsd:enumeration value="i4"/>
|
||||||
|
<xsd:enumeration value="i8"/>
|
||||||
|
<xsd:enumeration value="ui1"/>
|
||||||
|
<xsd:enumeration value="ui2"/>
|
||||||
|
<xsd:enumeration value="ui4"/>
|
||||||
|
<xsd:enumeration value="ui8"/>
|
||||||
|
<xsd:enumeration value="r4"/>
|
||||||
|
<xsd:enumeration value="r8"/>
|
||||||
|
<xsd:enumeration value="lpstr"/>
|
||||||
|
<xsd:enumeration value="lpwstr"/>
|
||||||
|
<xsd:enumeration value="bstr"/>
|
||||||
|
<xsd:enumeration value="date"/>
|
||||||
|
<xsd:enumeration value="filetime"/>
|
||||||
|
<xsd:enumeration value="bool"/>
|
||||||
|
<xsd:enumeration value="cy"/>
|
||||||
|
<xsd:enumeration value="error"/>
|
||||||
|
<xsd:enumeration value="clsid"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_ArrayBaseType">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="variant"/>
|
||||||
|
<xsd:enumeration value="i1"/>
|
||||||
|
<xsd:enumeration value="i2"/>
|
||||||
|
<xsd:enumeration value="i4"/>
|
||||||
|
<xsd:enumeration value="int"/>
|
||||||
|
<xsd:enumeration value="ui1"/>
|
||||||
|
<xsd:enumeration value="ui2"/>
|
||||||
|
<xsd:enumeration value="ui4"/>
|
||||||
|
<xsd:enumeration value="uint"/>
|
||||||
|
<xsd:enumeration value="r4"/>
|
||||||
|
<xsd:enumeration value="r8"/>
|
||||||
|
<xsd:enumeration value="decimal"/>
|
||||||
|
<xsd:enumeration value="bstr"/>
|
||||||
|
<xsd:enumeration value="date"/>
|
||||||
|
<xsd:enumeration value="bool"/>
|
||||||
|
<xsd:enumeration value="cy"/>
|
||||||
|
<xsd:enumeration value="error"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_Cy">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:pattern value="\s*[0-9]*\.[0-9]{4}\s*"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_Error">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:pattern value="\s*0x[0-9A-Za-z]{8}\s*"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Empty"/>
|
||||||
|
<xsd:complexType name="CT_Null"/>
|
||||||
|
<xsd:complexType name="CT_Vector">
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="unbounded">
|
||||||
|
<xsd:element ref="variant"/>
|
||||||
|
<xsd:element ref="i1"/>
|
||||||
|
<xsd:element ref="i2"/>
|
||||||
|
<xsd:element ref="i4"/>
|
||||||
|
<xsd:element ref="i8"/>
|
||||||
|
<xsd:element ref="ui1"/>
|
||||||
|
<xsd:element ref="ui2"/>
|
||||||
|
<xsd:element ref="ui4"/>
|
||||||
|
<xsd:element ref="ui8"/>
|
||||||
|
<xsd:element ref="r4"/>
|
||||||
|
<xsd:element ref="r8"/>
|
||||||
|
<xsd:element ref="lpstr"/>
|
||||||
|
<xsd:element ref="lpwstr"/>
|
||||||
|
<xsd:element ref="bstr"/>
|
||||||
|
<xsd:element ref="date"/>
|
||||||
|
<xsd:element ref="filetime"/>
|
||||||
|
<xsd:element ref="bool"/>
|
||||||
|
<xsd:element ref="cy"/>
|
||||||
|
<xsd:element ref="error"/>
|
||||||
|
<xsd:element ref="clsid"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:attribute name="baseType" type="ST_VectorBaseType" use="required"/>
|
||||||
|
<xsd:attribute name="size" type="xsd:unsignedInt" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Array">
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="unbounded">
|
||||||
|
<xsd:element ref="variant"/>
|
||||||
|
<xsd:element ref="i1"/>
|
||||||
|
<xsd:element ref="i2"/>
|
||||||
|
<xsd:element ref="i4"/>
|
||||||
|
<xsd:element ref="int"/>
|
||||||
|
<xsd:element ref="ui1"/>
|
||||||
|
<xsd:element ref="ui2"/>
|
||||||
|
<xsd:element ref="ui4"/>
|
||||||
|
<xsd:element ref="uint"/>
|
||||||
|
<xsd:element ref="r4"/>
|
||||||
|
<xsd:element ref="r8"/>
|
||||||
|
<xsd:element ref="decimal"/>
|
||||||
|
<xsd:element ref="bstr"/>
|
||||||
|
<xsd:element ref="date"/>
|
||||||
|
<xsd:element ref="bool"/>
|
||||||
|
<xsd:element ref="error"/>
|
||||||
|
<xsd:element ref="cy"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:attribute name="lBounds" type="xsd:int" use="required"/>
|
||||||
|
<xsd:attribute name="uBounds" type="xsd:int" use="required"/>
|
||||||
|
<xsd:attribute name="baseType" type="ST_ArrayBaseType" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Variant">
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element ref="variant"/>
|
||||||
|
<xsd:element ref="vector"/>
|
||||||
|
<xsd:element ref="array"/>
|
||||||
|
<xsd:element ref="blob"/>
|
||||||
|
<xsd:element ref="oblob"/>
|
||||||
|
<xsd:element ref="empty"/>
|
||||||
|
<xsd:element ref="null"/>
|
||||||
|
<xsd:element ref="i1"/>
|
||||||
|
<xsd:element ref="i2"/>
|
||||||
|
<xsd:element ref="i4"/>
|
||||||
|
<xsd:element ref="i8"/>
|
||||||
|
<xsd:element ref="int"/>
|
||||||
|
<xsd:element ref="ui1"/>
|
||||||
|
<xsd:element ref="ui2"/>
|
||||||
|
<xsd:element ref="ui4"/>
|
||||||
|
<xsd:element ref="ui8"/>
|
||||||
|
<xsd:element ref="uint"/>
|
||||||
|
<xsd:element ref="r4"/>
|
||||||
|
<xsd:element ref="r8"/>
|
||||||
|
<xsd:element ref="decimal"/>
|
||||||
|
<xsd:element ref="lpstr"/>
|
||||||
|
<xsd:element ref="lpwstr"/>
|
||||||
|
<xsd:element ref="bstr"/>
|
||||||
|
<xsd:element ref="date"/>
|
||||||
|
<xsd:element ref="filetime"/>
|
||||||
|
<xsd:element ref="bool"/>
|
||||||
|
<xsd:element ref="cy"/>
|
||||||
|
<xsd:element ref="error"/>
|
||||||
|
<xsd:element ref="stream"/>
|
||||||
|
<xsd:element ref="ostream"/>
|
||||||
|
<xsd:element ref="storage"/>
|
||||||
|
<xsd:element ref="ostorage"/>
|
||||||
|
<xsd:element ref="vstream"/>
|
||||||
|
<xsd:element ref="clsid"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Vstream">
|
||||||
|
<xsd:simpleContent>
|
||||||
|
<xsd:extension base="xsd:base64Binary">
|
||||||
|
<xsd:attribute name="version" type="s:ST_Guid"/>
|
||||||
|
</xsd:extension>
|
||||||
|
</xsd:simpleContent>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="variant" type="CT_Variant"/>
|
||||||
|
<xsd:element name="vector" type="CT_Vector"/>
|
||||||
|
<xsd:element name="array" type="CT_Array"/>
|
||||||
|
<xsd:element name="blob" type="xsd:base64Binary"/>
|
||||||
|
<xsd:element name="oblob" type="xsd:base64Binary"/>
|
||||||
|
<xsd:element name="empty" type="CT_Empty"/>
|
||||||
|
<xsd:element name="null" type="CT_Null"/>
|
||||||
|
<xsd:element name="i1" type="xsd:byte"/>
|
||||||
|
<xsd:element name="i2" type="xsd:short"/>
|
||||||
|
<xsd:element name="i4" type="xsd:int"/>
|
||||||
|
<xsd:element name="i8" type="xsd:long"/>
|
||||||
|
<xsd:element name="int" type="xsd:int"/>
|
||||||
|
<xsd:element name="ui1" type="xsd:unsignedByte"/>
|
||||||
|
<xsd:element name="ui2" type="xsd:unsignedShort"/>
|
||||||
|
<xsd:element name="ui4" type="xsd:unsignedInt"/>
|
||||||
|
<xsd:element name="ui8" type="xsd:unsignedLong"/>
|
||||||
|
<xsd:element name="uint" type="xsd:unsignedInt"/>
|
||||||
|
<xsd:element name="r4" type="xsd:float"/>
|
||||||
|
<xsd:element name="r8" type="xsd:double"/>
|
||||||
|
<xsd:element name="decimal" type="xsd:decimal"/>
|
||||||
|
<xsd:element name="lpstr" type="xsd:string"/>
|
||||||
|
<xsd:element name="lpwstr" type="xsd:string"/>
|
||||||
|
<xsd:element name="bstr" type="xsd:string"/>
|
||||||
|
<xsd:element name="date" type="xsd:dateTime"/>
|
||||||
|
<xsd:element name="filetime" type="xsd:dateTime"/>
|
||||||
|
<xsd:element name="bool" type="xsd:boolean"/>
|
||||||
|
<xsd:element name="cy" type="ST_Cy"/>
|
||||||
|
<xsd:element name="error" type="ST_Error"/>
|
||||||
|
<xsd:element name="stream" type="xsd:base64Binary"/>
|
||||||
|
<xsd:element name="ostream" type="xsd:base64Binary"/>
|
||||||
|
<xsd:element name="storage" type="xsd:base64Binary"/>
|
||||||
|
<xsd:element name="ostorage" type="xsd:base64Binary"/>
|
||||||
|
<xsd:element name="vstream" type="CT_Vstream"/>
|
||||||
|
<xsd:element name="clsid" type="s:ST_Guid"/>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,582 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/officeDocument/math"
|
||||||
|
xmlns:m="http://purl.oclc.org/ooxml/officeDocument/math"
|
||||||
|
xmlns:w="http://purl.oclc.org/ooxml/wordprocessingml/main"
|
||||||
|
xmlns:s="http://purl.oclc.org/ooxml/officeDocument/sharedTypes" elementFormDefault="qualified"
|
||||||
|
attributeFormDefault="qualified" blockDefault="#all"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/officeDocument/math">
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/wordprocessingml/main"
|
||||||
|
schemaLocation="wml.xsd"/>
|
||||||
|
<xsd:import namespace="http://purl.oclc.org/ooxml/officeDocument/sharedTypes"
|
||||||
|
schemaLocation="shared-commonSimpleTypes.xsd"/>
|
||||||
|
<xsd:import namespace="http://www.w3.org/XML/1998/namespace"/>
|
||||||
|
<xsd:simpleType name="ST_Integer255">
|
||||||
|
<xsd:restriction base="xsd:integer">
|
||||||
|
<xsd:minInclusive value="1"/>
|
||||||
|
<xsd:maxInclusive value="255"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Integer255">
|
||||||
|
<xsd:attribute name="val" type="ST_Integer255" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_Integer2">
|
||||||
|
<xsd:restriction base="xsd:integer">
|
||||||
|
<xsd:minInclusive value="-2"/>
|
||||||
|
<xsd:maxInclusive value="2"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Integer2">
|
||||||
|
<xsd:attribute name="val" type="ST_Integer2" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_SpacingRule">
|
||||||
|
<xsd:restriction base="xsd:integer">
|
||||||
|
<xsd:minInclusive value="0"/>
|
||||||
|
<xsd:maxInclusive value="4"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_SpacingRule">
|
||||||
|
<xsd:attribute name="val" type="ST_SpacingRule" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_UnSignedInteger">
|
||||||
|
<xsd:restriction base="xsd:unsignedInt"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_UnSignedInteger">
|
||||||
|
<xsd:attribute name="val" type="ST_UnSignedInteger" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_Char">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:maxLength value="1"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Char">
|
||||||
|
<xsd:attribute name="val" type="ST_Char" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_OnOff">
|
||||||
|
<xsd:attribute name="val" type="s:ST_OnOff"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_String">
|
||||||
|
<xsd:attribute name="val" type="s:ST_String"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_XAlign">
|
||||||
|
<xsd:attribute name="val" type="s:ST_XAlign" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_YAlign">
|
||||||
|
<xsd:attribute name="val" type="s:ST_YAlign" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_Shp">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="centered"/>
|
||||||
|
<xsd:enumeration value="match"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Shp">
|
||||||
|
<xsd:attribute name="val" type="ST_Shp" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_FType">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="bar"/>
|
||||||
|
<xsd:enumeration value="skw"/>
|
||||||
|
<xsd:enumeration value="lin"/>
|
||||||
|
<xsd:enumeration value="noBar"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_FType">
|
||||||
|
<xsd:attribute name="val" type="ST_FType" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_LimLoc">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="undOvr"/>
|
||||||
|
<xsd:enumeration value="subSup"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_LimLoc">
|
||||||
|
<xsd:attribute name="val" type="ST_LimLoc" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_TopBot">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="top"/>
|
||||||
|
<xsd:enumeration value="bot"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_TopBot">
|
||||||
|
<xsd:attribute name="val" type="ST_TopBot" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_Script">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="roman"/>
|
||||||
|
<xsd:enumeration value="script"/>
|
||||||
|
<xsd:enumeration value="fraktur"/>
|
||||||
|
<xsd:enumeration value="double-struck"/>
|
||||||
|
<xsd:enumeration value="sans-serif"/>
|
||||||
|
<xsd:enumeration value="monospace"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Script">
|
||||||
|
<xsd:attribute name="val" type="ST_Script"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_Style">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="p"/>
|
||||||
|
<xsd:enumeration value="b"/>
|
||||||
|
<xsd:enumeration value="i"/>
|
||||||
|
<xsd:enumeration value="bi"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Style">
|
||||||
|
<xsd:attribute name="val" type="ST_Style"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_ManualBreak">
|
||||||
|
<xsd:attribute name="alnAt" type="ST_Integer255"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_ScriptStyle">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="scr" minOccurs="0" type="CT_Script"/>
|
||||||
|
<xsd:element name="sty" minOccurs="0" type="CT_Style"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:complexType name="CT_RPR">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="lit" minOccurs="0" type="CT_OnOff"/>
|
||||||
|
<xsd:choice>
|
||||||
|
<xsd:element name="nor" minOccurs="0" type="CT_OnOff"/>
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:group ref="EG_ScriptStyle"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:element name="brk" minOccurs="0" type="CT_ManualBreak"/>
|
||||||
|
<xsd:element name="aln" minOccurs="0" type="CT_OnOff"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Text">
|
||||||
|
<xsd:simpleContent>
|
||||||
|
<xsd:extension base="s:ST_String">
|
||||||
|
<xsd:attribute ref="xml:space" use="optional"/>
|
||||||
|
</xsd:extension>
|
||||||
|
</xsd:simpleContent>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_R">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="rPr" type="CT_RPR" minOccurs="0"/>
|
||||||
|
<xsd:group ref="w:EG_RPr" minOccurs="0"/>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:group ref="w:EG_RunInnerContent"/>
|
||||||
|
<xsd:element name="t" type="CT_Text" minOccurs="0"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_CtrlPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:group ref="w:EG_RPrMath" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_AccPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="chr" type="CT_Char" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Acc">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="accPr" type="CT_AccPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_BarPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="pos" type="CT_TopBot" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Bar">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="barPr" type="CT_BarPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_BoxPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="opEmu" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="noBreak" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="diff" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="brk" type="CT_ManualBreak" minOccurs="0"/>
|
||||||
|
<xsd:element name="aln" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Box">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="boxPr" type="CT_BoxPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_BorderBoxPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="hideTop" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="hideBot" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="hideLeft" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="hideRight" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="strikeH" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="strikeV" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="strikeBLTR" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="strikeTLBR" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_BorderBox">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="borderBoxPr" type="CT_BorderBoxPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_DPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="begChr" type="CT_Char" minOccurs="0"/>
|
||||||
|
<xsd:element name="sepChr" type="CT_Char" minOccurs="0"/>
|
||||||
|
<xsd:element name="endChr" type="CT_Char" minOccurs="0"/>
|
||||||
|
<xsd:element name="grow" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="shp" type="CT_Shp" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_D">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="dPr" type="CT_DPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_EqArrPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="baseJc" type="CT_YAlign" minOccurs="0"/>
|
||||||
|
<xsd:element name="maxDist" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="objDist" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="rSpRule" type="CT_SpacingRule" minOccurs="0"/>
|
||||||
|
<xsd:element name="rSp" type="CT_UnSignedInteger" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_EqArr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="eqArrPr" type="CT_EqArrPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_FPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="type" type="CT_FType" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_F">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="fPr" type="CT_FPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="num" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="den" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_FuncPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Func">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="funcPr" type="CT_FuncPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="fName" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GroupChrPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="chr" type="CT_Char" minOccurs="0"/>
|
||||||
|
<xsd:element name="pos" type="CT_TopBot" minOccurs="0"/>
|
||||||
|
<xsd:element name="vertJc" type="CT_TopBot" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GroupChr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="groupChrPr" type="CT_GroupChrPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_LimLowPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_LimLow">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="limLowPr" type="CT_LimLowPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="lim" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_LimUppPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_LimUpp">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="limUppPr" type="CT_LimUppPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="lim" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_MCPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="count" type="CT_Integer255" minOccurs="0"/>
|
||||||
|
<xsd:element name="mcJc" type="CT_XAlign" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_MC">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="mcPr" type="CT_MCPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_MCS">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="mc" type="CT_MC" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_MPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="baseJc" type="CT_YAlign" minOccurs="0"/>
|
||||||
|
<xsd:element name="plcHide" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="rSpRule" type="CT_SpacingRule" minOccurs="0"/>
|
||||||
|
<xsd:element name="cGpRule" type="CT_SpacingRule" minOccurs="0"/>
|
||||||
|
<xsd:element name="rSp" type="CT_UnSignedInteger" minOccurs="0"/>
|
||||||
|
<xsd:element name="cSp" type="CT_UnSignedInteger" minOccurs="0"/>
|
||||||
|
<xsd:element name="cGp" type="CT_UnSignedInteger" minOccurs="0"/>
|
||||||
|
<xsd:element name="mcs" type="CT_MCS" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_MR">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_M">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="mPr" type="CT_MPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="mr" type="CT_MR" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_NaryPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="chr" type="CT_Char" minOccurs="0"/>
|
||||||
|
<xsd:element name="limLoc" type="CT_LimLoc" minOccurs="0"/>
|
||||||
|
<xsd:element name="grow" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="subHide" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="supHide" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Nary">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="naryPr" type="CT_NaryPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="sub" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="sup" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_PhantPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="show" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="zeroWid" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="zeroAsc" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="zeroDesc" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="transp" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Phant">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="phantPr" type="CT_PhantPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_RadPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="degHide" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Rad">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="radPr" type="CT_RadPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="deg" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_SPrePr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_SPre">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="sPrePr" type="CT_SPrePr" minOccurs="0"/>
|
||||||
|
<xsd:element name="sub" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="sup" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_SSubPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_SSub">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="sSubPr" type="CT_SSubPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="sub" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_SSubSupPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="alnScr" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_SSubSup">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="sSubSupPr" type="CT_SSubSupPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="sub" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="sup" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_SSupPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_SSup">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="sSupPr" type="CT_SSupPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="e" type="CT_OMathArg"/>
|
||||||
|
<xsd:element name="sup" type="CT_OMathArg"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_OMathMathElements">
|
||||||
|
<xsd:choice>
|
||||||
|
<xsd:element name="acc" type="CT_Acc"/>
|
||||||
|
<xsd:element name="bar" type="CT_Bar"/>
|
||||||
|
<xsd:element name="box" type="CT_Box"/>
|
||||||
|
<xsd:element name="borderBox" type="CT_BorderBox"/>
|
||||||
|
<xsd:element name="d" type="CT_D"/>
|
||||||
|
<xsd:element name="eqArr" type="CT_EqArr"/>
|
||||||
|
<xsd:element name="f" type="CT_F"/>
|
||||||
|
<xsd:element name="func" type="CT_Func"/>
|
||||||
|
<xsd:element name="groupChr" type="CT_GroupChr"/>
|
||||||
|
<xsd:element name="limLow" type="CT_LimLow"/>
|
||||||
|
<xsd:element name="limUpp" type="CT_LimUpp"/>
|
||||||
|
<xsd:element name="m" type="CT_M"/>
|
||||||
|
<xsd:element name="nary" type="CT_Nary"/>
|
||||||
|
<xsd:element name="phant" type="CT_Phant"/>
|
||||||
|
<xsd:element name="rad" type="CT_Rad"/>
|
||||||
|
<xsd:element name="sPre" type="CT_SPre"/>
|
||||||
|
<xsd:element name="sSub" type="CT_SSub"/>
|
||||||
|
<xsd:element name="sSubSup" type="CT_SSubSup"/>
|
||||||
|
<xsd:element name="sSup" type="CT_SSup"/>
|
||||||
|
<xsd:element name="r" type="CT_R"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:group name="EG_OMathElements">
|
||||||
|
<xsd:choice>
|
||||||
|
<xsd:group ref="EG_OMathMathElements"/>
|
||||||
|
<xsd:group ref="w:EG_PContentMath"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:complexType name="CT_OMathArgPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="argSz" type="CT_Integer2" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_OMathArg">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="argPr" type="CT_OMathArgPr" minOccurs="0"/>
|
||||||
|
<xsd:group ref="EG_OMathElements" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
<xsd:element name="ctrlPr" type="CT_CtrlPr" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_Jc">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="left"/>
|
||||||
|
<xsd:enumeration value="right"/>
|
||||||
|
<xsd:enumeration value="center"/>
|
||||||
|
<xsd:enumeration value="centerGroup"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_OMathJc">
|
||||||
|
<xsd:attribute name="val" type="ST_Jc"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_OMathParaPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="jc" type="CT_OMathJc" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_TwipsMeasure">
|
||||||
|
<xsd:attribute name="val" type="s:ST_TwipsMeasure" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_BreakBin">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="before"/>
|
||||||
|
<xsd:enumeration value="after"/>
|
||||||
|
<xsd:enumeration value="repeat"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_BreakBin">
|
||||||
|
<xsd:attribute name="val" type="ST_BreakBin"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_BreakBinSub">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="--"/>
|
||||||
|
<xsd:enumeration value="-+"/>
|
||||||
|
<xsd:enumeration value="+-"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_BreakBinSub">
|
||||||
|
<xsd:attribute name="val" type="ST_BreakBinSub"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_MathPr">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="mathFont" type="CT_String" minOccurs="0"/>
|
||||||
|
<xsd:element name="brkBin" type="CT_BreakBin" minOccurs="0"/>
|
||||||
|
<xsd:element name="brkBinSub" type="CT_BreakBinSub" minOccurs="0"/>
|
||||||
|
<xsd:element name="smallFrac" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="dispDef" type="CT_OnOff" minOccurs="0"/>
|
||||||
|
<xsd:element name="lMargin" type="CT_TwipsMeasure" minOccurs="0"/>
|
||||||
|
<xsd:element name="rMargin" type="CT_TwipsMeasure" minOccurs="0"/>
|
||||||
|
<xsd:element name="defJc" type="CT_OMathJc" minOccurs="0"/>
|
||||||
|
<xsd:element name="preSp" type="CT_TwipsMeasure" minOccurs="0"/>
|
||||||
|
<xsd:element name="postSp" type="CT_TwipsMeasure" minOccurs="0"/>
|
||||||
|
<xsd:element name="interSp" type="CT_TwipsMeasure" minOccurs="0"/>
|
||||||
|
<xsd:element name="intraSp" type="CT_TwipsMeasure" minOccurs="0"/>
|
||||||
|
<xsd:choice minOccurs="0">
|
||||||
|
<xsd:element name="wrapIndent" type="CT_TwipsMeasure"/>
|
||||||
|
<xsd:element name="wrapRight" type="CT_OnOff"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:element name="intLim" type="CT_LimLoc" minOccurs="0"/>
|
||||||
|
<xsd:element name="naryLim" type="CT_LimLoc" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="mathPr" type="CT_MathPr"/>
|
||||||
|
<xsd:complexType name="CT_OMathPara">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="oMathParaPr" type="CT_OMathParaPr" minOccurs="0"/>
|
||||||
|
<xsd:element name="oMath" type="CT_OMath" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_OMath">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:group ref="EG_OMathElements" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="oMathPara" type="CT_OMathPara"/>
|
||||||
|
<xsd:element name="oMath" type="CT_OMath"/>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://purl.oclc.org/ooxml/officeDocument/relationships"
|
||||||
|
xmlns:r="http://purl.oclc.org/ooxml/officeDocument/relationships" elementFormDefault="qualified"
|
||||||
|
targetNamespace="http://purl.oclc.org/ooxml/officeDocument/relationships" blockDefault="#all">
|
||||||
|
<xsd:simpleType name="ST_RelationshipId">
|
||||||
|
<xsd:restriction base="xsd:string"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:attribute name="id" type="ST_RelationshipId"/>
|
||||||
|
<xsd:attribute name="embed" type="ST_RelationshipId"/>
|
||||||
|
<xsd:attribute name="link" type="ST_RelationshipId"/>
|
||||||
|
<xsd:attribute name="dm" type="ST_RelationshipId" default=""/>
|
||||||
|
<xsd:attribute name="lo" type="ST_RelationshipId" default=""/>
|
||||||
|
<xsd:attribute name="qs" type="ST_RelationshipId" default=""/>
|
||||||
|
<xsd:attribute name="cs" type="ST_RelationshipId" default=""/>
|
||||||
|
<xsd:attribute name="blip" type="ST_RelationshipId" default=""/>
|
||||||
|
<xsd:attribute name="pict" type="ST_RelationshipId"/>
|
||||||
|
<xsd:attribute name="href" type="ST_RelationshipId"/>
|
||||||
|
<xsd:attribute name="topLeft" type="ST_RelationshipId"/>
|
||||||
|
<xsd:attribute name="topRight" type="ST_RelationshipId"/>
|
||||||
|
<xsd:attribute name="bottomLeft" type="ST_RelationshipId"/>
|
||||||
|
<xsd:attribute name="bottomRight" type="ST_RelationshipId"/>
|
||||||
|
</xsd:schema>
|
||||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,146 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
|
||||||
|
xmlns="http://schemas.openxmlformats.org/drawingml/2006/chartDrawing"
|
||||||
|
targetNamespace="http://schemas.openxmlformats.org/drawingml/2006/chartDrawing"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:import namespace="http://schemas.openxmlformats.org/drawingml/2006/main"
|
||||||
|
schemaLocation="dml-main.xsd"/>
|
||||||
|
<xsd:complexType name="CT_ShapeNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvSpPr" type="a:CT_NonVisualDrawingShapeProps" minOccurs="1" maxOccurs="1"
|
||||||
|
/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Shape">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvSpPr" type="CT_ShapeNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="txBody" type="a:CT_TextBody" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="textlink" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fLocksText" type="xsd:boolean" use="optional" default="true"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_ConnectorNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvCxnSpPr" type="a:CT_NonVisualConnectorProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Connector">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvCxnSpPr" type="CT_ConnectorNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_PictureNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvPicPr" type="a:CT_NonVisualPictureProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Picture">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvPicPr" type="CT_PictureNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="blipFill" type="a:CT_BlipFillProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional" default=""/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GraphicFrameNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGraphicFramePr" type="a:CT_NonVisualGraphicFrameProperties"
|
||||||
|
minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GraphicFrame">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvGraphicFramePr" type="CT_GraphicFrameNonVisual" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
<xsd:element name="xfrm" type="a:CT_Transform2D" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GroupShapeNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGrpSpPr" type="a:CT_NonVisualGroupDrawingShapeProps" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GroupShape">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvGrpSpPr" type="CT_GroupShapeNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="grpSpPr" type="a:CT_GroupShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element name="sp" type="CT_Shape"/>
|
||||||
|
<xsd:element name="grpSp" type="CT_GroupShape"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicFrame"/>
|
||||||
|
<xsd:element name="cxnSp" type="CT_Connector"/>
|
||||||
|
<xsd:element name="pic" type="CT_Picture"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_ObjectChoices">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="sp" type="CT_Shape"/>
|
||||||
|
<xsd:element name="grpSp" type="CT_GroupShape"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicFrame"/>
|
||||||
|
<xsd:element name="cxnSp" type="CT_Connector"/>
|
||||||
|
<xsd:element name="pic" type="CT_Picture"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:simpleType name="ST_MarkerCoordinate">
|
||||||
|
<xsd:restriction base="xsd:double">
|
||||||
|
<xsd:minInclusive value="0.0"/>
|
||||||
|
<xsd:maxInclusive value="1.0"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Marker">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="x" type="ST_MarkerCoordinate" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="y" type="ST_MarkerCoordinate" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_RelSizeAnchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="from" type="CT_Marker"/>
|
||||||
|
<xsd:element name="to" type="CT_Marker"/>
|
||||||
|
<xsd:group ref="EG_ObjectChoices"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_AbsSizeAnchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="from" type="CT_Marker"/>
|
||||||
|
<xsd:element name="ext" type="a:CT_PositiveSize2D"/>
|
||||||
|
<xsd:group ref="EG_ObjectChoices"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_Anchor">
|
||||||
|
<xsd:choice>
|
||||||
|
<xsd:element name="relSizeAnchor" type="CT_RelSizeAnchor"/>
|
||||||
|
<xsd:element name="absSizeAnchor" type="CT_AbsSizeAnchor"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:complexType name="CT_Drawing">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:group ref="EG_Anchor" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
</xsd:schema>
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,11 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://schemas.openxmlformats.org/drawingml/2006/lockedCanvas"
|
||||||
|
xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
|
||||||
|
xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
|
||||||
|
elementFormDefault="qualified"
|
||||||
|
targetNamespace="http://schemas.openxmlformats.org/drawingml/2006/lockedCanvas">
|
||||||
|
<xsd:import namespace="http://schemas.openxmlformats.org/drawingml/2006/main"
|
||||||
|
schemaLocation="dml-main.xsd"/>
|
||||||
|
<xsd:element name="lockedCanvas" type="a:CT_GvmlGroupShape"/>
|
||||||
|
</xsd:schema>
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,23 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://schemas.openxmlformats.org/drawingml/2006/picture"
|
||||||
|
xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" elementFormDefault="qualified"
|
||||||
|
targetNamespace="http://schemas.openxmlformats.org/drawingml/2006/picture">
|
||||||
|
<xsd:import namespace="http://schemas.openxmlformats.org/drawingml/2006/main"
|
||||||
|
schemaLocation="dml-main.xsd"/>
|
||||||
|
<xsd:complexType name="CT_PictureNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvPicPr" type="a:CT_NonVisualPictureProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Picture">
|
||||||
|
<xsd:sequence minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="nvPicPr" type="CT_PictureNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="blipFill" type="a:CT_BlipFillProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="pic" type="CT_Picture"/>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,185 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
|
||||||
|
xmlns="http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing"
|
||||||
|
xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
|
||||||
|
targetNamespace="http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:import namespace="http://schemas.openxmlformats.org/drawingml/2006/main"
|
||||||
|
schemaLocation="dml-main.xsd"/>
|
||||||
|
<xsd:import schemaLocation="shared-relationshipReference.xsd"
|
||||||
|
namespace="http://schemas.openxmlformats.org/officeDocument/2006/relationships"/>
|
||||||
|
<xsd:element name="from" type="CT_Marker"/>
|
||||||
|
<xsd:element name="to" type="CT_Marker"/>
|
||||||
|
<xsd:complexType name="CT_AnchorClientData">
|
||||||
|
<xsd:attribute name="fLocksWithSheet" type="xsd:boolean" use="optional" default="true"/>
|
||||||
|
<xsd:attribute name="fPrintsWithSheet" type="xsd:boolean" use="optional" default="true"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_ShapeNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvSpPr" type="a:CT_NonVisualDrawingShapeProps" minOccurs="1" maxOccurs="1"
|
||||||
|
/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Shape">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvSpPr" type="CT_ShapeNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="txBody" type="a:CT_TextBody" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="textlink" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fLocksText" type="xsd:boolean" use="optional" default="true"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_ConnectorNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvCxnSpPr" type="a:CT_NonVisualConnectorProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Connector">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvCxnSpPr" type="CT_ConnectorNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_PictureNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvPicPr" type="a:CT_NonVisualPictureProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Picture">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvPicPr" type="CT_PictureNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="blipFill" type="a:CT_BlipFillProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional" default=""/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GraphicalObjectFrameNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGraphicFramePr" type="a:CT_NonVisualGraphicFrameProperties"
|
||||||
|
minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GraphicalObjectFrame">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvGraphicFramePr" type="CT_GraphicalObjectFrameNonVisual" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
<xsd:element name="xfrm" type="a:CT_Transform2D" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="macro" type="xsd:string" use="optional"/>
|
||||||
|
<xsd:attribute name="fPublished" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GroupShapeNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGrpSpPr" type="a:CT_NonVisualGroupDrawingShapeProps" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GroupShape">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvGrpSpPr" type="CT_GroupShapeNonVisual" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="grpSpPr" type="a:CT_GroupShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element name="sp" type="CT_Shape"/>
|
||||||
|
<xsd:element name="grpSp" type="CT_GroupShape"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicalObjectFrame"/>
|
||||||
|
<xsd:element name="cxnSp" type="CT_Connector"/>
|
||||||
|
<xsd:element name="pic" type="CT_Picture"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_ObjectChoices">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="sp" type="CT_Shape"/>
|
||||||
|
<xsd:element name="grpSp" type="CT_GroupShape"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicalObjectFrame"/>
|
||||||
|
<xsd:element name="cxnSp" type="CT_Connector"/>
|
||||||
|
<xsd:element name="pic" type="CT_Picture"/>
|
||||||
|
<xsd:element name="contentPart" type="CT_Rel"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:complexType name="CT_Rel">
|
||||||
|
<xsd:attribute ref="r:id" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_ColID">
|
||||||
|
<xsd:restriction base="xsd:int">
|
||||||
|
<xsd:minInclusive value="0"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_RowID">
|
||||||
|
<xsd:restriction base="xsd:int">
|
||||||
|
<xsd:minInclusive value="0"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Marker">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="col" type="ST_ColID"/>
|
||||||
|
<xsd:element name="colOff" type="a:ST_Coordinate"/>
|
||||||
|
<xsd:element name="row" type="ST_RowID"/>
|
||||||
|
<xsd:element name="rowOff" type="a:ST_Coordinate"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_EditAs">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="twoCell"/>
|
||||||
|
<xsd:enumeration value="oneCell"/>
|
||||||
|
<xsd:enumeration value="absolute"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_TwoCellAnchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="from" type="CT_Marker"/>
|
||||||
|
<xsd:element name="to" type="CT_Marker"/>
|
||||||
|
<xsd:group ref="EG_ObjectChoices"/>
|
||||||
|
<xsd:element name="clientData" type="CT_AnchorClientData" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="editAs" type="ST_EditAs" use="optional" default="twoCell"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_OneCellAnchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="from" type="CT_Marker"/>
|
||||||
|
<xsd:element name="ext" type="a:CT_PositiveSize2D"/>
|
||||||
|
<xsd:group ref="EG_ObjectChoices"/>
|
||||||
|
<xsd:element name="clientData" type="CT_AnchorClientData" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_AbsoluteAnchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="pos" type="a:CT_Point2D"/>
|
||||||
|
<xsd:element name="ext" type="a:CT_PositiveSize2D"/>
|
||||||
|
<xsd:group ref="EG_ObjectChoices"/>
|
||||||
|
<xsd:element name="clientData" type="CT_AnchorClientData" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_Anchor">
|
||||||
|
<xsd:choice>
|
||||||
|
<xsd:element name="twoCellAnchor" type="CT_TwoCellAnchor"/>
|
||||||
|
<xsd:element name="oneCellAnchor" type="CT_OneCellAnchor"/>
|
||||||
|
<xsd:element name="absoluteAnchor" type="CT_AbsoluteAnchor"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:complexType name="CT_Drawing">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:group ref="EG_Anchor" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="wsDr" type="CT_Drawing"/>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,287 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
|
||||||
|
xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
|
||||||
|
xmlns:dpct="http://schemas.openxmlformats.org/drawingml/2006/picture"
|
||||||
|
xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
|
||||||
|
xmlns="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing"
|
||||||
|
targetNamespace="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:import namespace="http://schemas.openxmlformats.org/drawingml/2006/main"
|
||||||
|
schemaLocation="dml-main.xsd"/>
|
||||||
|
<xsd:import schemaLocation="wml.xsd"
|
||||||
|
namespace="http://schemas.openxmlformats.org/wordprocessingml/2006/main"/>
|
||||||
|
<xsd:import namespace="http://schemas.openxmlformats.org/drawingml/2006/picture"
|
||||||
|
schemaLocation="dml-picture.xsd"/>
|
||||||
|
<xsd:import namespace="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
|
||||||
|
schemaLocation="shared-relationshipReference.xsd"/>
|
||||||
|
<xsd:complexType name="CT_EffectExtent">
|
||||||
|
<xsd:attribute name="l" type="a:ST_Coordinate" use="required"/>
|
||||||
|
<xsd:attribute name="t" type="a:ST_Coordinate" use="required"/>
|
||||||
|
<xsd:attribute name="r" type="a:ST_Coordinate" use="required"/>
|
||||||
|
<xsd:attribute name="b" type="a:ST_Coordinate" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_WrapDistance">
|
||||||
|
<xsd:restriction base="xsd:unsignedInt"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_Inline">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="extent" type="a:CT_PositiveSize2D"/>
|
||||||
|
<xsd:element name="effectExtent" type="CT_EffectExtent" minOccurs="0"/>
|
||||||
|
<xsd:element name="docPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGraphicFramePr" type="a:CT_NonVisualGraphicFrameProperties"
|
||||||
|
minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="distT" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distB" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distL" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distR" type="ST_WrapDistance" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_WrapText">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="bothSides"/>
|
||||||
|
<xsd:enumeration value="left"/>
|
||||||
|
<xsd:enumeration value="right"/>
|
||||||
|
<xsd:enumeration value="largest"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_WrapPath">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="start" type="a:CT_Point2D" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="lineTo" type="a:CT_Point2D" minOccurs="2" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="edited" type="xsd:boolean" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WrapNone"/>
|
||||||
|
<xsd:complexType name="CT_WrapSquare">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="effectExtent" type="CT_EffectExtent" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="wrapText" type="ST_WrapText" use="required"/>
|
||||||
|
<xsd:attribute name="distT" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distB" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distL" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distR" type="ST_WrapDistance" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WrapTight">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="wrapPolygon" type="CT_WrapPath" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="wrapText" type="ST_WrapText" use="required"/>
|
||||||
|
<xsd:attribute name="distL" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distR" type="ST_WrapDistance" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WrapThrough">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="wrapPolygon" type="CT_WrapPath" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="wrapText" type="ST_WrapText" use="required"/>
|
||||||
|
<xsd:attribute name="distL" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distR" type="ST_WrapDistance" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WrapTopBottom">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="effectExtent" type="CT_EffectExtent" minOccurs="0"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="distT" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distB" type="ST_WrapDistance" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:group name="EG_WrapType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="wrapNone" type="CT_WrapNone" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="wrapSquare" type="CT_WrapSquare" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="wrapTight" type="CT_WrapTight" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="wrapThrough" type="CT_WrapThrough" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="wrapTopAndBottom" type="CT_WrapTopBottom" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:group>
|
||||||
|
<xsd:simpleType name="ST_PositionOffset">
|
||||||
|
<xsd:restriction base="xsd:int"/>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_AlignH">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="left"/>
|
||||||
|
<xsd:enumeration value="right"/>
|
||||||
|
<xsd:enumeration value="center"/>
|
||||||
|
<xsd:enumeration value="inside"/>
|
||||||
|
<xsd:enumeration value="outside"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_RelFromH">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="margin"/>
|
||||||
|
<xsd:enumeration value="page"/>
|
||||||
|
<xsd:enumeration value="column"/>
|
||||||
|
<xsd:enumeration value="character"/>
|
||||||
|
<xsd:enumeration value="leftMargin"/>
|
||||||
|
<xsd:enumeration value="rightMargin"/>
|
||||||
|
<xsd:enumeration value="insideMargin"/>
|
||||||
|
<xsd:enumeration value="outsideMargin"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_PosH">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="align" type="ST_AlignH" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="posOffset" type="ST_PositionOffset" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="relativeFrom" type="ST_RelFromH" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_AlignV">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="top"/>
|
||||||
|
<xsd:enumeration value="bottom"/>
|
||||||
|
<xsd:enumeration value="center"/>
|
||||||
|
<xsd:enumeration value="inside"/>
|
||||||
|
<xsd:enumeration value="outside"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:simpleType name="ST_RelFromV">
|
||||||
|
<xsd:restriction base="xsd:token">
|
||||||
|
<xsd:enumeration value="margin"/>
|
||||||
|
<xsd:enumeration value="page"/>
|
||||||
|
<xsd:enumeration value="paragraph"/>
|
||||||
|
<xsd:enumeration value="line"/>
|
||||||
|
<xsd:enumeration value="topMargin"/>
|
||||||
|
<xsd:enumeration value="bottomMargin"/>
|
||||||
|
<xsd:enumeration value="insideMargin"/>
|
||||||
|
<xsd:enumeration value="outsideMargin"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_PosV">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="align" type="ST_AlignV" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="posOffset" type="ST_PositionOffset" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="relativeFrom" type="ST_RelFromV" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Anchor">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="simplePos" type="a:CT_Point2D"/>
|
||||||
|
<xsd:element name="positionH" type="CT_PosH"/>
|
||||||
|
<xsd:element name="positionV" type="CT_PosV"/>
|
||||||
|
<xsd:element name="extent" type="a:CT_PositiveSize2D"/>
|
||||||
|
<xsd:element name="effectExtent" type="CT_EffectExtent" minOccurs="0"/>
|
||||||
|
<xsd:group ref="EG_WrapType"/>
|
||||||
|
<xsd:element name="docPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGraphicFramePr" type="a:CT_NonVisualGraphicFrameProperties"
|
||||||
|
minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="distT" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distB" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distL" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="distR" type="ST_WrapDistance" use="optional"/>
|
||||||
|
<xsd:attribute name="simplePos" type="xsd:boolean"/>
|
||||||
|
<xsd:attribute name="relativeHeight" type="xsd:unsignedInt" use="required"/>
|
||||||
|
<xsd:attribute name="behindDoc" type="xsd:boolean" use="required"/>
|
||||||
|
<xsd:attribute name="locked" type="xsd:boolean" use="required"/>
|
||||||
|
<xsd:attribute name="layoutInCell" type="xsd:boolean" use="required"/>
|
||||||
|
<xsd:attribute name="hidden" type="xsd:boolean" use="optional"/>
|
||||||
|
<xsd:attribute name="allowOverlap" type="xsd:boolean" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_TxbxContent">
|
||||||
|
<xsd:group ref="w:EG_BlockLevelElts" minOccurs="1" maxOccurs="unbounded"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_TextboxInfo">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="txbxContent" type="CT_TxbxContent" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="id" type="xsd:unsignedShort" use="optional" default="0"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_LinkedTextboxInformation">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="id" type="xsd:unsignedShort" use="required"/>
|
||||||
|
<xsd:attribute name="seq" type="xsd:unsignedShort" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WordprocessingShape">
|
||||||
|
<xsd:sequence minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="cNvSpPr" type="a:CT_NonVisualDrawingShapeProps" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvCnPr" type="a:CT_NonVisualConnectorProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:element name="spPr" type="a:CT_ShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="style" type="a:CT_ShapeStyle" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="1">
|
||||||
|
<xsd:element name="txbx" type="CT_TextboxInfo" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="linkedTxbx" type="CT_LinkedTextboxInformation" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:element name="bodyPr" type="a:CT_TextBodyProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="normalEastAsianFlow" type="xsd:boolean" use="optional" default="false"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_GraphicFrame">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvFrPr" type="a:CT_NonVisualGraphicFrameProperties" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
<xsd:element name="xfrm" type="a:CT_Transform2D" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WordprocessingContentPartNonVisual">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvContentPartPr" type="a:CT_NonVisualContentPartProperties" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WordprocessingContentPart">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="nvContentPartPr" type="CT_WordprocessingContentPartNonVisual" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="xfrm" type="a:CT_Transform2D" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="bwMode" type="a:ST_BlackWhiteMode" use="optional"/>
|
||||||
|
<xsd:attribute ref="r:id" use="required"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WordprocessingGroup">
|
||||||
|
<xsd:sequence minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="cNvPr" type="a:CT_NonVisualDrawingProps" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="cNvGrpSpPr" type="a:CT_NonVisualGroupDrawingShapeProps" minOccurs="1"
|
||||||
|
maxOccurs="1"/>
|
||||||
|
<xsd:element name="grpSpPr" type="a:CT_GroupShapeProperties" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element ref="wsp"/>
|
||||||
|
<xsd:element name="grpSp" type="CT_WordprocessingGroup"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicFrame"/>
|
||||||
|
<xsd:element ref="dpct:pic"/>
|
||||||
|
<xsd:element name="contentPart" type="CT_WordprocessingContentPart"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_WordprocessingCanvas">
|
||||||
|
<xsd:sequence minOccurs="1" maxOccurs="1">
|
||||||
|
<xsd:element name="bg" type="a:CT_BackgroundFormatting" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:element name="whole" type="a:CT_WholeE2oFormatting" minOccurs="0" maxOccurs="1"/>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element ref="wsp"/>
|
||||||
|
<xsd:element ref="dpct:pic"/>
|
||||||
|
<xsd:element name="contentPart" type="CT_WordprocessingContentPart"/>
|
||||||
|
<xsd:element ref="wgp"/>
|
||||||
|
<xsd:element name="graphicFrame" type="CT_GraphicFrame"/>
|
||||||
|
</xsd:choice>
|
||||||
|
<xsd:element name="extLst" type="a:CT_OfficeArtExtensionList" minOccurs="0" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="wpc" type="CT_WordprocessingCanvas"/>
|
||||||
|
<xsd:element name="wgp" type="CT_WordprocessingGroup"/>
|
||||||
|
<xsd:element name="wsp" type="CT_WordprocessingShape"/>
|
||||||
|
<xsd:element name="inline" type="CT_Inline"/>
|
||||||
|
<xsd:element name="anchor" type="CT_Anchor"/>
|
||||||
|
</xsd:schema>
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,28 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://schemas.openxmlformats.org/officeDocument/2006/characteristics"
|
||||||
|
targetNamespace="http://schemas.openxmlformats.org/officeDocument/2006/characteristics"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:complexType name="CT_AdditionalCharacteristics">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="characteristic" type="CT_Characteristic" minOccurs="0"
|
||||||
|
maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_Characteristic">
|
||||||
|
<xsd:attribute name="name" type="xsd:string" use="required"/>
|
||||||
|
<xsd:attribute name="relation" type="ST_Relation" use="required"/>
|
||||||
|
<xsd:attribute name="val" type="xsd:string" use="required"/>
|
||||||
|
<xsd:attribute name="vocabulary" type="xsd:anyURI" use="optional"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:simpleType name="ST_Relation">
|
||||||
|
<xsd:restriction base="xsd:string">
|
||||||
|
<xsd:enumeration value="ge"/>
|
||||||
|
<xsd:enumeration value="le"/>
|
||||||
|
<xsd:enumeration value="gt"/>
|
||||||
|
<xsd:enumeration value="lt"/>
|
||||||
|
<xsd:enumeration value="eq"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:element name="additionalCharacteristics" type="CT_AdditionalCharacteristics"/>
|
||||||
|
</xsd:schema>
|
||||||
@@ -0,0 +1,144 @@
|
|||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
|
||||||
|
xmlns="http://schemas.openxmlformats.org/officeDocument/2006/bibliography"
|
||||||
|
xmlns:s="http://schemas.openxmlformats.org/officeDocument/2006/sharedTypes"
|
||||||
|
targetNamespace="http://schemas.openxmlformats.org/officeDocument/2006/bibliography"
|
||||||
|
elementFormDefault="qualified">
|
||||||
|
<xsd:import namespace="http://schemas.openxmlformats.org/officeDocument/2006/sharedTypes"
|
||||||
|
schemaLocation="shared-commonSimpleTypes.xsd"/>
|
||||||
|
<xsd:simpleType name="ST_SourceType">
|
||||||
|
<xsd:restriction base="s:ST_String">
|
||||||
|
<xsd:enumeration value="ArticleInAPeriodical"/>
|
||||||
|
<xsd:enumeration value="Book"/>
|
||||||
|
<xsd:enumeration value="BookSection"/>
|
||||||
|
<xsd:enumeration value="JournalArticle"/>
|
||||||
|
<xsd:enumeration value="ConferenceProceedings"/>
|
||||||
|
<xsd:enumeration value="Report"/>
|
||||||
|
<xsd:enumeration value="SoundRecording"/>
|
||||||
|
<xsd:enumeration value="Performance"/>
|
||||||
|
<xsd:enumeration value="Art"/>
|
||||||
|
<xsd:enumeration value="DocumentFromInternetSite"/>
|
||||||
|
<xsd:enumeration value="InternetSite"/>
|
||||||
|
<xsd:enumeration value="Film"/>
|
||||||
|
<xsd:enumeration value="Interview"/>
|
||||||
|
<xsd:enumeration value="Patent"/>
|
||||||
|
<xsd:enumeration value="ElectronicSource"/>
|
||||||
|
<xsd:enumeration value="Case"/>
|
||||||
|
<xsd:enumeration value="Misc"/>
|
||||||
|
</xsd:restriction>
|
||||||
|
</xsd:simpleType>
|
||||||
|
<xsd:complexType name="CT_NameListType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="Person" type="CT_PersonType" minOccurs="1" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_PersonType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="Last" type="s:ST_String" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
<xsd:element name="First" type="s:ST_String" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
<xsd:element name="Middle" type="s:ST_String" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_NameType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="NameList" type="CT_NameListType" minOccurs="1" maxOccurs="1"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_NameOrCorporateType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="1">
|
||||||
|
<xsd:element name="NameList" type="CT_NameListType" minOccurs="1" maxOccurs="1"/>
|
||||||
|
<xsd:element name="Corporate" minOccurs="1" maxOccurs="1" type="s:ST_String"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_AuthorType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element name="Artist" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Author" type="CT_NameOrCorporateType"/>
|
||||||
|
<xsd:element name="BookAuthor" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Compiler" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Composer" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Conductor" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Counsel" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Director" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Editor" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Interviewee" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Interviewer" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Inventor" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Performer" type="CT_NameOrCorporateType"/>
|
||||||
|
<xsd:element name="ProducerName" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Translator" type="CT_NameType"/>
|
||||||
|
<xsd:element name="Writer" type="CT_NameType"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:complexType name="CT_SourceType">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:choice minOccurs="0" maxOccurs="unbounded">
|
||||||
|
<xsd:element name="AbbreviatedCaseNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="AlbumTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Author" type="CT_AuthorType"/>
|
||||||
|
<xsd:element name="BookTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Broadcaster" type="s:ST_String"/>
|
||||||
|
<xsd:element name="BroadcastTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="CaseNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="ChapterNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="City" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Comments" type="s:ST_String"/>
|
||||||
|
<xsd:element name="ConferenceName" type="s:ST_String"/>
|
||||||
|
<xsd:element name="CountryRegion" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Court" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Day" type="s:ST_String"/>
|
||||||
|
<xsd:element name="DayAccessed" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Department" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Distributor" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Edition" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Guid" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Institution" type="s:ST_String"/>
|
||||||
|
<xsd:element name="InternetSiteTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Issue" type="s:ST_String"/>
|
||||||
|
<xsd:element name="JournalName" type="s:ST_String"/>
|
||||||
|
<xsd:element name="LCID" type="s:ST_Lang"/>
|
||||||
|
<xsd:element name="Medium" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Month" type="s:ST_String"/>
|
||||||
|
<xsd:element name="MonthAccessed" type="s:ST_String"/>
|
||||||
|
<xsd:element name="NumberVolumes" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Pages" type="s:ST_String"/>
|
||||||
|
<xsd:element name="PatentNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="PeriodicalTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="ProductionCompany" type="s:ST_String"/>
|
||||||
|
<xsd:element name="PublicationTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Publisher" type="s:ST_String"/>
|
||||||
|
<xsd:element name="RecordingNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="RefOrder" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Reporter" type="s:ST_String"/>
|
||||||
|
<xsd:element name="SourceType" type="ST_SourceType"/>
|
||||||
|
<xsd:element name="ShortTitle" type="s:ST_String"/>
|
||||||
|
<xsd:element name="StandardNumber" type="s:ST_String"/>
|
||||||
|
<xsd:element name="StateProvince" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Station" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Tag" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Theater" type="s:ST_String"/>
|
||||||
|
<xsd:element name="ThesisType" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Title" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Type" type="s:ST_String"/>
|
||||||
|
<xsd:element name="URL" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Version" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Volume" type="s:ST_String"/>
|
||||||
|
<xsd:element name="Year" type="s:ST_String"/>
|
||||||
|
<xsd:element name="YearAccessed" type="s:ST_String"/>
|
||||||
|
</xsd:choice>
|
||||||
|
</xsd:sequence>
|
||||||
|
</xsd:complexType>
|
||||||
|
<xsd:element name="Sources" type="CT_Sources"/>
|
||||||
|
<xsd:complexType name="CT_Sources">
|
||||||
|
<xsd:sequence>
|
||||||
|
<xsd:element name="Source" type="CT_SourceType" minOccurs="0" maxOccurs="unbounded"/>
|
||||||
|
</xsd:sequence>
|
||||||
|
<xsd:attribute name="SelectedStyle" type="s:ST_String"/>
|
||||||
|
<xsd:attribute name="StyleName" type="s:ST_String"/>
|
||||||
|
<xsd:attribute name="URI" type="s:ST_String"/>
|
||||||
|
</xsd:complexType>
|
||||||
|
</xsd:schema>
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user