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/07 14:19:25 UTC
(maven-jxr) branch master updated: Restore the document metadata dropped when the pages were ported
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-jxr.git
The following commit(s) were added to refs/heads/master by this push:
new 42d0a70 Restore the document metadata dropped when the pages were ported
42d0a70 is described below
commit 42d0a70e933dbf9b5262db15fdcb3c7839b70060
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Fri Aug 7 11:41:09 2026 +0200
Restore the document metadata dropped when the pages were ported
An APT document opens with a header block giving its title, authors and date, and
doxia-converter turns that into YAML front matter. The port removed the front
matter along with the converter's per-line licence comments, so the generated
pages lost their author and date meta tags, and took their title from the first
heading rather than from the document title.
The front matter has to come first in the file: the Markdown parser only looks for
it when the source begins with "---". A licence header ahead of it would hide it,
and RAT is happy either way.
---
maven-jxr-plugin/src/site/markdown/examples/aggregate.md.vm | 7 +++++++
.../src/site/markdown/examples/include-exclude.md.vm | 7 +++++++
maven-jxr-plugin/src/site/markdown/examples/linkjavadoc.md.vm | 7 +++++++
maven-jxr-plugin/src/site/markdown/examples/nofork.md.vm | 7 +++++++
maven-jxr-plugin/src/site/markdown/index.md | 7 +++++++
maven-jxr-plugin/src/site/markdown/usage.md.vm | 9 +++++++++
src/site/markdown/examples/java.md | 7 +++++++
src/site/markdown/index.md | 8 ++++++++
8 files changed, 59 insertions(+)
diff --git a/maven-jxr-plugin/src/site/markdown/examples/aggregate.md.vm b/maven-jxr-plugin/src/site/markdown/examples/aggregate.md.vm
index 9a70a58..eb81967 100644
--- a/maven-jxr-plugin/src/site/markdown/examples/aggregate.md.vm
+++ b/maven-jxr-plugin/src/site/markdown/examples/aggregate.md.vm
@@ -1,3 +1,10 @@
+---
+title: Aggregating JXR Reports for Multi-module Projects
+author:
+ - Maria Odea Ching
+date: 2010-01-20
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-jxr-plugin/src/site/markdown/examples/include-exclude.md.vm b/maven-jxr-plugin/src/site/markdown/examples/include-exclude.md.vm
index 78812be..812d93e 100644
--- a/maven-jxr-plugin/src/site/markdown/examples/include-exclude.md.vm
+++ b/maven-jxr-plugin/src/site/markdown/examples/include-exclude.md.vm
@@ -1,3 +1,10 @@
+---
+title: Including/Excluding Source Files
+author:
+ - Dennis Lundberg
+date: 2010-01-20
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-jxr-plugin/src/site/markdown/examples/linkjavadoc.md.vm b/maven-jxr-plugin/src/site/markdown/examples/linkjavadoc.md.vm
index 0686436..b77716b 100644
--- a/maven-jxr-plugin/src/site/markdown/examples/linkjavadoc.md.vm
+++ b/maven-jxr-plugin/src/site/markdown/examples/linkjavadoc.md.vm
@@ -1,3 +1,10 @@
+---
+title: Linking JXR Files to Javadocs
+author:
+ - Maria Odea Ching
+date: 2010-01-20
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-jxr-plugin/src/site/markdown/examples/nofork.md.vm b/maven-jxr-plugin/src/site/markdown/examples/nofork.md.vm
index 21f6ce3..8dc29b7 100644
--- a/maven-jxr-plugin/src/site/markdown/examples/nofork.md.vm
+++ b/maven-jxr-plugin/src/site/markdown/examples/nofork.md.vm
@@ -1,3 +1,10 @@
+---
+title: Generate JXR without duplicate execution of phase generate-sources.
+author:
+ - Matt Nelson
+date: 2019-01-18
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-jxr-plugin/src/site/markdown/index.md b/maven-jxr-plugin/src/site/markdown/index.md
index f4b0346..a803005 100644
--- a/maven-jxr-plugin/src/site/markdown/index.md
+++ b/maven-jxr-plugin/src/site/markdown/index.md
@@ -1,3 +1,10 @@
+---
+title: Introduction
+author:
+ - Maria Odea Ching
+date: 2010-01-20
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-jxr-plugin/src/site/markdown/usage.md.vm b/maven-jxr-plugin/src/site/markdown/usage.md.vm
index 1cadadc..2909795 100644
--- a/maven-jxr-plugin/src/site/markdown/usage.md.vm
+++ b/maven-jxr-plugin/src/site/markdown/usage.md.vm
@@ -1,3 +1,12 @@
+---
+title: Usage
+author:
+ - Fabrice Bellingard
+ - bellingard.NO-SPAM@gmail.com
+ - Maria Odea Ching
+date: 2010-04-27
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/src/site/markdown/examples/java.md b/src/site/markdown/examples/java.md
index 51721f3..5ee4ed0 100644
--- a/src/site/markdown/examples/java.md
+++ b/src/site/markdown/examples/java.md
@@ -1,3 +1,10 @@
+---
+title: Using Maven JXR in Java
+author:
+ - Vincent Siveton
+date: 2010-01-20
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index d236c31..7ad6afd 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -1,3 +1,11 @@
+---
+title: Introduction
+author:
+ - Jason van Zyl
+ - Vincent Siveton
+date: 2010-01-20
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file