docs: favicon and hierarchy

Moving the output to /luci breaks existing links out there so let's do our best to output to /luci/jsapi Include a favicon also as a static resource. Signed-off-by: Paul Donald <newtwen+github@gmail.com> (cherry picked from commit 7f6ba9d460)
2026-05-31 10:31:55 +08:00 · 2026-02-22 16:51:25 +01:00
parent 9fa84e5a33
commit d8c1754d6a
4 changed files with 16 additions and 4 deletions
@@ -7,4 +7,4 @@ Start with the [LuCI Client side JavaScript APIs](LuCI.html)

 ## Historical

-The older [Lua API docs](api/index.html) are available for historical reference.
+The older [Lua API docs](../api/index.html) are available for historical reference.
@@ -0,0 +1 @@
+../../themes/luci-theme-bootstrap/htdocs/luci-static/bootstrap/logo_48.png
@@ -0,0 +1,6 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta http-equiv="refresh" content="0; url=/luci/jsapi" />
+  </head>
+</html>
@@ -14,14 +14,19 @@
 		"cleverLinks": true,
 		"monospaceLinks": true,
 		"default": {
-			"outputSourceFiles": true
+			"outputSourceFiles": true,
+			"staticFiles": {
+				"include": [
+					"doc_gen/include"
+				]
+			}
 		}
 	},
 	"opts": {
 		"template": "node_modules/clean-jsdoc-theme",
 		"template_alt": "@alphanull/jsdoc-vision-theme",
 		"template_old": "jaguarjs-jsdoc",
-		"destination": "docs/",
+		"destination": "docs/jsapi",
 		"destination_comment": "output directory in the repo",
 		"recurse": true,
 		"readme": "doc_gen/README.md",
@@ -30,7 +35,7 @@
 		"tutorials_comment": "tutorials index. See 'sections' below. jaguarjs does not like the tutorials entry",
 		"theme_opts": {
 			"default_theme": "fallback-dark",
-			"favicon": "themes/luci-theme-bootstrap/htdocs/luci-static/bootstrap/logo.svg",
+			"favicon": "favicon.png",
 			"title": "LuCI Documentation",
 			"homepageTitle": "LuCI - Reference Documentation",
 			"displayModuleHeader": false,
				`@@ -0,0 +1 @@`
				`../../themes/luci-theme-bootstrap/htdocs/luci-static/bootstrap/logo_48.png`