9b8e3a4bcd84ad0ee122031ec21680730c02df2f
mspeir
  Thu Jul 23 15:34:52 2026 -0700
Move vendored reveal.js library out of docs/slideDecks into the source tree

Per code review feedback on #37904, the reveal.js 5.1.0 files used by the
training slide decks now live in their conventional homes rather than bundled
under docs/slideDecks/reveal.js:

- JS  -> src/hg/js/external/ (reveal-5.1.0.js, reveal-notes-5.1.0.js),
added to that makefile; MIT LICENSE kept alongside.
- CSS -> src/hg/htdocs/style/ (reveal-5.1.0.css, reveal-white-5.1.0.css),
added to that makefile.
- Source Sans Pro fonts -> src/hg/htdocs/fonts/source-sans-pro/, matching
the existing font-awesome pattern (auto-rsynced, no makefile edit).

The white theme's @import and the five deck index.html files were updated to
reference the assets by absolute /js, /style, and /fonts paths.

refs #37904

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

diff --git docs/makefile docs/makefile
index 414e1e89cc6..c2dca6c8e31 100644
--- docs/makefile
+++ docs/makefile
@@ -1,50 +1,51 @@
 kentSrc = ..
 include ../src/inc/common.mk
 rsyncOpts = --whole-file --times --recursive --omit-dir-times --cvs-exclude --exclude='makefile' --exclude='cpAndLinkToResourceFiles.pl' --exclude='style/*'
 
 # Find all .md files in tutorials/ and subdirectories
 DOCS := $(shell find . -name '*.md' -type f | sed 's|^\./||')
 
 user:
 	${MAKE} doInstall destDir=${DOCUMENTROOT}-${USER}
 alpha:
 	${MAKE} doInstall destDir=${DOCUMENTROOT}
 beta:
 	${MAKE} doInstall destDir=${DOCUMENTROOT}-beta
 	rsync ${rsyncOpts} ${DOCUMENTROOT}-beta/docs/ qateam@hgwbeta:${DOCUMENTROOT}/docs/
 
 doInstall: $(DOCS)
 	@for mdfile in $(DOCS); do \
 		htmlfile=$$(echo "$$mdfile" | sed 's|\.md$$|.html|'); \
 		dirpart=$$(dirname "$$htmlfile"); \
 		if [ "$$dirpart" = "." ]; then \
 			targetdir=${destDir}/docs; \
 			depth=1; \
 		else \
 			targetdir=${destDir}/docs/$$dirpart; \
 			depth=$$(echo "$$htmlfile" | tr -cd '/' | wc -c); \
 			depth=$$((depth + 1)); \
 		fi; \
 		rootpath=$$(printf '../%.0s' $$(seq 1 $$depth)); \
 		rootpath=$${rootpath%/}; \
 		mkdir -p "$$targetdir"; \
 		echo "Processing $$mdfile -> $$targetdir/$$(basename $$htmlfile) (ROOT=$$rootpath)"; \
 		rm -f "$$targetdir/$$(basename $$htmlfile).tmp"; \
 		pandoc --ascii -f markdown-smart -t html5 -o "$$targetdir/$$(basename $$htmlfile).tmp" "$$mdfile" --template staticPage.html -t staticPage.lua --lua-filter GBpandocHTMLrules.lua -V ROOT="$$rootpath"; \
 		mv -f "$$targetdir/$$(basename $$htmlfile).tmp" "$$targetdir/$$(basename $$htmlfile)"; \
 		chmod a+x "$$targetdir/$$(basename $$htmlfile)"; \
 	done
 	@# Copy prebuilt static slide decks (reveal.js HTML) as-is. Their images are
 	@# served separately from /images/slideDecks/ (kept in the htdocsExtras repo),
-	@# so only the HTML is deployed here.
+	@# and the reveal.js library/CSS are served from /js/ and /style/ (installed
+	@# by src/hg/js/external and src/hg/htdocs/style), so only the HTML is deployed here.
 	@if [ -d slideDecks ]; then \
 		echo "Copying slide-deck HTML -> ${destDir}/docs/slideDecks/"; \
 		mkdir -p "${destDir}/docs"; \
 		rsync ${rsyncOpts} slideDecks "${destDir}/docs/"; \
 	fi
 
 testPandoc:
 	@printf "Test the following path and commands look ok\n"
 	@printf "pandoc path: %s\n" "$$(which pandoc)"
 	@printf "Found markdown files:\n"
 	@for f in $(DOCS); do printf "  %s -> %s\n" "$$f" "$$(echo $$f | sed 's|\.md$$|.html|')"; done