使用 Doxygen 将数学公式记录为 Python 代码中的注释

Question

我的问题是这个问题的扩展，我想要的是 Doxygen 输出我的 python 源代码的同一注释行中的数学公式和文本。让我们看下面的例子：# Create homogeneous probability matrix from the colors matrixdef create_probability_map(colors_map):    """!\f$(x_1,y_1)\f$"""    pass当我运行上面的代码时，Doxygen 会按预期输出正确的数学公式。但是，如果我在数学公式之前添加一些文本：# Create homogeneous probability matrix from the colors matrixdef create_probability_map(colors_map):    """Formula is: !\f$(x_1,y_1)\f$"""    pass输出不如预期。有谁知道如何解决这一问题？在尝试其他几种组合时，我发现如果文本在数学公式之后，Doxygen 会输出正确的注释，如下所示：# Create homogeneous probability matrix from the colors matrixdef create_probability_map(colors_map):    """!\f$(x_1,y_1)\f$ is the formula"""    passPS：我还发现奇怪的是，据说 Doxygen 无法在 Python 上处理数学公式，如文档中所述（特别是在此处）。文档是否过时？

Answer 1

我尝试使用 doxygen 1.8.18 以下代码：

## \file

# Create homogeneous probability matrix from the colors matrix

def create_probability_map1(colors_map):

    """!\f$(x_1,y_1)\f$"""

    pass

# Create homogeneous probability matrix from the colors matrix

def create_probability_map2(colors_map):

    """Formula is: !\f$(x_2,y_2)\f$"""

    pass

# Create homogeneous probability matrix from the colors matrix

def create_probability_map3(colors_map):

    """!\f$(x_3,y_3)\f$ is the formula"""

    pass

# Create homogeneous probability matrix from the colors matrix

def create_probability_map4(colors_map):

    """!Formula is: \f$(x_4,y_4)\f$ is the formula"""

    pass

使用默认的 doxygen 配置设置，这将导致：

对我来说，这看起来一切正常，文档字符串"""!被视为 doxygen 注释，而只是"""被视为逐字/代码（如问题中提到的链接中所示）。