[PR] Convert the index page from xdoc to Markdown (maven-plugin-tools-3.x) [maven-plugin-tools]

["slachiewicz (via GitHub)" <gi...@apache.org>]

slachiewicz opened a new pull request, #1157:
URL: https://github.com/apache/maven-plugin-tools/pull/1157

   The 3.x counterpart of #1156 — converts `src/site/xdoc/index.xml` to Markdown with `doxia-converter` on the `maven-plugin-tools-3.x` maintenance line, so the two branches keep their site documentation in the same format.
   
   Please **merge or rebase rather than squash** — the rename is in its own commit so `git log --follow` keeps working.
   
   ### The SVG embed had to be put back by hand
   
   The page embeds its dependency diagram as `<object type="image/svg+xml">`. `doxia-converter` drops it — `Unknown Sink event 'object', ignoring!` — which would remove the diagram entirely. Markdown has no equivalent, so the original `<object>` is written back as an inline HTML block; Doxia passes it through unchanged.
   
   ### Verification
   
   The site was rendered from this branch before and after and compared on title, author, visible text and link targets. The only difference is that a non-breaking space is now written `&#xa0;` where it was `&#160;` — the same character, hexadecimal rather than decimal.
   
   The YAML front matter is kept and must stay the first bytes of the file — it carries the title and author.
   


-- 
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-unsubscribe@maven.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org

Re: [PR] Convert the index page from xdoc to Markdown (maven-plugin-tools-3.x) [maven-plugin-tools]

["slachiewicz (via GitHub)" <gi...@apache.org>]

slachiewicz merged PR #1157:
URL: https://github.com/apache/maven-plugin-tools/pull/1157


-- 
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-unsubscribe@maven.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org