Add support for code blocks in other languages #16
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
It has been some time since this repository has been active, so I apologize if this PR is unwanted, but the tool is still highly useful for myself.
The
<code>tag in XML comments supports alanguageattribute to specify the language of the code in the block. DocFx's XML parser will pick this up and use it to produce the correct HTML markup.Ex:
Produces:
This PR corrects the behavior of DocFxMarkdownGen to match code blocks and not assume csharp for the lang.
Currently, DocFX doesn't properly handle replacing HTML entities with their raw character counterparts in code blocks (at least not in the metadata step) and Docusaurus will not fix this automatically inside code blocks. I think that it would be nice for dfmg to provide an option to replace HTML entities in codeblocks with their literal representations, but I think that deserves its own PR.