slachiewicz opened a new pull request, #114: URL: https://github.com/apache/maven-jmod-plugin/pull/114
The site pages lost their document metadata when they were ported from APT. An APT document opens with a header block giving its title, authors and date, and `doxia-converter` turns that into YAML front matter. The port dropped the front matter along with the converter's per-line licence comments, so the generated pages lost their `<meta name="author">` and date, and took their `<title>` from the first heading instead of from the document title. Building one project's site from the APT sources and from the ported Markdown shows the difference: | | `<title>` produced | |---|---| | APT original | `Release Notes - Modello` | | ported Markdown | `Modello - Modello` | | with this change | `Release Notes - Modello` | The front matter has to come first in the file, because the Markdown parser only looks for it when the source begins with `---`; a licence header ahead of it would hide it. RAT is happy either way. Verified by building the site before and after and comparing `<title>` and the author meta tags of every generated page, and by confirming the front matter does not reach the rendered body. -- 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]
