Revert highlight.js to 10.7 because of issue with callouts.

Add callout examples in code blocks.

Author: stefano-ottolenghi

package-lock.json

@@ -44,7 +44,7 @@
     "gulp-uglify": "~3.0",
     "gulp-vinyl-zip": "~2.2",
     "handlebars": "~4.7",
-    "highlight.js": "^11.0",
+    "highlight.js": "^10.7",
     "highlightjs-cypher": "^1.1",
     "husky": "^4.3.0",
     "js-yaml": "~3.13",

package.json

@@ -201,7 +201,37 @@ console.log('hello')
 [source,js,role=noheader]
 console.log('hello')
 
-=== Expand code block
+
+== Reference lines
+
+You can add number bubbles to reference specific lines by appending `<n>` to a line. It is advised to put them behind a line comment for the language the code is in.
+
+[source,ruby]
+----
+require 'sinatra' <1>
+
+get '/hi' do <2> <3>
+  "Hello World!"
+end
+----
+<1> Library import
+<2> URL mapping
+<3> Response block
+
+[source]
+----
+line of code // <1>
+line of code # <2>
+line of code ;; <3>
+line of code <!--4-->
+----
+<1> A callout behind a line comment for C-style languages.
+<2> A callout behind a line comment for Ruby, Python, Perl, etc.
+<3> A callout behind a line comment for Clojure.
+<4> A callout behind a line comment for XML or SGML languages like HTML.
+
+
+== Expand code block
 
 Code blocks longer than 15 lines (+5 of tolerance) are collapsed, unless you add `role=nocollapse`
 

preview-src/example.adoc

@@ -52,6 +52,45 @@
   })
   // add an alias, use properties syntax highlighter on conf
   hljs.registerLanguage('conf', require('highlight.js/lib/languages/properties'))
-  hljs.registerLanguage('graphql', require('highlight.js/lib/languages/graphql'))
+  hljs.registerLanguage('graphql', function (hljs) {
+    return {
+      aliases: ['gql'],
+      keywords: {
+        keyword:
+        'query mutation subscription|10 type interface union scalar fragment|10 enum on ...',
+        literal: 'true false null',
+      },
+      contains: [
+        hljs.HASH_COMMENT_MODE,
+        hljs.QUOTE_STRING_MODE,
+        hljs.NUMBER_MODE,
+        {
+          className: 'type',
+          begin: '[^\\w][A-Z][a-z]',
+          end: '\\W',
+          excludeEnd: true,
+        },
+        {
+          className: 'literal',
+          begin: '[^\\w][A-Z][A-Z]',
+          end: '\\W',
+          excludeEnd: true,
+        },
+        { className: 'variable', begin: '\\$', end: '\\W', excludeEnd: true },
+        {
+          className: 'keyword',
+          begin: '[.]{2}',
+          end: '\\.',
+        },
+        {
+          className: 'meta',
+          begin: '@',
+          end: '\\W',
+          excludeEnd: true,
+        },
+      ],
+      illegal: /([;<']|BEGIN)/,
+    }
+  })
   hljs.highlightAll()
 })()