XSP 源中的任务标签答案

【问题标题】：Task Tags in XSP sourcesXSP 源中的任务标签
【发布时间】：2012-10-25 11:31:28
【问题描述】：

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

我也想在 SSJS 中使用它，但我无法让它工作。在 Designer 首选项 General/Editors/Structured Text Editors/Task Tags、Filters 选项卡中，您可以启用“Enable search for Task Tags”复选框和勾选 XML 类型。受影响的内容类型部分包含“xsp”，它是 XP/CC 源的文件扩展名。

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

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

【问题讨论】：

我没有得到这个问题。它适用于 XPages 或自定义控件（此处详细说明：ibm.com/developerworks/mydeveloperworks/blogs/hmedney/entry/…）
但它在 SSJS 中不起作用。是这个问题吧？
正确，可以在源码中用注释XML，SSJS里面的cmets会被忽略。我正在寻找 SSJS cmets 的解决方案。

标签： eclipse xpages

【解决方案1】：

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

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

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

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

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

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

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

以本示例代码为例，Tasks View 显示如下。

【讨论】：