Adding info about docker and MacOS (#2231)

* first approach

* Revert "Hiding docker (#1728)"

This reverts commit 282e7d4.

* Fixing links to new org

* Adding docker and macos sections

* Adding info about OS in versioning

* Revamping docker compose files

* removing number

* Fixing vale

* Apply suggestions from Kathy's code review

Co-authored-by: Kathy Pippert <[email protected]>

* Apply suggestions from Robert's code review

Co-authored-by: Roberto Pastor Muela <[email protected]>

* Fixing headings

* fixing bullet list

* fix a reference.

* Apply suggestions from Kathy's second code review

Co-authored-by: Kathy Pippert <[email protected]>

* Missing kathy's comment.

* Fixing vale

* Bringing change.

* Using % for the indexing

* Adding resizing color.

* fixing bullet list

* fixing pypim inventory

* Fixing link

* Update doc/source/getting_started/versioning.rst

* Going back to normal link.

* I had to remove the replaced part because it was giving an error in sphinx.

* Using a new name

* Getting rid of the susbstitutions

* Following advice from Kathy.

* Atempting to fix graphviz

* Improving diagram.

* Last try graphviz

* Increasing timeout

* Removing graphviz

---------

Co-authored-by: Kathy Pippert <[email protected]>
Co-authored-by: Roberto Pastor Muela <[email protected]>

Author: 3 people

.devcontainer/README.rst

@@ -24,7 +24,7 @@ If you want to build your own docker image, visit the following link
 Develop on a remote container
 =============================
 
-.. note:: If you are an Ansys employee or collaborator and want to use this development method, please email |pyansys_contact|.
+.. note:: If you are an Ansys employee or collaborator and want to use this development method, please email `PyAnsys Core team <pyansys_core_>`_.
 
 To use a `remote container <https://code.visualstudio.com/docs/devcontainers/containers>`_, you must install:
 
@@ -111,5 +111,5 @@ You can launch a container which all the required tools and start to work in cou
 This is an easy way to get started with PyMAPDL development.
 
 .. warning:: This method is only applicable and allowed to Ansys employees or collaborators.
-   If you are an Ansys employee and wants use this development method, please email |pyansys_contact|.
+   If you are an Ansys employee and wants use this development method, please email `PyAnsys Core team <pyansys_core_>`_.
 

.github/workflows/ci.yml

@@ -84,7 +84,7 @@ jobs:
     name: "Build documentation"
     runs-on: ubuntu-latest
     needs: doc-style
-    timeout-minutes: 35
+    timeout-minutes: 45
     outputs:
       PYMAPDL_VERSION: ${{ steps.version.outputs.PYMAPDL_VERSION }}
     env:
@@ -105,7 +105,7 @@ jobs:
       - name: "Install OS packages"
         run: |
           sudo apt update 
-          sudo apt install zip pandoc libgl1-mesa-glx xvfb texlive-latex-extra latexmk graphviz
+          sudo apt install zip pandoc libgl1-mesa-glx xvfb texlive-latex-extra latexmk graphviz texlive-xetex
 
       - name: "Test virtual framebuffer"
         run: |

doc/source/conf.py

@@ -105,6 +105,8 @@
 suppress_warnings = ["label.*"]
 # supress_warnings = ["ref.option"]
 
+# Graphviz diagrams configuration
+graphviz_output_format = "png"
 
 # numpydoc configuration
 numpydoc_use_plots = True
@@ -285,6 +287,8 @@
 # -- Options for LaTeX output ------------------------------------------------
 latex_elements = {}
 
+latex_engine = "xelatex"
+
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).

doc/source/examples/index.rst

@@ -55,4 +55,4 @@ These links refers to the following GitHub repository where you can find all of
 
 If you find a missing or broken link, open an issue in
 GitHub (`PyMAPDL Issues <pymapdl_issues_>`_)
-or send an email to |pyansys_contact|.
+or send an email to `PyAnsys Core team <pyansys_core_>`_.

doc/source/getting_started/contribution.rst

@@ -38,7 +38,7 @@ use these issue templates:
 
 If your issue does not fit into one of these categories, create your own issue.
 
-To reach the project support team, email |pyansys_contact|.
+To reach the project support team, email `PyAnsys Core team <pyansys_core_>`_.
 
 Viewing PyMAPDL documentation
 =============================