doc,tools: properly syntax highlight API ref docs

Makefile

@@ -737,7 +737,7 @@ out/doc/api/assets:
 
 # If it's not a source tarball, we need to copy assets from doc/api_assets
 out/doc/api/assets/%: doc/api_assets/% out/doc/api/assets
-	@cp $< $@
+	@cp $< $@ ; $(RM) out/doc/api/assets/README.md
 
 
 run-npm-ci = $(PWD)/$(NPM) ci

doc/api_assets/README.md

@@ -0,0 +1,27 @@
+# API Reference Document Assets
+
+## highlight.pack.js
+
+_Generated by [highlightjs.org/download][] on 2020-05-16._
+
+Grammars included in the custom bundle:
+
+* Bash
+* C
+* C++
+* CoffeeScript
+* JavaScript
+* JSON
+* Markdown
+* Plaintext
+* Shell Session
+
+## sh.css
+
+The syntax theme for code snippets in API reference documents.
+
+## style.css
+
+The main stylesheet for API reference documents.
+
+[highlightjs.org/download]: https://highlightjs.org/download/

doc/api_assets/sh.css

@@ -1,25 +1,23 @@
-.sh_sourceCode {
+.hljs {
   font-weight: normal;
   font-style: normal;
 }
 
-.sh_sourceCode .sh_symbol,
-.sh_sourceCode .sh_cbracket {
+.hljs-symbol {
   color: #333;
 }
 
-.sh_sourceCode .sh_keyword {
+.hljs-keyword {
   color: #338;
 }
 
-.sh_sourceCode .sh_string,
-.sh_sourceCode .sh_regexp,
-.sh_sourceCode .sh_number,
-.sh_sourceCode .sh_specialchar {
+.hljs-string,
+.hljs-regexp,
+.hljs-number {
   color: #E54305;
 }
 
-.sh_sourceCode .sh_comment {
+.hljs-comment {
   color: #666;
   font-weight: lighter;
 }