reorganize and update doc

Author: Saurav Agarwal

.github/docker-base-action/action.yml

@@ -48,7 +48,7 @@ runs:
       with:
         provenance: false
         platforms: linux/amd64
-        file: setup_utils/docker/Dockerfile
+        file: utils/docker/Dockerfile
         build-args: |
           BASE_TAG=${{ inputs.base_tag }}
           BUILDKIT_CONTEXT_KEEP_GIT_DIR=1

.github/workflows/cd.yml

@@ -17,7 +17,7 @@ jobs:
           fetch-depth: 0
 
       - name: Install dependencies
-        run: sudo bash ./setup_utils/install_dependencies.sh  --boost --gmp --mpfr --eigen --cgal
+        run: sudo bash ./utils/setup/install_dependencies.sh  --boost --gmp --mpfr --eigen --cgal
 
       - name: Build SDist
         run: pipx run build --sdist
@@ -106,6 +106,20 @@ jobs:
           github_token: ${{ secrets.GITHUB_TOKEN }}
       - name: cleanup
         run: docker system prune -a -f
+      - name: 'CI docker base'
+        uses: ./.github/docker-base-action
+        with:
+          base_tag: noble-torch2.5.1-cuda12.6.2
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+      - name: cleanup
+        run: docker system prune -a -f
+      - name: 'CI docker base'
+        uses: ./.github/docker-base-action
+        with:
+          base_tag: noble-torch2.5.1-cuda12.6.2-jazzy
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+      - name: cleanup
+        run: docker system prune -a -f
       - name: 'CI docker base'
         uses: ./.github/docker-base-action
         with:

doc/config/BaseDoxyfile

@@ -55,9 +55,7 @@ class DoxygenAwesomeInteractiveToc {
                         headerNode: document.getElementById(id)
                     })
 
-                    document.getElementById("doc-content")?.addEventListener("scroll", () => {
-                        DoxygenAwesomeInteractiveToc.update()
-                    })
+                    document.getElementById("doc-content")?.addEventListener("scroll",this.throttle(DoxygenAwesomeInteractiveToc.update, 100))
                 })
                 DoxygenAwesomeInteractiveToc.update()
             }
@@ -78,4 +76,16 @@ class DoxygenAwesomeInteractiveToc {
         active?.classList.add("active")
         active?.classList.remove("aboveActive")
     }
-}
+
+    static throttle(func, delay) {
+        let lastCall = 0;
+        return function (...args) {
+            const now = new Date().getTime();
+            if (now - lastCall < delay) {
+                return;
+            }
+            lastCall = now;
+            return setTimeout(() => {func(...args)}, delay);
+        };
+    }
+}

doc/config/doxygen-awesome-interactive-toc.js

@@ -805,6 +805,8 @@ html.dark-mode iframe#MSearchResults {
 #nav-tree .item {
     height: var(--tree-item-height);
     line-height: var(--tree-item-height);
+    overflow: hidden;
+    text-overflow: ellipsis;
 }
 
 #nav-tree .item > a:focus {
@@ -823,6 +825,8 @@ html.dark-mode iframe#MSearchResults {
     background-image: none;
     background-color: transparent;
     position: relative;
+    color: var(--primary-color) !important;
+    font-weight: 500;
 }
 
 #nav-tree .selected::after {
@@ -1046,7 +1050,7 @@ blockquote::after {
 blockquote p {
     margin: var(--spacing-small) 0 var(--spacing-medium) 0;
 }
-.paramname {
+.paramname, .paramname em {
     font-weight: 600;
     color: var(--primary-dark-color);
 }
@@ -1096,7 +1100,7 @@ div.contents .toc {
     border: 0;
     border-left: 1px solid var(--separator-color);
     border-radius: 0;
-    background-color: transparent;
+    background-color: var(--page-background-color);
     box-shadow: none;
     position: sticky;
     top: var(--toc-sticky-top);
@@ -1749,7 +1753,7 @@ table.fieldtable th {
     color: var(--tablehead-foreground);
 }
 
-table.fieldtable td.fieldtype, .fieldtable td.fieldname, .fieldtable td.fielddoc, .fieldtable th {
+table.fieldtable td.fieldtype, .fieldtable td.fieldname, .fieldtable td.fieldinit, .fieldtable td.fielddoc, .fieldtable th {
     border-bottom: 1px solid var(--separator-color);
     border-right: 1px solid var(--separator-color);
 }
@@ -1988,14 +1992,16 @@ hr {
 }
 
 .contents hr {
-    box-shadow: 100px 0 0 var(--separator-color),
-                -100px 0 0 var(--separator-color),
-                500px 0 0 var(--separator-color),
-                -500px 0 0 var(--separator-color),
-                1500px 0 0 var(--separator-color),
-                -1500px 0 0 var(--separator-color),
-                2000px 0 0 var(--separator-color),
-                -2000px 0 0 var(--separator-color);
+    box-shadow: 100px 0 var(--separator-color),
+                -100px 0 var(--separator-color),
+                500px 0 var(--separator-color),
+                -500px 0 var(--separator-color),
+                900px 0 var(--separator-color),
+                -900px 0 var(--separator-color),
+                1400px 0 var(--separator-color),
+                -1400px 0 var(--separator-color),
+                1900px 0 var(--separator-color),
+                -1900px 0 var(--separator-color);       
 }
 
 .contents img, .contents .center, .contents center, .contents div.image object {

doc/config/doxygen-awesome.css

@@ -87,7 +87,7 @@ manylinux-aarch64-image = "manylinux_2_28"
 
 [tool.cibuildwheel.linux]
 environment = { PATH="/usr/local/cuda/bin:$PATH", LD_LIBRARY_PATH="/usr/local/cuda/lib64:$LD_LIBRARY_PATH" }
-before-all = "bash setup_utils/manylinux_2_28_before-all.sh"
+before-all = "bash utils/setup/manylinux_2_28_before-all.sh"
 repair-wheel-command = "auditwheel repair -w {dest_dir} {wheel}"
 
 [tool.cibuildwheel.macos]
@@ -101,7 +101,7 @@ testpaths = ["python/tests"]
 
 [tool.pylint]
 py-version = "3.10"
-ignore-paths = [".*/_version.py", "cppsrc/*", "setup_utils/*", "python/coverage_control/_version.py"]
+ignore-paths = [".*/_version.py", "cppsrc/*", "utils/*", "python/coverage_control/_version.py"]
 extension-pkg-allow-list = ["coverage_control._core"]
 reports.output-format = "colorized"
 similarities.ignore-imports = "yes"