slachiewicz opened a new pull request, #669: URL: https://github.com/apache/maven-doxia-sitetools/pull/669
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 image map had to be put back by hand The page's dependency diagram is an image map — 8 `<area>` elements making each module clickable. `doxia-converter` drops it, saying so only in a warning that is easy to miss: ``` WARN MarkdownSink - Unknown Sink event 'map', ignoring! ``` That would leave a plain picture with every link gone, invisible in the Markdown and findable only by comparing the generated HTML. The `<img usemap>` and its `<map>` are written back as an inline HTML block, which Doxia passes through unchanged. ### Verification Site rendered before and after and compared on title, author, visible text and link targets: **identical**, including all 8 map areas. -- 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]
