mkdocs_pdf.yml

# 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: Set up Node.js
        uses: actions/setup-node@v4

      - name: Install RelaxedJS globally
        run: npm install -g relaxedjs
      #- name: Install RelaxedJS locally
      #  run: npm install relaxedjs

      - name: find relaxedjs
        run: |
          which relaxedjs
          exit

      # - name: Setup chromium
      #   uses: browser-actions/setup-chrome@v1
      #   id: setup-chrome
      #   with:
      #     install-dependencies: true
      #     install-chromedriver: true
      # - run: |
      #     echo ${{ steps.setup-chrome.outputs.chrome-path }} --version
      #     ${{ steps.setup-chrome.outputs.chrome-path }} --version
      # - name: test installed chrome
      #   run: |
      #     ${{ steps.setup-chrome.outputs.chrome-path }} --no-sandbox --headless --disable-gpu --dump-dom https://google.com
      # - name: test system chromium
      #   run: |
      #     /usr/bin/chromium-browser --no-sandbox --headless --disable-gpu --dump-dom https://google.com
      
      - 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
          #mv mkdocs.yml_pdf mkdocs.yml
          # 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/site
            name: MDhelp
            retention-days: 1
        
      # - 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