tweak PDF

Author: briantoby

.github/workflows/mkdocs_pdf.yml

@@ -40,12 +40,13 @@ jobs:
           mv mkdocs.yml_pdf mkdocs.yml
           mkdocs build
           ENABLE_PDF_EXPORT=1 mkdocs build
+          # mv site/GSASII-help.pdf ...
           #cp -vr site ../help_test
           
       - name: Upload help artifact  # creates zip file with website contents
         uses: actions/upload-pages-artifact@v3
         with:
-            path: MDhelp
+            path: MDhelp/site
             name: MDhelp
             retention-days: 1
 

.github/workflows/test_builddocsite.yml

@@ -29,6 +29,7 @@ jobs:
       - name: Sphinx setup
         run: |
           pip install sphinx sphinx_readable_theme
+          pip install mkdocs-with-pdf
       - name: pandoc setup
         uses: pandoc/actions/setup@v1
       - name: mkdocs setup

MDhelp/mkdocs.yml_pdf

@@ -61,7 +61,14 @@ plugins:
       author: Brian H. Toby and Robert B. Von Dreele
       enabled_if_env: ENABLE_PDF_EXPORT
       cover_title: GSAS-II Help information
+      cover_subtitle: a compilation of HTML pages
+      copyright: this material is available at https://advancedphotonsource.github.io/GSAS-II-tutorials/help/
+      back_cover: true
       output_path: GSASII-help.pdf
+      exclude_pages:
+          - 'index.md'
+      render_js: true
+
   - i18n:
       docs_structure: suffix
       languages: