Open Document Format format (.odt, .ods, .odp, .odg, .odf)

ODF (OpenDocument Format) is the OASIS standard used by LibreOffice, OpenOffice, and compatible suites. neokapi handles the text (.odt), spreadsheet (.ods), presentation (.odp), and graphics (.odg) variants, auto-detecting the variant from the package's mimetype entry. Each file is a ZIP archive containing a content.xml payload plus styles and metadata sub-documents; the reader extracts translatable text from the content while preserving the surrounding XML and the package structure as skeleton.

neokapi reads and writes ODF, round-tripping the archive so the translated output remains a valid OpenDocument file. By default it extracts presentation notes but skips hidden content — matching the upstream Okapi OpenOffice filter behaviour. The native reader applies these defaults but does not expose them as a configurable JSON schema in this reference.

IDodf

SourceBuilt-in

Extensions.odt, .ods, .odp, .odg, .odf

MIME Typesapplication/vnd.oasis.opendocument.text, application/vnd.oasis.opendocument.spreadsheet, application/vnd.oasis.opendocument.presentation

CapabilitiesRead + Write

Parameters

Parameter	Type	Default	Description
extractNonTranslatableContent	boolean	true	If true (default), non-translatable contextual content — image accessibility text (svg:title/svg:desc alt-text and long descriptions) and form-control display strings (form:label/form:title/form:help-text) — is surfaced as content blocks (visible to ingestion/LLM consumers, skipped by machine translation) instead of being hidden in skeleton. Disable to keep it in skeleton.
translateHiddenContent	boolean	false	If true, hidden content is extracted as translatable content.
translateNotes	boolean	true	If true, presentation speaker notes are extracted as translatable content.

Configure it live

Configuration

Loading form…

Configuration output

vs defaultsno changes

apiVersion: neokapi/v1
kind: OdfFormatConfig
metadata:
  name: odf
spec:
  # (default configuration)

Processing notes

• The ODF variant (text, spreadsheet, presentation, graphics) is auto-detected from the package mimetype entry.

• Presentation notes are extracted by default; the surrounding XML and package structure are preserved as skeleton.

• Each sub-document inside the ZIP archive is processed independently.

Limitations

• Hidden content is not extracted by default.

• Extraction toggles match the upstream Okapi OpenOffice filter but are not surfaced as configurable schema properties in this reference.

Reference documentation

← Back to the Format Reference