PDF 2025 (#32)

Generate a PDF file.

Author: s2t2

.gitignore

@@ -3,7 +3,16 @@
 
 .jupyter_cache
 
-# HTML files recursive:
-
+# HTML files:
 docs/.quarto
 docs/_build
+
+# half-way built files:
+**/**/*_files/
+**/**/*.html
+
+# pdf generation artifacts:
+index.aux
+index.log
+index.pdf
+index.toc

Makefile

@@ -1,26 +1,39 @@
 
 
-
-
-build:
-	quarto render docs/
-	open docs/_build/index.html
-
 preview:
 	quarto preview docs/
 
 render:
 	quarto render docs/
 
+pdf:
+	quarto render docs/ --to pdf
+
+docx:
+	quarto render docs/ --to docx
+
 open:
 	open docs/_build/index.html
 
 open-pdf:
 	open docs/_build/Intro-to-Python-Programming.pdf
 
+clean:
+	rm -rf docs/_build
+	rm -rf docs/.quarto
 
+build:
+	$(MAKE) render
+	$(MAKE) open
 
 render-fresh:
-	rm -rf docs/_build
-	rm -rf docs/.quarto
-	quarto render docs/
+	$(MAKE) clean
+	$(MAKE) render
+
+render-fresh-pdf:
+	$(MAKE) clean
+	$(MAKE) pdf
+
+render-fresh-docx:
+	$(MAKE) clean
+	$(MAKE) docx

docs/README.md

@@ -65,3 +65,26 @@ quarto render docs/ --verbose
 We are using the ["quarto-pages.yml" workflow configuration file](/.github/workflows/quarto-pages.yml) to deploy the site to GitHub Pages when new commits are pushed to the main branch.
 
 In order for this to work, you first need to configure your GitHub Pages repo settings to publish via GitHub Actions.
+
+## Publishing
+
+Install fonts:
+
+```sh
+# install font:
+brew install --cask font-merriweather
+brew install --cask font-alegreya
+brew install --cask font-source-sans-3
+brew install --cask font-source-code-pro
+
+# reset and verify font installation:
+fc-cache -fv
+fc-list | grep -i "SourceSans3"
+```
+
+
+```sh
+# not used
+quarto use template nrennie/PrettyPDF
+quarto install extension nrennie/PrettyPDF
+```

docs/_pdf_styles.tex

@@ -0,0 +1,21 @@
+% _pdf_styles.tex
+
+\usepackage{fontspec}
+
+% define \headingfont to use Source Sans Bold
+\newfontfamily\headingfont
+  [ UprightFont = *-Regular,
+    BoldFont    = *-Bold ]
+  {Source Sans 3}
+
+\usepackage{titlesec}
+
+% Chapter titles in SS3 Bold
+\titleformat{\chapter}[display]
+  {\headingfont\bfseries\huge}
+  {\chaptername\ \thechapter}{20pt}{\Huge}
+
+% Section titles in SS3 Bold
+\titleformat{\section}
+  {\headingfont\bfseries\Large}
+  {\thesection}{1em}{}

docs/_quarto.yml

@@ -87,12 +87,8 @@ book:
       chapters:
         - href: notes/python-lang/overview.ipynb
           text: "Comments, Variables, and Built-in Functions"
-        #- href: notes/python-lang/basic-datatypes/index.qmd
-        #  text: "Python Datatypes Overview"
         - href: notes/python-lang/python-operators.qmd
           text: "Operators"
-        #- href: notes/python-lang/control-flow/index.qmd
-        #  text: "Control Flow Overview"
         - href: notes/python-modules/index.qmd
           text: "Modules and Imports"
 
@@ -151,12 +147,7 @@ book:
       chapters:
         - href: notes/dataviz/overview.qmd
           text: "Data Visualization Overview"
-        #- href: notes/dataviz/trendlines.qmd
-        #  text: "Charts with Trendlines"
-        #- href: notes/dataviz/multiple-objects.qmd
-        #  text: "Charts with Multiple Objects"
-        #- href: notes/dataviz/candlesticks.qmd
-        #  text: "Candlestick Charts"
+
 
     - part: "Fetching Data from the Internet"
       chapters:
@@ -173,11 +164,6 @@ book:
         - href: notes/fetching-data/automated-browsing-form-inputs.ipynb
           text: "Automated Browsing w/ Form Inputs"
 
-    #- part: "APIs and Integrations"
-    #  chapters:
-    #    - href: notes/fetching-data/apis.qmd
-    #      text: "APIs Overview"
-
     - part: "APIs and Integrations"
       chapters:
         - href: notes/fetching-data/apis.qmd
@@ -298,5 +284,19 @@ format:
           gtag('config', 'G-B1MPHWM8NN');
         </script>
 
-  #pdf:
-  #  documentclass: scrreprt
+  pdf:
+
+    # use XeLaTeX or LuaLaTeX so fontspec works:
+    latex-engine: xelatex
+
+    mainfont: "Source Sans 3" # "Merriweather"
+    sansfont: "Source Sans 3" # "Helvetica Neue"
+    monofont: "Menlo"
+    #fontsize: 11pt
+    #linestretch: 1.2
+
+    includes:
+      in-header: _pdf_styles.tex
+
+  #PrettyPDF-pdf:
+  #  keep-tex: true