add antora doc + workflow to deploy site

Author: prudhomm

.github/workflows/main.yml

@@ -0,0 +1,34 @@
+# This is a basic workflow to help you get started with Actions
+
+name: Build and Deploy
+
+# Controls when the action will run. Triggers the workflow on push or pull request
+# events but only for the master branch
+on:
+  push:
+    branches: [ master ]
+
+# A workflow run is made up of one or more jobs that can run sequentially or in parallel
+jobs:
+  # This workflow contains a single job called "build"
+  build:
+    # The type of runner that the job will run on
+    runs-on: ubuntu-latest
+
+    # Steps represent a sequence of tasks that will be executed as part of the job
+    steps:
+    # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+    - uses: actions/checkout@v2.3.1
+    - name: Install 
+      run: npm install
+      working-directory: docs
+    - name: Build
+      run: npm run build 
+      working-directory: docs
+    - name: Deploy
+      uses: JamesIves/github-pages-deploy-action@3.5.9
+      with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          BRANCH: gh-pages # The branch the action should deploy to.
+          FOLDER: build/site # The folder the action should deploy.
+      working-directory: docs

.gitignore

@@ -1,3 +1,4 @@
-/node_modules/
+/**/node_modules/
+/**/build/
 /dist/
 /bin/

README.adoc

@@ -2,3 +2,10 @@
 
 Remote include processor extension for asciidoctor
 
+----
+.code here
+[source,cpp]
+----
+include::https://raw.githubusercontent.com/feelpp/feelpp/develop/feelpp/quickstart/qs_laplacian.cpp[tag=env]
+----
+----

docs/antora.yml

@@ -0,0 +1,6 @@
+name: adoc-rip
+title: Asciidoctor Remote Include Processor
+version: latest
+nav:
+- modules/ROOT/nav.adoc
+

docs/modules/ROOT/nav.adoc

@@ -0,0 +1 @@
+* xref::index.adoc[Asciidoctor Remote Include Processor]

docs/modules/ROOT/pages/index.adoc

@@ -0,0 +1,43 @@
+= Asciidoctor Remote Include Processor Extension
+:stem: latexmath
+:uri-asciidoctorjs: https://github.com/asciidoctor/asciidoctor.js
+:uri-antora: https://docs.antora.org
+:antora: {uri-antora}[Antora]
+
+An extension for {uri-asciidoctorjs}[Asciidoctor.js] that allows to include remote files in {antora}.
+
+This is useful in {antora} which does not enable this asciidoctor feature, see discussion https://gitlab.com/antora/antora/-/issues/246[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
+
+[source,yaml]
+----
+asciidoc:
+  extensions:
+  - "@feelpp/asciidoctor-remote-include-extension"
+----
+
+=== Include a remote file
+
+In an Antora adoc page, include a remote file
+
+```adoc
+[source,cpp]
+----
+include::https://raw.githubusercontent.com/feelpp/asciidoctor-remote-include-processor/master/test/helloworld.cpp[]
+----
+```
+which gives:
+
+[source,cpp]
+----
+include::https://raw.githubusercontent.com/feelpp/asciidoctor-remote-include-processor/master/test/helloworld.cpp[]
+----