Skip to content

XSL: drop deprecated "jsxgraph" and "paragraphs" as "sidebyside" panels - #3062

Merged
rbeezer merged 1 commit into
PreTeXtBook:masterfrom
rbeezer:sidebyside-drop-deprecated-panels
Jul 22, 2026
Merged

XSL: drop deprecated "jsxgraph" and "paragraphs" as "sidebyside" panels#3062
rbeezer merged 1 commit into
PreTeXtBook:masterfrom
rbeezer:sidebyside-drop-deprecated-panels

Conversation

@rbeezer

@rbeezer rbeezer commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Summary

A "jsxgraph" and a "paragraphs" have been deprecated as panels of a "sidebyside" since 2018 — "jsxgraph" was absorbed into "interactive", and "paragraphs" was reserved as a lightweight division. The schema already disallows both in that position (a "paragraphs" is not a valid "sidebyside" panel, and "jsxgraph" is not permitted anywhere), yet the stylesheets still rendered them: the shared panel-content entity SBSPANEL, introduced with the side-by-side entity work in #3057, continued to list them.

This removes the two elements from SBSPANEL, so a "jsxgraph" or "paragraphs" placed directly in a "sidebyside" is no longer rendered as a panel. Because that single entity drives the panel selection in the common "sidebyside" template, the change applies uniformly to HTML, LaTeX/PDF, and PDF via FO. The deprecation warnings are updated to say so.

Changes

  • xsl/entities.ent: drop "jsxgraph" and "paragraphs" from SBSPANEL, and trim the accompanying comment. STACKABLE already excluded both, so a "stack" panel is unaffected.
  • xsl/pretext-common.xsl: add a "sidebyside"-specific deprecation for "jsxgraph" (mirroring the existing "paragraphs" one), and extend both messages to note that, as of 2026-07-22, such a panel and its content are silently ignored.

Notes

  • A standalone "jsxgraph" (outside a "sidebyside") is untouched — its general deprecation message is unchanged and it continues to render.
  • Verified: a "sidebyside" containing a "paragraphs" or "jsxgraph" panel now renders neither in HTML, LaTeX, or FO, while both deprecation warnings still fire. The sample article — whose "jsxgraph" and "paragraphs" are all standalone or divisions — is unchanged.

Claude Opus 4.8, acting as a coding assistant for Rob Beezer

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012b3Z81apPnfAvj7fLBDPzZ
@rbeezer
rbeezer merged commit ff7ceb2 into PreTeXtBook:master Jul 22, 2026
@rbeezer
rbeezer deleted the sidebyside-drop-deprecated-panels branch July 22, 2026 23:54
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