🚀 Asciidoctor Remote Include Processor Extension

An extension for Asciidoctor.js that allows to include remote files.

This is useful in antora.org[Antora] which does not enable this asciidoctor feature, see discussion here.

Install

Install the dependencies:

$ npm install asciidoctor.js asciidoctor-remote-include-processor

Usage

Register as an Asciidoctor extension in the Antora playbook of your website

asciidoc:
  extensions:
  - "@feelpp/asciidoctor-remote-include-extension"

Include a remote file

In an Antora adoc page, include a remote file

[source,cpp]
----
link:https://raw.githubusercontent.com/feelpp/asciidoctor-remote-include-processor/master/test/helloworld.cpp[role=include]
----

.code here
[source,cpp]

https://raw.githubusercontent.com/feelpp/feelpp/develop/feelpp/quickstart/qs_laplacian.cpp

More details are available in the documentation.

Acknowledgments

• @Djenks on Gitter Antora/users for his many suggestions and explanations

• @Mozgtter for asciidoctor-emoji which served as the template for this extension

and of course

• @mojavelinux for the awesome work he does on {antora} and {adoc}.