Включить файл docx в asciidoc?

Question

Я использую asciidoc с asciidoctor для создания документации для текущего проекта.

Я заметил, есть разметка для включения файлов в документации, как так:

link:index.html или link:protocol.json[Open the JSON file]

Можно ли включать DOCX файл как ссылку так, чтобы она откроет извне или быть в состоянии загрузить? Также я могу поместить этот файл в папку внутри моего каталога asciidoc (ради организации) и все еще иметь возможность правильно ссылаться на него?

Answer 1

Вы пишете что-то вроде этого:

Open this link:somefile.docx[Word file] should work. 

Or this link:file:///C:/Users/xxx/docs/otherfile.docx[second file]. 

Он работает с относительным или абсолютным путем.

Необходимо гарантировать, что путь к вашему файлу будет правильным для чтения вашего документа.

Пример: если вы помещаете файлы HTML, созданные Asciidoctor на веб-сервер (общедоступный или интранет), наличие пути, ссылающегося на ваш локальный C:, не является хорошей идеей.

Трудно сказать вам, что делать без знания вашей цепочки публикации/распространения.