Latex source saving (#1090)

* Improve latex and pdf building

* add latex flag to keep latex source

* remove extra managed directory copying

Author: oscarlevin

CHANGELOG.md

@@ -9,6 +9,10 @@ Instructions: Add a subsection under `[Unreleased]` for additions, fixes, change
 
 ## [Unreleased]
 
+### Added
+
+- PDF targets built with `--latex` flag will include the latex source in the output directory.
+
 ## [2.31.0] - 2025-11-20
 
 Includes updates to core through commit: [65231d1](https://github.com/PreTeXtBook/pretext/commit/65231d1891e6a60f9e9d4873520e5d3e849e59b3)

new-pretext-project1/logs/.fuse_hidden0006e26600000258

@@ -19,7 +19,7 @@
 VERSION = get_version("pretext", Path(__file__).parent.parent)
 
 
-CORE_COMMIT = "65231d1891e6a60f9e9d4873520e5d3e849e59b3"
+CORE_COMMIT = "ce20f15d525f2d1e7a3c3fb8da3bb5fa9d16d3ee"
 
 
 def activate() -> None:

new-pretext-project1/logs/.fuse_hidden0006e27000000230

@@ -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/__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,20 +777,18 @@ def build(
                     out_file=out_file,
                     dest_dir=self.output_dir_abspath().as_posix(),
                     method=self.latex_engine,
+                    outputs="all" if latex else "pdf",
                 )
             elif self.format == Format.LATEX:
-                core.latex(
+                core.pdf(
                     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(),
-                )
-                utils.manage_directories(
-                    self.output_dir_abspath(),
-                    external_abs=self.external_dir_abspath(),
-                    generated_abs=self.generated_dir_abspath(),
+                    method=self.latex_engine,
+                    outputs="prebuild",
                 )
             elif self.format == Format.EPUB:
                 utils.mjsre_npm_install()