add beamer support (#1187)

* add beamer support

* Update slideshow templates

* update tests

* update schema

* build rng

Author: oscarlevin

CHANGELOG.md

@@ -9,6 +9,13 @@ Instructions: Add a subsection under `[Unreleased]` for additions, fixes, change
 
 ## [Unreleased]
 
+### Added
+- Experimental support for beamer format builds (from a `<slideshow>`).  Use `<target name="slides" format="beamer"/>` in the manifest to build a beamer PDF. 
+- Publication variable to use cdn javascript/css for HTML output instead of local copies.
+
+### Fixed
+- Better heading levels for HTML output to improve accessibility.
+
 ## [2.43.2] - 2026-07-07
 
 Includes updates to core through commit: [ad605bb](https://github.com/PreTeXtBook/pretext/commit/ad605bb27faf9f12c2bcb3b98ea953533f1aacb4)

poetry.lock

@@ -18,8 +18,7 @@
 
 VERSION = get_version("pretext", Path(__file__).parent.parent)
 
-
-CORE_COMMIT = "ad605bb27faf9f12c2bcb3b98ea953533f1aacb4"
+CORE_COMMIT = "07c8b5c9a9a55e95ec27073e88bd5c9c61b9c161"
 
 
 def activate() -> None:

pretext/__init__.py

@@ -12,6 +12,7 @@
     "kindle",
     "braille",
     "revealjs",
+    "beamer",
     "webwork",
     "custom",
 ]
@@ -123,6 +124,20 @@
         "datafile",
         "myopenmath",
     ],
+    "beamer": [
+        "webwork",
+        "sageplot",
+        "asymptote",
+        "prefigure",
+        "youtube",
+        "codelens",
+        "datafile",
+        "interactive",
+        "qrcode",
+        "mermaid",
+        "myopenmath",
+        "dynamic-subs",
+    ],
     "webwork": [
         "webwork",
     ],
@@ -239,6 +254,13 @@
         "sageplot": ["html", "svg"],
         "prefigure": ["svg"],
     },
+    "beamer": {
+        "asymptote": ["pdf"],
+        "latex-image": [],
+        "sageplot": ["pdf", "png"],
+        "prefigure": ["pdf"],
+        "mermaid": ["png"],
+    },
     "webwork": {
         "asymptote": [],
         "latex-image": [],

pretext/constants.py

@@ -56,6 +56,7 @@ class Format(str, Enum):
     KINDLE = "kindle"
     BRAILLE = "braille"
     REVEALJS = "revealjs"
+    BEAMER = "beamer"
     WEBWORK = "webwork"
     CUSTOM = "custom"
 
@@ -67,6 +68,7 @@ class Format(str, Enum):
     Format.EPUB: ".epub",
     Format.KINDLE: ".epub",
     Format.BRAILLE: ".brl",
+    Format.BEAMER: ".pdf",
 }
 
 
@@ -874,6 +876,7 @@ def build(
                         dest_dir=self.output_dir_abspath().as_posix(),
                         method=self.pdf_method,
                         outputs="all" if latex else "pdf-only",
+                        format_xsl=None,
                     )
             elif self.format == Format.LATEX:
                 core.pdf(
@@ -885,6 +888,7 @@ def build(
                     dest_dir=self.output_dir_abspath().as_posix(),
                     method=self.pdf_method,
                     outputs="prebuild",
+                    format_xsl=None,
                 )
             elif self.format == Format.EPUB:
                 utils.mjsre_npm_install()
@@ -930,6 +934,17 @@ def build(
                     out_file=out_file,
                     dest_dir=self.output_dir_abspath().as_posix(),
                 )
+            elif self.format == Format.BEAMER:
+                core.beamer(
+                    xml=self.source_abspath(),
+                    pub_file=self.publication_abspath().as_posix(),
+                    stringparams=stringparams_copy,
+                    extra_xsl=custom_xsl,
+                    out_file=out_file,
+                    dest_dir=self.output_dir_abspath().as_posix(),
+                    method=self.pdf_method,
+                    outputs="all" if latex else "pdf-only",
+                )
             elif self.format == Format.BRAILLE:
                 log.warning(
                     "Braille output is still experimental, and requires additional libraries from liblouis (specifically the file2brl software)."

pretext/project/__init__.py

@@ -45,7 +45,7 @@ plastex = "^3"
 jinja2 = "^3"
 coloraide = "^4"
 pelican = { extras = ["markdown"], version = "^4.10", optional = true }
-prefig = { extras = ["text"], version = "^0.6.5", optional = true }
+prefig = { extras = ["text"], version = "^0.6.7", optional = true }
 citeproc-py = "^0"
 
 

pyproject.toml

@@ -44,14 +44,15 @@ Target = element target {
 	## Unique identifier for this build target. This is the name you pass on the
 	## command line when building via the `pretext` CLI.
 	attribute name { text },
-	## the required format can be `html`, `pdf`, `latex`, `epub`, `kindle`, `braille`, `revealjs`, `webwork`, or `custom`.
+	## the required format can be `html`, `pdf`, `latex`, `epub`, `kindle`, `braille`, `revealjs`, `beamer`, `webwork`, or `custom`.
 	(
 		HtmlAttributes
 		| PdfAttributes
 		| LatexAttributes
 		| EpubAttributes
 		| BrailleAttributes
 		| RevealjsAttributes
+		| BeamerAttributes
 		| WebworkAttributes
 		| CustomAttributes
 	),
@@ -81,6 +82,7 @@ HtmlAttributes = (
 
 PdfAttributes = (
 	attribute format { "pdf" },
+	attribute pdf-method { "xelatex" | "pdflatex" | "latex" | "pdf-fo"}?,
 	attribute latex-engine { "xelatex" | "pdflatex" | "latex" }?,
 	attribute output-filename { text }?
 )
@@ -105,6 +107,11 @@ RevealjsAttributes = (
 	attribute output-filename { text }?
 )
 
+BeamerAttributes = (
+	attribute format { "beamer" },
+	attribute output-filename { text }?
+)
+
 WebworkAttributes = (
 	attribute format { "webwork" },
 	attribute compression { "zip" }?
@@ -127,4 +134,4 @@ Stringparams = element stringparams {
 	attribute html.css.extra { text }?
 }
 
-}
+}

schema/project-ptx.rnc

@@ -74,13 +74,14 @@
 command line when building via the `pretext` CLI.</a:documentation>
       </attribute>
       <choice>
-        <a:documentation>the required format can be `html`, `pdf`, `latex`, `epub`, `kindle`, `braille`, `revealjs`, `webwork`, or `custom`.</a:documentation>
+        <a:documentation>the required format can be `html`, `pdf`, `latex`, `epub`, `kindle`, `braille`, `revealjs`, `beamer`, `webwork`, or `custom`.</a:documentation>
         <ref name="HtmlAttributes"/>
         <ref name="PdfAttributes"/>
         <ref name="LatexAttributes"/>
         <ref name="EpubAttributes"/>
         <ref name="BrailleAttributes"/>
         <ref name="RevealjsAttributes"/>
+        <ref name="BeamerAttributes"/>
         <ref name="WebworkAttributes"/>
         <ref name="CustomAttributes"/>
       </choice>
@@ -158,6 +159,16 @@ These parameters are rarely used by content authors.</a:documentation>
     <attribute name="format">
       <value>pdf</value>
     </attribute>
+    <optional>
+      <attribute name="pdf-method">
+        <choice>
+          <value>xelatex</value>
+          <value>pdflatex</value>
+          <value>latex</value>
+          <value>pdf-fo</value>
+        </choice>
+      </attribute>
+    </optional>
     <optional>
       <attribute name="latex-engine">
         <choice>
@@ -211,6 +222,14 @@ These parameters are rarely used by content authors.</a:documentation>
       <attribute name="output-filename"/>
     </optional>
   </define>
+  <define name="BeamerAttributes">
+    <attribute name="format">
+      <value>beamer</value>
+    </attribute>
+    <optional>
+      <attribute name="output-filename"/>
+    </optional>
+  </define>
   <define name="WebworkAttributes">
     <attribute name="format">
       <value>webwork</value>