Doc: Stop duplicating common links

Author: Joseph-Edwards

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

@@ -45,8 +45,7 @@ Full API
         If you believe your code is incorrectly throwing a
         :any:`LibsemigroupsError`, or isn't throwing a :any:`LibsemigroupsError`
         but you think it should, please let us known by opening an issue on the
-        `issue tracker
-        <https://github.com/libsemigroups/libsemigroups_pybind11/issues>`_.
+        `issue tracker`_.
 
 .. autofunction:: error_message_with_prefix
 

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

@@ -13,8 +13,7 @@ This page contains links to the classes and functions in
 objects implemented in ``libsemigroups_pybind11``.
 
 The class :any:`Dot` facilitates the creation and rendering of graph
-descriptions in the `DOT <https://www.graphviz.org/doc/info/lang.html>`_
-language of `Graphviz <https://www.graphviz.org>`_ graph drawing software.
+descriptions in the DOT_ language of Graphviz_ graph drawing software.
 
 .. toctree::
     :maxdepth: 1

docs/source/index.rst

@@ -106,8 +106,7 @@ defined upon. These may appear in error messages. For example:
 The :doc:`authors <authors>` of ``libsemigroups_pybind11`` have gone to a lot of
 effort to try and make error messages clear, specific and intelligible; however,
 if there you encounter any errors with unclear messages, please raise this on
-the
-`issue tracker <https://github.com/libsemigroups/libsemigroups_pybind11/issues>`_.
+the `issue tracker`_.
 
 Further Info
 ------------

docs/source/install.rst

@@ -104,5 +104,5 @@ Issues
 ------
 
 If you find any problems with ``libsemigroups_pybind11``, or have any
-suggestions for features that you’d like to see, please use the `issue tracker
-<https://github.com/libsemigroups/libsemigroups_pybind11/issues>`__.
+suggestions for features that you’d like to see, please use the
+`issue tracker`_.

docs/source/links.rst

@@ -1 +1,4 @@
-.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/
+.. _libsemigroups: https://libsemigroups.github.io/libsemigroups/
+.. _issue tracker: https://github.com/libsemigroups/libsemigroups_pybind11/issues
+.. _DOT: https://www.graphviz.org/doc/info/lang.html
+.. _Graphviz: https://www.graphviz.org

src/dot.cpp

@@ -37,21 +37,16 @@ namespace libsemigroups {
     ////////////////////////////////////////////////////////////////////////////
     py::class_<Dot> dot(m,
                         "Dot",
-                        R"pbdoc(A representation of a graph in the `DOT
-<https://www.graphviz.org/doc/info/lang.html>`_
-language of `Graphviz <https://www.graphviz.org>`_.
+                        R"pbdoc(A representation of a graph in the DOT_ language
+of Graphviz_.
 
 This class facilitates the creation and rendering of graph descriptions in the
-`DOT <https://www.graphviz.org/doc/info/lang.html>`_
-language of the `Graphviz <https://www.graphviz.org>`_ graph drawing software.
-This class is fairly rudimentary, and is not intended to implement every
-feature of the `DOT <https://www.graphviz.org/doc/info/lang.html>`_ language.
-You can create a :any:`Dot` object, assemble the graph by adding nodes and
-edges, attributes, labels, colours, subgraphs, and clusters, and retrieve its
-`DOT <https://www.graphviz.org/doc/info/lang.html>`_
-source code string (:any:`Dot.to_string`). Write the source code to a file and
-render it with the `Graphviz <https://www.graphviz.org>`_
-installation on your system.
+DOT_ language of the Graphviz_ graph drawing software. This class is fairly
+rudimentary, and is not intended to implement every feature of the DOT_
+language. You can create a :any:`Dot` object, assemble the graph by adding nodes
+and edges, attributes, labels, colours, subgraphs, and clusters, and retrieve
+its DOT_ source code string (:any:`Dot.to_string`). Write the source code to a
+file and render it with the Graphviz_ installation on your system.
 )pbdoc");
 
     ////////////////////////////////////////////////////////////////////////////
@@ -467,9 +462,7 @@ Returns the edge object with head named *head* and tail named *tail*.
             R"pbdoc(
 Convert a :any:`Dot` object to a string. This function returns the string
 representation of the :any:`Dot` object. This string contains a
-representation of the graph in the `DOT
-<https://www.graphviz.org/doc/info/lang.html>`_ language for `Graphviz
-<https://www.graphviz.org>`_.
+representation of the graph in the DOT_ language for Graphviz_.
 
 :returns:
    The string representation of *self*.