Rebased develop against main, develop -> main

.github/workflows/workflow-generate-website.yml

@@ -50,7 +50,6 @@ jobs:
     - name: Checkout
       uses: actions/checkout@c85c95e3d7251135ab7dc9ce3241c5835cc595a9 # v3.5.3
       with:
-        submodules: recursive
         fetch-depth: 0
     - name: Install Node.js dependencies
       run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
@@ -98,7 +97,7 @@ jobs:
     - name: Check Links
       uses: lycheeverse/lychee-action@76ab977fedbeaeb32029313724a2e56a8a393548
       with:
-        args: --exclude-file ./.github/workflows/config/.lycheeignore --verbose --no-progress --accept 200,206,429 './website/**/*.html' --exclude-mail
+        args: --config ./src/lychee.toml './website/**/*.html'
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     - name: Save Report

.gitignore

@@ -3,5 +3,5 @@
 node_modules/
 src/public
 src/resources/_gen
-
-
+lychee_report.md
+.hugo_build.lock

Makefile

@@ -0,0 +1,58 @@
+SHELL:=/usr/bin/env bash
+
+.PHONY: help
+# Run "make" or "make help" to get a list of user targets
+# Adapted from https://marmelab.com/blog/2016/02/29/auto-documented-makefile.html
+help: ## Show this help message
+	@grep -E '^[a-zA-Z_-]+:.*?##.*$$' $(MAKEFILE_LIST) | awk 'BEGIN { \
+	 FS = ":.*?## "; \
+	 printf "\033[1m%-30s %s\033[0m\n", "TARGET", "DESCRIPTION" \
+	} \
+	{ printf "\033[32m%-30s\033[0m %s\n", $$1, $$2 }'
+
+.PHONY: clean
+clean: clean-site clean-linkcheck ## Clean all
+
+#
+# Website generation / hugo
+#
+
+SITE_OUTPUT_DIR:=src/public
+
+.PHONY: serve
+serve:  ## Spin up a static web server for local dev
+	cd src; hugo serve
+
+.PHONY: site
+site: $(SITE_OUTPUT_DIR) ## Build the site
+
+$(SITE_OUTPUT_DIR):
+	cd src; hugo --minify
+
+.PHONY: clean-site
+clean-site: ## Clean the site
+	rm -fr $(SITE_OUTPUT_DIR)
+
+#
+# Checks
+#
+
+LYCHEE_OUTPUT_FILE:=lychee_report.md
+LYCHEE_CONFIG_FILE:=./src/lychee.toml
+# Flags that currently cannot be configured via the configuration file
+LYCHEE_FLAGS:=--verbose --format markdown
+# Extra flags for the user to override (used to set github token in GHA workflow)
+LYCHEE_EXTRA_FLAGS:=
+
+.PHONY: linkcheck
+linkcheck: $(LYCHEE_OUTPUT_FILE) ## Generate a report of all site links
+
+$(LYCHEE_OUTPUT_FILE): $(SITE_OUTPUT_DIR)
+	lychee \
+		--config '$(LYCHEE_CONFIG_FILE)' \
+		--output $(LYCHEE_OUTPUT_FILE) \
+		$(LYCHEE_FLAGS) $(LYCHEE_EXTRA_FLAGS) \
+		'$(SITE_OUTPUT_DIR)/**/*.html'
+
+clean-linkcheck: ## Clean the linkcheck report
+	rm -f $(LYCHEE_OUTPUT_FILE)

README.md

@@ -25,20 +25,11 @@ If you have any questions about OSCAL in general or if you would like to get inv
 Run the following Git command to clone the OSCAL-Pages repository, and you can begin editing content without any special setup.
 
 ```sh
-git clone --recurse-submodules https://github.com/usnistgov/OSCAL-Pages.git
+git clone https://github.com/usnistgov/OSCAL-Pages.git
 ```
 
 The website content in this repository is generated into the full website with [Hugo](https://gohugo.io/).  If you wish to run the website locally, you can either install hugo, or use Docker and docker-compose.
 
-## Initializing for Development
-
-This repository uses submodules to load design elements required by the website.  You can initialize these submodules with the command inside the cloned repository:
-
-```sh
-cd OSCAL-Pages
-git submodule update --init --recursive
-```
-
 ## Using Hugo
 
 In terminal: