Merging in modern HTML stylesheet

.github/workflows/docs.yaml

@@ -1,5 +1,5 @@
 ##
-## Copyright (c) 2023-2025 The Johns Hopkins University Applied Physics
+## Copyright (c) 2023-2026 The Johns Hopkins University Applied Physics
 ## Laboratory LLC.
 ##
 ## This file is part of the Asynchronous Network Management System (ANMS).
@@ -37,23 +37,38 @@ jobs:
       contents: read
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
           submodules: recursive
       - name: Set up OS
         run: |
-          sudo rm /var/lib/man-db/auto-update
-          sudo apt-get update && sudo apt-get install -y cmake make coreutils ruby asciidoctor graphviz inkscape dblatex docbook-xsl-ns xsltproc xmlstarlet
-          sudo gem install asciidoctor-diagram
+          sudo apt-get update
+          sudo apt-get install -y \
+              cmake make coreutils \
+              ruby asciidoctor graphviz plantuml inkscape \
+              dblatex xmlstarlet aspell
+          sudo gem install \
+              asciidoctor-diagram \
+              'asciidoctor-diagram-plantuml:~>1.2024.8'
       - name: Build
         env:
           DESTDIR: public
         run: ./build.sh
-      - uses: actions/upload-artifact@v4
+      - name: Misspelling
+        run: ./build.sh docs-spelling
+      - uses: actions/upload-artifact@v7
         with:
           name: docs
           path: public
+      - uses: actions/upload-artifact@v7
+        with:
+          archive: false
+          path: public/product-guide/anms-product-guide.pdf
+      - uses: actions/upload-artifact@v7
+        with:
+          archive: false
+          path: public/user-guide/anms-user-guide.pdf
 
   deploy:
     # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
@@ -73,16 +88,16 @@ jobs:
     if: github.ref == 'refs/heads/main'
     runs-on: ubuntu-24.04
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v8
         with:
           name: docs
           path: public
       - name: Setup Pages
-        uses: actions/configure-pages@v3
+        uses: actions/configure-pages@v6
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v5
         with:
           path: public
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5

.gitlab-ci.yml

@@ -1,5 +1,5 @@
 ##
-## Copyright (c) 2023-2025 The Johns Hopkins University Applied Physics
+## Copyright (c) 2023-2026 The Johns Hopkins University Applied Physics
 ## Laboratory LLC.
 ##
 ## This file is part of the Asynchronous Network Management System (ANMS).

CMakeLists.txt

@@ -1,5 +1,5 @@
 #[[
-Copyright (c) 2023-2025 The Johns Hopkins University Applied Physics
+Copyright (c) 2023-2026 The Johns Hopkins University Applied Physics
 Laboratory LLC.
 
 This file is part of the Asynchronous Network Management System (ANMS).
@@ -24,10 +24,24 @@ cmake_minimum_required(VERSION 3.16)
 project(anms-docs LANGUAGES )
 set(CMAKE_INSTALL_PREFIX "")
 
+include(FetchContent)
+FetchContent_Declare(
+  xsltng
+  URL https://codeberg.org/DocBook/xslTNG/releases/download/2.8.0/docbook-xslTNG-2.8.0.zip
+  URL_HASH SHA256=adbbddbf33a4fcc5c949a2851cac53e8111d30a5fd0b32429eeec68aedb61efd
+  DOWNLOAD_EXTRACT_TIMESTAMP OFF
+)
+FetchContent_MakeAvailable(xsltng)
+file(GLOB xsltng_JAR "${xsltng_SOURCE_DIR}/libs/*.jar")
+if(NOT xsltng_JAR)
+  message(FATAL_ERROR "No xslTNG jar file found under ${xsltng_SOURCE_DIR}")
+endif(NOT xsltng_JAR)
+
 add_subdirectory(user-guide)
 add_subdirectory(product-guide)
 
 install(
-  FILES index.html
+  FILES deploy-index.html
+  RENAME index.html
   DESTINATION .
 )

CODE_OF_CONDUCT.md

@@ -1,5 +1,5 @@
 <!--
-Copyright (c) 2023-2025 The Johns Hopkins University Applied Physics
+Copyright (c) 2023-2026 The Johns Hopkins University Applied Physics
 Laboratory LLC.
 
 This file is part of the Asynchronous Network Management System (ANMS).

CONTRIBUTING.md

@@ -1,5 +1,5 @@
 <!--
-Copyright (c) 2023-2025 The Johns Hopkins University Applied Physics
+Copyright (c) 2023-2026 The Johns Hopkins University Applied Physics
 Laboratory LLC.
 
 This file is part of the Asynchronous Network Management System (ANMS).

README.md

@@ -1,5 +1,5 @@
 <!--
-Copyright (c) 2023-2025 The Johns Hopkins University Applied Physics
+Copyright (c) 2023-2026 The Johns Hopkins University Applied Physics
 Laboratory LLC.
 
 This file is part of the Asynchronous Network Management System (ANMS).

apply_license.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 ##
-## Copyright (c) 2023-2025 The Johns Hopkins University Applied Physics
+## Copyright (c) 2023-2026 The Johns Hopkins University Applied Physics
 ## Laboratory LLC.
 ##
 ## This file is part of the Asynchronous Network Management System (ANMS).
@@ -33,7 +33,7 @@ set -e
 SELFDIR=$(realpath $(dirname "${BASH_SOURCE[0]}"))
 
 LICENSEOPTS="${LICENSEOPTS} --tmpl ${SELFDIR}/apply_license.tmpl"
-LICENSEOPTS="${LICENSEOPTS} --years 2023-$(date +%Y)"
+LICENSEOPTS="${LICENSEOPTS} --years 2023-2026"
 # Excludes only apply to directory (--dir) mode and not file mode
 #LICENSEOPTS="${LICENSEOPTS} --exclude *.yml "
 

build.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 ##
-## Copyright (c) 2023-2025 The Johns Hopkins University Applied Physics
+## Copyright (c) 2023-2026 The Johns Hopkins University Applied Physics
 ## Laboratory LLC.
 ##
 ## This file is part of the Asynchronous Network Management System (ANMS).
@@ -25,11 +25,39 @@
 set -e
 
 SELFDIR=$(realpath $(dirname "${BASH_SOURCE[0]}"))
-
 cd ${SELFDIR}
-cmake -S . -B build
-cmake --build build $@
-if [[ -n "${DESTDIR}" ]]
+
+if [[ "$1" == "docs-spelling" ]]
 then
-    cmake --install build
+    USER_MISSPELLING_TXT="build/user-guide/misspelling.txt"
+    USER_MISSPELLING_CTX_TXT="build/user-guide/misspelling-ctx.txt"
+    PROD_MISSPELLING_TXT="build/product-guide/misspelling.txt"
+    PROD_MISSPELLING_CTX_TXT="build/product-guide/misspelling-ctx.txt"
+    # success means file is present and empty
+    FAILURES=0
+    if [[ -s "${USER_MISSPELLING_TXT}" ]]
+    then
+        printf "\nUser guide:\n"
+        cat "${USER_MISSPELLING_TXT}"
+        printf "\nIn context:\n"
+        cat "${USER_MISSPELLING_CTX_TXT}"
+        ((FAILURES += 1))
+    fi
+    if [[ -s "${PROD_MISSPELLING_TXT}" ]]
+    then
+        printf "\nProduct guide:\n"
+        cat "${PROD_MISSPELLING_TXT}"
+        printf "\nIn context:\n"
+        cat "${PROD_MISSPELLING_CTX_TXT}"
+        ((FAILURES += 1))
+    fi
+    exit ${FAILURES}
+else
+    # actual build
+    cmake -S . -B build
+    cmake --build build "$@"
+    if [[ -n "${DESTDIR}" ]]
+    then
+        cmake --install build
+    fi
 fi

index.html → deploy-index.html

@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!--
--- Copyright (c) 2023-2025 The Johns Hopkins University Applied Physics
+-- Copyright (c) 2023-2026 The Johns Hopkins University Applied Physics
 -- Laboratory LLC.
 --
 -- This file is part of the Asynchronous Network Management System (ANMS).
@@ -20,7 +20,7 @@
 -- the prime contract 80NM0018D0004 between the Caltech and NASA under
 -- subcontract 1658085.
 -->
-<html xmlns="http://www.w3.org/1999/xhtml">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en-us">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
     <title>Index</title>