syntax-highlighting - doxygen markdown 防止在受保护的代码块中突出显示语法

Question

我希望在没有任何语法突出显示的情况下出现一个受保护的代码块。对于以下代码：

~~~
Behold this, for this is an orange.
~~~

我得到for和this颜色。注意我没有指定文件扩展名。我需要指定特定的扩展名吗？我试过了{.txt}，但这没有帮助。

Answer 1

您在这里有几个选择。

• 可以使用 <pre> </pre> 块。里面的任何东西都会像控制台一样以等宽字体显示。

• 您可以使用 <blockquote> </blockquote> 缩进并在左侧放置一条垂直的蓝线。
  • 或者，您可以使用降价并放置一个“>”，然后在要显示为输出的文本之前放置一个空格。

Answer 2

Doxygen 将基于显式语言{.cpp}（如果无法识别该语言，它似乎假定 C/C++ 语法高亮规则。

不幸的是，这意味着代码将根据 Doxygen 支持的一种语言进行格式化，并且没有办法让它在没有语法突出显示的情况下显示受保护的代码块。

Answer 3

使用当前版本的 doxygen（我使用 1.8.13）使用~~~-syntax没有语言规范会产生一个没有语法突出显示的代码块。通用语言规范是

• ~~~{.cpp}(C++)
• ~~~{.c}（C）
• ~~~{.py}（Python）

Answer 4

您可以尝试模仿 doxygen 使用的样式，方法如下：

/**
 * <div class="fragment">
 * <div class="line">Behold this, for this is an orange.</div>
 * <div class="line">General use:</div>
 * <div class="line">   ./SLAM_plus_plus -i <filename> --no-detailed-timing</div>
 * <div class="line"></div>
 * <div class="line">To run the pose-only datasets more quickly:</div>
 * <div class="line">   ./SLAM_plus_plus -i <filename> --pose-only --no-detailed-timing</div>
 * <div class="line"></div>
 * <div class="line">To run incrementally:</div>
 * <div class="line">   ./SLAM_plus_plus -nsp <optimize-each-N-verts> -fL -i <filename> --no-detailed-timing</div>
 * </div>
 */

虽然有点复杂（每行文本都需要被自己的 包围<div>），但它会为您提供所需的内容，而不会突出显示。您可能希望使用\htmlonly并避免空格浓缩来包围此块（否则，多个制表符/空格的序列将被 Doxygen\endhtmlonly替换为单个空格- 调整 css 将无济于事）。

{.f}或者，您可以使用一些更晦涩的语言，例如{.vhdl}Doxygen 知道但在您的文本中没有过多出现关键字的语言。