62 lines
3.9 KiB
Markdown
62 lines
3.9 KiB
Markdown
# Format support
|
|
|
|
Office Tools 0.1.0 targets read-only browser viewing, not editing or
|
|
pixel-identical reproduction.
|
|
|
|
| Family | Extensions | 0.1 viewing coverage |
|
|
| ---------------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
|
|
| Office Open XML document | `.docx/.docm/.dotx/.dotm` | Paginated sections, text, lists, tables, images, shapes, charts, headers/footers, comments, selection and find |
|
|
| Office Open XML spreadsheet | `.xlsx/.xlsm/.xltx/.xltm` | Sheets, cached values/formulas, styles, merges, frozen panes, images, charts, comments, navigation and find |
|
|
| Office Open XML presentation | `.pptx/.pptm/.potx/.potm/.ppsx/.ppsm` | Slides/masters, text, shapes, images, tables, charts, notes, selection, navigation and find |
|
|
| OpenDocument text | `.odt` | Semantic headings, runs, inherited styles, tables, images, metadata, comments and foot/endnotes |
|
|
| OpenDocument spreadsheet | `.ods` | Typed/cached values, formulas, repeats, merges, row/column defaults, visibility, annotations and paged rows |
|
|
| OpenDocument presentation | `.odp` | Page geometry, positioned/transformed shapes, groups, tables, packaged images, notes and safe styling |
|
|
|
|
Legacy compound-binary `.doc`, `.xls` and `.ppt` formats are explicitly outside
|
|
the first package-reader slice. They require a distinct, bounded parser and must
|
|
not be misidentified as their XML successors.
|
|
|
|
The input boundary also identifies RTF, older OpenOffice `.sxw/.sxc/.sxi`, flat
|
|
OpenDocument `.fodt/.fods/.fodp`, renamed OLE Compound Files and invalid non-ZIP
|
|
packages. It explains the required conversion instead of passing them to a ZIP
|
|
or XML successor parser.
|
|
|
|
## Export paths
|
|
|
|
- `Save exact copy` downloads the original immutable File for every format.
|
|
- ODT exports plain semantic text; ODS exports the active sheet's cached display
|
|
values as bounded UTF-8 CSV; ODP exports a text slide/notes outline.
|
|
- ODF inspection JSON excludes embedded asset bytes while retaining asset
|
|
identities, sizes, styles, metadata and the bounded semantic structure.
|
|
- Derived exports are intentionally not advertised as round-trip replacements.
|
|
|
|
## Never executed
|
|
|
|
Macros, VBA projects, embedded executables, OLE objects, scripts, remote
|
|
templates and automatic external relationships remain inert. Unsupported
|
|
content is reported in diagnostics where it can be identified.
|
|
|
|
## Known boundaries
|
|
|
|
- Spreadsheet formulas display their saved cached result; Office Tools does not
|
|
recalculate them or refresh pivots and external data.
|
|
- Presentation animations and transitions are not reproduced. Embedded media
|
|
playback is disabled in the first release.
|
|
- OLE, ActiveX, VBA and OpenDocument embedded objects remain inert. The ODF
|
|
semantic view reports and omits embedded objects such as chart subdocuments.
|
|
- OpenDocument slide masters/layouts are identified but not fully reproduced;
|
|
uncommon drawing transforms and office-suite-specific layout can be
|
|
approximated.
|
|
- Fonts are substituted locally. Remote fonts, templates, images and links are
|
|
never fetched.
|
|
- ODS renders 200 rows at a time and up to 256 columns. Empty full-grid tails
|
|
emitted by office suites are deliberately trimmed.
|
|
|
|
## Safety limits
|
|
|
|
The source-file limit is 100 MiB. OOXML and ODF packages also enforce expanded
|
|
entry, total expanded byte, entry-count and image limits. ODF additionally
|
|
bounds compression ratio, XML depth/nodes, text, repeats, cells and assets.
|
|
Files that exceed a boundary fail with a visible diagnostic instead of being
|
|
partially trusted.
|