chore(docs): revise documentation and add Highlight.js extension (#1744)

Co-authored-by: Guillaume Grossetie <[email protected]>
Co-authored-by: Guillaume Grossetie <[email protected]>

Author: vvavrychuk

docs/antora.yml

@@ -3,7 +3,7 @@ title: Asciidoctor.js
 version: '3.0'
 asciidoc:
   attributes:
-    url-jsdoc-latest: 'http://asciidoctor.github.io/asciidoctor.js/main'
+    url-jsdoc-latest: 'https://asciidoctor.github.io/asciidoctor.js/main/'
 nav:
 - modules/setup/nav.adoc
 - modules/processor/nav.adoc

docs/modules/extend/pages/extensions/ecosystem.adoc

@@ -18,6 +18,7 @@
 :uri-ext-mathjax-gl: https://gitlab.com/djencks/asciidoctor-mathjax.js
 :uri-ext-openblock-gl: https://gitlab.com/djencks/asciidoctor-openblock
 :uri-ext-template-gl: https://gitlab.com/djencks/asciidoctor-template
+:uri-ext-highlight-gh: https://github.com/jirutka/asciidoctor-highlight.js
 
 Here's a list of extensions provided by the awesome community:
 
@@ -41,6 +42,10 @@ Emoji::
 Inline macro to render `emoji:heart[]` as an `<img>` that points to a remote SVG using {uri-twemoji}[Twemoji from Twitter]. +
 {uri-ext-emoji-gh}
 
+Highlight.js::
+Highlighting source listing blocks using https://highlightjs.org[highlight.js] during document conversion (instead of in browser as the built-in highlight.js support). +
+{uri-ext-highlight-gh}
+
 Interactive runner::
 Transform AsciiDoc code listings into interactive playgrounds which run in the browser.
 Add the `%interactive` option to your `[source]` block. +

docs/modules/setup/pages/quick-tour.adoc

@@ -37,7 +37,7 @@ Alternatively, you can use the function `convertFile` to convert a file containi
 var doc = asciidoctor.convertFile('/path/to/file.adoc') // <1>
 ```
 <1> The command will output to the file `file.html` in the same directory. +
-The variable `doc` will contain an {uri-js-api-doc}/#document[Asciidoctor.Document] object.
+The variable `doc` will contain an {url-jsdoc-latest}/#document[Asciidoctor.Document] object.
 
 Alternatively, you can capture the HTML 5 output in a variable instead of writing it to a file:
 
@@ -60,7 +60,7 @@ var html = asciidoctor.convert(fs.readFileSync('/path/to/file.adoc')) // <1>
 
 == Load and convert
 
-To parse an AsciiDoc file into an {uri-js-api-doc}/#document[Asciidoctor.Document] object:
+To parse an AsciiDoc file into an {url-jsdoc-latest}/#document[Asciidoctor.Document] object:
 
 ```js
 var doc = asciidoctor.loadFile('file.adoc')
@@ -74,7 +74,7 @@ console.log(doc.getAttributes())
 ```
 
 More than likely, you will want to convert the document.
-To convert an {uri-js-api-doc}/#document[Asciidoctor.Document] to HTML5, use the `convert` function on a `Document`:
+To convert an {url-jsdoc-latest}/#document[Asciidoctor.Document] to HTML5, use the `convert` function on a `Document`:
 
 ```js
 var doc = asciidoctor.loadFile('file.adoc')