Skip to content

fix(preview): improve table of contents rendering and disable toc: left - #1144

Merged
ggrossetie merged 1 commit into
asciidoctor:mainfrom
ggrossetie:fix/toc-preview-styling
Jul 5, 2026
Merged

fix(preview): improve table of contents rendering and disable toc: left#1144
ggrossetie merged 1 commit into
asciidoctor:mainfrom
ggrossetie:fix/toc-preview-styling

Conversation

@ggrossetie

Copy link
Copy Markdown
Member

Force every toc: left/right sidebar to the right (a left sidebar overlapped the document text in the preview instead of reserving a column), so toc: left now renders like toc: right.

Clean up the header-anchored TOC (:toc: auto, or a collapsed sidebar): it is now bracketed by exactly two rules — one below the title/author and one below the TOC — with no doubled line and matching top/bottom padding. A body-placed toc::[] macro keeps its boxed-card styling. Under the editor theme these separators used currentColor (a harsh black/white line) and now use the subtle theme border color.

Document the table-of-contents behaviour, including the unsupported left sidebar, on the Preview page.

Force every `toc: left`/`right` sidebar to the right (a left sidebar
overlapped the document text in the preview instead of reserving a
column), so `toc: left` now renders like `toc: right`.

Clean up the header-anchored TOC (`:toc:` auto, or a collapsed sidebar):
it is now bracketed by exactly two rules — one below the title/author and
one below the TOC — with no doubled line and matching top/bottom padding.
A body-placed `toc::[]` macro keeps its boxed-card styling. Under the
editor theme these separators used `currentColor` (a harsh black/white
line) and now use the subtle theme border color.

Document the table-of-contents behaviour, including the unsupported left
sidebar, on the Preview page.
@ggrossetie
ggrossetie merged commit da5c094 into asciidoctor:main Jul 5, 2026
2 checks passed
@ggrossetie
ggrossetie deleted the fix/toc-preview-styling branch July 7, 2026 08:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant