Bukama commented on PR #573: URL: https://github.com/apache/maven-site/pull/573#issuecomment-2780665550
As written, I tested the conversation on a smaller folder (the `examples` folder, containing two `.apt` files). I forked doxia-converter, cloned the master branch, built it and used the shaded.jar to generate with the following command (inside content folder) `java -jar doxia-converter-1.4-SNAPSHOT-shaded.jar -in ./apt/examples -from apt -out ./markdown/examples -to markdown -removeIn` According to the logs, files got converted successfully. ``` D:\Github\Maven\maven-site\content>java -jar doxia-converter-1.4-SNAPSHOT-shaded.jar -in ./apt/examples -from apt -out ./markdown/examples -to markdown -removeIn [main] INFO org.apache.maven.doxia.DefaultConverter - Successfully converted file "D:\Github\Maven\maven-site\content\.\apt\examples\index.apt" to "D:\Github\Maven\maven-site\content\.\markdown\examples\index.md" [main] INFO org.apache.maven.doxia.DefaultConverter - Removed input file "D:\Github\Maven\maven-site\content\.\apt\examples\index.apt" after successful conversion [main] INFO org.apache.maven.doxia.DefaultConverter - Successfully converted file "D:\Github\Maven\maven-site\content\.\apt\examples\injecting-properties-via-settings.apt" to "D:\Github\Maven\maven-site\content\.\markdown\examples\injecting-properties-via-settings.md" [main] INFO org.apache.maven.doxia.DefaultConverter - Removed input file "D:\Github\Maven\maven-site\content\.\apt\examples\injecting-properties-via-settings.apt" after successful conversion ``` But I'm not convinced the outcome is 100% correct. * meta-data (title, author) are converted to markdown front matter. On other pages we wrote it in a way that it gets rendered to the HTML or left it out completly * character escapes are still in text * source-code set to unknown. I guess it's a default, because the converter can't analyse what language the code snippets are and then `unknown` might be semantically correct. But, we don't use this anywhere else (yet). So maybe remove it?. However, my IntelliJ plugin can display it.  But when I run `mvn site:run` or build the site via `mvn clean verify site` the content does not converted to HTML. The content body of the final file is just empty and therefore an empty content page is displayed.  Did I miss a step during my very small test (which did not covered all style elements yet)? -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@maven.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org