c++ - 在 Doxygen 中将文本映射到 HTML 实体

Question

在 Doxygen 中，要在 HTML 输出中获取版权符号，文档必须使用©，如：

/// @copyright Copyright &copy; 2012

在这种情况下，我更喜欢这样输入：

/// @copyright Copyright (c) 2012

在后一个示例中，它看起来更好一些，并且可能会更好地转换为纯文本和 RTF 输出。是否可以在 Doxygen 中创建文本到实体的映射？例如，(c)将映射到©，并且 doxygen 将简单地将所有(c)出现的地方替换为©

score 4 · Accepted Answer

一般来说，我认为输入过滤器可以更好地处理此类替换。这是一个简单的过滤器，它将替换 a(c)后跟一些数字©，然后是相同的数字：

#!/bin/perl
open(F,"<$ARGV[0]") || die("Failed to open file $ARGV[0]: $!");
while (<F>)
{
  s/\([cC]\)(\s*\d+)/&copy;\1/g;
  print $_;
}
close(F);

要使用此过滤器，请在配置文件中添加以下内容：

INPUT_FILTER = "perl filter.pl"

注 1过滤器将处理整个文件。允许仅应用于评论的过滤器可能是一个有用的功能。

注 2如果您使用支持 UTF-8 的编辑器和相应的编码 (INPUT_ENCODING)，您也可以直接插入版权字符（代码 C2 A9 hex）

1 回答 1