ENH(site): put |substs| in rst_epilog config ...

to stop requiring README's' tail inclusion.

Author: ankostis

README.rst

@@ -118,11 +118,10 @@ Run the graph and request all of the outputs:
     :alt: graphtik legend
     :align: middle
 
-.. _substs:
 
 .. _Graphkit: https://github.com/yahoo/graphkit
-.. _`Graphviz`: https://graphviz.org
-.. _`pydot`: https://github.com/pydot/pydot
+.. _Graphviz: https://graphviz.org
+.. _badges_substs:
 
 .. |travis-status| image:: https://img.shields.io/travis/pygraphkit/graphtik
     :alt: Travis continuous integration testing ok? (Linux)

docs/source/conf.py

@@ -121,6 +121,14 @@ def linkcode_resolve(domain, info):
     return uri
 
 
+rst_epilog = """
+.. _Graphkit: https://github.com/yahoo/graphkit
+.. _Graphviz: https://graphviz.org
+.. _pydot: https://github.com/pydot/pydot
+.. |pydot.Dot| replace:: ``pydot.Dot``
+.. _pydot.Dot: https://github.com/pydot/pydot
+"""
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 

docs/source/index.rst

@@ -124,4 +124,4 @@ Solutions are plottable as well:
 .. |plot-legend| raw:: html
     :file:  images/GraphtikLegend.svg
 .. include:: ../../README.rst
-    :start-after: _substs:
+    :start-after: _badges_substs: