@@ -16,8 +16,9 @@ env:
   # builds and fail on any warnings.
   #SPHINXOPTS: "-W --keep-going -T"
   GENERATE_PDF: true          # to enable, must be 'true' lowercase
+  GENERATE_EPUB: true         # to enable, must be 'true' lowercase
   GENERATE_SINGLEHTML: true   # to enable, must be 'true' lowercase
-  PDF_FILENAME: lesson.pdf
+  OUTPUT_BASENAME: ${{ github.repository_owner }}-${{ github.event.repository.name }}     # used for pdf, epub
   MULTIBRANCH: true    # to enable, must be 'true' lowercase
 
 
@@ -30,17 +31,17 @@ jobs:
 
     steps:
       # https://github.com/marketplace/actions/checkout
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
           lfs: true
 
       # https://github.com/marketplace/actions/setup-python
       # ^-- This gives info on matrix testing.
       - name: Install Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v6
         with:
-          python-version: '3.11'
+          python-version: '3.13'
           cache: 'pip'
 
       # https://docs.github.com/en/actions/guides/building-and-testing-python#installing-dependencies
@@ -73,6 +74,9 @@ jobs:
           pip list --not-required
           pip list
 
+      - name: Make target pub directory (_gh-pages)
+        run:
+          mkdir _gh-pages/
 
       # Build
       - uses: ammaraskar/sphinx-problem-matcher@master
@@ -88,29 +92,30 @@ jobs:
           #   https://github.com/sphinx-doc/sphinx/pull/8524
           #   https://github.com/readthedocs/sphinx_rtd_theme/pull/1025
           sed -i 's/url_root="#"/url_root=""/' _build/dirhtml/index.html || true
+          rsync -a _build/dirhtml/ _gh-pages/
 
-      # singlehtml
+      # singlehtml if requested
       - name: Generate singlehtml
         if: ${{ env.GENERATE_SINGLEHTML == 'true' }}
         run: |
           make singlehtml
-          mv _build/singlehtml/ _build/dirhtml/singlehtml/
+          mv _build/singlehtml _gh_pages/singlehtml
+
+      # epub if requested
+      - name: Generate epub
+        if: ${{ env.GENERATE_EPUB == 'true' }}
+        run: |
+          make epub
+          mv _build/eppub/*.epub _gh-pages/${OUTPUT_BASENAME}.epub
 
       # PDF if requested
       - name: Generate PDF
         if: ${{ env.GENERATE_PDF == 'true' }}
         run: |
           #pip install https://github.com/rkdarst/sphinx_pyppeteer_builder/archive/refs/heads/main.zip
           pip install sphinx_pyppeteer_builder
-          make pyppeteer
-          mv _build/pyppeteer/*.pdf _build/dirhtml/${PDF_FILENAME}
-
-      # Stage all deployed assets in _gh-pages/ for simplicity, and to
-      # prepare to do a multi-branch deployment.
-      - name: Copy deployment data to _gh-pages/
-        if: ${{ github.event_name == 'push' || github.event_name == 'workflow_dispatch' }}
-        run:
-          rsync -a _build/dirhtml/ _gh-pages/
+          make SPHINXOPTS="-t pdf" pyppeteer
+          mv _build/pyppeteer/*.pdf _gh-pages/${OUTPUT_BASENAME}.pdf
 
       # Use gh-pages-multibranch to multiplex different branches into
       # one deployment. See
@@ -130,7 +135,7 @@ jobs:
           touch _gh-pages/.nojekyll
 
       # Save artifact for the next step.
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v6
         if: ${{ github.event_name == 'push' || github.event_name == 'workflow_dispatch' }}
         with:
           name: gh-pages-build
@@ -148,7 +153,7 @@ jobs:
       contents: write
 
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v6
         if: ${{ (github.event_name == 'push' || github.event_name == 'workflow_dispatch') && ( env.MULTIBRANCH == 'true' || github.ref == format('refs/heads/{0}', env.DEFAULT_BRANCH )) }}
         with:
           name: gh-pages-build
@@ -162,7 +167,7 @@ jobs:
       # Deploy
       # https://github.com/peaceiris/actions-gh-pages
       - name: Deploy
-        uses: peaceiris/actions-gh-pages@v3
+        uses: peaceiris/actions-gh-pages@v4
         if: ${{ (github.event_name == 'push' || github.event_name == 'workflow_dispatch') && ( env.MULTIBRANCH == 'true' || github.ref == format('refs/heads/{0}', env.DEFAULT_BRANCH )) }}
         with:
           publish_branch: gh-pages