start developing mkdocs to pdf

Author: briantoby

.github/workflows/mkdocs_pdf.yml

@@ -0,0 +1,121 @@
+# work on building PDFs from the .md help files
+
+
+name: test MD help to .pdf
+
+#on: [workflow_dispatch] 
+on: [push, workflow_dispatch]
+
+permissions:
+  contents: write
+  id-token: write
+  pages: write
+
+jobs:
+  build:       # Build web pages
+    runs-on: ubuntu-latest
+    steps:
+
+      - name: Python setup
+        uses: actions/setup-python@v3
+#      - name: Sphinx setup
+#        run: |
+#          pip install sphinx sphinx_readable_theme
+      - name: pandoc setup
+        uses: pandoc/actions/setup@v1
+      - name: mkdocs setup
+        run: |
+          pip install mkdocs mkdocs-material python-markdown-math mkdocs-static-i18n
+          pip install weasyprint
+          pip install mkdocs-with-pdf
+          pip install mkdocs-to-pdf
+          weasyprint --info
+          
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: convert MDhelp
+        run: |
+          cd MDhelp
+          mkdocs build
+          cp -vr site ../help_test
+        
+      # - name: Get tutorials index from source code
+      #   run: |
+      #     curl -L https://github.com/AdvancedPhotonSource/GSAS-II/raw/master/GSASII/tutorialIndex.py -o scripts/tutorialIndex.py
+
+      # - name: convert tutorials
+      #   run: |
+      #     cd MDtutorials
+      #     for path in ./*; do
+      #       [ -d "${path}" ] || continue # skip if not a directory
+      #       dirname="$(basename "${path}")"
+      #       dest="../${dirname}"
+      #       mkdir -pv ${dest}
+      #       [ ! -d "${path}/data" ] || cp -r "${path}/data" ${dest}/
+      #       [ ! -d "${path}/imgs" ] || cp -r "${path}/imgs" ${dest}/
+      #       cp tutorial.css ${dest}
+      #       for fil in $dirname/*.md; do
+      #         outfile="${dest}/$(basename "${fil%.md}.html")"
+      #         echo "creating $outfile from $fil"
+      #         pandoc --standalone ${fil} --css tutorial.css -o ${outfile}
+      #         sed -i "s/<figure>/<BR clear=all><figure>/g" ${outfile}
+      #       done
+      #       git add ${dest}
+      #     done
+      #     cd ..
+        
+      # - name: build tutorials index 
+      #   run: |
+      #     cd scripts
+      #     python makeGitTutorial.py ..
+
+#      - name: Note changed files
+#        run: |
+#            git add tutorials.html
+#            git add */data/index.html
+#            git status
+#            git commit -m"changes from automated build of tutorials"
+#      - name: Push changes
+#        uses: ad-m/github-push-action@master
+
+      # - name: Sphinx build
+      #   run: |
+      #     sphinx-build webdocs .  # place output into root dir
+      #     cp webdocs/_static/fix.css _static/fix.css # should be done by sphinx
+
+      # # get the help pages from the GSAS-II sources into the web site
+      # - name: Get GSAS-II
+      #   run: |
+      #     git clone --depth 1 https://github.com/AdvancedPhotonSource/GSAS-II.git _gsas2
+      # - name: move help into site
+      #   run: |
+      #     mv _gsas2/GSASII/help ./help
+      # - name: Get rid of the rest of the GSAS-II files & other stuff not needed on web
+      #   run: |
+      #     rm -rf _gsas2 webdocs scripts MDtutorials MDhelp
+        
+      # - name: Upload artifact  # creates zip file with website contents
+      #   uses: actions/upload-pages-artifact@v3
+      #   with:
+      #       path: .
+      #       name: github-pages
+      #       retention-days: 1
+
+  # deploy:   # Deployment of web pages to GitHub pages
+  #   needs: build     
+  #   permissions:
+  #     pages: write
+  #     id-token: write
+  #   environment:
+  #     name: github-pages
+  #     url: ${{ steps.deployment.outputs.page_url }}
+  #   runs-on: ubuntu-latest
+    
+  #   steps:
+  #     - name: Deploy to GitHub Pages
+  #       id: deployment
+  #       uses: actions/deploy-pages@v4
+  #       with:
+  #          token: ${{ secrets.GITHUB_TOKEN }}
+  #          artifact_name: github-pages

.github/workflows/test_builddocsite.yml

@@ -11,8 +11,8 @@
 
 name: test MD help w/build GSAS-II web site
 
-#on: [workflow_dispatch] 
-on: [push, workflow_dispatch]
+on: [workflow_dispatch] 
+#on: [push, workflow_dispatch]
 
 permissions:
   contents: write