为什么我的 asciidoc 相对链接在我的微服务之外不起作用?



我开始在我的项目上使用 asciidoc 创建文档,该项目遵循微服务架构。 我们有一个用于文档的微服务。在其文件中,我想链接到另一个微服务中的另一个文档。 我可以在我自己的组件中做一个相对链接,但是当我尝试用../它不起作用,链接什么也不做。

有谁知道为什么?

可能是因为 asciidoc 安装在我的组件的 jenkins 文件中而不是其他文件中吗? 还是因为我没有正确使用链接?

我按照文档中的描述使用它:

link:../other_microservice/other-document.asciidoc[]

我也尝试了外部参照,但没有更多的成功。

非常感谢任何可以帮助我的人

link:

宏应该与 URL 一起使用,而不是文件路径。一般来说,它会按照你的意思去做。但是,Asciidoctor的安全模式阻止访问位于包含指定用于转换的源文件的文件夹之外的文件。

因此,如果其他微服务的文档将单独托管(例如,每个微服务一个 URL(,则应更新link:宏用法以指定 URL。

如果要将所有微服务文档托管在一个 URL 下,请在调用 Asciidoctor 时指定--safe。有关更多详细信息,请参阅:: https://asciidoctor.org/docs/user-manual/#running-asciidoctor-securely

最新更新