I looked at the Doxygen code and discovered that a fenced code block in a
Markdown file is converted to @code … @endcode block before further processing.
I have also discovered that @code{.unparsed} in a .cpp file results in the same
“hljs” syntax highlighting. Is this a bug in doxygen or something undocumented?
The documentation quite clearly states
"If the contents of the code block are in a language that doxygen cannot parse,
doxygen will just show the output as-is. You can make this explicit using
.unparsed, or by giving some other extension that doxygen doesn't support, e.g.
\code{.unparsed}
Show this as-is please
\endcode
“
Regards
-Mark
> On Jul 20, 2020, at 14:30, Mark <[email protected]> wrote:
>
> No, sadly that doesn’t work either. Nor does ```unparsed.
>
> doxygen seems to think these blocks are some language called hljs. This is
> the HTML for the example I gave below:
>
> code class="fragment <>"><span class="hljs-selector-tag <>">Support</span>
> 16<span class="hljs-selector-tag <>">-bit</span> <span
> class="hljs-selector-tag <>">and</span> <span class="hljs-selector-tag
> <>">paletted</span> <span class="hljs-selector-tag <>">images</span>.
> <span class="hljs-selector-tag <>">Fixes</span> <span class="hljs-selector-id
> <>">#252</span>. <span class="hljs-selector-tag <>">Fixes</span> <span
> class="hljs-selector-id <>">#253</span>. <span class="hljs-selector-tag
> <>">Fixes</span> <span class="hljs-selector-id <>">#255</span>.
> </code></pre></div>
> Regards
>
> -Mark
>
>> On Jul 20, 2020, at 14:08, Travis Everett <[email protected]
>> <mailto:[email protected]>> wrote:
>>
>> Drat. I know that works for some other markdown-based systems I use.
>>
>> I found a mention in the docs for the \code command
>> (https://www.doxygen.nl/manual/commands.html#cmdcode
>> <https://www.doxygen.nl/manual/commands.html#cmdcode>) that mention using
>> `{.unparsed}` to explicitly specify blocks like this. If the Markdown
>> equivalent is flowing through the same code site, perhaps that'll work?
>>
>> On Mon, Jul 20, 2020 at 3:55 PM Mark <[email protected]
>> <mailto:[email protected]>> wrote:
>>
>> Thanks for the suggestion. No it does not. I tried ```plain, ```.plain
>> ```{plain} and ```{.plain}. None had any effect.
>>
>> I’ve also discovered that \verbatim is doing the same highlighting.
>>
>> For example the text
>>
>> Support 16-bit and paletted images
>> .
>>
>> Fixes #252. Fixes #253. Fixes #255.
>>
>> is rendered with everything but “16” in boldface and the numbers after Fixes
>> rendered in red.
>>
>> Regards
>>
>> -Mark
>>
>>
>>> On Jul 20, 2020, at 13:27, Travis Everett <[email protected]
>>> <mailto:[email protected]>> wrote:
>>>
>>> Does `plain` work?
>>>
>>> On Mon, Jul 20, 2020 at 3:04 PM Mark <[email protected]
>>> <mailto:[email protected]>> wrote:
>>> I have a fenced code block
>>>
>>> ```
>>> Text that is not code
>>> ```
>>>
>>> and it is being highlighted. How can I prevent that? I tried ```text and
>>> ```plaintext, ```{.text} and ```{.txt} but none made any difference.
>>>
>>> Regards
>>>
>>> -Mark
>>>
>>> _______________________________________________
>>> Doxygen-users mailing list
>>> [email protected]
>>> <mailto:[email protected]>
>>> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>>> <https://lists.sourceforge.net/lists/listinfo/doxygen-users>
>>
>
_______________________________________________
Doxygen-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/doxygen-users
