ci: let linkcheck not always fail in CI

Author: ascott18

docs/.vitepress/config.mts

@@ -10,7 +10,7 @@ function autoTitle(link: string) {
   const fullPath = path.join(
     url.fileURLToPath(import.meta.url),
     "../../",
-    link + (path.extname(link) ? "" : ".md")
+    link + (path.extname(link) ? "" : ".md"),
   );
 
   const { data, content } = matter(fs.readFileSync(fullPath));
@@ -31,7 +31,7 @@ function autoTitle(link: string) {
 
 const vuetifyComponents = fs
   .readdirSync(
-    path.resolve(__dirname, "../stacks/vue/coalesce-vue-vuetify/components")
+    path.resolve(__dirname, "../stacks/vue/coalesce-vue-vuetify/components"),
   )
   .map((f) => autoTitle("/stacks/vue/coalesce-vue-vuetify/components/" + f));
 
@@ -50,7 +50,7 @@ function getComponentCategory(item: (typeof vuetifyComponents)[0]) {
 
 const attributes = fs
   .readdirSync(
-    path.resolve(__dirname, "../modeling/model-components/attributes")
+    path.resolve(__dirname, "../modeling/model-components/attributes"),
   )
   .map((f) => autoTitle("/modeling/model-components/attributes/" + f));
 
@@ -97,7 +97,7 @@ export default defineConfig({
     },
 
     editLink: {
-      pattern: "https://github.com/IntelliTect/Coalesce/blob/dev/docs/:path",
+      pattern: "https://github.com/IntelliTect/Coalesce/blob/main/docs/:path",
     },
 
     sidebar: [
@@ -171,7 +171,7 @@ export default defineConfig({
             collapsed: false,
             items: [
               ...vuetifyComponents.filter(
-                (i) => getComponentCategory(i) == "display"
+                (i) => getComponentCategory(i) == "display",
               ),
             ],
           },
@@ -192,7 +192,7 @@ export default defineConfig({
             collapsed: true,
             items: [
               ...vuetifyComponents.filter(
-                (i) => getComponentCategory(i) == "admin"
+                (i) => getComponentCategory(i) == "admin",
               ),
             ],
           },

docs/.vitepress/linkcheck-skip-file-ci.txt

@@ -0,0 +1,6 @@
+# Skip file for CI environments (GitHub Actions)
+# In CI, we can only reliably check internal links, not external websites
+# This filter excludes all non-localhost external links
+
+# Skip all external links (anything that's not localhost)
+^https?://(?!localhost)

docs/.vitepress/linkcheck-skip-file.txt

@@ -1,7 +1,3 @@
 github.com/intellitect/coalesce/edit
-
-# fails on github actions randomly:
-https://www.npmjs.com/package
-https://github.com/IntelliTect/Coalesce
-https://intellitect.com
-https://www.intellitect.com
+github.com/IntelliTect/Coalesce/blob/main
+github.com/IntelliTect/Coalesce/blob/1fb00c7de5e363aaf3c1a78f45af3b949b11dff4/src/coalesce-vue/test/utils.spec.ts#L5

docs/check-links.mjs

@@ -31,12 +31,21 @@ try {
   // Wait for server to be ready
   await waitOn({ resources: ["http://localhost:8087"], timeout: 30000 });
 
+  // Choose skip file based on environment
+  const isCI =
+    process.env.CI === "true" || process.env.GITHUB_ACTIONS === "true";
+  const skipFile = isCI
+    ? "./.vitepress/linkcheck-skip-file-ci.txt"
+    : "./.vitepress/linkcheck-skip-file.txt";
+
+  console.log(`Running linkcheck with skip file: ${skipFile} (CI: ${isCI})`);
+
   // Run linkcheck
   await run("linkcheck", [
     "localhost:8087/Coalesce",
     "-e",
     "--skip-file",
-    "./.vitepress/linkcheck-skip-file.txt",
+    skipFile,
   ]);
 
   process.exit(0);

docs/linkcheck-bin-3.0.0-1.fix-issue-56.tgz

@@ -17,7 +17,7 @@
   },
   "devDependencies": {
     "gray-matter": "^4.0.3",
-    "linkcheck-bin": "file:linkcheck-bin-3.0.0-1.fix-issue-56.tgz",
+    "linkcheck-bin": "3.0.0-2",
     "serve-handler": "^6.1.6",
     "vitepress": "2.0.0-alpha.5",
     "wait-on": "^8.0.4"