Skip to content

docs(image): Usage-Guide für native Bild-Metadaten (RFC 0005)#77

Merged
lepy merged 1 commit into
masterfrom
docs/image-metadata-usage
Jun 29, 2026
Merged

docs(image): Usage-Guide für native Bild-Metadaten (RFC 0005)#77
lepy merged 1 commit into
masterfrom
docs/image-metadata-usage

Conversation

@lepy

@lepy lepy commented Jun 29, 2026

Copy link
Copy Markdown
Owner

Was

Rundet das in #76 gelieferte Image-Metadaten-Feature dokumentarisch ab: eine
How-to-Seite ergänzt RFC 0005 (Entwurf) und die API-Referenz (Referenz).

docs/usage/image-metadata.md:

  • Einheitliche Image-API über PNG/JPEG/JP2/GIF/WebP (from_bytes/from_file/
    save/embedded_metadata) mit Code-Beispielen.
  • Verlustfreies Einbetten ohne Re-Encoding vs. Transkodierung bei Formatwechsel.
  • Geerbte Blob-Fähigkeiten (size/sha256/verify/write).
  • Hinweis Checksum vs. Einbettung (Einbetten ändert die Bytes/den Hash).
  • Low-Level-Fassade sdata.imagemeta (detect_format/embed/extract).
  • Sidecar als Komplement.

Nebenänderungen

  • mkdocs-Nav: Usage → „Image metadata"; Startseiten-Link in „Where to next".
  • API-Referenz: sdata.sclass.blob aufgenommen (Foundation-Klasse; löst die
    Cross-Reference der Usage-Seite auf).

Verifikation

mkdocs build --strict grün (alle Cross-Refs aufgelöst). Reine Docs-Änderung —
kein Python berührt, Tests/Coverage unverändert (100 %).

How-to-Seite docs/usage/image-metadata.md: einheitliche Image-API über
PNG/JPEG/JP2/GIF/WebP (from_bytes/from_file/save/embedded_metadata), verlustfreies
Einbetten ohne Re-Encoding vs. Transkodierung, geerbte Blob-Faehigkeiten
(size/sha256/verify/write), Checksum-vs-Einbettung-Hinweis, Low-Level-Fassade
sdata.imagemeta (detect_format/embed/extract), Sidecar-Komplement.

- mkdocs-Nav: Usage -> "Image metadata"; Startseiten-Link ergaenzt
- API-Referenz: sdata.sclass.blob aufgenommen (Foundation-Klasse; loest
  Cross-Reference der Usage-Seite auf)
- mkdocs build --strict gruen (alle Cross-Refs aufgeloest)
@lepy lepy merged commit 0db3283 into master Jun 29, 2026
1 of 2 checks passed
@lepy lepy deleted the docs/image-metadata-usage branch June 29, 2026 13:56
@codacy-production

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant