简体   繁体   English

doxygen markdown文件中的fortran代码块中的doxygen注释未打印

[英]doxygen comment in fortran codeblock in doxygen markdown file not printed

I'm writing a markdown file with some code examples. 我正在用一些代码示例编写markdown文件。 In one example I want to show how to comment the code using doxygen comments: 在一个示例中,我想展示如何使用doxygen注释来注释代码:

Here is normal text.

~~~.f90
!> Here is a doxygen comment in a fortran code example
!! that should be visible in the doxygen output
Here comes some more code
~~~

The code is printed nicely, but the comment is not shown in the output. 该代码可以很好地打印,但是注释不会显示在输出中。 Instead there is just a blank line. 相反,只有空白行。 When I change the example to use the code block markup indicated by four leading spaces, the code highlight get's lost. 当我更改示例以使用由四个前导空格指示的代码块标记时,代码突出显示get丢失了。 I guess that is because the code isn't marked as fortran. 我猜这是因为代码没有标记为fortran。

So the questions are: 所以问题是:

  • How to get the comment visible when using the fenced code region. 使用围栏代码区域时如何使注释可见。

or 要么

  • How to get the code formatted as fortran code when using the leading space code region indication. 使用前导空格代码区域指示时,如何获取格式化为fortran代码的代码。

As albert does not want to answer my question, I'll do on his behalf: 由于阿尔伯特不想回答我的问题,我将代表他做:

The !> and !! !>和!! are seen as normal comment signs (no special processing). 被视为正常的注释符号(无需特殊处理)。 By means of setting STRIP_CODE_COMMENTS to NO you can get this information. 通过将STRIP_CODE_COMMENTS设置为NO,您可以获得此信息。

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM