Skip to content

Fix 545 broken .md links and add dark/light theme toggle to documentation #2941

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fermga merged 3 commits into from
Nov 13, 2025
Merged

Fix 545 broken .md links and add dark/light theme toggle to documentation #2941

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
a103804
Initial plan
Copilot Nov 13, 2025
ff4a912
Fix broken documentation links - replace .md with correct HTML paths
Copilot Nov 13, 2025
963b8d0
Add dark/light mode toggle to website
Copilot Nov 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 67 additions & 5 deletions 404.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@
</head>


<body dir="ltr">
<body dir="ltr" data-md-color-scheme="default">


<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
Expand Down Expand Up @@ -101,7 +101,13 @@
</div>


<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>

<button class="md-header__button md-icon theme-toggle-button" title="Toggle dark/light mode" aria-label="Toggle theme" onclick="toggleTheme()">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" id="theme-icon-light"><path d="M12 7a5 5 0 0 1 5 5 5 5 0 0 1-5 5 5 5 0 0 1-5-5 5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3m0-7 2.39 3.42C13.65 5.15 12.84 5 12 5s-1.65.15-2.39.42zM3.34 7l4.16-.35A7.2 7.2 0 0 0 5.94 8.5c-.44.74-.69 1.5-.83 2.29zm.02 10 1.76-3.77a7.13 7.13 0 0 0 2.38 4.14zm11.3 3.5-1.77-3.79a7.05 7.05 0 0 0 2.38-4.15l4.16-.35c-.14.79-.39 1.55-.83 2.29a7.2 7.2 0 0 1-1.56 1.85zm6.99-10-4.16.35A7.2 7.2 0 0 0 18.06 8.5c.44-.74.69-1.5.83-2.29l1.76 3.77z"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" id="theme-icon-dark" style="display: none;"><path d="M17.75 4.09 15.22 6.62l1.42 1.42 2.53-2.53zM5.34 10.42l-3.53 3.53 1.41 1.42L6.75 12zm12.01 1.42-3.53 3.53 1.42 1.41 3.53-3.53zM21 13h-4v2h4zM3 11h4v2H3zm9.5-8v4h-2V3zM12 19.5v4h-2v-4z"/></svg>
</button>




Expand Down Expand Up @@ -1219,7 +1225,7 @@


<li class="md-nav__item">
<a href="/TNFR-Python-Engine/grammar/GLOSSARY.md" class="md-nav__link">
<a href="/TNFR-Python-Engine/GLOSSARY/" class="md-nav__link">



Expand Down Expand Up @@ -1472,7 +1478,7 @@


<li class="md-nav__item">
<a href="/TNFR-Python-Engine/grammar/DEPRECATION-INDEX.md" class="md-nav__link">
<a href="/TNFR-Python-Engine/grammar/" class="md-nav__link">



Expand Down Expand Up @@ -3190,5 +3196,61 @@ <h1>404 - Not found</h1>
<script src="/TNFR-Python-Engine/assets/javascripts/bundle.e71a0d61.min.js"></script>


</body>

<script>
function toggleTheme() {
const body = document.body;
const currentScheme = body.getAttribute('data-md-color-scheme') || 'default';
const newScheme = currentScheme === 'slate' ? 'default' : 'slate';

body.setAttribute('data-md-color-scheme', newScheme);

// Toggle icon visibility
const lightIcon = document.getElementById('theme-icon-light');
const darkIcon = document.getElementById('theme-icon-dark');
if (lightIcon && darkIcon) {
if (newScheme === 'slate') {
lightIcon.style.display = 'none';
darkIcon.style.display = 'block';
} else {
lightIcon.style.display = 'block';
darkIcon.style.display = 'none';
}
}

// Save preference
localStorage.setItem('theme-preference', newScheme);
}

// Initialize theme immediately
(function() {
const savedTheme = localStorage.getItem('theme-preference') || 'default';
const body = document.body;
body.setAttribute('data-md-color-scheme', savedTheme);

// Wait for DOM to set icon visibility
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', function() {
updateThemeIcons(savedTheme);
});
} else {
updateThemeIcons(savedTheme);
}

function updateThemeIcons(theme) {
const lightIcon = document.getElementById('theme-icon-light');
const darkIcon = document.getElementById('theme-icon-dark');
if (lightIcon && darkIcon) {
if (theme === 'slate') {
lightIcon.style.display = 'none';
darkIcon.style.display = 'block';
} else {
lightIcon.style.display = 'block';
darkIcon.style.display = 'none';
}
}
}
})();
</script>
</body>
</html>
80 changes: 71 additions & 9 deletions AGENTS/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@
</head>


<body dir="ltr">
<body dir="ltr" data-md-color-scheme="default">


<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
Expand Down Expand Up @@ -112,7 +112,13 @@
</div>


<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>

<button class="md-header__button md-icon theme-toggle-button" title="Toggle dark/light mode" aria-label="Toggle theme" onclick="toggleTheme()">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" id="theme-icon-light"><path d="M12 7a5 5 0 0 1 5 5 5 5 0 0 1-5 5 5 5 0 0 1-5-5 5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3m0-7 2.39 3.42C13.65 5.15 12.84 5 12 5s-1.65.15-2.39.42zM3.34 7l4.16-.35A7.2 7.2 0 0 0 5.94 8.5c-.44.74-.69 1.5-.83 2.29zm.02 10 1.76-3.77a7.13 7.13 0 0 0 2.38 4.14zm11.3 3.5-1.77-3.79a7.05 7.05 0 0 0 2.38-4.15l4.16-.35c-.14.79-.39 1.55-.83 2.29a7.2 7.2 0 0 1-1.56 1.85zm6.99-10-4.16.35A7.2 7.2 0 0 0 18.06 8.5c.44-.74.69-1.5.83-2.29l1.76 3.77z"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" id="theme-icon-dark" style="display: none;"><path d="M17.75 4.09 15.22 6.62l1.42 1.42 2.53-2.53zM5.34 10.42l-3.53 3.53 1.41 1.42L6.75 12zm12.01 1.42-3.53 3.53 1.42 1.41 3.53-3.53zM21 13h-4v2h4zM3 11h4v2H3zm9.5-8v4h-2V3zM12 19.5v4h-2v-4z"/></svg>
</button>




Expand Down Expand Up @@ -1230,7 +1236,7 @@


<li class="md-nav__item">
<a href="../grammar/GLOSSARY.md" class="md-nav__link">
<a href="../GLOSSARY/" class="md-nav__link">



Expand Down Expand Up @@ -1483,7 +1489,7 @@


<li class="md-nav__item">
<a href="../grammar/DEPRECATION-INDEX.md" class="md-nav__link">
<a href="../grammar/" class="md-nav__link">



Expand Down Expand Up @@ -4136,7 +4142,7 @@ <h2 id="core-mission">🎯 Core Mission<a class="headerlink" href="#core-mission
<p><strong>Repository</strong>: https://github.com/fermga/TNFR-Python-Engine</p>
<h3 id="quick-links">Quick Links<a class="headerlink" href="#quick-links" title="Permanent link">&para;</a></h3>
<ul>
<li>Canonical Math Hub: <a href="src/tnfr/mathematics/README.md">src/tnfr/mathematics/README.md</a></li>
<li>Canonical Math Hub: <a href="https://github.com/fermga/TNFR-Python-Engine/tree/main/src/tnfr/mathematics/README">src/tnfr/mathematics/README.md</a></li>
<li>Theory: <a href="TNFR.pdf">TNFR.pdf</a> · <a href="../UNIFIED_GRAMMAR_RULES/">UNIFIED_GRAMMAR_RULES.md</a></li>
<li>Operators Grammar: <a href="src/tnfr/operators/grammar.py">src/tnfr/operators/grammar.py</a></li>
<li>Structural Fields: <a href="src/tnfr/physics/fields.py">src/tnfr/physics/fields.py</a></li>
Expand Down Expand Up @@ -4377,7 +4383,7 @@ <h3 id="u6-structural-potential-confinement">U6: STRUCTURAL POTENTIAL CONFINEMEN
<li><strong>Usage</strong>: Telemetry-based safety check (read-only, not sequence constraint)</li>
<li><strong>Typical</strong>: Valid sequences maintain Δ Φ_s ≈ 0.6 (30% of threshold)</li>
<li><strong>Canonicity</strong>: STRONG (2,400+ experiments across 5 topologies, universal)</li>
<li><strong>See</strong>: <a href="docs/grammar/U6_STRUCTURAL_POTENTIAL_CONFINEMENT.md">docs/grammar/U6_STRUCTURAL_POTENTIAL_CONFINEMENT.md</a> for complete specification</li>
<li><strong>See</strong>: <a href="grammar/U6_STRUCTURAL_POTENTIAL_CONFINEMENT/">docs/grammar/U6_STRUCTURAL_POTENTIAL_CONFINEMENT.md</a> for complete specification</li>
</ul>
<p><strong>See</strong>: <a href="../UNIFIED_GRAMMAR_RULES/">UNIFIED_GRAMMAR_RULES.md</a> for complete derivations</p>
<hr />
Expand Down Expand Up @@ -4865,7 +4871,7 @@ <h4 id="phase-curvature-k_-canonical-newly-promoted-nov-2025"><strong>Phase Curv
- Import from <a href="src/tnfr/physics/fields.py">src/tnfr/physics/fields.py</a>
- Compute via <code>compute_phase_curvature(G)</code> [CANONICAL]
- Optional multiscale check: <code>k_phi_multiscale_safety(G, alpha_hint=2.76)</code></p>
<p><strong>Documentation</strong>: See <a href="benchmarks/K_PHI_RESEARCH_SUMMARY.md">benchmarks/K_PHI_RESEARCH_SUMMARY.md</a> and
<p><strong>Documentation</strong>: See <a href="benchmarks/K_PHI_RESEARCH_SUMMARY/">benchmarks/K_PHI_RESEARCH_SUMMARY.md</a> and
<code>benchmarks/enhanced_fragmentation_test.py</code> for empirical validation.</p>
<hr />
<h4 id="coherence-length-_c-canonical-newly-promoted-nov-2025"><strong>Coherence Length (ξ_C)</strong> - CANONICAL ⭐ <strong>NEWLY PROMOTED (Nov 2025)</strong><a class="headerlink" href="#coherence-length-_c-canonical-newly-promoted-nov-2025" title="Permanent link">&para;</a></h4>
Expand Down Expand Up @@ -4910,7 +4916,7 @@ <h4 id="coherence-length-_c-canonical-newly-promoted-nov-2025"><strong>Coherence
not captured by Φ_s, |∇φ|, or K_φ. Enables detection of genuine phase
transitions through divergence near critical points. Topology-dependent
critical exponents suggest rich universality class structure in TNFR networks.</p>
<p><strong>Documentation</strong>: See <a href="docs/XI_C_CANONICAL_PROMOTION.md">docs/XI_C_CANONICAL_PROMOTION.md</a> for complete
<p><strong>Documentation</strong>: See <a href="XI_C_CANONICAL_PROMOTION/">docs/XI_C_CANONICAL_PROMOTION.md</a> for complete
experimental validation, <a href="docs/XI_C_BREAKTHROUGH_REPORT.txt">docs/XI_C_BREAKTHROUGH_REPORT.txt</a> for detailed
analysis, and <a href="benchmarks/results/xi_c_critical_behavior_analysis.png">benchmarks/results/xi_c_critical_behavior_analysis.png</a> for
visualization of critical behavior across topologies.</p>
Expand Down Expand Up @@ -4985,5 +4991,61 @@ <h4 id="coherence-length-_c-canonical-newly-promoted-nov-2025"><strong>Coherence
<script src="../assets/javascripts/bundle.e71a0d61.min.js"></script>


</body>

<script>
function toggleTheme() {
const body = document.body;
const currentScheme = body.getAttribute('data-md-color-scheme') || 'default';
const newScheme = currentScheme === 'slate' ? 'default' : 'slate';

body.setAttribute('data-md-color-scheme', newScheme);

// Toggle icon visibility
const lightIcon = document.getElementById('theme-icon-light');
const darkIcon = document.getElementById('theme-icon-dark');
if (lightIcon && darkIcon) {
if (newScheme === 'slate') {
lightIcon.style.display = 'none';
darkIcon.style.display = 'block';
} else {
lightIcon.style.display = 'block';
darkIcon.style.display = 'none';
}
}

// Save preference
localStorage.setItem('theme-preference', newScheme);
}

// Initialize theme immediately
(function() {
const savedTheme = localStorage.getItem('theme-preference') || 'default';
const body = document.body;
body.setAttribute('data-md-color-scheme', savedTheme);

// Wait for DOM to set icon visibility
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', function() {
updateThemeIcons(savedTheme);
});
} else {
updateThemeIcons(savedTheme);
}

function updateThemeIcons(theme) {
const lightIcon = document.getElementById('theme-icon-light');
const darkIcon = document.getElementById('theme-icon-dark');
if (lightIcon && darkIcon) {
if (theme === 'slate') {
lightIcon.style.display = 'none';
darkIcon.style.display = 'block';
} else {
lightIcon.style.display = 'block';
darkIcon.style.display = 'none';
}
}
}
})();
</script>
</body>
</html>
72 changes: 67 additions & 5 deletions API_CONTRACTS/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@
</head>


<body dir="ltr">
<body dir="ltr" data-md-color-scheme="default">


<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
Expand Down Expand Up @@ -108,7 +108,13 @@
</div>


<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>

<button class="md-header__button md-icon theme-toggle-button" title="Toggle dark/light mode" aria-label="Toggle theme" onclick="toggleTheme()">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" id="theme-icon-light"><path d="M12 7a5 5 0 0 1 5 5 5 5 0 0 1-5 5 5 5 0 0 1-5-5 5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3m0-7 2.39 3.42C13.65 5.15 12.84 5 12 5s-1.65.15-2.39.42zM3.34 7l4.16-.35A7.2 7.2 0 0 0 5.94 8.5c-.44.74-.69 1.5-.83 2.29zm.02 10 1.76-3.77a7.13 7.13 0 0 0 2.38 4.14zm11.3 3.5-1.77-3.79a7.05 7.05 0 0 0 2.38-4.15l4.16-.35c-.14.79-.39 1.55-.83 2.29a7.2 7.2 0 0 1-1.56 1.85zm6.99-10-4.16.35A7.2 7.2 0 0 0 18.06 8.5c.44-.74.69-1.5.83-2.29l1.76 3.77z"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" id="theme-icon-dark" style="display: none;"><path d="M17.75 4.09 15.22 6.62l1.42 1.42 2.53-2.53zM5.34 10.42l-3.53 3.53 1.41 1.42L6.75 12zm12.01 1.42-3.53 3.53 1.42 1.41 3.53-3.53zM21 13h-4v2h4zM3 11h4v2H3zm9.5-8v4h-2V3zM12 19.5v4h-2v-4z"/></svg>
</button>




Expand Down Expand Up @@ -1226,7 +1232,7 @@


<li class="md-nav__item">
<a href="../grammar/GLOSSARY.md" class="md-nav__link">
<a href="../GLOSSARY/" class="md-nav__link">



Expand Down Expand Up @@ -1479,7 +1485,7 @@


<li class="md-nav__item">
<a href="../grammar/DEPRECATION-INDEX.md" class="md-nav__link">
<a href="../grammar/" class="md-nav__link">



Expand Down Expand Up @@ -3704,5 +3710,61 @@ <h2 id="references">References<a class="headerlink" href="#references" title="Pe
<script src="../assets/javascripts/bundle.e71a0d61.min.js"></script>


</body>

<script>
function toggleTheme() {
const body = document.body;
const currentScheme = body.getAttribute('data-md-color-scheme') || 'default';
const newScheme = currentScheme === 'slate' ? 'default' : 'slate';

body.setAttribute('data-md-color-scheme', newScheme);

// Toggle icon visibility
const lightIcon = document.getElementById('theme-icon-light');
const darkIcon = document.getElementById('theme-icon-dark');
if (lightIcon && darkIcon) {
if (newScheme === 'slate') {
lightIcon.style.display = 'none';
darkIcon.style.display = 'block';
} else {
lightIcon.style.display = 'block';
darkIcon.style.display = 'none';
}
}

// Save preference
localStorage.setItem('theme-preference', newScheme);
}

// Initialize theme immediately
(function() {
const savedTheme = localStorage.getItem('theme-preference') || 'default';
const body = document.body;
body.setAttribute('data-md-color-scheme', savedTheme);

// Wait for DOM to set icon visibility
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', function() {
updateThemeIcons(savedTheme);
});
} else {
updateThemeIcons(savedTheme);
}

function updateThemeIcons(theme) {
const lightIcon = document.getElementById('theme-icon-light');
const darkIcon = document.getElementById('theme-icon-dark');
if (lightIcon && darkIcon) {
if (theme === 'slate') {
lightIcon.style.display = 'none';
darkIcon.style.display = 'block';
} else {
lightIcon.style.display = 'block';
darkIcon.style.display = 'none';
}
}
}
})();
</script>
</body>
</html>
Loading
Loading