From 2e33a78eea42b4e93913209dfb4b614bdebe3f28 Mon Sep 17 00:00:00 2001 From: Sylwester Lachiewicz Date: Mon, 10 Aug 2026 01:51:07 +0200 Subject: [PATCH 1/2] Rename the FAQ ahead of converting it Git records a rename plus a rewrite in one commit as a delete and an add, which stops 'git log --follow'. Splitting the rename out keeps the history. Please merge or rebase rather than squash. Generated-by: Claude Opus 5 (1M context) --- src/site/{fml/faq.fml => markdown/faq.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename src/site/{fml/faq.fml => markdown/faq.md} (100%) diff --git a/src/site/fml/faq.fml b/src/site/markdown/faq.md similarity index 100% rename from src/site/fml/faq.fml rename to src/site/markdown/faq.md From f50a3e49347974de14a94e707492948784bda285 Mon Sep 17 00:00:00 2001 From: Sylwester Lachiewicz Date: Mon, 10 Aug 2026 01:51:08 +0200 Subject: [PATCH 2/2] Convert the FAQ from FML to Markdown doxia-converter cannot target FML usefully - the questions come out as link-reference syntax rather than headings, the [top] back-links become links to a nonexistent 'top' page, and the contents links lose their # anchors. The page is written out by hand instead. Neither value is a valid XML name, so DoxiaUtils.encodeId rewrites both at render time: 'What is a Mojo' survives as #What_is_a_Mojo, and the second becomes #Why_mvn_help.3Aactive-profiles_won.27t_show_the_active_profiles_under_Maven_2.1 - note that it ends at '2.1' with no '.3F', because the id carries no question mark even though the question does. The elements written here reproduce those rendered forms, not the raw attributes, so the live deep links still resolve. The first question needs no explicit : the h3 it becomes already generates #What_is_a_Mojo from the same encodeId rule, so writing one as well would emit the id twice and Doxia warns about it. The second does need one, because the heading would generate a trailing '.3F' the live anchor does not have. Verified by building the site before and after and comparing the set of anchors the generated faq.html actually serves. Every anchor present before is still present after, and the is byte-identical, so the title and metadata are unchanged. site.xml needs no edit: src/site/fml/faq.fml and src/site/markdown/faq.md both render to faq.html, so the menu entry keeps working. FML generates a [top] back-link after each answer; those are dropped rather than hand-written. The question becomes an h3 heading instead of a definition term. Nothing else on the page changes. Generated-by: Claude Opus 5 (1M context) --- src/site/markdown/faq.md | 42 +++++++++++++++++----------------------- 1 file changed, 18 insertions(+), 24 deletions(-) diff --git a/src/site/markdown/faq.md b/src/site/markdown/faq.md index ae8ef277..28e13b76 100644 --- a/src/site/markdown/faq.md +++ b/src/site/markdown/faq.md @@ -1,4 +1,6 @@ - +--- +title: Frequently Asked Questions +--- + - - - - What is a Mojo - -

- See the Maven FAQ: What is a Mojo. -

- - - - Why mvn help:active-profiles won't show the active profiles under Maven 2.1? - -

- See MPH-38 for more info. -

- - - - \ No newline at end of file +# Frequently Asked Questions + +1. [What is a Mojo](#What_is_a_Mojo) +2. [Why `mvn help:active-profiles` won't show the active profiles under Maven 2.1?](#Why_mvn_help.3Aactive-profiles_won.27t_show_the_active_profiles_under_Maven_2.1) + +### What is a Mojo + +See the Maven FAQ: [What is a Mojo](http://maven.apache.org/general.html#What_is_a_Mojo). + + + +### Why `mvn help:active-profiles` won't show the active profiles under Maven 2.1? + +See [MPH-38](https://issues.apache.org/jira/browse/MPH-38) for more info.