来自Documenter.jl中其他子模块的交叉引用功能

时间:2017-02-22 06:55:45

标签: documentation julia cross-reference

给定类似

的模块层次结构
module A
    module B; function foo end; end
    module C
        """
            bar(x)

        Like [`foo`](@ref), but more `bar`.
        """
        function bar end
    end
end

我如何从foo的文档字符串中交叉引用bar?我尝试过A.B.fooB.foo..B.foo但没有成功。

1 个答案:

答案 0 :(得分:7)

首先,B.fooC.bar都需要(i)具有文档字符串和(ii)在降价文件中,例如在Documenter @docs block中。

```@docs
A.B.foo
A.C.bar
```

,以便在它们之间进行交叉引用。其次,绑定B.foo必须在C模块内部可见。例如,可以通过在import ..B: foo模块中添加C(或在export foo中添加Busing ..B中的C来实现。 。这是一个工作示例:

module A
    module B
        "foo function"
        function foo end
    end
    module C
        import ..B: foo
        """
            bar(x)

        Like [`foo`](@ref), but more `bar`.
        """
        function bar end
    end
end # module