You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by sl...@apache.org on 2026/08/10 00:35:10 UTC
(maven-source-plugin) branch master updated (7f72e34 -> 8109764)
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/maven-source-plugin.git
from 7f72e34 Restore the document metadata dropped when the pages were ported
new 1a53bce Rename the FAQ ahead of converting it
new 8109764 Convert the FAQ from FML to Markdown
The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
src/site/{fml/faq.fml => markdown/faq.md} | 30 ++++++++++++++----------------
1 file changed, 14 insertions(+), 16 deletions(-)
rename src/site/{fml/faq.fml => markdown/faq.md} (54%)
(maven-source-plugin) 01/02: Rename the FAQ ahead of converting it
Posted by sl...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-source-plugin.git
commit 1a53bce8ad160b08d8d08f31e2df584201d8a770
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Mon Aug 10 01:37:20 2026 +0200
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(-)
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
(maven-source-plugin) 02/02: Convert the FAQ from FML to Markdown
Posted by sl...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-source-plugin.git
commit 8109764cf9f3b3a3e3148a5c2a8292a2528f02aa
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Mon Aug 10 01:40:12 2026 +0200
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.
Explicit <a name> anchors keep the existing deep links working. All 1
still resolve. Where an id was not a valid XML name, Doxia rewrote it at
render time via DoxiaUtils.encodeId; the anchors written here reproduce
that rendered form, not the raw attribute.
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, the <head> is byte-identical, and every
link target on the page is unchanged.
site.xml needs no edit: src/site/fml/faq.fml and
src/site/markdown/faq.md both render to faq.html.
FML generates a [top] back-link after each answer; those are dropped
rather than hand-written, which is the only rendering loss.
The anchors are written <a id> rather than <a name>: maven-site-plugin
3.21.0 silently drops a name attribute from inline HTML, leaving the
build green and every deep link broken. The id form works on every
version and is the correct HTML5 spelling.
Generated-by: Claude Opus 5 (1M context)
---
src/site/markdown/faq.md | 30 ++++++++++++++----------------
1 file changed, 14 insertions(+), 16 deletions(-)
diff --git a/src/site/markdown/faq.md b/src/site/markdown/faq.md
index dd6b0ed..cb3f3df 100644
--- a/src/site/markdown/faq.md
+++ b/src/site/markdown/faq.md
@@ -1,4 +1,6 @@
-<?xml version="1.0" encoding="UTF-8"?>
+---
+title: Frequently Asked Questions
+---
<!--
Licensed to the Apache Software Foundation (ASF) under one
@@ -19,18 +21,14 @@ specific language governing permissions and limitations
under the License.
-->
-<faqs xmlns="http://maven.apache.org/FML/1.0.1"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://maven.apache.org/FML/1.0.1 http://maven.apache.org/xsd/fml-1.0.1.xsd"
- id="FAQ" title="Frequently Asked Questions">
- <part id="General">
- <faq id="How can I generate a source jar of the test classes">
- <question>How can I generate a source jar of the test classes?</question>
- <answer>
- <p>
- Use the source:test-jar goal to generate a jar file that contains the project test sources.
- </p>
- </answer>
- </faq>
- </part>
-</faqs>
\ No newline at end of file
+<a id="top"></a>
+
+# Frequently Asked Questions
+
+1. [How can I generate a source jar of the test classes?](#How_can_I_generate_a_source_jar_of_the_test_classes)
+
+<a id="How_can_I_generate_a_source_jar_of_the_test_classes"></a>
+
+### How can I generate a source jar of the test classes?
+
+Use the source:test-jar goal to generate a jar file that contains the project test sources.