From 447db0b0f9df6a02ec80a434177147e197510c64 Mon Sep 17 00:00:00 2001
From: Sylwester Lachiewicz <slachiewicz@apache.org>
Date: Fri, 7 Aug 2026 11:41:08 +0200
Subject: [PATCH] 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.
---
 .../markdown/examples/customize-file-name-mapping.md.vm  | 9 +++++++++
 .../examples/customizing-a-module-filename.md.vm         | 8 ++++++++
 .../markdown/examples/customizing-context-root.md.vm     | 8 ++++++++
 .../markdown/examples/customizing-module-location.md.vm  | 8 ++++++++
 src/site/markdown/examples/customizing-module-uri.md.vm  | 8 ++++++++
 .../examples/eclipse-and-maven-integration.md.vm         | 8 ++++++++
 src/site/markdown/examples/excluding-a-module.md.vm      | 8 ++++++++
 .../markdown/examples/excluding-files-from-ear.md.vm     | 7 +++++++
 src/site/markdown/examples/filtering-advanced.md.vm      | 8 ++++++++
 src/site/markdown/examples/filtering-sources.md.vm       | 8 ++++++++
 src/site/markdown/examples/generating-jboss-app.md.vm    | 8 ++++++++
 src/site/markdown/examples/generating-modules-id.md.vm   | 8 ++++++++
 ...luding-a-third-party-library-in-application-xml.md.vm | 8 ++++++++
 src/site/markdown/examples/skinny-modules.md.vm          | 7 +++++++
 src/site/markdown/examples/skinny-wars.md.vm             | 8 ++++++++
 ...b-ref-entries-for-the-generated-application-xml.md.vm | 7 +++++++
 ...g-env-entries-for-the-generated-application-xml.md.vm | 8 ++++++++
 ...e-ref-entries-for-the-generated-application-xml.md.vm | 7 +++++++
 ...ecurity-roles-for-the-generated-application-xml.md.vm | 8 ++++++++
 src/site/markdown/examples/unpacking-a-module.md.vm      | 8 ++++++++
 src/site/markdown/examples/using-app-client.md           | 8 ++++++++
 src/site/markdown/index.md                               | 9 +++++++++
 src/site/markdown/modules.md.vm                          | 7 +++++++
 src/site/markdown/tests.md                               | 7 +++++++
 src/site/markdown/usage.md.vm                            | 8 ++++++++
 25 files changed, 196 insertions(+)

diff --git a/src/site/markdown/examples/customize-file-name-mapping.md.vm b/src/site/markdown/examples/customize-file-name-mapping.md.vm
index a57d2d18..78b56c90 100644
--- a/src/site/markdown/examples/customize-file-name-mapping.md.vm
+++ b/src/site/markdown/examples/customize-file-name-mapping.md.vm
@@ -1,3 +1,12 @@
+---
+title: Customizing The File Name Mapping
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+  - Karl Heinz Marbaise khmarbaise@apache.org
+date: 2006-11-19
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/customizing-a-module-filename.md.vm b/src/site/markdown/examples/customizing-a-module-filename.md.vm
index caf5bf42..8880e294 100644
--- a/src/site/markdown/examples/customizing-a-module-filename.md.vm
+++ b/src/site/markdown/examples/customizing-a-module-filename.md.vm
@@ -1,3 +1,11 @@
+---
+title: Customizing A Module Filename
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2005-09-23
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/customizing-context-root.md.vm b/src/site/markdown/examples/customizing-context-root.md.vm
index eb587cb4..c48aade5 100644
--- a/src/site/markdown/examples/customizing-context-root.md.vm
+++ b/src/site/markdown/examples/customizing-context-root.md.vm
@@ -1,3 +1,11 @@
+---
+title: Customizing The Context Root
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2005-09-23
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/customizing-module-location.md.vm b/src/site/markdown/examples/customizing-module-location.md.vm
index 9886a94b..889f04cc 100644
--- a/src/site/markdown/examples/customizing-module-location.md.vm
+++ b/src/site/markdown/examples/customizing-module-location.md.vm
@@ -1,3 +1,11 @@
+---
+title: Customizing A Module Location
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2011-12-23
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/customizing-module-uri.md.vm b/src/site/markdown/examples/customizing-module-uri.md.vm
index 69dfa42d..a1d1adfc 100644
--- a/src/site/markdown/examples/customizing-module-uri.md.vm
+++ b/src/site/markdown/examples/customizing-module-uri.md.vm
@@ -1,3 +1,11 @@
+---
+title: Customizing A Module URI
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2005-09-23
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/eclipse-and-maven-integration.md.vm b/src/site/markdown/examples/eclipse-and-maven-integration.md.vm
index 85432eed..84ce799b 100644
--- a/src/site/markdown/examples/eclipse-and-maven-integration.md.vm
+++ b/src/site/markdown/examples/eclipse-and-maven-integration.md.vm
@@ -1,3 +1,11 @@
+---
+title: Eclipse and Maven integration
+author: 
+  - Chris Graham
+  - Robert Scholte
+date: 2013-11-19
+---
+
 <!--
 Copyright 2013 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/excluding-a-module.md.vm b/src/site/markdown/examples/excluding-a-module.md.vm
index 383585bb..91937f7c 100644
--- a/src/site/markdown/examples/excluding-a-module.md.vm
+++ b/src/site/markdown/examples/excluding-a-module.md.vm
@@ -1,3 +1,11 @@
+---
+title: Excluding A Module
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2005-09-23
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/excluding-files-from-ear.md.vm b/src/site/markdown/examples/excluding-files-from-ear.md.vm
index 72af69d1..f5dddc0d 100644
--- a/src/site/markdown/examples/excluding-files-from-ear.md.vm
+++ b/src/site/markdown/examples/excluding-files-from-ear.md.vm
@@ -1,3 +1,10 @@
+---
+title: Excluding Files From the EAR
+author: 
+  - Dennis Lundberg
+date: 2011-12-09
+---
+
 <!--
 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/filtering-advanced.md.vm b/src/site/markdown/examples/filtering-advanced.md.vm
index f812e196..4b2fc69f 100644
--- a/src/site/markdown/examples/filtering-advanced.md.vm
+++ b/src/site/markdown/examples/filtering-advanced.md.vm
@@ -1,3 +1,11 @@
+---
+title: Filtering Advanced Techniques
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2009-01-03
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/filtering-sources.md.vm b/src/site/markdown/examples/filtering-sources.md.vm
index 3760c898..89bf1edc 100644
--- a/src/site/markdown/examples/filtering-sources.md.vm
+++ b/src/site/markdown/examples/filtering-sources.md.vm
@@ -1,3 +1,11 @@
+---
+title: Filtering the sources
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2009-01-03
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/generating-jboss-app.md.vm b/src/site/markdown/examples/generating-jboss-app.md.vm
index e74b2989..e73d2175 100644
--- a/src/site/markdown/examples/generating-jboss-app.md.vm
+++ b/src/site/markdown/examples/generating-jboss-app.md.vm
@@ -1,3 +1,11 @@
+---
+title: Generating the JBoss deployment descriptor file
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2006-08-06
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/generating-modules-id.md.vm b/src/site/markdown/examples/generating-modules-id.md.vm
index 1ac774cf..c838a800 100644
--- a/src/site/markdown/examples/generating-modules-id.md.vm
+++ b/src/site/markdown/examples/generating-modules-id.md.vm
@@ -1,3 +1,11 @@
+---
+title: Generating modules ID
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2010-09-04
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/including-a-third-party-library-in-application-xml.md.vm b/src/site/markdown/examples/including-a-third-party-library-in-application-xml.md.vm
index 283f447f..2a5634ed 100644
--- a/src/site/markdown/examples/including-a-third-party-library-in-application-xml.md.vm
+++ b/src/site/markdown/examples/including-a-third-party-library-in-application-xml.md.vm
@@ -1,3 +1,11 @@
+---
+title: Including A Third Party Library In application.xml
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2005-09-23
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/skinny-modules.md.vm b/src/site/markdown/examples/skinny-modules.md.vm
index 2f90c277..8c49c6d8 100644
--- a/src/site/markdown/examples/skinny-modules.md.vm
+++ b/src/site/markdown/examples/skinny-modules.md.vm
@@ -1,3 +1,10 @@
+---
+title: Creating Skinny Modules
+author: 
+  - Marat Abrarov
+date: 2020-10-18
+---
+
 <!--
 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/skinny-wars.md.vm b/src/site/markdown/examples/skinny-wars.md.vm
index 93a8f0af..e78be520 100644
--- a/src/site/markdown/examples/skinny-wars.md.vm
+++ b/src/site/markdown/examples/skinny-wars.md.vm
@@ -1,3 +1,11 @@
+---
+title: Creating Skinny WARs
+author: 
+  - Mike Perham
+  - Dennis Lundberg
+date: 2011-12-09
+---
+
 <!--
 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/specifying-ejb-ref-entries-for-the-generated-application-xml.md.vm b/src/site/markdown/examples/specifying-ejb-ref-entries-for-the-generated-application-xml.md.vm
index 15d7cb51..38dd6e7e 100644
--- a/src/site/markdown/examples/specifying-ejb-ref-entries-for-the-generated-application-xml.md.vm
+++ b/src/site/markdown/examples/specifying-ejb-ref-entries-for-the-generated-application-xml.md.vm
@@ -1,3 +1,10 @@
+---
+title: Specifying Ejb Refs For The Generated application.xml
+author: 
+  - Karl Heinz Marbaise khmarbaise@apache.org
+date: 2026-02-14
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/specifying-env-entries-for-the-generated-application-xml.md.vm b/src/site/markdown/examples/specifying-env-entries-for-the-generated-application-xml.md.vm
index ae7a6862..5599dd43 100644
--- a/src/site/markdown/examples/specifying-env-entries-for-the-generated-application-xml.md.vm
+++ b/src/site/markdown/examples/specifying-env-entries-for-the-generated-application-xml.md.vm
@@ -1,3 +1,11 @@
+---
+title: Specifying Security Roles For The Generated application.xml
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2017-08-27
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/specifying-resource-ref-entries-for-the-generated-application-xml.md.vm b/src/site/markdown/examples/specifying-resource-ref-entries-for-the-generated-application-xml.md.vm
index cfcb5179..7c6f2c32 100644
--- a/src/site/markdown/examples/specifying-resource-ref-entries-for-the-generated-application-xml.md.vm
+++ b/src/site/markdown/examples/specifying-resource-ref-entries-for-the-generated-application-xml.md.vm
@@ -1,3 +1,10 @@
+---
+title: Specifying Resource Refs For The Generated application.xml
+author: 
+  - Karl Heinz Marbaise khmarbaise@apache.org
+date: 2017-08-27
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/specifying-security-roles-for-the-generated-application-xml.md.vm b/src/site/markdown/examples/specifying-security-roles-for-the-generated-application-xml.md.vm
index 823cd8e6..defcf2d3 100644
--- a/src/site/markdown/examples/specifying-security-roles-for-the-generated-application-xml.md.vm
+++ b/src/site/markdown/examples/specifying-security-roles-for-the-generated-application-xml.md.vm
@@ -1,3 +1,11 @@
+---
+title: Specifying Security Roles For The Generated application.xml
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2005-09-23
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/unpacking-a-module.md.vm b/src/site/markdown/examples/unpacking-a-module.md.vm
index 9355c726..1bcb0231 100644
--- a/src/site/markdown/examples/unpacking-a-module.md.vm
+++ b/src/site/markdown/examples/unpacking-a-module.md.vm
@@ -1,3 +1,11 @@
+---
+title: Unpacking A Module
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2006-08-14
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/examples/using-app-client.md b/src/site/markdown/examples/using-app-client.md
index 12e31e56..0332e3a7 100644
--- a/src/site/markdown/examples/using-app-client.md
+++ b/src/site/markdown/examples/using-app-client.md
@@ -1,3 +1,11 @@
+---
+title: Using app client
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2011-04-03
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index bff0d2c8..144dcee8 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -1,3 +1,12 @@
+---
+title: Introduction
+author: 
+  - Edwin Punzalan
+  - Stephane Nicoll
+  - Dennis Lundberg
+date: 2013-07-22
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/modules.md.vm b/src/site/markdown/modules.md.vm
index 3665ef3b..ad1ae470 100644
--- a/src/site/markdown/modules.md.vm
+++ b/src/site/markdown/modules.md.vm
@@ -1,3 +1,10 @@
+---
+title: EAR Modules
+author: 
+  - Edwin Punzalan
+date: 2006-07-31
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/tests.md b/src/site/markdown/tests.md
index dc1a96da..4ffc6b52 100644
--- a/src/site/markdown/tests.md
+++ b/src/site/markdown/tests.md
@@ -1,3 +1,10 @@
+---
+title: Tests
+author: 
+  - Stephane Nicoll
+date: 2006-10-29
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.
 
diff --git a/src/site/markdown/usage.md.vm b/src/site/markdown/usage.md.vm
index 88073e3c..fc631444 100644
--- a/src/site/markdown/usage.md.vm
+++ b/src/site/markdown/usage.md.vm
@@ -1,3 +1,11 @@
+---
+title: Usage
+author: 
+  - Stephane Nicoll
+  - snicoll@apache.org
+date: 2010-12-23
+---
+
 <!--
 Copyright 2006 The Apache Software Foundation.