fix(highlighting): drop prism

unify on highlight.js for docs, fundocs, and inline md

Author: duncdrum

gulpfile.js

@@ -31,15 +31,14 @@ const paths = {
       "src/main/xar-resources/resources/scripts/*",
       "node_modules/bootstrap/dist/js/bootstrap.min.*",
       "node_modules/jquery/dist/jquery.min.*",
-      "node_modules/prismjs/prism.js",
-      "node_modules/prismjs/components/prism-xquery.min.js",
-      "node_modules/prismjs/components/prism-java.min.js",
+      "node_modules/@highlightjs/cdn-assets/highlight.min.js", 
+      "node_modules/@highlightjs/cdn-assets/languages/xquery.min.js",
       "node_modules/zero-md/dist/index.min.js"
     ],
     styles: [
       "src/main/xar-resources/resources/css/*",
       "node_modules/bootstrap/dist/css/bootstrap.min.*",
-      // 'node_modules/prismjs/themes/*.css'
+      "node_modules/@highlightjs/cdn-assets/styles/atom-one-dark.min.css"
     ],
     fonts: ["node_modules/bootstrap/dist/fonts/*"],
   },

package-lock.json

@@ -25,9 +25,9 @@
   },
   "homepage": "https://github.com/eXist-db/function-documentation#readme",
   "dependencies": {
+    "@highlightjs/cdn-assets": "^11.11.1",
     "bootstrap": "^3.4.1",
     "jquery": "^1.12.4",
-    "prismjs": "^1.23.0",
     "zero-md": "^3.1.6"
   },
   "devDependencies": {

package.json

@@ -279,7 +279,8 @@ declare %private
 function app:include-markdown ($path as xs:string) as element(zero-md) {
     <zero-md src="{ $path }">
         <template>
-            <link rel="stylesheet" href="resources/css/exist.css" />
+            <link rel="stylesheet" type="text/css" href="resources/css/exist.css" />
+            <link rel="stylesheet" type="text/css" href="resources/css/atom-one-dark.min.css" />
         </template>
     </zero-md>
 };

src/main/xar-resources/modules/app.xql

@@ -16,9 +16,7 @@ $(document).on("ready", function() {
             success: function (data) {
                 $("#results").fadeOut(100, function() {
                     $(this).html(data);
-                    $(this).fadeIn(100, function() {
-                        Prism.highlightAll()
-                    });
+                    $(this).fadeIn(100);
                     timeout = null;
                 });
             }

src/main/xar-resources/resources/css/prism-fundocs.css

@@ -6,7 +6,7 @@
         <link rel="shortcut icon" href="resources/images/exist_icon_16x16.ico"/>
 
         <link rel="stylesheet" type="text/css" href="resources/css/bootstrap.min.css"/>
-        <link rel="stylesheet" type="text/css" href="resources/css/prism-fundocs.css"/>
+        <link rel="stylesheet" type="text/css" href="resources/css/atom-one-dark.min.css"/>
         <link rel="stylesheet" type="text/css" href="resources/css/exist.css"/>
         <link rel="stylesheet" type="text/css" href="resources/css/fundocs.css"/>
         <script type="module" src="resources/scripts/index.min.js?register"/>
@@ -211,11 +211,11 @@ <h3>Login</h3>
                 </div>
             </div>
         </div>
-        <script type="text/javascript" src="resources/scripts/jquery.min.js"></script>
-        <script type="text/javascript" src="resources/scripts/bootstrap.min.js"></script>
-        <script type="text/javascript" src="resources/scripts/prism.js"></script>
-        <script type="text/javascript" src="resources/scripts/prism-java.min.js"></script>
-        <script type="text/javascript" src="resources/scripts/prism-xquery.min.js"></script>
-        <script type="text/javascript" src="resources/scripts/query.js"></script>
+        <script type="text/javascript" src="resources/scripts/jquery.min.js"/>
+        <script type="text/javascript" src="resources/scripts/bootstrap.min.js"/>
+        <script type="text/javascript" src="resources/scripts/highlight.min.js"/>
+        <script type="text/javascript" src="resources/scripts/xquery.min.js" />
+        <script type="text/javascript" src="resources/scripts/query.js"/>
+        <script type="text/javascript">hljs.highlightAll();</script>
     </body>
 </html>

src/main/xar-resources/resources/scripts/query.js

@@ -14,15 +14,20 @@ context('Function Documentation', () => {
   })
 
   describe('simple search', () => {
-    it('should find article with extended markdown contents', () => {
+    it('should find article with extended markdown contents and code highlighting', () => {
       cy.get('#query-field')
         .type('file:sync')
       cy.get('.function-head > h4')
         .should('exist')
         .click()
+      // code is highlighted 
+      cy.get('.language-xquery')
+        .should('exist')
+      // button is visible
       cy.get('.extended-docs')
         .should('exist')
         .click()
+      // displays MD 
       cy.get('zero-md')
         .should('exist')
     })