Attempt to fix docs building (#2602 part 3)

.github/workflows/docs.yml

@@ -16,6 +16,8 @@ jobs:
  shell: bash -l {0}
  steps:
  - uses: actions/checkout@v2
+ with:
+ fetch-depth: 0
  - name: Setup Mambaforge Python 3.7
  uses: conda-incubator/setup-miniconda@v2
  with:
@@ -46,30 +48,78 @@ jobs:
  - uses: actions/checkout@v2
  with:
  ref: gh-pages
- path: build/html
+ clean: false
+ path: documentation/build/html
+ fetch-depth: 0 # checkout the complete git history so upstream is seen as out of date when attempting to push these updates
  - name: Make documentation - for testing
  if: ${{ github.event_name != 'push' || github.repository != 'ReactionMechanismGenerator/RMG-Py' }}
  run: |
+ git config --global user.name "github-actions"
+ git config --global user.email "github-actions@github.com"
+ ls -l
+ pwd
  cd documentation
- sphinx-build -b html -d build/doctrees/ source/ build/html -w errors.log -W --keep-going
+ ls -l
+ make html
+ ls -l
+ ls -l build/html
  - name: Report documentation errors
  if: ${{ failure() }}
  run: |
  cat documentation/errors.log
  - name: Make documentation - to publish
  if: ${{ github.event_name == 'push' && github.repository == 'ReactionMechanismGenerator/RMG-Py' }}
  run: |
- git config --global user.name "github-actions"
- git config --global user.email "github-actions@github.com"
  cd documentation
- make html
+ sphinx-build -b html -d build/doctrees/ source/ build/html -w errors.log -W --keep-going
  - name: Check documentation links
  continue-on-error: true
  run: |
  cd documentation
  sphinx-build -b linkcheck -d build/doctrees/ source/ build/linkcheck | grep -e broken -e redirect | grep -v -e 'redirect https://doi.org/' -e 'broken https://doi.org/.* 403 Client Error: Forbidden'
  - name: Publish documentation
- if: ${{ github.event_name == 'push' && github.repository == 'ReactionMechanismGenerator/RMG-Py' }}
+ # if: ${{ github.event_name == 'push' && github.repository == 'ReactionMechanismGenerator/RMG-Py' }}
  run: |
+ cd documentation/build/html
+ git add -A .
+ git commit -m "Automated documentation rebuild"
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git status
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git push --dry-run origin gh-pages
+ echo "THIS NEXT ONE SHOULD FAIL BECAUSE THAT DIR SHOULD NOT EXIST ANYMORE SINCE WE AREN'T CLONING GH-PAGES INTO IT" 
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  touch build/html/.nojekyll
- cd build/html; git add -A .; git commit -m "Automated documentation rebuild"; git push origin gh-pages
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ touch build/html/AHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ ls -l
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ pwd
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ ls -l build/html/
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git status
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git branch -vv
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ cd build/html
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git status
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git branch -vv
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git add --force -A .
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git status
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git add --force latex-api.html
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git status
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git commit -m "Automated documentation rebuild"
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git status
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ git push --dry-run origin gh-pages
+ echo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

documentation/Makefile

@@ -51,7 +51,7 @@ clean:
  rm -rf build_temp
 
 html:
- $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+ $(SPHINXBUILD) -v -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
  @echo
  @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."