slachiewicz opened a new pull request, #577:
URL: https://github.com/apache/maven-jar-plugin/pull/577
Converts the 6 page(s) 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.
This PR targets **`maven-jar-plugin-3.x`**. The master line is covered by
the sibling
PR (opened right after this one), so the conversion lands on both lines and
is not lost on the next
merge.
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.
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]
