DOC: Update existing links to theory

Author: hagenw

doc/conf.py

@@ -41,6 +41,7 @@
     'sphinx.ext.intersphinx',
     'sphinx.ext.doctest',
     'sphinxcontrib.bibtex',
+    'sphinx.ext.extlinks',
     'matplotlib.sphinxext.plot_directive',
     'nbsphinx',
 ]
@@ -77,6 +78,9 @@
     'matplotlib': ('https://matplotlib.org/', None),
 }
 
+extlinks = {'sfs': ('https://sfs.readthedocs.io/en/3.2/%s',
+                    'https://sfs.rtfd.io/')}
+
 plot_include_source = True
 plot_html_show_source_link = False
 plot_html_show_formats = False

sfs/fd/nfchoa.py

@@ -74,7 +74,7 @@ def plane_2d(omega, x0, r0, n=[0, 1, 0], *, max_order=None, c=None):
         \frac{\i^{-m}}{\Hankel{2}{m}{\wc r_0}}
         \e{\i m (\phi_0 - \phi_\text{pw})}
 
-    See http://sfstoolbox.org/#equation-D.nfchoa.pw.2D.
+    See :sfs:`d_nfchoa/#equation-fd-nfchoa-plane-2d`
 
     Examples
     --------
@@ -140,7 +140,7 @@ def point_25d(omega, x0, r0, xs, *, max_order=None, c=None):
         \frac{\hankel{2}{|m|}{\wc r}}{\hankel{2}{|m|}{\wc r_0}}
         \e{\i m (\phi_0 - \phi)}
 
-    See http://sfstoolbox.org/#equation-D.nfchoa.ps.2.5D.
+    See :sfs:`d_nfchoa/#equation-fd-nfchoa-point-25d`
 
     Examples
     --------
@@ -208,7 +208,7 @@ def plane_25d(omega, x0, r0, n=[0, 1, 0], *, max_order=None, c=None):
         \frac{\i^{-|m|}}{\wc \hankel{2}{|m|}{\wc r_0}}
         \e{\i m (\phi_0 - \phi_\text{pw})}
 
-    See http://sfstoolbox.org/#equation-D.nfchoa.pw.2.5D.
+    See :sfs:`d_nfchoa/#equation-fd-nfchoa-plane-25d`
 
     Examples
     --------

sfs/td/wfs.py

@@ -96,9 +96,7 @@ def plane_25d(x0, n0, n=[0, 1, 0], xref=[0, 0, 0], c=None):
 
     with wfs(2.5D) prefilter h(t), which is not implemented yet.
 
-    References
-    ----------
-    See http://sfstoolbox.org/en/latest/#equation-d.wfs.pw.2.5D
+    See :sfs:`d_wfs/#equation-td-wfs-plane-25d`
 
     Examples
     --------
@@ -173,9 +171,7 @@ def point_25d(x0, n0, xs, xref=[0, 0, 0], c=None):
 
     with wfs(2.5D) prefilter h(t), which is not implemented yet.
 
-    References
-    ----------
-    See http://sfstoolbox.org/en/latest/#equation-d.wfs.ps.2.5D
+    See :sfs:`d_wfs/#equation-td-wfs-point-25d`
 
     Examples
     --------
@@ -257,9 +253,7 @@ def focused_25d(x0, n0, xs, ns, xref=[0, 0, 0], c=None):
 
     with wfs(2.5D) prefilter h(t), which is not implemented yet.
 
-    References
-    ----------
-    See http://sfstoolbox.org/en/latest/#equation-d.wfs.fs.2.5D
+    See :sfs:`d_wfs/#equation-td-wfs-focused-25d`
 
     Examples
     --------