Merge branch 'main' of https://github.com/CortexIntelligentAutomation/docs into feature/hide-unsupported-version

Author: Donna-Marie Smith

.github/workflows/checklink.yml

@@ -36,7 +36,10 @@ jobs:
           # For maximum backward compatibility with Hugo modules
           HUGO_ENVIRONMENT: production
           HUGO_ENV: production
-        run: hugo --environment GitHubPages -d $GITHUB_WORKSPACE/dist
+        run: hugo --environment GitHubPages -d $GITHUB_WORKSPACE/dist --buildFuture
+      - name: Generate Search index
+        run: |
+          node ./assets/js/generate-lunr-index.js $GITHUB_WORKSPACE/dist
       - name: Test HTML
         uses: wjdp/htmltest-action@master
         with:

.github/workflows/hugo.yml

@@ -63,6 +63,9 @@ jobs:
           HUGO_ENV: production
         run: |
           hugo --environment GitHubPages
+      - name: Generate Search index
+        run: |
+          node ./assets/js/generate-lunr-index.js
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:

.gitignore

@@ -1,4 +1,5 @@
-
+docs/
+!docs/CNAME
 public/
 resources/
 node_modules/
@@ -7,4 +8,5 @@ content/en/docs/latest/
 content/static/latest/
 content/static/**/*.dtmp
 content/static/**/*.bkp
-content/static/**/*.crswap
+content/static/**/*.crswap
+content/static/lunr-index.json

.htmltest.yml

@@ -26,7 +26,8 @@ IgnoreURLs:
 - "https://jsonformatter.org/.*"
 - "https://www.newtonsoft.com/.*"
 - "https://.*.gov.uk/.*"
-
+- "https://www.elastic.co/.*"
+- "https://www.connectionstrings.com/.*"
 IgnoreDirs:
 - "docs/?.*/_print/"
 - "docs/?.*/_shared/"

assets/js/generate-lunr-index.js

@@ -0,0 +1,54 @@
+const fs = require('fs');
+const lunr = require('lunr');
+
+/**
+ * This script is used to generate a lunr index from the offline-search-index.json file.
+ * Hugo must be built before running this script, as jt requires the offline-search-index.json file to have been generated.
+ * 
+ * The script will output a lunr-index.json file in the content/static directory and the docs directory.
+ */
+
+const args = process.argv.slice(2);
+
+// Arguments should only be provided from a pipeline build.
+const isFromPipeline = args[0] !== undefined;
+
+const source = isFromPipeline
+    ? args[0]
+    : "./docs";
+
+const destination = isFromPipeline
+    ? `${args[0]}`
+    : "./docs";
+
+const data = JSON.parse(fs.readFileSync(`${source}/offline-search-index.json`));
+
+const idx = lunr(function () {
+    this.ref('ref');
+    this.field('title', { boost: 5 });
+    this.field('categories', { boost: 3 });
+    this.field('tags', { boost: 3 });
+    this.field('description', { boost: 2 });
+    this.field('body');
+
+    data.forEach((doc) => {
+        if (doc
+            && doc.ref !== undefined
+            && !doc.ref.includes('/_shared/')
+        ) {
+            this.add(doc);
+        }
+    });
+});
+
+if (!isFromPipeline) {
+    fs.writeFileSync(`./content/static/lunr-index.json`, JSON.stringify(idx));
+}
+
+fs.writeFileSync(`${destination}/lunr-index.json`, JSON.stringify(idx));
+
+// check if file got created
+if (!fs.existsSync(`${destination}/lunr-index.json`)) {
+    console.error('Failed to create lunr index, hugo must be build using `hugo` command before running this script.');
+    process.exit(1);
+}