page_landing_url

documenteer.citations.page_landing_url(citation, page_url)

Locate a page-claiming citation on the page it claims: the page’s URL with that citation’s own fragment appended.

Parameters:

• citation (Mapping[str, Any]) – The claiming citation, as the mapping GuideCitation.to_html_context composes.

• page_url (str | None) – The claimed page’s own absolute URL, without a fragment.

Returns:

The location, or None when the page’s URL is unknown — a site that declares no base URL — in which case the caller states no location rather than inventing one.

Return type:

str | None

Notes

The fragment is what tells two works documented on one page apart, so every surface that states where such a work lives — its JSON-LD node’s url and its citation_fulltext_html_url meta tag — locates it through this one function and they cannot disagree.