[CI] Update to build pdf using pdflatex (#47)

* enable cache, and pdflatex builds

* update file name for latex

* [test] remove lectures that contain ipywidgets

* prepare publish for building LaTeX

* upgrade jupyter-book to 0.11.2 which is required for latex improvements

Author: mmcky

.github/workflows/ci.yml

@@ -15,17 +15,17 @@ jobs:
           python-version: 3.8
           environment-file: environment.yml
           activate-environment: quantecon
-      # - name: Install latex dependencies
-      #   run: |
-      #     sudo apt-get -qq update
-      #     sudo apt-get install -y     \
-      #       texlive-latex-recommended \
-      #       texlive-latex-extra       \
-      #       texlive-fonts-recommended \
-      #       texlive-fonts-extra       \
-      #       texlive-xetex             \
-      #       latexmk                   \
-      #       xindy
+      - name: Install latex dependencies
+        run: |
+          sudo apt-get -qq update
+          sudo apt-get install -y     \
+            texlive-latex-recommended \
+            texlive-latex-extra       \
+            texlive-fonts-recommended \
+            texlive-fonts-extra       \
+            texlive-xetex             \
+            latexmk                   \
+            xindy
       - name: Display Conda Environment Versions
         shell: bash -l {0}
         run: conda list
@@ -40,12 +40,12 @@ jobs:
           name: build-cache
           path: _build
       # Build Assets (Download Notebooks and PDF via LaTeX)
-      # - name: Build PDF from LaTeX
-      #   shell: bash -l {0}
-      #   run: |
-      #     jb build lectures --builder pdflatex --path-output ./ -n --keep-going
-      #     mkdir -p _build/html/_pdf
-      #     cp -u _build/latex/*.pdf _build/html/_pdf
+      - name: Build PDF from LaTeX
+        shell: bash -l {0}
+        run: |
+          jb build lectures --builder pdflatex --path-output ./ -n --keep-going
+          mkdir -p _build/html/_pdf
+          cp -u _build/latex/*.pdf _build/html/_pdf
       - name: Build Download Notebooks (sphinx-tojupyter)
         shell: bash -l {0}
         run: |

.github/workflows/publish.yml

@@ -19,17 +19,17 @@ jobs:
           python-version: 3.8
           environment-file: environment.yml
           activate-environment: quantecon
-      # - name: Install latex dependencies
-      #   run: |
-      #     sudo apt-get -qq update
-      #     sudo apt-get install -y     \
-      #       texlive-latex-recommended \
-      #       texlive-latex-extra       \
-      #       texlive-fonts-recommended \
-      #       texlive-fonts-extra       \
-      #       texlive-xetex             \
-      #       latexmk                   \
-      #       xindy
+      - name: Install latex dependencies
+        run: |
+          sudo apt-get -qq update
+          sudo apt-get install -y     \
+            texlive-latex-recommended \
+            texlive-latex-extra       \
+            texlive-fonts-recommended \
+            texlive-fonts-extra       \
+            texlive-xetex             \
+            latexmk                   \
+            xindy
       - name: Display Conda Environment Versions
         shell: bash -l {0}
         run: conda list
@@ -44,15 +44,15 @@ jobs:
           name: build-cache
           path: _build
       # Build Assets (Download Notebooks and PDF via LaTeX)
-      # - name: Build PDF from LaTeX
-      #   shell: bash -l {0}
-      #   run: |
-      #     jb build lectures --builder pdflatex --path-output ./ -n --keep-going
-      # - name: Copy LaTeX PDF for GH-PAGES
-      #   shell: bash -l {0}
-      #   run: |
-      #     mkdir -p _build/html/_pdf
-      #     cp -u _build/latex/*.pdf _build/html/_pdf
+      - name: Build PDF from LaTeX
+        shell: bash -l {0}
+        run: |
+          jb build lectures --builder pdflatex --path-output ./ -n --keep-going
+      - name: Copy LaTeX PDF for GH-PAGES
+        shell: bash -l {0}
+        run: |
+          mkdir -p _build/html/_pdf
+          cp -u _build/latex/*.pdf _build/html/_pdf
       - name: Build Download Notebooks (sphinx-tojupyter)
         shell: bash -l {0}
         run: |

environment.yml

@@ -6,7 +6,7 @@ dependencies:
   - anaconda=2020.11
   - pip
   - pip:
-    - jupyter-book==0.11.1
+    - jupyter-book==0.11.2
     - sphinx-multitoc-numbering==0.1.3
     - quantecon-book-theme==0.2.5
     - sphinx-tojupyter==0.1.2

lectures/_config.yml

@@ -13,6 +13,10 @@ bibtex_bibfiles:
 html:
   baseurl: https://python-advanced.quantecon.org/
 
+latex:
+   latex_documents:
+      targetname: quantecon-python-advanced.tex
+
 sphinx:
   extra_extensions: [sphinx_multitoc_numbering, sphinxext.rediraffe, sphinx_tojupyter]
   config: