Skip to content

fix(docs): base-aware internal links - #32

Merged
rasuvaeff merged 1 commit into
masterfrom
fix/docs-internal-links
Aug 5, 2026
Merged

fix(docs): base-aware internal links#32
rasuvaeff merged 1 commit into
masterfrom
fix/docs-internal-links

Conversation

@rasuvaeff

Copy link
Copy Markdown
Owner

Follow-up to #31. The site base: '/property-testing/' only applies to markdown links and Vue Router links — raw HTML <a href="/en/..."> is not rewritten, so those links pointed at the domain root (rasuvaeff.github.io/en/ → 404).

Fixed (5 links):

  • docs/index.md language picker → relative ./en/ ./ru/ (browser-resolved under base)
  • en/ru api/index.md + api/exceptions.md <small> blocks → markdown links (base-applied)

Regression guard: check-integrity.mjs now fails the build on any raw HTML internal <a href="/..."> link, forcing the markdown form so VitePress applies base.

Verified in the built dist: no href="/en/..." remains; all internal links carry the /property-testing/ prefix.

Raw HTML <a href="/en/..."> links bypass VitePress's `base` rewriting
(only markdown and Vue Router links get the /property-testing/ prefix), so
they pointed at the domain root and 404'd. Converted the five offending links:

- docs/index.md language picker -> relative ./en/ ./ru/ (browser-resolved)
- en/ru api/index.md + api/exceptions.md <small> blocks -> markdown links

Added an integrity gate that fails the build on any raw HTML internal anchor,
so this class of regression cannot recur.
@rasuvaeff
rasuvaeff merged commit bba0be2 into master Aug 5, 2026
9 checks passed
@rasuvaeff
rasuvaeff deleted the fix/docs-internal-links branch August 5, 2026 12:43
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