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.
   
   
![image](https://github.com/user-attachments/assets/4849a896-df3e-4f29-8cb9-6dd6999781a8)
   
   
   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.
   
   
![image](https://github.com/user-attachments/assets/da4e011e-2b0a-4842-827f-32a8283d45d8)
   
   
   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

Reply via email to