some fixes...but not enough

Author: SpectraL519

Doxyfile

@@ -1743,7 +1743,7 @@ FORMULA_MACROFILE      =
 # The default value is: NO.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-USE_MATHJAX            = YES
+USE_MATHJAX            = NO
 
 # With MATHJAX_VERSION it is possible to specify the MathJax version to be used.
 # Note that the different versions of MathJax have different requirements with

include/gl/graph.hpp

@@ -76,19 +76,17 @@ struct to_impl;
 ///
 /// ### Mathematics
 /// Inline math: \f$V = E - F + 2\f$
-/// Big-O: \f$\mathcal{O}(\vert V \vert + \vert E \vert)\f$
+/// Big-O: \f$\mathcal{O}(|V| + |E|)\f$
 ///
 /// Display math:
-///
-/// $$
-/// \sum_{v \in V} \text{deg}(v) = 2 \vert E \vert
-/// $$
+/// ```math
+/// \sum_{v \in V} \text{deg}(v) = 2 |E|
+/// ```
 ///
 /// Complex environment:
-///
-/// $$
-/// A_{i,j} = \begin{cases} 1 & \text{if } (i,j) \in E \\\\ 0 & \text{otherwise} \end{cases}
-/// $$
+/// ```math
+/// A_{i,j} = \begin{cases} 1 & \text{if } (i,j) \in E \\ 0 & \text{otherwise} \end{cases}
+/// ```
 ///
 /// ### Code Example
 /// ```cpp
@@ -105,9 +103,9 @@ struct to_impl;
 /// ```
 ///
 /// ### References
-/// For a general overview and integration instructions, see the [Project Overview](README.md#overview)
-/// or the [Installation Guide](README.md#installing-the-library).
-/// A simple reference [MAIN PAGE](README.md)
+/// For a general overview and integration instructions, see the [Project Overview](/#overview)
+/// or the [Installation Guide](/#installing-the-library).
+/// A simple reference [MAIN PAGE](/)
 ///
 /// > [!WARNING]
 /// > This class relies on its internal implementation tag to correctly define its layout. Modifying

mkdocs.yml

@@ -7,20 +7,18 @@ theme:
   logo: docs/img/cpp-gl-hex.png
   favicon: docs/img/cpp-gl-hex.png
   features:
-    - navigation.tabs # Top-level navigation tabs
-    - navigation.sections # Collapsible side-menu sections
+    - navigation.tabs
+    - navigation.sections
+    - navigation.expand
     - search.suggest
-    - search.highlight
-    - content.code.copy # Copy buttons on code blocks
+    - content.code.copy
   palette:
-    # Light Mode
     - media: "(prefers-color-scheme: light)"
       scheme: default
       primary: indigo
       toggle:
         icon: material/brightness-7
         name: Switch to dark mode
-    # Dark Mode
     - media: "(prefers-color-scheme: dark)"
       scheme: slate
       primary: indigo
@@ -31,37 +29,40 @@ theme:
 markdown_extensions:
   - admonition
   - tables
-  - md_in_html          # <-- FIX FOR BADGES
+  - md_in_html
+  - attr_list
   - pymdownx.details
-  - pymdownx.superfences
   - pymdownx.arithmatex:
       generic: true
-  - pymdownx.snippets:  # <-- FIX FOR README DUPLICATION
+  - pymdownx.superfences:
+      custom_fences:
+        - name: math
+          class: arithmatex
+          format: !!python/name:pymdownx.arithmatex.fence_mathjax_format
+  - pymdownx.snippets:
       base_path: "."
-      check_paths: true # Attempts to fix image paths when injecting
+      check_paths: true
 
 plugins:
   - search
+  - include-markdown
+  - callouts
   - mkdoxy:
       projects:
         cpp-gl:
-          src-dirs: include # The directory to scan
+          src-dirs: include
           full-doc: True
           doxy-cfg:
-            # You can override Doxyfile settings here if needed,
-            # or MkDoxy will just use your existing Doxyfile.
             PROJECT_NAME: "CPP-GL"
 
-# Inject MathJax for LaTeX rendering
 extra_javascript:
   - scripts/mathjax.js
   - https://polyfill.io/v3/polyfill.min.js?features=es6
   - https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
 
 nav:
   - Home: index.md
-  - CPP-GL API: # <-- FIXES THE TAB NAME
+  - CPP-GL API:
     - Namespaces: cpp-gl/namespaces.md
     - Classes & Structs: cpp-gl/annotated.md
     - Files: cpp-gl/files.md
-    # You can omit macros, modules, etc., if you don't want them cluttering the menu

pyproject.toml

@@ -6,6 +6,7 @@ readme = "README.md"
 requires-python = ">=3.14"
 dependencies = [
     "mkdocs>=1.6.1",
+    "mkdocs-callouts>=1.16.0",
     "mkdocs-material>=9.7.6",
     "mkdoxy>=1.2.8",
 ]