You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "slachiewicz (via GitHub)" <gi...@apache.org> on 2026/08/09 15:36:52 UTC

[PR] Convert the index page from xdoc to Markdown [maven-plugin-tools]

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

   Converts `src/site/xdoc/index.xml` to Markdown with `doxia-converter`.
   
   Please **merge or rebase rather than squash** — the rename is in its own commit so `git log --follow` keeps working, and squashing collapses it back into a delete plus an add.
   
   The YAML front matter is kept and must stay the first bytes of the file: it carries the title and author, and without it the parser falls back to the first heading and `<meta name="author">` disappears.
   
   ### The SVG embed had to be put back by hand
   
   The page embeds its dependency diagram as `<object type="image/svg+xml" data="images/plugin-tools-deps.svg">`. `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
   
   Site rendered 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.
   


-- 
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]

Posted by "slachiewicz (via GitHub)" <gi...@apache.org>.
slachiewicz merged PR #1156:
URL: https://github.com/apache/maven-plugin-tools/pull/1156


-- 
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