From 12b3363b2ca1c8417c2a1fb20f5806709bc58f76 Mon Sep 17 00:00:00 2001
From: lethosor <lethosor@gmail.com>
Date: Sat, 6 Aug 2022 17:26:33 -0400
Subject: [PATCH] Make dfhack-tool tags link to tag descriptions

---
 docs/sphinx_extensions/dfhack/tool_docs.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/sphinx_extensions/dfhack/tool_docs.py b/docs/sphinx_extensions/dfhack/tool_docs.py
index 809bd48b8..65da95181 100644
--- a/docs/sphinx_extensions/dfhack/tool_docs.py
+++ b/docs/sphinx_extensions/dfhack/tool_docs.py
@@ -6,6 +6,7 @@
 import docutils.nodes as nodes
 # import docutils.parsers.rst.directives as rst_directives
 import sphinx
+import sphinx.addnodes as addnodes
 import sphinx.directives
 
 import dfhack.util
@@ -26,7 +27,13 @@ class DFHackToolDirective(sphinx.directives.ObjectDescription):
         tag_nodes = [nodes.strong(text='Tags: ')]
         for tag in self.options.get('tags', []):
             tag_nodes += [
-                nodes.literal(tag, tag),
+                addnodes.pending_xref(tag, nodes.inline(text=tag), **{
+                    'reftype': 'ref',
+                    'refdomain': 'std',
+                    'reftarget': 'tag/' + tag,
+                    'refexplicit': False,
+                    'refwarn': True,
+                }),
                 nodes.inline(text=' | '),
             ]
         tag_nodes.pop()