Templates (#1086)

oscarlevin · web-flow · commit 75fa7babd84d · 2025-11-19T13:23:51.000-07:00
* fix worksheet publication template typo

* fix default slideshow output filename in slideshow template

* add commented journal name option to article template

* update tests to reflect new template output filename
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,12 @@ Instructions: Add a subsection under `[Unreleased]` for additions, fixes, change
 
 ## [Unreleased]
 
+### Fixed
+
+- Bug that sometimes prevented `pretext view` from working due to permissions on mac.
+- Typos in template publication files.
+- Default output filename for the slideshow template is now `index.html` so `pretext view` will open directly to the slideshow.
+
 ## [2.30.2] - 2025-11-11
 
 Includes updates to core through commit: [ad3ef3f](https://github.com/PreTeXtBook/pretext/commit/ad3ef3fb102bf393b9fe33ecb242848e5ca6b0df)
diff --git a/templates/article/publication/publication.ptx b/templates/article/publication/publication.ptx
@@ -4,4 +4,13 @@
     <source>
         <directories external="../assets" generated="../generated-assets"/>
     </source>
+
+    <common>
+        <!-- When writing an article for a specific journal, you can   -->
+        <!-- specify the name of the journal to get appropriate latex. -->
+        <!-- See the guide for a list of valid names:
+          https://pretextbook.org/doc/guide/html/appendix-journals.html#appendix-journals -->
+
+        <!--<journal name="ams" /> -->
+    </common>
 </publication>
diff --git a/templates/book/publication/publication.ptx b/templates/book/publication/publication.ptx
@@ -34,7 +34,7 @@
       <!-- <watermark scale="0.5">DRAFT</watermark> -->
 
     <!-- Mermaid diagram themes -->
-      <!-- <mermaid theme="default" /> -->  
+      <!-- <mermaid theme="default" /> -->
 
     <!-- QR code image: set path to an image to put in center of QR codes -->
       <!-- <qrcode image="image.png" /> -->
@@ -92,7 +92,7 @@
           font-size="10"
           draft="no"
           latex-style="dyslexic-font"
-      > 
+      >
   -->
 
     <!-- Control text justification and bottom page behavior. Add content intended for \geometry{} inside the <geometry> element. -->
@@ -109,7 +109,7 @@
     <!-- Covers: provide paths to pdfs for front and back covers: -->
       <!--<cover front="cover-front.pdf" back="cover-back.pdf" />-->
     <!-- Set @formatted to "no" to remove formatting on worksheets: -->
-      <!--<worksheets formatted="yes" />-->
+      <!--<worksheet formatted="yes" />-->
   </latex>
 
   <html>
diff --git a/templates/course/publication/publication-syllabus.ptx b/templates/course/publication/publication-syllabus.ptx
@@ -105,7 +105,7 @@
     <!-- Covers: provide paths to pdfs for front and back covers: -->
       <!--<cover front="cover-front.pdf" back="cover-back.pdf" />-->
     <!-- Set @formatted to "no" to remove formatting on worksheets: -->
-      <!--<worksheets formatted="yes" />-->
+      <!--<worksheet formatted="yes" />-->
   </latex>
 
   <html embed-button="yes">
diff --git a/templates/course/publication/publication.ptx b/templates/course/publication/publication.ptx
@@ -105,7 +105,7 @@
     <!-- Covers: provide paths to pdfs for front and back covers: -->
       <!--<cover front="cover-front.pdf" back="cover-back.pdf" />-->
     <!-- Set @formatted to "no" to remove formatting on worksheets: -->
-      <!--<worksheets formatted="yes" />-->
+      <!--<worksheet formatted="yes" />-->
   </latex>
 
   <html embed-button="yes">
diff --git a/templates/course/publication/publication_scorm_syllabus.ptx b/templates/course/publication/publication_scorm_syllabus.ptx
@@ -105,7 +105,7 @@
     <!-- Covers: provide paths to pdfs for front and back covers: -->
       <!--<cover front="cover-front.pdf" back="cover-back.pdf" />-->
     <!-- Set @formatted to "no" to remove formatting on worksheets: -->
-      <!--<worksheets formatted="yes" />-->
+      <!--<worksheet formatted="yes" />-->
   </latex>
 
   <html>
diff --git a/templates/course/publication/publication_standalone.ptx b/templates/course/publication/publication_standalone.ptx
@@ -105,7 +105,7 @@
     <!-- Covers: provide paths to pdfs for front and back covers: -->
       <!--<cover front="cover-front.pdf" back="cover-back.pdf" />-->
     <!-- Set @formatted to "no" to remove formatting on worksheets: -->
-      <!--<worksheets formatted="yes" />-->
+      <!--<worksheet formatted="yes" />-->
   </latex>
 
   <html>
diff --git a/templates/demo/publication/publication.ptx b/templates/demo/publication/publication.ptx
@@ -34,7 +34,7 @@
       <!-- <watermark scale="0.5">DRAFT</watermark> -->
 
     <!-- Mermaid diagram themes -->
-      <!-- <mermaid theme="default" /> -->  
+      <!-- <mermaid theme="default" /> -->
 
     <!-- QR code image: set path to an image to put in center of QR codes -->
       <!-- <qrcode image="image.png" /> -->
@@ -105,7 +105,7 @@
     <!-- Covers: provide paths to pdfs for front and back covers: -->
       <!--<covers front="cover-front.pdf" back="cover-back.pdf" />-->
     <!-- Set @formatted to "no" to remove formatting on worksheets: -->
-      <!--<worksheets formatted="yes" />-->
+      <!--<worksheet formatted="yes" />-->
   </latex>
 
   <html>
diff --git a/templates/slideshow/project.ptx b/templates/slideshow/project.ptx
@@ -5,7 +5,7 @@
     <target
         name="slides"
         format="revealjs"
-        output-filename="slides.html"
+        output-filename="index.html"
         />
   </targets>
 </project>
diff --git a/tests/test_cli.py b/tests/test_cli.py
@@ -321,7 +321,7 @@ def test_slideshow(tmp_path: Path, script_runner: ScriptRunner) -> None:
     assert script_runner.run(
         [PTX_CMD, "-v", "debug", "build", "slides"], cwd=tmp_path
     ).success
-    assert (tmp_path / "output" / "slides" / "slides.html").exists()
+    assert (tmp_path / "output" / "slides" / "index.html").exists()
 
 
 def test_deploy(tmp_path: Path, script_runner: ScriptRunner) -> None:
