url-spec: STATIC_VERSION 2a

Author: towerofnix

src/static/shared-util/README.md

@@ -6,6 +6,6 @@ Module imports under `src/static/js` may appear to be pointing to files that are
 
 ...is reading a file that doesn't exist here, under `shared-util`. This isn't an error!
 
-This folder (`src/shared-util`) does not actually exist in a build of the website; instead, the folder `src/util` is symlinked in its place. So, all files under `src/util` are actually available at `/shared-util/` online.
+This folder (`src/shared-util`) does not actually exist in a build of the website; instead, the folder `src/util` is symlinked in its place. So, all files under `src/util` are actually available at (e.g.) `/static/shared-util/` online.
 
 The above import would actually import from the bindings in `src/util/sugar.js`.

src/url-spec.js

@@ -1,5 +1,11 @@
 import {withEntries} from '#sugar';
 
+// Static files are all grouped under a `static-${STATIC_VERSION}` folder as
+// part of a build. This is so that multiple builds of a wiki can coexist
+// served from the same server / file system root: older builds' HTML files
+// refer to earlier values of STATIC_VERSION, avoiding name collisions.
+const STATIC_VERSION = '2a';
+
 const genericPaths = {
   root: '',
   path: '<>',
@@ -67,25 +73,25 @@ const urlSpec = {
   },
 
   staticCSS: {
-    prefix: 'static/css/',
+    prefix: `static-${STATIC_VERSION}/css/`,
     paths: genericPaths,
   },
 
   staticJS: {
-    prefix: 'static/js/',
+    prefix: `static-${STATIC_VERSION}/js/`,
     paths: genericPaths,
   },
 
   staticMisc: {
-    prefix: 'static/misc/',
+    prefix: `static-${STATIC_VERSION}/misc/`,
     paths: {
       ...genericPaths,
       icon: 'icons.svg#icon-<>',
     },
   },
 
   staticSharedUtil: {
-    prefix: 'static/shared-util/',
+    prefix: `static-${STATIC_VERSION}/shared-util/`,
     paths: genericPaths,
   },