3

在 Java 源代码中,可以使用(默认情况下)//TODO、//FIXME 和//XXX 注释将该部分源代码添加到 Eclipse/Domino Designer 中的 Tasks 视图中。

我也想在 SSJS 中使用它,但我不能让它工作。在 Designer 首选项General/Editors/Structured Text Editors/Task TagsFilters选项卡中,您可以启用“启用搜索任务标签”复选框并勾选 XML 类型。受影响的内容类型部分包含“xsp”,它是 XP/CC 源的文件扩展名。

但是 SSJS 源代码中的任何标记(实际上是 XML 标记的属性)都不会出现在 Tasks 视图中。

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

4

1 回答 1

2

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

但是,报告的行为发生是因为任务标记添加到 CDATA 部分。

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

有关参考,请参阅http://www.w3.org/TR/REC-xml/#sec-cdata-sect具体:

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

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

因此,XSP 源代码中的任何带注释的服务器端 JavaScript 都不会出现在任务视图中。

以该示例代码为例,Tasks View 显示如下。

XPages 源视图中的示例 XSP 代码说明了任务标记的使用 来自 Domino Designer 的任务视图中的示例 XSP 代码的任务标记

于 2013-03-14T18:04:38.360 回答