fix(docs[aafig]): use builder target URI for image paths (dirhtml compat)

tony · tony · commit 520d4605f3a5 · 2026-03-24T04:05:31.000-05:00
why: The aafig extension computed image paths using the raw docname
instead of the builder's target URI. With dirhtml, this produces
../_images/ instead of ../../_images/ because dirhtml outputs files
one directory deeper (page/index.html vs page.html).
what:
- Change relative_uri(docname, "_images") to
  relative_uri(get_target_uri(docname), "_images")
- Matches how Sphinx itself computes image paths
  (sphinx/builders/html/__init__.py:655)
diff --git a/docs/_ext/aafig.py b/docs/_ext/aafig.py
@@ -176,7 +176,8 @@ def render_aafigure(
     fname = "{}.{}".format(get_basename(text, options), options["format"])
     if app.builder.format == "html":
         # HTML
-        imgpath = relative_uri(app.builder.env.docname, "_images")
+        target_uri = app.builder.get_target_uri(app.builder.env.docname)
+        imgpath = relative_uri(target_uri, "_images")
         relfn = posixpath.join(imgpath, fname)
         outfn = path.join(app.builder.outdir, "_images", fname)
     else:
