Doc: make libsemigroups link global

Author: Joseph-Edwards

docs/source/authors.rst

@@ -31,4 +31,3 @@ Contributors
   packaging.
 
 .. _nicolas thiery: http://nicolas.thiery.name/
-.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/ 

docs/source/conf.py

@@ -25,6 +25,11 @@
 
 bibtex_bibfiles = ["libsemigroups.bib"]
 
+rst_epilog = ""
+# Read link all targets from file
+with open("links.rst", encoding="utf-8") as f:
+    rst_epilog += f.read()
+
 autosummary_generate = True
 # We set this to True here, but remove "libsemigroups_pybind11\..*" from the doc
 # everywhere. This is done so we still get the submodule names, but not the
@@ -41,7 +46,7 @@
 # Use the version number of the installed project
 version = release = importlib.metadata.version(project)
 language = "python"
-exclude_patterns = ["_build", "_old"]
+exclude_patterns = ["_build", "_old", "links.rst"]
 pygments_style = "sphinx"
 highlight_language = "python"
 todo_include_todos = False

docs/source/data-structures/adapters/index.rst

@@ -15,7 +15,6 @@ These are classes that permit the generic classes in libsemigroups_ to be
 used with arbitrary types, provided that the adapters are implemented for these
 types.
 
-.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/ 
 
 .. toctree::
     :maxdepth: 1

docs/source/data-structures/elements/index.rst

@@ -11,7 +11,6 @@ Elements
 This page contains an overview summary of the functionality in libsemigroups_
 for defining elements of semigroups.
 
-.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/ 
 
 .. toctree::
     :maxdepth: 1

docs/source/data-structures/misc/libsemigroups-error.rst

@@ -50,4 +50,3 @@ Full API
 
 .. autofunction:: error_message_with_prefix
 
-.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/ 

docs/source/data-structures/presentations/index.rst

@@ -37,7 +37,6 @@ further details see, for example, :any:`Runner.run_for` and
 The classes and modules in ``libsemigroups_pybind11`` for finitely presented
 semigroups and monoids are:
 
-.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/ 
 
 .. toctree::
     :maxdepth: 1

docs/source/links.rst

@@ -0,0 +1 @@
+.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/

docs/source/main-algorithms/kambites/index.rst

@@ -13,7 +13,6 @@ On this page there are links to the documentation for the algorithms in
 authors of libsemigroups_; see :cite:`Kambites2009aa`,
 :cite:`Kambites2009ab`, and :cite:`Mitchell2021aa`.
 
-.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/ 
 
 .. toctree::
     :maxdepth: 1

docs/source/main-algorithms/todd-coxeter/index.rst

@@ -21,7 +21,6 @@ Similar to other places in libsemigroups_ it is possible to create a
 :any:`ToddCoxeter` object from a presentation consisting of strings or lists of
 integers.
 
-.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/ 
 
 .. toctree::
     :maxdepth: 1

src/errors.cpp

@@ -88,8 +88,6 @@ exception.
 :return: Whether :any:`LibsemigroupsError` messages contain a prefix about the
   C++ function that raised the exception.
 :rtype: bool
-
-.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/
 )pbdoc");
     m.def("error_message_with_prefix",
           py::overload_cast<bool>(&error_message_with_prefix),
@@ -107,7 +105,6 @@ exception. By default, this information is not included.
   about the C++ function that raised the exception.
 :type val: bool
 
-.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/
 )pbdoc");
   }
 }  // namespace libsemigroups