Skip to content

docs: fix basePath on raw internal links in the recipe picker - #156

Merged
mountainowl merged 1 commit into
mainfrom
docs/fix-recipe-links
Jul 7, 2026
Merged

docs: fix basePath on raw internal links in the recipe picker#156
mountainowl merged 1 commit into
mainfrom
docs/fix-recipe-links

Conversation

@mountainowl

Copy link
Copy Markdown
Owner

The "schedule it" link (and the self-hosted recipe's "OpenAI-compatible config" prereq link) were raw <a href="/…"> tags. Next only basePath-prefixes <Link> and _next/ assets, not raw <a>, so on the Pages deployment (served under /bubo/) these resolved to the domain root (mountainowl.github.io/operate) and 404'd.

Fix

  • schedule itasset('/operate/#schedule-the-poller') — basePath-prefixed and now lands on the Schedule the poller section instead of the page top.
  • Prerequisite links render via asset() for internal hrefs; external http links stay untouched (keep target=_blank).

Verification

  • next build green. asset('/operate/#schedule-the-poller')/bubo/operate/#schedule-the-poller; the operate page carries id="schedule-the-poller".

Raw `<a href="/…">` tags are not basePath-prefixed by Next, so on the
Pages deployment (served under /bubo/) they resolved to the domain root and
404'd. Prefix them with the asset() helper:

- "schedule it" → asset('/operate/#schedule-the-poller') — also lands on the
  Schedule-the-poller section instead of the page top.
- prerequisite links (e.g. the self-hosted "OpenAI-compatible config" →
  /configuration) → asset() for internal hrefs, external http links untouched.
@mountainowl
mountainowl merged commit 786b64b into main Jul 7, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant