slachiewicz opened a new pull request, #12682:
URL: https://github.com/apache/maven/pull/12682
Converts the 76 pages under `src/site/apt` to Markdown. APT is a format only
Doxia understands; Markdown is already supported by `maven-site-plugin` out
of
the box, so no POM change is needed.
The pages were converted with `doxia-converter` and then cleaned up by hand:
- `<<<code>>>` becomes backticks, `<<bold>>` becomes `**bold**`, and
`{{{url}text}}` becomes `[text](url)`
- the ASF licence header becomes a single block HTML comment
- a page whose only Velocity reference was `${project.name}` is now a plain
`.md` with the title spelled out
- a page that keeps a reference stays a `.vm`. Velocity reads `##` as a line
comment and would silently swallow every ATX heading below level one, so
subsections use setext underlines and anything deeper is wrapped in
`#[[ ... ]]#`
- a reference the page means to display rather than resolve is written
`${esc.d}{...}`
Verified by building the site before and after the change and comparing every
generated page. The visible text and the link targets are unchanged, apart
from `<b>`/`<i>` rendering as `<strong>`/`<em>` and quotes and ellipses in
prose picking up the Markdown module's typographic substitution.
The four modules under `its/` could not be built in my environment, so their
five pages are converted but unverified. Their `%{snippet}` macros were
checked
by hand against the originals.
Part of the wider migration tracked in
https://github.com/apache/maven-doxia-converter/issues/139
--
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]
