simplify CSS, light/dark switch on auto, fix RST tables to be html

Author: psifertex

api-docs/cppdocs/Doxyfile-HTML

@@ -334,7 +334,7 @@ MARKDOWN_SUPPORT       = NO
 # Minimum value: 0, maximum value: 99, default value: 5.
 # This tag requires that the tag MARKDOWN_SUPPORT is set to YES.
 
-TOC_INCLUDE_HEADINGS   = 5
+TOC_INCLUDE_HEADINGS   = 0
 
 # When enabled doxygen tries to link words that correspond to documented
 # classes, or namespaces to their corresponding documentation. Such a link can
@@ -1053,7 +1053,7 @@ REFERENCES_LINK_SOURCE = NO
 # The default value is: YES.
 # This tag requires that the tag SOURCE_BROWSER is set to YES.
 
-SOURCE_TOOLTIPS        = YES
+SOURCE_TOOLTIPS        = NO
 
 # If the USE_HTAGS tag is set to YES then the references to source code will
 # point to the HTML generated by the htags(1) tool instead of doxygen built-in
@@ -1175,7 +1175,7 @@ HTML_FOOTER            = footer.html
 # obsolete.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_STYLESHEET        =
+HTML_STYLESHEET        = binaryninja-docs.css
 
 # The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined
 # cascading style sheets that are included after the standard style sheets
@@ -1188,10 +1188,7 @@ HTML_STYLESHEET        =
 # list). For an example see the documentation.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_EXTRA_STYLESHEET  = doxygen-awesome-css/doxygen-awesome.css \
-                         doxygen-awesome-css/doxygen-awesome-sidebar-only.css \
-                         doxygen-awesome-css/doxygen-awesome-sidebar-only-darkmode-toggle.css \
-                         custom.css
+HTML_EXTRA_STYLESHEET  =
 
 # The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
 # other source files which should be copied to the HTML output directory. Note
@@ -1201,7 +1198,7 @@ HTML_EXTRA_STYLESHEET  = doxygen-awesome-css/doxygen-awesome.css \
 # files will be copied as-is; there are no commands or markers available.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_EXTRA_FILES       = doxygen-awesome-css/doxygen-awesome-darkmode-toggle.js
+HTML_EXTRA_FILES       = binaryninja-darkmode.js
 
 # The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen
 # will adjust the colors in the style sheet and background images according to
@@ -1251,15 +1248,15 @@ HTML_TIMESTAMP         = NO
 # The default value is: YES.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_DYNAMIC_MENUS     = NO
+HTML_DYNAMIC_MENUS     = YES
 
 # If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
 # documentation will contain sections that can be hidden and shown after the
 # page has loaded.
 # The default value is: NO.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_DYNAMIC_SECTIONS  = NO
+HTML_DYNAMIC_SECTIONS  = YES
 
 # With HTML_INDEX_NUM_ENTRIES one can control the preferred number of entries
 # shown in the various tree structured indices initially; the user can expand
@@ -1490,6 +1487,9 @@ DISABLE_INDEX          = YES
 
 GENERATE_TREEVIEW      = YES
 
+# Disable the page outline panel on the right side
+PAGE_OUTLINE_PANEL     = NO
+
 # The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that
 # doxygen will group on one line in the generated HTML documentation.
 #

api-docs/cppdocs/binaryninja-darkmode.js

@@ -0,0 +1,100 @@
+/**
+ * Binary Ninja Dark Mode - System Preference with Cookie Persistence
+ * Follows system color scheme automatically via CSS
+ * Provides console toggle for testing with cookie-based persistence
+ */
+
+(function() {
+    'use strict';
+
+    const COOKIE_NAME = 'bn-docs-theme';
+    const COOKIE_DAYS = 365;
+
+    /**
+     * Get cookie value by name
+     */
+    function getCookie(name) {
+        const value = `; ${document.cookie}`;
+        const parts = value.split(`; ${name}=`);
+        if (parts.length === 2) return parts.pop().split(';').shift();
+        return null;
+    }
+
+    /**
+     * Set cookie value
+     */
+    function setCookie(name, value, days) {
+        const date = new Date();
+        date.setTime(date.getTime() + (days * 24 * 60 * 60 * 1000));
+        const expires = `expires=${date.toUTCString()}`;
+        document.cookie = `${name}=${value};${expires};path=/`;
+    }
+
+    /**
+     * Delete cookie
+     */
+    function deleteCookie(name) {
+        document.cookie = `${name}=;expires=Thu, 01 Jan 1970 00:00:00 UTC;path=/`;
+    }
+
+    /**
+     * Apply theme mode
+     */
+    function applyTheme(mode) {
+        const html = document.documentElement;
+
+        if (mode === 'dark') {
+            html.classList.remove('light-mode');
+            html.classList.add('dark-mode');
+        } else if (mode === 'light') {
+            html.classList.remove('dark-mode');
+            html.classList.add('light-mode');
+        } else {
+            // Auto mode - remove both classes to follow system preference
+            html.classList.remove('dark-mode');
+            html.classList.remove('light-mode');
+        }
+    }
+
+    /**
+     * Console-accessible toggle function with cookie persistence
+     * Usage: bnToggleDarkMode('dark'), bnToggleDarkMode('light'), or bnToggleDarkMode('auto')
+     */
+    window.bnToggleDarkMode = function(mode) {
+        if (mode === 'dark') {
+            applyTheme('dark');
+            setCookie(COOKIE_NAME, 'dark', COOKIE_DAYS);
+            console.log('Dark mode: FORCED ON (saved to cookie, will persist across reloads)');
+        } else if (mode === 'light') {
+            applyTheme('light');
+            setCookie(COOKIE_NAME, 'light', COOKIE_DAYS);
+            console.log('Dark mode: FORCED OFF (saved to cookie, will persist across reloads)');
+        } else if (mode === 'auto') {
+            applyTheme('auto');
+            deleteCookie(COOKIE_NAME);
+            console.log('Dark mode: AUTO (following system preference, cookie cleared)');
+        } else {
+            console.log('Usage: bnToggleDarkMode("dark"), bnToggleDarkMode("light"), or bnToggleDarkMode("auto")');
+            console.log('Current setting:', getCookie(COOKIE_NAME) || 'auto (system preference)');
+        }
+    };
+
+    /**
+     * Initialize theme on page load
+     */
+    function init() {
+        const savedTheme = getCookie(COOKIE_NAME);
+
+        if (savedTheme) {
+            applyTheme(savedTheme);
+            console.log(`Binary Ninja Docs: Theme loaded from cookie: ${savedTheme}`);
+        } else {
+            console.log('Binary Ninja Docs: Following system preference (no cookie set)');
+        }
+
+        console.log('Use bnToggleDarkMode("dark"), bnToggleDarkMode("light"), or bnToggleDarkMode("auto") to change theme');
+    }
+
+    // Initialize on page load
+    init();
+})();