Add 'htmldark' option for dark theme support in HTML output

nmaguiar · nmaguiar · commit 37f09ebbaaf3 · 2025-03-03T12:34:45.000Z
diff --git a/data/completion.yaml b/data/completion.yaml
@@ -317,6 +317,8 @@ complete:
       desc: Boolean that if false won't try to open the output contents in a browser -defaults to true-
     - name: htmlwait=
       desc: Amount of ms, when htmlopen=true, to wait for the system browser to open an render the html output
+    - name: htmldark=
+      desc: If supported and true the output html will use a dark theme.
   - name: out=ini
     desc: A INI/Properties format -arrays are not supported-
   - name: out=json
diff --git a/data/usage.json b/data/usage.json
@@ -1327,6 +1327,11 @@
       "Option": "htmlwait",
       "Type": "Number",
       "Description": "Amount of ms, when htmlopen=true, to wait for the system browser to open an render the html output"
+    },
+    {
+      "Option": "htmldark",
+      "Type": "Boolean",
+      "Description": "If supported and true the output html will use a dark theme."
     }
   ],
   [
diff --git a/src/build.yaml b/src/build.yaml
@@ -6,6 +6,12 @@ help:
     desc     : Option to perform (e.g. dev; clean; pack; build; test)
     example  : "build"
     mandatory: false
+    options  :
+    - dev
+    - clean
+    - pack
+    - build
+    - test
 
 todo:
 - (ask        ):
diff --git a/src/docs/USAGE.md b/src/docs/USAGE.md
@@ -758,6 +758,7 @@ List of options to use when _out=html_:
 | htmlpart | Boolean | Boolean flag that if true and the input data is a string or markdown the generated html will be partial and not the complete file |
 | htmlopen | Boolean | Boolean that if false won't try to open the output contents in a browser (defaults to true). To use outfile= you need to set htmlopen=false. |
 | htmlwait | Number | Amount of ms, when htmlopen=true, to wait for the system browser to open an render the html output | 
+| htmldark | Boolean | If supported and true the output html will use a dark theme. |
 
 ---
 
diff --git a/src/include/outputFns.js b/src/include/outputFns.js
@@ -18,12 +18,13 @@ var _outputFns = new Map([
         if (params.htmlopen) tmpf = io.createTempFile("oafp_", ".html")
 
         ow.loadTemplate()
+        params.htmldark = toBoolean(_$(params.htmldark, "htmldark").isString().default("false"))
         if (isString(r)) {
-            html = ow.template.html.genStaticVersion(ow.template.parseMD2HTML(r, !toBoolean(params.htmlpart), !toBoolean(params.htmlcompact)))
+            html = ow.template.html.genStaticVersion(ow.template.parseMD2HTML(r, !toBoolean(params.htmlpart), !toBoolean(params.htmlcompact),__,params.htmldark))
             html = html.replace("<html>", "<html><meta charset=\"utf-8\">")
         } else {
             let _res = ow.template.html.parseMap(r, true)
-            html = "<html><meta charset=\"utf-8\"><style>" + _res.css + "</style><body>" + _res.out + "</body></html>"
+            html = "<html><meta charset=\"utf-8\"><style>" + _res.css + "</style><body" + (params.htmldark ? " class=\"njsmap_dark\"" : "") + ">" + _res.out + "</body></html>"
         }
         if (params.htmlopen) {
             io.writeFileString(tmpf, html)

Original file line number	Diff line number	Diff line change
`@@ -1327,6 +1327,11 @@`
`1327`	`1327`	`"Option": "htmlwait",`
`1328`	`1328`	`"Type": "Number",`
`1329`	`1329`	`"Description": "Amount of ms, when htmlopen=true, to wait for the system browser to open an render the html output"`
	`1330`	`+ },`
	`1331`	`+ {`
	`1332`	`+ "Option": "htmldark",`
	`1333`	`+ "Type": "Boolean",`
	`1334`	`+ "Description": "If supported and true the output html will use a dark theme."`
`1330`	`1335`	`}`
`1331`	`1336`	`],`
`1332`	`1337`	`[`