add academic fea example

.github/workflows/ci.yml

@@ -168,13 +168,7 @@ jobs:
 
       - name: Build PDF Documentation
         working-directory: doc
-        run: |
-          # Overwrite MAPDL commands section so it doesn't show up
-          make latex
-          python validate_png.py  # clean-up GIFs mislabeled as PNG
-          cd build/latex
-          latexmk -r latexmkrc -pdf *.tex -interaction=nonstopmode || true
-          (test -f *.pdf && echo pdf exists) || exit 1
+        run: make pdf
 
       - name: Upload PDF Documentation
         uses: actions/upload-artifact@v2

Makefile

@@ -1,7 +1,7 @@
 # Simple makefile to simplify repetitive build env management tasks under posix
 
 CODESPELL_DIRS ?= ./
-CODESPELL_SKIP ?= "*.pyc,*.txt,*.gif,*.png,*.jpg,*.js,*.html,*.doctree,*.ttf,*.woff,*.woff2,*.eot,*.mp4,*.inv,*.pickle,*.ipynb,flycheck*,./.git/*,./.hypothesis/*,*.yml,./doc/build/*,./doc/images/*,./dist/*,*~,.hypothesis*,./doc/source/examples/*,*cover,*.dat,*.mac,\#*,build,./docker/mapdl/v*,./factory/*,./ansys/mapdl/core/mapdl_functions.py,PKG-INFO,*.mypy_cache/*,./docker/mapdl/*"
+CODESPELL_SKIP ?= "*.pyc,*.txt,*.gif,*.png,*.jpg,*.js,*.html,*.doctree,*.ttf,*.woff,*.woff2,*.eot,*.mp4,*.inv,*.pickle,*.ipynb,flycheck*,./.git/*,./.hypothesis/*,*.yml,./doc/build/*,./doc/images/*,./dist/*,*~,.hypothesis*,./doc/source/examples/*,*cover,*.dat,*.mac,\#*,build,./docker/mapdl/v*,./factory/*,./ansys/mapdl/core/mapdl_functions.py,PKG-INFO,*.mypy_cache/*,./docker/mapdl/*,./_unused/*"
 CODESPELL_IGNORE ?= "ignore_words.txt"
 
 codestyle: codespell flake8

doc/Makefile

@@ -31,6 +31,14 @@ clean-except-examples:
 	rm -rf images/auto-generated
 	find . -type d -name "_autosummary" -exec rm -rf {} +
 
+# customized to build the pdf rather than using latexpdf due to various issues
+# with our docs like GIFs being written as PNG.
+pdf:
+	@$(SPHINXBUILD) -M latex "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	python validate_png.py  # clean-up GIFs mislabeled as PNG
+	cd build/latex && latexmk -r latexmkrc -pdf *.tex -interaction=nonstopmode || true
+	(test -f build/latex/*.pdf && echo pdf exists) || exit 1
+
 # manually deploy to https://github.com/pyansys/pymapdl-docs
 # WARNING: Use with care as this overwrites history of gh-pages
 deploy: 

examples/01-apdlmath-examples/README.txt

@@ -1,6 +1,5 @@
 .. _ref_apdl_math_examples:
 
-PyMapdl Math Examples
+PyMAPDL Math Examples
 =====================
-These examples demonstrate using APDL Math and the PyAnsys module
-together within the PyMapdl module.
+These examples demonstrate using APDL Math from the PyMAPDL library.