Skip to content

feelpp/asciidoctor-remote-include-processor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 Asciidoctor Remote Include Processor Extension

npm-publish npmjs version

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]

More details are available in the documentation.

Acknowledgments

and of course

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