PDF creation

Author: Samuelopez-ansys

doc/Makefile

@@ -29,12 +29,23 @@ clean:
 phtml:
 	$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) -j auto
 
+phtml-no-examples:
+    export PYAEDT_SKIP_EXAMPLE="1"
+	$(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) -j auto
+
 # Build pdf docs.
 pdf:
 	@$(SPHINXBUILD) -M latex "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 	cd $(BUILDDIR)/latex && latexmk -r latexmkrc -pdf *.tex -interaction=nonstopmode || true
 	(test -f $(BUILDDIR)/latex/pyaedt.pdf && echo pdf exists) || exit 1
 
+pdf-no-examples:
+    export PYAEDT_SKIP_EXAMPLE="1"
+	@$(SPHINXBUILD) -M latex "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	cd $(BUILDDIR)/latex && latexmk -r latexmkrc -pdf *.tex -interaction=nonstopmode || true
+	(test -f $(BUILDDIR)/latex/pyaedt.pdf && echo pdf exists) || exit 1
+
+
 # build docs like the CI build
 cibuild:
 	mkdir source/examples -p

doc/make.bat

@@ -33,10 +33,13 @@ goto end
 %SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
 
 :pdf
+set PYAEDT_SKIP_EXAMPLE=1
+
+
 %SPHINXBUILD% -M latex %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
 cd "%BUILDDIR%\latex"
 for %%f in (*.tex) do (
-pdflatex "%%f" --interaction=nonstopmode)
+xelatex "%%f" --interaction=nonstopmode)
 
 :end
 popd

doc/source/conf.py

@@ -100,6 +100,7 @@ def setup(app):
 copyright = f"(c) {datetime.datetime.now().year} ANSYS, Inc. All rights reserved"
 author = "Ansys Inc."
 cname = os.getenv("DOCUMENTATION_CNAME", "nocname.com")
+switcher_version = get_version_match(__version__)
 
 # Check for the local config file, otherwise use default desktop configuration
 local_config_file = os.path.join(local_path, "local_config.json")
@@ -134,6 +135,7 @@ def setup(app):
     "sphinx.ext.inheritance_diagram",
     "numpydoc",
     "ansys_sphinx_theme.extension.linkcode",
+    "recommonmark",
 ]
 
 # Intersphinx mapping
@@ -266,7 +268,7 @@ def setup(app):
     # necessary for pyvista when building the sphinx gallery
     pyvista.BUILDING_GALLERY = True
 
-    if config["run_examples"]:
+    if config["run_examples"] and not os.environ.get("PYAEDT_SKIP_EXAMPLE", False):
         extensions.append("sphinx_gallery.gen_gallery")
 
         sphinx_gallery_conf = {
@@ -340,6 +342,12 @@ def setup(app):
             "url": "https://github.com/ansys/pyaedt/discussions",
             "icon": "fa fa-comment fa-fw",
         },
+        {
+            "name": "Download documentation in PDF",
+            "url": f"https://{cname}/version/{switcher_version}/_static/assets/download/pyaedt.pdf",
+            # noqa: E501
+            "icon": "fa fa-file-pdf fa-fw",
+        },
     ],
     "switcher": {
         "json_url": f"https://{cname}/versions.json",

pyproject.toml

@@ -82,7 +82,7 @@ doc = [
     "pypandoc>=1.10.0,<1.14",
     #"pytest-sphinx",
     "pyvista>=0.38.0,<0.44",
-    #"recommonmark",
+    "recommonmark",
     #"scikit-learn",
     "scikit-rf>=0.30.0,<0.33",
     "Sphinx==5.3.0; python_version == '3.7'",