Skip to content

docs: furo copies a titled table's id onto its wrapper, so const/reg.html carries duplicate ids #1861

Closed

Description

@JarryShaw

On const/reg.html, each of id9–id13 appears both on a <div class="table-wrapper …"> and on the <table> inside it. No other page has a duplicate id.

They come from the titled .. list-table:: {title} blocks that AppType.tabulate emits (pcapkit/vendor/reg/apptype/apptype.py:1153, with the titles at :1371 and :1380). furo 2025.12.19's wrapper transform calls update_all_atts (furo/__init__.py:56), which copies ids along with the rest. Reproduced independently with a titled list-table.

Fix, one of:

  • a conf.py post-transform at a priority above furo's that clears ids on table-wrapper containers; this was verified to remove the duplicates;
  • drop the list-table title in the generator.

Report it upstream either way.

Activity

  1. added
    docsPull requests that change documentation only (docs: subject prefix)
    pendingAccepted and unstarted - nobody is on it and nothing blocks it
    on Oct 16, 2026
  2. JarryShaw commented on Oct 16, 2026

    @JarryShaw
    OwnerAuthor

    Blocked until #1856 merges. That PR bumps sphinx-autodoc-typehints, which changes how signatures render, and it edits docs/source/conf.py, which this fix also edits.

  3. added
    blockedDeferred pending another issue or decision; see the last comment for what unblocks it
    and removed
    pendingAccepted and unstarted - nobody is on it and nothing blocks it
    on Oct 16, 2026
  4. moved this to Blocked in PyPCAPKiton Oct 16, 2026
  5. JarryShaw commented on Oct 17, 2026

    @JarryShaw
    OwnerAuthor

    Started on top of #1877, the PR for #1856, so the conf.py edits don't conflict. One worker is taking #1858–#1863 together, since every fix goes through conf.py.

  6. added
    wipWork in flight - a covering PR is open or an agent is actively on it
    and removed
    blockedDeferred pending another issue or decision; see the last comment for what unblocks it
    on Oct 17, 2026
  7. moved this from Blocked to WIP in PyPCAPKiton Oct 17, 2026
  8. removed
    wipWork in flight - a covering PR is open or an agent is actively on it
    on Oct 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsPull requests that change documentation only (docs: subject prefix)

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions