eclipse - XSP 源中的任务标签

Question

在 Java 源代码中，可以使用(默认情况下)//TODO、//FIXME 和//XXX 注释将源代码的该部分添加到 Eclipse/Domino Designer 中的“任务” View 中。

我也想在 SSJS 中使用它，但我无法让它工作。在设计器首选项常规/编辑器/结构化文本编辑器/任务标签、过滤器选项卡中，您可以启用“启用任务标签搜索”复选框，然后勾选 XML 类型。受影响的内容类型部分包含“xsp”，即 XP/CC 源的文件扩展名。

但是 SSJS 源中的任何标记(实际上是 XML 标记的属性)不会出现在“任务” View 中。

如何将这样的任务标签写入XP/CC源代码以使其工作？

Answer 1

在 Domino Designer 中，大多数编辑器都可以通过首选项启用搜索任务标签。
即(常规 -> 编辑器 -> 结构化文本编辑器 -> 任务标签)

但是，由于任务标记被添加到 CDATA 部分，因此会出现报告的行为。

CDATA 部分基本上是 XML 的狂野西部。

有关引用，请参阅http://www.w3.org/TR/REC-xml/#sec-cdata-sect具体来说:

"在 CDATA 节中，只有 ]]> 字符串被识别为标记，因此左尖括号和 & 符号可能以其文字形式出现；它们不需要(也不能)使用 < 进行转义。和 & ”

因此，由于这个原因，CDATA 节的内容通常会被 Eclipse XML 解析和验证忽略。所以如果 <!-- TODO -->或//TODO (或任何标签)被放入 CDATA 部分，但不会被如此拾取。

因此，XSP 源中任何带注释的服务器端 JavaScript 都不会出现在任务 View 中。

以此示例代码为例，任务 View 显示如下。