Visitar URL original
Keep the site descriptor's links to maven.apache.org absolute by slachiewicz · Pull Request #630 · apache/maven-parent · GitHub
Skip to content

Keep the site descriptor's links to maven.apache.org absolute - #630

Merged
slachiewicz merged 1 commit into
apache:masterfrom
slachiewicz:site-links-absolute
Nov 3, 2026
Merged

slachiewicz merged 1 commit into
apache:masterfrom
slachiewicz:site-links-absolute

Conversation

@slachiewicz

@slachiewicz slachiewicz commented Nov 2, 2026 •

Copy link
Copy Markdown
Member

Sets relativizeSiteLinks to false, so the banners and the menu links to other Maven sites keep the absolute https://maven.apache.org/... URLs that the site descriptor already uses. Relativized links such as ../../images/... resolve only where a site is published, so local renders, fork previews and staging copies had broken logos and menu links.

Closes #559

Verified: maven-archiver master rendered with -DrelativizeSiteLinks=false → 0 links above the site root, against 374 with the default.

maven-site, the root site, keeps relativizing: set relativizeSiteLinks to true there when it moves to this parent, or the "Maven Projects" menu stops marking the current section on its six section pages (plugins/, skins/, shared/, pom/, doxia/, extensions/). Every other link of its 300 pages keeps its target.

maven-site-plugin turned the banners and the menu links to other Maven sites into links that climb above the
site root (../../images/...), which resolve only where the site is published on maven.apache.org. A fork
preview, a staging copy or a local render had broken logos and menu links: 374 on the maven-archiver site.
@slachiewicz slachiewicz added the enhancement New feature or request label Nov 2, 2026
@slachiewicz
slachiewicz marked this pull request as ready for review November 3, 2026 01:00
@slachiewicz
slachiewicz merged commit 7ffedb9 into apache:master Nov 3, 2026
7 checks passed
@github-actions github-actions Bot added this to the 51 milestone Nov 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Proposal: Don't relativize site links

1 participant