1

我正在尝试使用 Intellij (2109.3.3) 为 Groovy 库创建文档，并使用 Gradle 窗口中的 groovydoc 任务进行 Gradle 构建。

库的结构如下：

在此处输入图像描述

使用的组件 (AnyGroupOfPipelineCollects) 只是一个示例，因为 {@link } 标记在我创建的任何文档中都不起作用。

课程开始如下：

package GPP_Library.functionals.composites

import GPP_Library.CompositeDetails
import GPP_Library.ResultDetails
import GPP_Library.functionals.pipelines.OnePipelineCollect
import groovy.transform.CompileStatic
import groovyJCSP.PAR
import jcsp.lang.CSProcess
import jcsp.lang.ChannelInput
import jcsp.lang.ChannelOutput

/**
 * An AnyGroupOfPipelineCollects comprises a network of {@code groups} parallel occurrences and each pipeline comprises
 * {@code stages} Worker processes, excluding the final {@link GPP_Library.terminals.Collect Collect} stage.
 * Inputs from the preceding process are assumed to come from the any end of a channel.
 * Internally, a collection of
 * {@code groups} {@link GPP_Library.functionals.pipelines.OnePipelineCollect OnePipeLineCollect} pipelines are created.
 *

执行 Gradle groovydoc 任务后，构建的文档如下：

AnyGroupOfPipelineCollects 包含一组并行发生的网络，每个管道包含阶段Worker 进程，不包括最终的 GPP_Library.terminals.Collect 阶段。假设来自上述过程的输入来自通道的任何一端。在内部，创建了一组GPP_Library.functionals.pipelines.OnePipelineCollect 管道。

可以看出，链接到 Collect 和 OnePipelineCollect 作为超文本项的预期转换并未发生，即使 {@code} 标记已被正确处理。

此外，作为链接 package.class 元素的一种类型，Intellij 会识别不正确的公式，直到它们正确为止。

我意识到库的名称不符合 Java 命名约定，因此将其更改为不同的名称，但这对生成的文档没有影响。

4

0 回答 0