[MSITE-1000] Introduce parser configuration parameter

Author: kwin

pom.xml

@@ -199,7 +199,7 @@ under the License.
     <!-- for dependencies -->
     <jettyVersion>9.4.53.v20231009</jettyVersion>
     <doxiaVersion>2.0.0-M8</doxiaVersion>
-    <doxiaSitetoolsVersion>2.0.0-M16</doxiaSitetoolsVersion>
+    <doxiaSitetoolsVersion>2.0.0-M17-SNAPSHOT</doxiaSitetoolsVersion>
     <wagonVersion>3.5.3</wagonVersion>
     <slf4jVersion>1.7.36</slf4jVersion>
     <!-- for ITs -->
@@ -513,6 +513,17 @@ under the License.
   <build>
     <pluginManagement>
       <plugins>
+        <plugin>
+          <groupId>org.apache.maven.plugins</groupId>
+          <artifactId>maven-plugin-plugin</artifactId>
+          <configuration>
+            <externalJavadocBaseUrls>
+              <externalJavadocBaseUrl>https://maven.apache.org/doxia/doxia/doxia-core/apidocs/</externalJavadocBaseUrl>
+              <externalJavadocBaseUrl>https://maven.apache.org/doxia/doxia-sitetools/doxia-site-renderer/apidocs/</externalJavadocBaseUrl>
+              <externalJavadocBaseUrl>https://docs.oracle.com/javase/8/docs/api/</externalJavadocBaseUrl>
+            </externalJavadocBaseUrls>
+          </configuration>
+        </plugin>
         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-plugin-report-plugin</artifactId>

src/main/java/org/apache/maven/plugins/site/render/AbstractSiteRenderingMojo.java

@@ -94,6 +94,24 @@ public abstract class AbstractSiteRenderingMojo extends AbstractSiteDescriptorMo
     @Parameter
     private Map<String, Object> attributes;
 
+    /**
+     * Parser configurations (per Doxia markup source file paths).
+     * Each entry has the following format
+     * <p/>
+     * <pre>
+     *   &lt;patterns&gt;
+     *     &lt;pattern&gt;glob:**&#47;*.md&lt;/pattern&gt;&lt;!-- is either glob or regex syntax --&gt;
+     *   &lt;/patterns&gt;
+     *   &lt;emitComments&gt;true&lt;/emitComments&gt;&lt;!-- false by default --&gt;
+     *   &lt;emitAnchorsForIndexableEntries&gt;false&lt;/emitAnchorsForIndexableEntries&gt;&lt;!-- true by default --&gt;
+     * </pre>
+     *
+     * @since 4.0.0
+     * @see java.nio.file.FileSystem#getPathMatcher(String) FileSystem.getPathMatcher(String) for the supported patterns
+     */
+    @Parameter
+    private List<ParserConfiguration> parserConfigurations;
+
     /**
      * Site renderer.
      */
@@ -329,7 +347,7 @@ protected SiteRenderingContext createSiteRenderingContext(Locale locale)
                 context.setProcessedContentOutput(processedDir);
             }
         }
-
+        context.setParserConfigurationRetriever(new ParserConfigurationRetrieverImpl(parserConfigurations));
         return context;
     }
 

src/main/java/org/apache/maven/plugins/site/render/ParserConfiguration.java

@@ -0,0 +1,88 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.maven.plugins.site.render;
+
+import java.nio.file.FileSystem;
+import java.nio.file.Path;
+import java.nio.file.PathMatcher;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Map.Entry;
+import java.util.regex.Pattern;
+
+import org.apache.maven.doxia.parser.Parser;
+
+/** Configuration for a Doxia {@link Parser} (bound to a specific markup source path pattern) **/
+public class ParserConfiguration implements org.apache.maven.doxia.siterenderer.ParserConfiguration {
+
+    /**
+     * Map of patterns and {@link PathMatcher}s.
+     * The key contains the pattern in the format described at {@link FileSystem#getPathMatcher(String)}, i.e. {@code <syntax>:<pattern>}
+     * where {@code <syntax} is either {@code glob} or {@code regex}. The value represents the according {@link PathMatcher} which is set
+     * lazily.
+     * If one of the patterns matches the file being parsed this configuration is applied.
+     * @see FileSystem#getPathMatcher(String)
+     * @see Pattern
+     */
+    private final Map<String, PathMatcher> patterns;
+
+    /**
+     * @see {@link Parser#setEmitComments(boolean)}
+     */
+    private boolean emitComments;
+
+    /**
+     * @see {@link Parser#setEmitAnchorsForIndexableEntries(boolean)}
+     */
+    private boolean emitAnchorsForIndexableEntries;
+
+    public ParserConfiguration() {
+        patterns = new HashMap<>();
+    }
+
+    public void setEmitComments(boolean emitComments) {
+        this.emitComments = emitComments;
+    }
+
+    public void setEmitAnchorsForIndexableEntries(boolean emitAnchorsForIndexableEntries) {
+        this.emitAnchorsForIndexableEntries = emitAnchorsForIndexableEntries;
+    }
+
+    public void addPattern(String pattern) {
+        patterns.put(pattern, null);
+    }
+
+    public boolean matches(Path filePath) {
+        for (Entry<String, PathMatcher> patternWithMatcher : patterns.entrySet()) {
+            if (patternWithMatcher.getValue() == null) {
+                patternWithMatcher.setValue(filePath.getFileSystem().getPathMatcher(patternWithMatcher.getKey()));
+            }
+            if (patternWithMatcher.getValue().matches(filePath)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    @Override
+    public void accept(Parser parser) {
+        parser.setEmitComments(emitComments);
+        // parser.setEmitAnchorsForIndexableEntries(emitAnchorsForIndexableEntries);
+    }
+}

src/main/java/org/apache/maven/plugins/site/render/ParserConfigurationRetrieverImpl.java

@@ -0,0 +1,39 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.maven.plugins.site.render;
+
+import java.nio.file.Path;
+import java.util.Collection;
+import java.util.Optional;
+
+import org.apache.maven.doxia.siterenderer.ParserConfigurationRetriever;
+
+public class ParserConfigurationRetrieverImpl implements ParserConfigurationRetriever {
+
+    private final Collection<ParserConfiguration> parserConfigurations;
+
+    public ParserConfigurationRetrieverImpl(Collection<ParserConfiguration> parserConfigurations) {
+        this.parserConfigurations = parserConfigurations;
+    }
+
+    @Override
+    public Optional<ParserConfiguration> apply(Path filePath) {
+        return parserConfigurations.stream().filter(c -> c.matches(filePath)).findFirst();
+    }
+}

src/main/java/org/apache/maven/plugins/site/render/ReportDocumentRenderer.java

@@ -131,6 +131,7 @@ public Sink createSink(File outputDirectory, String outputName) {
                     docRenderingContext.getBasedirRelativePath(),
                     document,
                     docRenderingContext.getParserId(),
+                    docRenderingContext.getParserConfiguration(), // TODO: use another config?
                     docRenderingContext.getExtension(),
                     docRenderingContext.isEditable(),
                     docRenderingContext.getGenerator());