时间戳

首页 > 解决方案 > doxygenfile 的替代方案，用于使用呼吸渲染文件描述

python-sphinx - doxygenfile 的替代方案，用于使用呼吸渲染文件描述

问题描述

我有一个使用 doxygen + 呼吸的项目设置来生成文档。我使用 doxygenfile 指令仅显示简短而详细的文件描述，如下所示：

.. doxygenfile:: DynamicArray.h
        :sections: briefdescription detaileddescription

我不想要其他部分，所以在那之后，我继续在子标题下对函数进行分组：

Lifecycle
---------
.. doxygenfunction:: DynamicArray_Create
.. doxygenfunction:: DynamicArray_CreateFromData
.. doxygenfunction:: DynamicArray_Destroy

但是，每次使用 doxygenfunction 都会导致“重复 ID”、“重复显式目标名称”和“重复 C 声明”，指向 doxygenfile 行。发生这种情况时，为函数生成的文档没有链接。删除 doxygenfile 可以解决问题。

这感觉像是一个错误，我已经创建了一个问题。但是，与此同时，是否有另一种方法来呈现不使用 doxygenfile 指令的文件描述？

标签： python-sphinxdoxygen

解决方案

推荐阅读