add latex flag to keep latex source

Author: oscarlevin

CHANGELOG.md

@@ -11,7 +11,7 @@ Instructions: Add a subsection under `[Unreleased]` for additions, fixes, change
 
 ### Added
 
-- PDF targets built with `-v debug` will include the latex source in the output directory.
+- PDF targets built with `--latex` flag will include the latex source in the output directory.
 
 ## [2.31.0] - 2025-11-20
 

pretext/cli.py

@@ -482,6 +482,12 @@ def init(refresh: bool, files: List[str], system: bool) -> None:
     is_flag=True,
     help="Only build the theme for the target, without performing any other build or generate steps.  (Themes are automatically built when building a target.)",
 )
+@click.option(
+    "-l",
+    "--latex",
+    is_flag=True,
+    help="When building a PDF, also place LaTeX source files in the output directory for inspection or manual compilation.",
+)
 @click.option(
     "-x",
     "--xmlid",
@@ -514,6 +520,7 @@ def build(
     generate: bool,
     no_generate: bool,
     theme: bool,
+    latex: bool,
     xmlid: Optional[str],
     no_knowls: bool,
     deploys: bool,
@@ -627,7 +634,11 @@ def build(
             if xmlid is not None:
                 log.info(f"with root of tree below {xmlid}")
             t.build(
-                clean=clean, generate=not no_generate, xmlid=xmlid, no_knowls=no_knowls
+                clean=clean,
+                generate=not no_generate,
+                xmlid=xmlid,
+                no_knowls=no_knowls,
+                latex=latex,
             )
             if t.format == "html" and t.compression is None:
                 log.info(

pretext/project/__init__.py

@@ -665,6 +665,7 @@ def build(
         generate: bool = True,
         xmlid: t.Optional[str] = None,
         no_knowls: bool = False,
+        latex: bool = False,
     ) -> None:
         # Add cli.version to stringparams.  Use only the major and minor version numbers.
         self.stringparams["cli.version"] = VERSION[: VERSION.rfind(".")]
@@ -776,7 +777,7 @@ def build(
                     out_file=out_file,
                     dest_dir=self.output_dir_abspath().as_posix(),
                     method=self.latex_engine,
-                    outputs="all" if log.isEnabledFor(logging.DEBUG) else "pdf",
+                    outputs="all" if latex else "pdf",
                 )
             elif self.format == Format.LATEX:
                 core.pdf(