Skip to content

2nd try: pdf build

2nd try: pdf build #3

Workflow file for this run

# 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
mv mkdocs.yml_pdf mkdocs.yml
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