slachiewicz opened a new pull request, #1768:
URL: https://github.com/apache/maven-site/pull/1768

   Gives the 107 Markdown code blocks that were opened with ```` ```unknown 
```` their real language, and fixes what turned up in those snippets on the 
Doxia and plugin guide pages. The two commits are meant to be read separately.
   
   1. **Languages** (mechanical): only fence lines change. POM, settings and 
xdoc samples are `xml`, Java snippets `java`; APT markup, Doxia macro syntax 
and program output are `text`, since highlight.js has no grammar for them. One 
block stays ```` ```unknown ````: in `doxia/migrating-apt-to-markdown.md` it is 
a literal sample of the converter's output.
   2. **Content**: snippets and statements that no longer match Doxia 2, 
checked against the maven-doxia sources: class names (`Xhtml5BaseParser`, 
`Xhtml5BaseSink`, `ParserModule`, `SinkAdapter`'s package), `implements 
SinkFactory`, `rawText`, the XDoc TOC example that contradicted its APT twin, 
the site descriptor template now on the SITE 2.1.0 model, three broken or dead 
links, maven-jxr-plugin 3.6.0, and APT conversion leftovers (a garbled table 
cell, literal backslashes and `'` quotes).
   
   Not in this PR: the Plexus to JSR-330 rewrite of the Doxia developer pages 
(`@Component`, `lookup( ...ROLE... )`), and which Maven 3.9.x or 3.10 the 
plugin guides pin.
   
   Part of #1766.
   
   Verified: `mvn site` builds; every link this PR adds or changes answers 200 
from the page's location on maven.apache.org.
   
   ---
   
   To make clear that you license your contribution under
   the [Apache License Version 2.0, January 
2004](https://www.apache.org/licenses/LICENSE-2.0)
   check one of the following:
   
   - [ ] I hereby declare this contribution to be licensed under the [Apache 
License Version 2.0, January 2004](https://www.apache.org/licenses/LICENSE-2.0)
   - [x] I hereby declare that I have filed an [Apache Individual Contributor 
License Agreement](https://www.apache.org/licenses/icla.pdf).
   


-- 
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: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to