Skip to content

Add chapter structure and sidebar TOC#364

Merged
jserv merged 1 commit intomasterfrom
modular
Apr 23, 2026
Merged

Add chapter structure and sidebar TOC#364
jserv merged 1 commit intomasterfrom
modular

Conversation

@jserv
Copy link
Copy Markdown
Contributor

@jserv jserv commented Apr 23, 2026

This organizes into four chapters (Getting Started, Core Kernel Interfaces, Execution Context and Control Flow, Hardware Integration and Advanced Topics) while preserving flat section numbering via @removefromreset to avoid breaking existing references.

Enable the table of contents in HTML output and style it as a fixed sidebar with responsive collapse at 1100px. Override tex4ht default cascade for TOC indentation and chapterToc link properties. Add focus-visible outlines, print stylesheet, and WCAG AA contrast.

Provide fancyvrb-based fallbacks for minted environments in HTML mode (lib/codeblock.tex) so code blocks render with line numbers and proper framing under tex4ht. Disable fncychap in HTML mode to avoid its line-break errors in tex4ht processing.

Close #26


Summary by cubic

Adds a four‑chapter structure and a responsive HTML sidebar table of contents to improve navigation without breaking existing section anchors. Also fixes HTML build issues and ensures code blocks render reliably. Closes #26.

  • New Features

    • Organized content into four chapters; kept flat section numbering using @removefromreset to preserve existing links.
    • Enabled \tableofcontents in HTML with a fixed sidebar that collapses below 1100px; custom TOC indentation/link styles, focus-visible outlines, and WCAG AA contrast.
    • Added a print stylesheet and responsive layout updates; moved GitHub action buttons into a .page-actions toolbar.
    • Provided fancyvrb fallbacks for minted environments in tex4ht HTML mode so code blocks have line numbers and frames.
  • Bug Fixes

    • Disabled fncychap in HTML mode to avoid tex4ht line-break errors during processing.

Written for commit 1583d27. Summary will update on new commits.

This organizes into four chapters (Getting Started, Core Kernel
Interfaces, Execution Context and Control Flow, Hardware Integration
and Advanced Topics) while preserving flat section numbering via
\@removefromreset to avoid breaking existing references.

Enable the table of contents in HTML output and style it as a fixed
sidebar with responsive collapse at 1100px. Override tex4ht default
cascade for TOC indentation and chapterToc link properties. Add
focus-visible outlines, print stylesheet, and WCAG AA contrast.

Provide fancyvrb-based fallbacks for minted environments in HTML
mode (lib/codeblock.tex) so code blocks render with line numbers
and proper framing under tex4ht. Disable fncychap in HTML mode to
avoid its line-break errors in tex4ht processing.

Close #26
Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 3 files

@jserv jserv merged commit a7d9538 into master Apr 23, 2026
2 checks passed
@jserv jserv deleted the modular branch April 23, 2026 05: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.

Modular LaTeX Documents.

1 participant