Fix link to tag pages

RELEASE.md → docs/details/RELEASE.md

@@ -2,6 +2,9 @@
 
 `sphinx-tags` uses [flit](https://github.com/pypa/flit) to manage releases.
 
+```{tags} development
+```
+
 To cut a new release:
 
 1. Make sure the version string in `src/sphinx_tags/__init__.py` is updated with

docs/index.rst

@@ -17,6 +17,7 @@ documentation.
    configuration
    examples.md
    devel
+   details/RELEASE.md
 
 .. toctree::
    :caption: Site tags

src/sphinx_tags/__init__.py

@@ -7,7 +7,7 @@
 from docutils import nodes
 from pathlib import Path
 
-__version__ = "0.1.3"
+__version__ = "0.1.3dev"
 
 logger = getLogger("sphinx-tags")
 
@@ -38,22 +38,17 @@ def run(self):
         count = 0
         for tag in tags:
             count += 1
-            on_rtd = os.environ.get("READTHEDOCS") == "True"
-            if on_rtd:
-                link = os.path.join(self.env.app.config.tags_output_dir, f"{tag}.html")
-            else:
-                link = os.path.join(
-                    self.env.app.srcdir,
-                    self.env.app.outdir,
-                    self.env.app.config.tags_output_dir,
-                    f"{tag}.html",
-                )
-            # link = os.path.join(
-            #     self.env.app.srcdir,
-            #     self.env.app.outdir,
-            #     self.env.app.config.tags_output_dir,
-            #     f"{tag}.html",
-            # )
+            # We want the link to be the path to the _tags folder, relative to this document's path
+            # where
+            #
+            #  - self.env.app.config.tags_output_dir
+            # |
+            #  - subfolder
+            #   |
+            #    - current_doc_path
+            docpath = Path(self.env.doc2path(self.env.docname)).parent
+            rootdir = os.path.relpath(self.env.app.config.tags_output_dir, docpath)
+            link = os.path.join(rootdir, f"{tag}.html")
             tag_node = nodes.reference(refuri=link, text=tag)
             result += tag_node
             if not count == len(tags):