From 9e990d79a348f06c3d031c6759814acc32449e15 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Timoth=C3=A9e=20Mazzucotelli?= <dev@pawamoy.fr>
Date: Fri, 10 Jan 2025 02:14:05 +0100
Subject: [PATCH] refactor: Log a debug message for unresolved optional
 references

This can help identify external references that could be resolved by loading additional inventories.
---
 src/mkdocs_autorefs/references.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/mkdocs_autorefs/references.py b/src/mkdocs_autorefs/references.py
index f2f7425..8eca5f0 100644
--- a/src/mkdocs_autorefs/references.py
+++ b/src/mkdocs_autorefs/references.py
@@ -391,6 +391,7 @@ def inner(match: Match) -> str:
             url = _find_url(identifiers, url_mapper)
         except KeyError:
             if optional:
+                log.debug("Unresolved optional cross-reference: %s", identifier)
                 if hover:
                     return f'<span title="{identifier}">{title}</span>'
                 return title