XSP源中的任务标记

Question

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

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

但SSJS源代码中的任何标记（实际上是XML标记的属性）都不会出现在“任务”视图中。

如何将此类任务标记写入XP / CC源以使其正常工作？

Answer 1

在Domino Designer中，可以通过首选项为大多数编辑器启用搜索任务标记 即（一般 - ＆gt;编辑 - ＆gt;结构化文本编辑器 - ＆gt;任务标签）

但是，报告的行为是因为任务标记被添加到CDATA部分。

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

供参考，具体见http://www.w3.org/TR/REC-xml/#sec-cdata-sect：

“在CDATA部分中，只有]]>字符串被识别为标记，因此左尖括号和＆符号可能以字面形式出现;它们不需要（也不能）使用{转义{1}}和< “

因此，出于这个原因，Eclipse XML解析和验证通常会忽略CDATA部分的内容。因此，如果将&或<!-- TODO -->（或任何标记）放入CDATA部分，则不会将其选中。

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

使用此示例代码作为示例，“任务视图”显示如下。