From dbab09ff2ffea5b91cd7a1bb49efe87eb014461e Mon Sep 17 00:00:00 2001 From: Sylwester Lachiewicz Date: Sat, 8 Aug 2026 19:58:15 +0200 Subject: [PATCH 1/2] Upgrade to plexus parent 26 Parent 26 keeps Spotless away from src/site/markdown. Its flexmark formatter rewrites the fence that closes a YAML front matter block, which silently costs each page its title. --- pom.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pom.xml b/pom.xml index d9f59c9..ab385de 100644 --- a/pom.xml +++ b/pom.xml @@ -5,7 +5,7 @@ org.codehaus.plexus plexus - 25 + 26 plexus-io From 15eeebf04fda0119c96b8564382d86fc3fecff98 Mon Sep 17 00:00:00 2001 From: Sylwester Lachiewicz Date: Sat, 8 Aug 2026 19:58:15 +0200 Subject: [PATCH 2/2] Restore the document titles dropped when the pages were ported Each APT source opened with a title block that the conversion to Markdown dropped, so every generated page took its name from the project rather than from the document. Put the titles back as YAML front matter. Only titles: none of the three APT sources carried an author or a date block. --- src/site/markdown/filemappers.md | 4 ++++ src/site/markdown/fileselectors.md | 4 ++++ src/site/markdown/index.md | 4 ++++ 3 files changed, 12 insertions(+) diff --git a/src/site/markdown/filemappers.md b/src/site/markdown/filemappers.md index e47aa92..e266593 100644 --- a/src/site/markdown/filemappers.md +++ b/src/site/markdown/filemappers.md @@ -1,3 +1,7 @@ +--- +title: File Mappers +--- + # File Mappers A file mapper is a plexus component, which allows to convert file names. File mappers are used when creating files. For example, the [XML Maven Plugin](https://www.mojohaus.org/xml-maven-plugin) allows to specify a file mapper when creating files by XSLT transformation. diff --git a/src/site/markdown/fileselectors.md b/src/site/markdown/fileselectors.md index 57b7216..3bccfb1 100644 --- a/src/site/markdown/fileselectors.md +++ b/src/site/markdown/fileselectors.md @@ -1,3 +1,7 @@ +--- +title: File Selectors +--- + # File Selectors A file selector is a plexus component, which allows to select certain files out of a given set. For example, the [Plexus Archiver](http://plexus.codehaus.org/plexus-archiver) uses file selectors to select the files being archived out of a base directory. Its counterpart, the Plexus Unarchiver allows to restrict the files to unarchive. diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md index 572af1a..c342667 100644 --- a/src/site/markdown/index.md +++ b/src/site/markdown/index.md @@ -1,3 +1,7 @@ +--- +title: Introduction +--- + # Plexus IO Plexus IO is a set of plexus components, which are designed for use in I/O operations. These I/O operations are doing nothing spectacular. For example, [Commons IO](http://jakarta.apache.org/commons/io) is a much more powerful library in the same area. However, the implementation as a plexus component allows reuse in Maven.