Add broken link checker and fix 8 broken relative links in docs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: namedgraph

.github/workflows/check-docs.yml

@@ -0,0 +1,21 @@
+name: Check Docs
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  check-docs:
+    name: Check documentation
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: RDF syntax check
+        uses: AtomGraph/RDF-syntax-check@v1.0.5
+
+      - name: Check links
+        run: ./check-links.sh

check-links.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_DIR="$(cd "$(dirname "$0")" && pwd)"
+EXIT_CODE=0
+
+resolve_url() {
+    python3 -c "
+import urllib.parse, sys
+base = 'http://x/' + sys.argv[1]
+result = urllib.parse.urljoin(base, sys.argv[2])
+print(result[len('http://x/'):])
+" "$1" "$2"
+}
+
+while IFS= read -r -d '' ttl_file; do
+    rel="${ttl_file#"$REPO_DIR"/}"
+    url_path="${rel%.ttl}/"
+
+    while IFS= read -r url; do
+        [[ "$url" =~ ^https?:// ]]  && continue
+        [[ "$url" =~ ^# ]]          && continue
+        [[ "$url" =~ (^|/)uploads/ ]] && continue
+        [[ -z "$url" ]]             && continue
+
+        path="${url%%#*}"
+        [[ -z "$path" ]] && continue
+        [[ "$path" =~ \.[a-zA-Z]+$ ]] && continue   # skip links to files (e.g. .xsl)
+
+        resolved="$(resolve_url "$url_path" "$path")"
+        target_file="$REPO_DIR/${resolved%/}.ttl"
+
+        if [[ ! -f "$target_file" ]]; then
+            echo "BROKEN: $rel  →  $url  (resolves to ${resolved%/}.ttl)"
+            EXIT_CODE=1
+        fi
+    done < <(grep -oE '(href|src|data)="[^"]*"' "$ttl_file" | sed 's/^[^"]*"//;s/"$//' || true)
+done < <(find "$REPO_DIR" -name "*.ttl" -print0)
+
+exit "$EXIT_CODE"

docs/Makefile

@@ -25,5 +25,8 @@ install:
 validate:
 	./validate-documents.sh
 
+check-links:
+	../check-links.sh
+
 ttl-to-html:
 	./ttl-to-html.sh

docs/reference/administration/acl.ttl

@@ -61,7 +61,7 @@
         <h2 id="user-accounts">User accounts</h2>
         <p>User account is a subclass of the <a href="http://rdfs.org/sioc/spec/#term_UserAccount"><code>sioc:UserAccount</code></a>
             class. An account is the actual instance that performs actions on the application
-            (<a href="../reference/data-model/documents/#manage">manages documents</a>, <a href="../../user-guide/import-data/import-csv-data/">imports data</a> etc.). An
+            (<a href="../../data-model/documents/#manage">manages documents</a>, <a href="../../../user-guide/import-data/import-csv-data/">imports data</a> etc.). An
             account always belongs to an <a href="#agents">agent</a>.</p>
     </div>
     -->

docs/reference/administration/packages.ttl

@@ -34,7 +34,7 @@
       <dt><code>ns.ttl</code> — Package ontology</dt>
       <dd>An RDF ontology file that imports the external vocabulary using <code>owl:imports</code> and attaches blocks to properties using <code>ldh:view</code> (forward relationships) or <code>ldh:inverseView</code> (inverse relationships). Blocks are typically <code>ldh:View</code> resources with SPARQL queries that render related data for property values.</dd>
       <dt><code>layout.xsl</code> — XSLT stylesheet</dt>
-      <dd>XSLT transformation file with templates that override default rendering using system modes like <code>bs2:*</code> (Bootstrap 2.3.2 components) and <code>xhtml:*</code> (XHTML elements). See <a href="../stylesheets/" target="_blank">Stylesheets reference</a> for details on XSLT customization.</dd>
+      <dd>XSLT transformation file with templates that override default rendering using system modes like <code>bs2:*</code> (Bootstrap 2.3.2 components) and <code>xhtml:*</code> (XHTML elements). See <a href="../../stylesheets/" target="_blank">Stylesheets reference</a> for details on XSLT customization.</dd>
     </dl>
     <p>Package files are organized in the LinkedDataHub-Apps repository:</p>
     <pre>packages/
@@ -191,7 +191,7 @@ schema:knows ldh:view :PersonKnows .
     ORDER BY ?person
     \"\"\" .</pre>
     <h3 id="write-stylesheet">Write XSLT stylesheet</h3>
-    <p>Create <code>layout.xsl</code> with XSLT templates using system modes like <code>bs2:*</code> and <code>xhtml:*</code>. See the <a href="../stylesheets/" target="_blank">Stylesheets reference</a> for template customization patterns.</p>
+    <p>Create <code>layout.xsl</code> with XSLT templates using system modes like <code>bs2:*</code> and <code>xhtml:*</code>. See the <a href="../../stylesheets/" target="_blank">Stylesheets reference</a> for template customization patterns.</p>
     <pre>&lt;xsl:template match="schema:knows" mode="bs2:PropertyList"/&gt;</pre>
     <h3 id="publish-metadata">Publish package metadata</h3>
     <p>Publish package metadata as Linked Data at your package URI:</p>

docs/user-guide/create-data/create-content.ttl

@@ -19,7 +19,7 @@
         <dt>XHTML</dt>
         <dd>A fragment of XHTML that is embedded onto the page</dd>
         <dt>Object</dt>
-        <dd>RDF URI resources that get transcluded into the page. <a href="../../../reference/user-interface/resources/#built-in-classes">Built-in resource</a> examples:
+        <dd>RDF URI resources that get transcluded into the page. <a href="../../../reference/data-model/resources/#built-in-classes">Built-in resource</a> examples:
             <dl>
                 <dt>Linked Data resource</dt>
                 <dd>Any URI that resolves to RDF data</dd>

docs/user-guide/import-data/import-csv-data.ttl

@@ -65,7 +65,7 @@
                             </dl>
                         </li>
                         <li>Once all the fields have been filled in click <span class="btn btn-primary btn-save">Save</span>. You can find this saved under
-                                <dfn>Queries</dfn> container in <a href="../../user-interface/#left-nav">left navigation</a>.</li>
+                                <dfn>Queries</dfn> container in <a href="../../../reference/user-interface/#left-nav">left navigation</a>.</li>
                         <li>Click on the <span class="btn btn-primary create-action">Create <span class="caret"></span></span> dropdown button at the top left-hand corner and select <dfn>CSV Import</dfn>.
                                 This will open a new form.</li>
                         <li>Fill out <dfn>Item</dfn> fields</li>

docs/user-guide/import-data/import-rdf-data.ttl

@@ -136,7 +136,7 @@
                                 </dl>
                             </li>
                             <li>Once all the fields have been filled in click <span class="btn btn-primary btn-save">Save</span>. You can find this saved under
-                                    <dfn>Queries</dfn> container in <a href="../../user-interface/#left-nav">left navigation</a>.</li>
+                                    <dfn>Queries</dfn> container in <a href="../../../reference/user-interface/#left-nav">left navigation</a>.</li>
                             <li>Click on the <span class="btn btn-primary create-action">Create <span class="caret"></span></span> dropdown button at the top left-hand corner and select <dfn>RDF Import</dfn>.
                                     This will open a new form.</li>
                             <li>Fill out <dfn>Item</dfn> fields</li>

docs/user-guide/query-data.ttl

@@ -12,7 +12,7 @@
     rdf:value """<div xmlns="http://www.w3.org/1999/xhtml">
         <p class="lead">This guide describes how the application dataset can be queried using SPARQL.</p>
         <p>The <a href="../../reference/dataspace/#end-user-apps">end-user application</a> dataset can be queried using SPARQL 1.1
-            endpoint, which is available via link in the <a href="../../user-interface/#nav-bar">navigation bar</a>.</p>
+            endpoint, which is available via link in the <a href="../../reference/user-interface/#nav-bar">navigation bar</a>.</p>
         <p>All forms of SPARQL queries are allowed; SPARQL updates are <em>not</em> allowed. A result limit might apply.</p>
         <p>For <code>DESCRIBE</code> and <code>CONSTRUCT</code> results, it is possible to switch the
         <a href="../../reference/user-interface/#layout-modes">layout mode</a> using a button above to the results.</p>