In-content documentation links 404 on the deployed site: root-relative links miss the deploy base path
### Overview
Links in the body text of the user documentation return 404 on the deployed
site. For example, the "Translations" link in the body of the Guides page
(https://project.pages.drupalcode.org/canvas/guides/) points to
`/guides/translations` instead of `/canvas/guides/translations`, so it 404s.
The same "Translations" link in the left sidebar works.
The documentation is deployed under a base path that is only known at build
time: `/canvas/` in production and a nested `/canvas/mr-<iid>/` for merge
request previews. Hardcoded root-relative Markdown links in the content are
emitted without that base, so they resolve to the domain root and 404. Sidebar
links are unaffected because Starlight resolves them against the base path. This
affects in-content links across all documentation sections, not only the Guides
page.
Because the base is dynamic (and nested for previews), hardcoding it into each
link is not viable — the correct base can only be applied at build time.
### Steps to reproduce
1. Open https://project.pages.drupalcode.org/canvas/guides/
2. Click the "Translations" link in the page body.
3. Result: 404 Not Found. The sidebar "Translations" link works.
### Proposed resolution
Apply the configured base path to in-content links at build time. A rehype
plugin prefixes the build-time base to root-relative in-site links, so they
resolve correctly on every deploy target (production and per-MR previews) while
the source markup stays base-agnostic. External, protocol-relative, anchor, and
already-prefixed links are left untouched.
### Remaining tasks
- Add link checking to the docs build so broken links fail before deploy
(follow-up).
### User interface changes
None (documentation only).
issue