super dupa

Author: SpectraL519

Doxyfile

@@ -1747,7 +1747,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

docs/scripts/mathjax.js

@@ -1,12 +1,12 @@
 window.MathJax = {
   tex: {
     inlineMath: [["\\(", "\\)"], ["$", "$"]],
-    displayMath: [["\\[", "\\]"], ["$$", "$$"], ["[[", "]]"]],
+    displayMath: [["\\[", "\\]"], ["$$", "$$"]],
     processEscapes: true,
     processEnvironments: true
   },
   options: {
-    ignoreHtmlClass: ".*|",
+    ignoreHtmlClass: ".*",
     processHtmlClass: "arithmatex"
   }
 };

include/gl/graph.hpp

@@ -75,20 +75,18 @@ struct to_impl;
 /// @tparam GraphTraits An instantiation of @ref gl::graph_traits
 ///
 /// ### Mathematics
-/// Here is an inline math equation using standard dollars: \f$V = E - F + 2\f$,
-/// and one using Big-O: \f$\mathcal{O}(\vert V \vert + \vert E \vert)\f$.
+/// Inline math: $V = E - F + 2$
+/// Big-O: $\mathcal{O}(\vert V \vert + \vert E \vert)$
 ///
-/// And here is a normal (multiline) math block:
-///
-/// $$
+/// Display math:
+/// ```math
 /// \sum_{v \in V} \text{deg}(v) = 2 \vert E \vert
-/// $$
-///
-/// Or alternatively for environments like cases:
+/// ```
 ///
-/// $$
+/// Complex environment:
+/// ```math
 /// A_{i,j} = \begin{cases} 1 & \text{if } (i,j) \in E \\\\ 0 & \text{otherwise} \end{cases}
-/// $$
+/// ```
 ///
 /// ### Code Example
 /// ```cpp
@@ -107,7 +105,7 @@ struct to_impl;
 /// ### References
 /// For a general overview and integration instructions, see the [Project Overview](/#overview)
 /// or the [Installation Guide](/#installing-the-library).
-/// A simple reference: @ref README
+/// A simple reference [MAIN PAGE](/)
 ///
 /// > [!WARNING]
 /// > This class relies on its internal implementation tag to correctly define its layout. Modifying

mkdocs.yml

@@ -55,6 +55,8 @@ plugins:
         graphlib:
           src-dirs: include/
           doxy-cfg:
-            GENERATE_HTML: NO
             GENERATE_XML: YES
+            GENERATE_HTML: NO
+            USE_MATHJAX: NO
+            ENABLE_PREPROCESSING: YES
             RECURSIVE: YES

scripts/postprocess_doxyhtml.py

@@ -118,10 +118,10 @@ def process_file(f: Path, img_rules: Optional[ImgRules] = None):
     content = f.read_text(encoding='utf-8')
     content = process_md_refs(content)
     content = process_gfm(content)
-    content = process_heading_code_blocks(content)
     content = remove_mainpage_title(content, f.name)
     if img_rules:
         content = process_images(content, f, img_rules)
+    content = process_heading_code_blocks(content)
 
     f.write_text(content, encoding='utf-8')