trying to fix a few build problems and the logging of nodify

Author: zerothi

docs/conf.py

@@ -21,6 +21,7 @@
 import os
 import pathlib
 import sys
+import typing
 from datetime import date
 from functools import wraps
 from textwrap import indent
@@ -31,7 +32,8 @@
 
 # Currently disabling logging.INFO because of nodify, it would likely be best
 # if we are only removing that one!
-logging.disable(logging.INFO)
+_nodify_logging = logging.getLogger("nodify")
+_nodify_logging.setLevel(logging.WARNING)
 
 _doc_root = pathlib.Path(__file__).absolute().parent
 # If extensions (or modules to document with autodoc) are in another directory,
@@ -977,7 +979,7 @@ def _setup_autodoc(app):
     """Patch and fix autodoc so we get the correct formatting of the environment"""
     from sphinx.ext import autodoc, autosummary
     from sphinx.locale import _
-    from sphinx.util import typing
+    from sphinx.util import typing as sphinx_typing
 
     # These subsequent class and methods originate from mpi4py
     # which is released under BSD-3 clause.
@@ -1023,7 +1025,7 @@ def update_content(self, more_content):
                 more_content.append(content, "")
                 more_content.append("", "")
             if istypealias(obj, self.name):
-                content = _("alias of %s") % typing.restify(obj)
+                content = _("alias of %s") % sphinx_typing.restify(obj)
                 more_content.append(content, "")
                 more_content.append("", "")
             super().update_content(more_content)

docs/release/0.16.0-notes.rst

@@ -93,7 +93,7 @@ Changes and improvements
   Finally we can write Hamiltonians from `sisl` in the ``HSX``
   file format.
 
-  For further details see: `https://gitlab.com/siesta-project/siesta/-/issues/183`__
+  For further details see: `here <https://gitlab.com/siesta-project/siesta/-/issues/183>`__
 
   (:pull:`884`)
 

src/sisl/physics/bloch.py

@@ -33,6 +33,7 @@ class Bloch:
     The general idea may be summarized in the following equation:
 
     .. math::
+
         \mathbf M_{K}^N =\frac1N
         \;
         \sum_{
@@ -74,12 +75,14 @@ class Bloch:
     Examples
     --------
     Auto-use finalize of the Toeplitz matrix.
+
     >>> bloch = Bloch([2, 1, 2])
     >>> k_unfold = bloch.unfold_points([0] * 3)
     >>> M = [func(*args, k=k) for k in k_unfold]
     >>> M = bloch.unfold(M, k_unfold)
 
     Manual finalization of the Toeplitz matrix.
+
     >>> bloch = Bloch([2, 1, 2], finalize=False)
     >>> k_unfold = bloch.unfold_points([0] * 3)
     >>> M = [func(*args, k=k) for k in k_unfold]