[MNGSITE-507] Convert APT to markdown sources

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Assignee: Konrad Windszus
• Reporter: Konrad Windszus
• Created: 20/Jan/23 18:35
• Updated: 05/Nov/24 07:21

Description

With the help of doxia-converter 1.3 it is now possible to automatically convert APT sources to markdown. In order to ease contribution with the well-known markdown format we should convert all APT sources currently located in https://github.com/apache/maven-site/tree/master/content/apt to markdown with that approach.

Issue Links

• breaks: MNGSITE-509 Lifecycle intro doc links to wrong pages
• is blocked by: DOXIA-710 Inconsistent anchors between toc macro and headers
• is blocked by: DOXIA-747 MarkdownSink: Section headings must be located at the beginning of a line
• is blocked by: DOXIA-749 MarkdownSink: Block elements inside list items must be separated by blank line
• is blocked by: DOXIA-750 MarkdownSink: Definition Lists don't properly escape inline styles
• is blocked by: DOXIA-751 MarkdownSink: Put link and inline code in markup in the right order
• is blocked by: DOXIA-690 Markdown Parser: Multiline metadata incorrectly rendered
• is blocked by: DOXIA-692 Markdown Sink: Incorrect escape characters
• is blocked by: DOXIA-693 Markdown Sink: Incorrect ordered list item prefixes
• is blocked by: DOXIA-694 Markdown Sink: Too many line separators
• is blocked by: DOXIA-695 Support of h6 in xhtml output is broken
• is blocked by: DOXIA-746 MarkdownSink: Comment missing EOLs
• is blocked by: DOXIATOOLS-84 Emit Velocity statements in special Sink events which prevent wrong escaping
• is blocked by: DOXIATOOLS-89 Macros should not be resolved during conversion
• is related to: DOXIATOOLS-75 Replace extensions and keep subdirectories when converting directories
• links to: GitHub Pull Request #382
• links to: GitHub Pull Request #573