Fix Gateway links in code blocks

[NicolasPllr1]

Problem (docs)

I found broken 'Learn about Gateway' links in code blocks (e.g. here) reading the docs, which led me to try and fix them!

I think the problem is in the transform_gateway_code_block function. It tries to compute a relative path to the Gateway page using the parent of the current page (relative_path_root ) instead of the page itself:

pydantic-ai/docs/.hooks/main.py

Lines 188 to 190 in 359c6d2

	docs_path = DOCS_ROOT / 'gateway'
	relative_path = docs_path.relative_to(relative_path_root, walk_up=True)
	link = f"<a href='{relative_path}' style='float: right;'>Learn about Gateway</a>"

This is the logic I tried to fix. I tested a few links locally and they seem to be working now ; )

Hope this is enough and helps!

---

Couple of tests:

• In 'Pydantic AI' : link (was already working)
• In 'Core Concepts > Agent' : link (was broken)
• In 'Models and Providers > OpenAI' : link (was broken)

Related Issue

• Broken gateway links in code blocks #3445