Почему моя относительная ссылка asciido c не работает вне моего микросервиса?

Question

Я начинаю создавать документацию, используя asciido c для моего проекта, который следует архитектуре микросервисов. У нас есть микросервис для документации. В своих файлах я хочу ссылку на другой документ в другом микросервисе. Я могу сделать относительную ссылку внутри моего собственного компонента, но когда я пытаюсь go выше с ../, он не работает, и ссылка ничего не делает.

Кто-нибудь может знать, почему?

Может ли это быть, потому что asciido c установлен в файле jenkins моего компонента, а не других? Или это потому, что я не правильно использую ссылку?

Я использую ее так, как описано в do c:

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

Я также пытался внешняя ссылка больше не имеет успеха.

Большое спасибо всем, кто может мне помочь

Answer 1

Макрос link: должен использоваться с URL, а не с путем к файлу. Как правило, он делает то, что вы имеете в виду. Однако безопасный режим Asciidoctor предотвращает доступ к файлам, которые находятся за пределами папки, содержащей исходный файл, указанный для преобразования.

Таким образом, если документация для других ваших микросервисов будет размещаться отдельно (например, один URL на микросервис) ), тогда вам следует обновить использование макроса link:, указав вместо этого URL-адреса.

Если вся документация вашего микросервиса должна размещаться под одним URL-адресом, укажите --safe при вызове Asciidoctor. Для получения более подробной информации см. :: https://asciidoctor.org/docs/user-manual/#running -asciidoctor-securely