Skip to content

Add layout strategies and diagnostics for wide tables #7

Description

@sigilabcodex

The stress-tests/cases/wide-table.md stress test shows that OSER can render a wide Markdown table to HTML and PDF without crashing, but the current print profile squeezes many columns into the page width. The result remains technically readable, but long cells wrap into very tall rows and the table becomes editorially awkward.

Observed behavior:

  • HTML output renders the table inside the page column without obvious horizontal overflow.
  • PDF output preserves all columns and does not clip the table.
  • Long text in narrow columns wraps heavily, producing tall rows.
  • The table is usable as a stress-test result, but not yet a polished editorial layout.

Potential future work:

  • Add diagnostics for wide tables, e.g. table-too-wide or table-many-columns.
  • Add LayoutProfile options for table strategy:
    • normal wrapping
    • compact table typography
    • landscape/table page
    • horizontal scroll for web outputs
    • split table across pages/sections
    • convert wide table to card/list format for narrow outputs
  • Add Studio UI hints when a table is likely to need manual/editorial review.
  • Consider separate behavior for HTML, print PDF, and WebBook outputs.

This should not be fixed blindly in the renderer. Wide tables are often editorial decisions, so OSER should surface options and warnings rather than forcing one universal behavior.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions