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:18:15 UTC
(maven-plugin-tools) 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-plugin-tools.git
The following commit(s) were added to refs/heads/master by this push:
new cc6e3dd3 Restore the document metadata dropped when the pages were ported
cc6e3dd3 is described below
commit cc6e3dd390655afd700c40d0eeec86cd87630bbf
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Fri Aug 7 11:41:11 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-plugin-annotations/src/site/markdown/index.md.vm | 7 +++++++
.../src/site/markdown/examples/generate-descriptor.md.vm | 7 +++++++
.../src/site/markdown/examples/generate-help.md.vm | 7 +++++++
.../src/site/markdown/examples/using-annotations.md.vm | 7 +++++++
maven-plugin-plugin/src/site/markdown/index.md | 7 +++++++
maven-plugin-plugin/src/site/markdown/usage.md | 8 ++++++++
.../src/site/markdown/examples/generate-report.md.vm | 7 +++++++
maven-plugin-report-plugin/src/site/markdown/index.md | 7 +++++++
maven-plugin-report-plugin/src/site/markdown/usage.md | 8 ++++++++
maven-plugin-tools-annotations/src/site/markdown/index.md | 7 +++++++
maven-plugin-tools-api/src/site/markdown/index.md | 7 +++++++
11 files changed, 79 insertions(+)
diff --git a/maven-plugin-annotations/src/site/markdown/index.md.vm b/maven-plugin-annotations/src/site/markdown/index.md.vm
index 099151ff..09dcde4b 100644
--- a/maven-plugin-annotations/src/site/markdown/index.md.vm
+++ b/maven-plugin-annotations/src/site/markdown/index.md.vm
@@ -1,3 +1,10 @@
+---
+title: About ${project.name}
+author:
+ - Hervé Boutemy
+date: 2012-06-03
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-plugin-plugin/src/site/markdown/examples/generate-descriptor.md.vm b/maven-plugin-plugin/src/site/markdown/examples/generate-descriptor.md.vm
index d1e589e3..27c1af9f 100644
--- a/maven-plugin-plugin/src/site/markdown/examples/generate-descriptor.md.vm
+++ b/maven-plugin-plugin/src/site/markdown/examples/generate-descriptor.md.vm
@@ -1,3 +1,10 @@
+---
+title: Configuring Generation of Plugin Descriptor
+author:
+ - Maria Odea Ching
+date: 2008-02-01
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-plugin-plugin/src/site/markdown/examples/generate-help.md.vm b/maven-plugin-plugin/src/site/markdown/examples/generate-help.md.vm
index 49c0f10c..99890a47 100644
--- a/maven-plugin-plugin/src/site/markdown/examples/generate-help.md.vm
+++ b/maven-plugin-plugin/src/site/markdown/examples/generate-help.md.vm
@@ -1,3 +1,10 @@
+---
+title: Configuring Generation of Help Mojo
+author:
+ - Vincent Siveton
+date: 2008-01-01
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-plugin-plugin/src/site/markdown/examples/using-annotations.md.vm b/maven-plugin-plugin/src/site/markdown/examples/using-annotations.md.vm
index e20ed68b..93304071 100644
--- a/maven-plugin-plugin/src/site/markdown/examples/using-annotations.md.vm
+++ b/maven-plugin-plugin/src/site/markdown/examples/using-annotations.md.vm
@@ -1,3 +1,10 @@
+---
+title: Using Plugin Tools Java5 Annotations
+author:
+ - Olivier Lamy
+date: 2012-05-14
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-plugin-plugin/src/site/markdown/index.md b/maven-plugin-plugin/src/site/markdown/index.md
index a29eb31c..0ea1f957 100644
--- a/maven-plugin-plugin/src/site/markdown/index.md
+++ b/maven-plugin-plugin/src/site/markdown/index.md
@@ -1,3 +1,10 @@
+---
+title: Introduction
+author:
+ - Maria Odea Ching
+date: 2008-01-01
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-plugin-plugin/src/site/markdown/usage.md b/maven-plugin-plugin/src/site/markdown/usage.md
index b13f77b9..6d2b594d 100644
--- a/maven-plugin-plugin/src/site/markdown/usage.md
+++ b/maven-plugin-plugin/src/site/markdown/usage.md
@@ -1,3 +1,11 @@
+---
+title: Usage
+author:
+ - Maria Odea Ching
+ - Vincent Siveton
+date: 2008-01-01
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-plugin-report-plugin/src/site/markdown/examples/generate-report.md.vm b/maven-plugin-report-plugin/src/site/markdown/examples/generate-report.md.vm
index bf19f313..d666bc67 100644
--- a/maven-plugin-report-plugin/src/site/markdown/examples/generate-report.md.vm
+++ b/maven-plugin-report-plugin/src/site/markdown/examples/generate-report.md.vm
@@ -1,3 +1,10 @@
+---
+title: Configuring Generation of Documentation Reports
+author:
+ - Vincent Siveton
+date: 2008-01-01
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-plugin-report-plugin/src/site/markdown/index.md b/maven-plugin-report-plugin/src/site/markdown/index.md
index 67eb91ac..0b19f556 100644
--- a/maven-plugin-report-plugin/src/site/markdown/index.md
+++ b/maven-plugin-report-plugin/src/site/markdown/index.md
@@ -1,3 +1,10 @@
+---
+title: Introduction
+author:
+ - Maria Odea Ching
+date: 2008-01-01
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-plugin-report-plugin/src/site/markdown/usage.md b/maven-plugin-report-plugin/src/site/markdown/usage.md
index fa009b88..7bce8a3d 100644
--- a/maven-plugin-report-plugin/src/site/markdown/usage.md
+++ b/maven-plugin-report-plugin/src/site/markdown/usage.md
@@ -1,3 +1,11 @@
+---
+title: Usage
+author:
+ - Maria Odea Ching
+ - Vincent Siveton
+date: 2008-01-01
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-plugin-tools-annotations/src/site/markdown/index.md b/maven-plugin-tools-annotations/src/site/markdown/index.md
index 83bbe3a6..ca686695 100644
--- a/maven-plugin-tools-annotations/src/site/markdown/index.md
+++ b/maven-plugin-tools-annotations/src/site/markdown/index.md
@@ -1,3 +1,10 @@
+---
+title: Introduction
+author:
+ - Hervé Boutemy
+date: 2012-05-12
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
diff --git a/maven-plugin-tools-api/src/site/markdown/index.md b/maven-plugin-tools-api/src/site/markdown/index.md
index a4d7188b..27606281 100644
--- a/maven-plugin-tools-api/src/site/markdown/index.md
+++ b/maven-plugin-tools-api/src/site/markdown/index.md
@@ -1,3 +1,10 @@
+---
+title: Introduction
+author:
+ - Vincent Siveton
+date: 2012-05-14
+---
+
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file