扩展类文档和实时模板

Question

我正在使用代码文档和实时模板，但我完全不明白。

我已阅读 Dr.Bob's article 关于生成有关实时模板的文档和 wiki 文章，但我对类描述有一个问题。

通过类描述，当我将鼠标光标指向类声明时，我了解 IDE 的行为。

例如，我有这样的类，它的描述：

type
  {$REGION 'TMyClass'}
    /// <summary>
    /// Summary works
    /// </summary>
    /// <remarks>
    /// Remarks works
    /// </remarks>
    /// <exception cref="www.some.link">This works</exception>
    /// <list type="bullet">
    /// <item>
    /// <description>description does not work</description>
    /// </item>
    /// <item>
    /// <description>description does not work</description>
    /// </item>
    /// </list>
    /// <permission cref="www.some.link">This works</permission>
    /// <example>
    /// <code>
    /// Code example does not work
    /// </code>
    /// </example>
  {$ENDREGION}
  TMyClass = class
  private
    a, b, c: Integer;
  public
  end;

后来在代码中我有这样的声明：

var
  MyObject: TMyClass;

当我将鼠标光标放在类类型上时，我有这样的描述：

正如您所见，并非每个 html 标记都由 IDE 引擎呈现。我真的很想知道如何呈现其他标签，尤其是带有代码示例的标签。有可能吗？

我正在使用 Delphi 2009 Proffesional。

Answer 1

仅支持有限的一组标签。我所知道的关于这些东西的最佳文档是 DevJET Software 的 Delphi Documentation Guidelines（在“目录”的末尾有指向 PDF 的链接）。

Answer 2

Help Insight 支持的标签在联机帮助和Delphi docwiki 中有描述。它们是 C# 的帮助标签支持的标签的子集。除了 Embarcadero 网站上列出的标签之外，似乎不支持其他标签（我已经尝试过）。其他唯一有效（并且是必需的）是“<”、“>”和“”。

更新

似乎有些产品允许您使用完整的语法，例如在@ain 链接的 Delphi 文档指南中描述。 但这需要您购买商业产品，例如 DevJet 的 Documentation Insight，不应将其与自 Delphi 2006 以来 IDE 支持的 Help Insight 混淆.

正如您所发现的，我也发现了，只有在 Delphi docwiki 中描述的子集由裸 IDE 支持，没有商业产品。建模接口也支持文档，但又有所不同。在普通的IDE中，只能使用你我已经找到的标签。