Doxygen @file是否适用于降价文件？ [英] Does Doxygen @file work in markdown files?

问题描述

在我正在处理的 .md 文件中，我有一个混合使用markdown和 @file 的问题与Doxygen 1.8.5。

I have a problem with a mix of markdown and @file in my .md files that I am processing with Doxygen 1.8.5.

如果我使用：

# Release Notes

@file releases.md
Release notes

@tableofcontents

@section rel_page Release History

Blah blah blah

除了第一个＃ line）。为了完整起见，这种情况发生在或者不存在'releases.md'文件名（根据手册是可选的）。

I get nothing other than the page title (resulting from the first # line) in the HTML. For completeness, this happens with or without the 'releases.md' filename being present (it's optional according to the manual).

但是，如果我删除 @file line ...

However, if I remove the @file line...

# Release Notes

@tableofcontents

@section rel_page Release History

Blah blah blah

这一切都很完美。

我有错误的语法，是不是作为Doxygen的降价支持一部分的@file不支持，还是这个错误？

Have I got the syntax wrong, is @file not supported as part of Doxygen's markdown support, or is this a bug?

Doxygen手册中没有任何关于任何约束的 @file 或markdown部分。

There's nothing in the Doxygen manual in either the @file or markdown sections about any constraints.

与我的其他（风滚草）有一些相似之处关于降价和群组的问题。

There's some similarity with my other (tumbleweed) question about markdown and groups.

推荐答案

结构指示符不适用于降价。您可以使用 @file 的效果如下：

The commands listed in the section structural indicators in the manual do not work with markdown. You can get the effect of using @file as follows:

Release notes {#releases}
=============

@tableofcontents

@section rel_page Release History

Blah blah blah

这篇关于Doxygen @file是否适用于降价文件？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！