Fix doc options in CI

Author: greschd

.github/workflows/ci.yml

@@ -31,7 +31,7 @@ jobs:
     - name: Build documentation
       env:
         READTHEDOCS: 'True'
-      run: SPHINXOPTS='-nW' make -C doc html
+      run: make SPHINXOPTS='-nW' -C doc html
     - uses: actions/upload-artifact@v2
       with:
         name: doc-build

.github/workflows_source/ci.yml

@@ -48,7 +48,7 @@ jobs:
       - name: Build documentation
         env:
           READTHEDOCS: "True"
-        run: SPHINXOPTS='-nW' make -C doc html
+        run: make SPHINXOPTS='-nW' -C doc html
       - uses: actions/upload-artifact@v2
         with:
           name: doc-build

doc/source/conf.py

@@ -41,11 +41,13 @@
 
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),
+    "numpy": ("https://numpy.org/devdocs/", None),
     "symmetry-representation": ("http://z2pack.ethz.ch/symmetry-representation/", None),
     "fsc.hdf5-io": ("http://frescolinogroup.github.io/frescolino/pyhdf5io/0.5/", None),
 }
 
 nitpick_ignore = [("py:class", "array")]
+nitpick_ignore_regex = [("py:class", "numpy.*"), ("py:class", "ty.*")]
 ipython_warning_is_error = False
 
 # Add any paths that contain templates here, relative to this directory.

doc/source/symmetrize.rst

@@ -32,7 +32,7 @@ The model is located in the ``examples`` directory of the TBmodels source. You w
 .. ipython::
 
     In [0]: model_nosym =  tbmodels.io.load(
-       ...:     EXAMPLES_DIR / 'symmetrization' / 'nonsymmorphic_Si'/'data' / 'model_nosym.hdf5'
+       ...:     EXAMPLES_DIR / 'symmetrization' / 'nonsymmorphic_Si' / 'data' / 'model_nosym.hdf5'
        ...: )
 
 
@@ -114,6 +114,7 @@ Note that we use the ``numeric=True`` flag here. This keyword is used to switch
 Next, we use ``pymatgen`` to determine the space group symmetries of our crystal:
 
 .. ipython::
+    :okwarning:
 
     In [0]: from pymatgen.core import Structure
        ...: from pymatgen.symmetry.analyzer import SpacegroupAnalyzer