remove references to old help; start on moving help into GSASII/newhelp #23
Workflow file for this run
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # create a documentation web site for GSAS-II from four sources | |
| # * HTML tutorials are simply copied | |
| # * markdown tutorials (in ./MDtutorials) are formatted with pandoc and are copied over | |
| # * sphinx is used to generate HTML from files in ./webdocs | |
| # Also the tutorials.html file and the */data/index.html files are | |
| # created by running scripts/makeGitTutorial | |
| # this is a development version that creates draft help pages from the MDhelp directory | |
| # For now | |
| # * HTML help files are copied over from the GSAS-II sources | |
| # Eventually, the help files generated here need to get into the GSASII/help | |
| # directory | |
| name: build GSAS-II web site w/test MD Help | |
| on: | |
| workflow_dispatch: | |
| push: | |
| branches: | |
| - newhelp | |
| 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 | |
| # Code below removed for more rapid testing | |
| # - name: Sphinx setup | |
| # run: | | |
| # pip install sphinx sphinx_readable_theme | |
| # - name: pandoc setup | |
| # uses: pandoc/actions/setup@v1 | |
| # MD help tools | |
| - name: install debian chrome | |
| run: | | |
| set -ex | |
| wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb | |
| sudo apt install ./google-chrome-stable_current_amd64.deb | |
| # - name: test newly-installed chrome | |
| # run: | | |
| # which google-chrome-stable | |
| # google-chrome-stable --version | |
| # /usr/bin/google-chrome-stable --headless --disable-gpu --dump-dom https://google.com | |
| - name: mkdocs setup | |
| run: | | |
| pip install mkdocs mkdocs-material python-markdown-math mkdocs-static-i18n | |
| pip install mkdocs-to-pdf pymdown-extensions | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| # MD help conversion | |
| - name: convert MDhelp | |
| run: | | |
| cd MDhelp | |
| mkdocs build | |
| ENABLE_PDF_EXPORT=1 mkdocs build | |
| mv site/GSASII-help.pdf ../docs/ | |
| # create an anchor index | |
| python findMDanchors.py | |
| cp -vr site ../help | |
| # - name: Upload help artifact # debug: 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 | |
| # Code below removed for more rapid testing | |
| # - 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 .. | |
| # Code below removed for more rapid testing | |
| # - name: build tutorials index | |
| # run: | | |
| # cd scripts | |
| # python makeGitTutorial.py .. | |
| # - name: Note changed files # unused development code | |
| # 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 | |
| # Code below removed for more rapid testing | |
| # - 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 new help pages into the GSAS-II sources | |
| - name: Get GSAS-II | |
| run: | | |
| git clone --depth 1 https://github.com/AdvancedPhotonSource/GSAS-II.git _gsas2 | |
| - name: move help into site | |
| run: | | |
| cp -rpv MDhelp/site _gsas2/GSASII/help | |
| cd _gsas2 | |
| git status | |
| # before uploading, clean up | |
| - 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 | |
| # Code below removed for more rapid testing | |
| # - 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 |