[DOXIA-616] Markdown: Properly expose the language specified in fenced code blocks

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.8, 1.9, 1.9.1
• Fix Version/s: 1.10
• Component/s: Module - Markdown
• Assignee: Michael Osipov
• Reporter: Bertrand Martin
• Created: 26/Nov/20 18:34
• Updated: 05/Apr/21 12:32
• Resolved: 02/Jan/21 21:35

Description

Use Case

Writers can specify the language used in a fenced code block (typically for syntax highlighting), as in the example below:

```java
System.out.println("Beautiful\n");
```

Currently, the Doxia module for Markdown does not expose this information ("java") in the produced HTML, so a Maven skin (or frontend renderer) cannot leverage it.

Produced HTML:

<div class="source"> <!-- No mention of Java :-( -->
<pre>
System.out.println("Beautiful\n");
</pre>
</div>

Wanted result:

<div class="source java"> <!-- :-) -->
<pre>
System.out.println("Beautiful\n");
</pre>
</div>

Specification

Un-comment this block:
https://github.com/apache/maven-doxia/blob/c439714e8f4a9e86f9962ac6be9a0077ae9b4d30/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/FlexmarkDoxiaNodeRenderer.java#L103

This should do the trick.

Issue Links

• fixes: DOXIA-521 Markdown: Allow using the standard "<pre><code>" for code blocks
• relates to: DOXIA-521 Markdown: Allow using the standard "<pre><code>" for code blocks
• links to: GitHub Pull Request #34
• links to: GitHub Pull Request #49
• links to: GitHub Pull Request #54