Question

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

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

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

Answer 1

Doxygen将语法突出显示应用于基于显式语言（{.cpp}）或隐式语言（当前正在解析的代码的语言）的受防护代码块。如果语言无法识别，它似乎假设C / C ++语法高亮规则。

不幸的是，这意味着代码将根据Doxygen支持的其中一种语言进行格式化，并且没有办法在没有语法高亮的情况下欺骗它显示受防护的代码块。

Answer 2

你有几个选择。

可以使用＆lt; pre＆gt; ＆LT; /预＆GT;块。内部的内容将以控制台等等宽字体显示。
您可以使用＆lt; blockquote＆gt; ＆LT; / BLOCKQUOTE＆GT;它会缩进并在左侧放置一条垂直的蓝线。
- 您也可以使用降价并放置'＆gt;'然后在要显示为输出的文本之前的空格。

Answer 3

您可以尝试模仿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和\endhtmlonly来覆盖此块以避免空白缩合（否则多个制表符/空格的序列被单个空格替换为Doxygen - 调整css将没有帮助）。

或者，您可以使用一些更加模糊的语言，例如Doxygen知道的{.f}或{.vhdl}，但文本中没有关键字。

doxygen markdown可防止在受防护的代码块中进行语法突出显示

3 个答案: