【问题标题】:Doxygen indentation in markdown files降价文件中的 Doxygen 缩进
【发布时间】:2020-01-08 22:11:06
【问题描述】:

我正在使用 doxygen 来消耗降价文件。但是,我遇到了与缩进相关的问题。 Doxygen 似乎无法识别缩进的“>”。我也不想要 4 个空格,因为我不想要代码块。我希望高级标题下的小节只是缩进,以便观众更容易阅读和理解上下文。

是否可以在 Markdown 文件中缩进段落/行以用于 doxygen? (不制作代码块)

【问题讨论】:

  • 您使用的是哪个版本的 doxygen?您需要哪种输出格式?
  • @albert 我正在使用 doxygen v1.8.14。我正在寻找的是所选文本是缩进的。就像您在 MS Word 中为段落所做的那样。
  • @albert 好的...我看到这不是降价的基本功能。我认为这是因为我的一位观众以这种方式呈现它。基本上,如果不修改样式表,markdown 中不存在此功能。我会试试的。谢谢!!

标签: doxygen


【解决方案1】:

markdown 语法中的> 字符是为“blockquote”工具保留的(参见https://daringfireball.net/projects/markdown/syntax#blockquote)。通过 doxygen 的 HTML 输出,这是通过竖线和一些缩进显示的。 这种样式是通过 doxygen.css 定义的,可以定义自己的 (HTML_EXTRA_STYLESHEET) 样式表,例如里面的代码如下:

blockquote {
        border-left-width: 0px;
}

默认定义为:

blockquote {
        background-color: #F7F8FB;
        border-left: 2px solid #9CAFD4;
        margin: 0 24px 0 4px;
        padding: 0 12px 0 16px;
}

以类似的方式可以调整背景颜色等。

注意:这会改变你所有的引用。

【讨论】:

  • doxygen 是否在其他领域使用了块引用(例如,在提取代码和创建 html 时)?我不想破坏正常的 doxygen 生成。
  • 据我所知(以及我在代码中看到的)不,它仅用于真正的块引用
猜你喜欢
  • 2013-11-28
  • 2014-08-16
  • 1970-01-01
  • 2013-12-02
  • 1970-01-01
  • 2012-10-16
  • 2012-11-13
  • 2013-10-17
  • 2014-01-15
相关资源
最近更新 更多