odglisted

# ODG creation, editing, and analysis ## Overview An `.odg` file is an OpenDocument ZIP package for vector drawings, diagrams, and LibreOffice Draw documents. Important package files: - `mimetype` - should be the first ZIP entry and stored uncompressed as `application/vnd.oasis.opendocument.graphics` - `content.xml` - pages, shapes, connectors, text boxes, images, and drawing content - `styles.xml` - drawing, text, page, and graphic styles - `meta.xml` - document metadata - `settings.xml` - application settings - `META-INF/manifest.xml` - package manifest - `Pictures/...` - embedded raster or vector media ## Quick Reference | Task | Preferred approach | |------|--------------------| | Create simple drawing/diagram | Generate ODG package XML directly | | Create branded/repeated diagram | Start from an `.odg` template and edit XML | | Use SVG-first | Only when portable vector output matters more than Draw editability | | Extract visible text | Use `scripts/extract_text.py` or parse `content.xml` | | Inspect shapes/geometry | Use `scripts/extract_shapes.py` | | Convert ODG to PDF/SVG/PNG | LibreOffice headless export | | Visual QA | Export to PDF/PNG/SVG and inspect the rendered output | ## Tool Checks Before starting a real ODG task, check available tools: ```bash which pandoc ``` Resolve the LibreOffice command as described in [docs/soffice-resolver.md](../../docs/soffice-resolver.md). ## Reading and Inspecting For raw package inspection: ```bash unzip -l input.odg