Add personalised mounting instructions for research drive

_doc/map-drive-mac.md

@@ -7,15 +7,20 @@ categories: mac howto drive
 
 2. Click on the **Finder** icon, press command ⌘ + K to bring up the **Connect to Server** window. 
 
-3. In the Server Address field, enter the drive location you were sent when the drive was created:
+3. In the Server Address field, 
+    <span id="defaultEnterMessage">enter the drive location you were sent when the drive was created:</span>
+    <span id="personalisedEnterMessage" style="display:none;">enter this drive location:</span>
 
-    a. For drives created after mid-September 2026, enter `smb://research.drive.auckland.ac.nz/` followed by the name of the Research Drive. It will look similar to this:
-    `smb://research.drive.auckland.ac.nz/ressci202400035-drive-name`
+    <div id="defaultPathInfo">
+    <p>a. For drives created after mid-September 2026, enter <code class="language-plaintext highlighter-rouge">smb://research.drive.auckland.ac.nz/</code> followed by the name of the Research Drive. It will look similar to this:
+    <code class="language-plaintext highlighter-rouge">smb://research.drive.auckland.ac.nz/ressci202400035-drive-name</code></p>
 
-    OR
+    <p>OR</p>
 
-    b. For drives created before mid-September 2026, enter `smb://files.auckland.ac.nz/research/` followed by the name of the Research Drive. It will look similar to this:
-    `smb://files.auckland.ac.nz/research/ressci202400035-drive-name`
+    <p>b. For drives created before mid-September 2026, enter <code class="language-plaintext highlighter-rouge">smb://files.auckland.ac.nz/research/</code> followed by the name of the Research Drive. It will look similar to this:
+    <code class="language-plaintext highlighter-rouge">smb://files.auckland.ac.nz/research/ressci202400035-drive-name</code></p>
+    </div>
+    <pre style="display:none" id="personalisedPathInfo"></pre>
 
 4. Click **+** to add the Research Drive location to **Favourite Servers** 
 
@@ -26,3 +31,6 @@ categories: mac howto drive
 If prompted, enter your University username and password ensuring the Domain is UOA.
 
 ![useful image]({{ "/assets" | append: page.id | append: "/map-mac-drive-username.png" | absolute_url }}){:width="600px"}
+
+<script src='{{"/assets/doc/personalised-instructions.js" | relative_url}}'></script>
+<script>initPersonalisedInstructions("mac")</script>

_doc/map-drive-windows.md

@@ -19,15 +19,18 @@ categories: windows admin user howto drive
 
 4. In the **Drive** list, select a free drive letter.
 
-5. In the **Folder** box, enter the drive location you were sent when the drive was created:
-
-    a. For drives created after mid-September 2026, enter `\\research.drive.auckland.ac.nz\` followed by the name of the Research Drive. It will look similar to this:
-    `\\research.drive.auckland.ac.nz\ressci202400035-drive-name`
-
-    OR
-
-    b. For drives created before mid-September 2026, enter `\\files.auckland.ac.nz\research\` followed by the name of the Research Drive. It will look similar to this:
-    `\\files.auckland.ac.nz\research\ressci202400035-drive-name`
+5. In the **Folder** box, 
+    <span id="defaultEnterMessage">enter the drive location you were sent when the drive was created:</span>
+    <span id="personalisedEnterMessage" style="display:none;">enter this drive location:</span>
+
+    <div id="defaultPathInfo">
+    <p>a. For drives created after mid-September 2026, enter <code class="language-plaintext highlighter-rouge">\\research.drive.auckland.ac.nz\</code> followed by the name of the Research Drive. It will look similar to this:
+    <code class="language-plaintext highlighter-rouge">\\research.drive.auckland.ac.nz\ressci202400035-drive-name</code></p>
+    <p>OR</p>
+    <p>b. For drives created before mid-September 2026, enter <code class="language-plaintext highlighter-rouge">\\files.auckland.ac.nz\research\</code> followed by the name of the Research Drive. It will look similar to this:
+    <code class="language-plaintext highlighter-rouge">\\files.auckland.ac.nz\research\ressci202400035-drive-name</code></p>
+    </div>
+    <pre style="display:none" id="personalisedPathInfo"></pre>
 
 6. Make sure that **Reconnect at login** remains ticked.
 
@@ -41,3 +44,6 @@ categories: windows admin user howto drive
 
 
     ![useful image]({{ "/assets" | append: page.id | append: "/map-drive-windows-credentials2.png" | absolute_url }}){:width="500"}
+
+<script src='{{"/assets/doc/personalised-instructions.js" | relative_url}}'></script>
+<script>initPersonalisedInstructions("windows")</script>

assets/doc/personalised-instructions.js

@@ -0,0 +1,23 @@
+/**  personalised-instructions.js - Script for personalising Research Drive setup instructions. Makes setup instructions include the drive name if it is part of the URL.
+*/
+function initPersonalisedInstructions(os) {
+    let prefix = "\\\\";
+    let divider = "\\";
+    if (os !== "windows") {
+        prefix = "smb://";
+        divider = "/";
+    }
+    let params = new URLSearchParams(document.location.search);
+    let basePath = `${prefix}files.auckland.ac.nz${divider}research${divider}`;
+    if (params.get("backend") !== null && params.get("backend") === "vast") {
+        basePath = `${prefix}research.drive.auckland.ac.nz${divider}`
+    }
+    let driveName = params.get("name");
+    if (driveName) {
+        document.getElementById("defaultEnterMessage").style.display = "none";
+        document.getElementById("personalisedEnterMessage").style.display = "inline";
+        document.getElementById("defaultPathInfo").style.display = "none";
+        document.getElementById("personalisedPathInfo").style.display = "block";
+        document.getElementById("personalisedPathInfo").textContent = basePath + driveName;
+    }
+}