Skip to content

resolves #4522 introduce STEM adapter facility - #4858

Open
ggrossetie wants to merge 2 commits into
asciidoctor:mainfrom
ggrossetie:4522-stem-adapter
Open

resolves #4522 introduce STEM adapter facility#4858
ggrossetie wants to merge 2 commits into
asciidoctor:mainfrom
ggrossetie:4522-stem-adapter

Conversation

@ggrossetie

Copy link
Copy Markdown
Member

Adds a pluggable StemAdapter module that allows alternate STEM renderers (e.g., KaTeX, MathML converters) to be integrated into AsciiDoc processing.
The built-in MathJaxAdapter reproduces existing behavior and registers for all standard stem attribute values (mathjax, asciimath, latexmath, latex, tex).
The adapter exposes three integration points: convert (content with delimiters), format (enclosing block element), and docinfo (client-side script injection).

Resolves #4522

ggrossetie and others added 2 commits May 28, 2026 15:34
Adds a pluggable StemAdapter module that allows alternate STEM renderers (e.g., KaTeX, MathML converters) to be integrated into AsciiDoc processing.
The built-in MathJaxAdapter reproduces existing behavior and registers for all standard stem attribute values (mathjax, asciimath, latexmath, latex, tex).
The adapter exposes three integration points: `convert` (content with delimiters), `format` (enclosing block element), and `docinfo` (client-side script injection).

Resolves asciidoctor#4522
Documents the new stem adapter facility introduced in asciidoctor#4522: adds a
custom-adapter page with a KaTeX example covering all integration points
(convert, format, docinfo head/footer), updates the STEM index to describe
the facility and the stem-adapter attribute, and adds the page to the nav.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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.

Introduce a STEM adapter facility

1 participant