[docs] switch generated docs to MkDocs

docs/api/eigensolvers.md

@@ -0,0 +1,3 @@
+# eigensolvers
+
+::: meanas.eigensolvers

docs/api/fdfd.md

@@ -0,0 +1,15 @@
+# fdfd
+
+::: meanas.fdfd
+
+## Core operator layers
+
+::: meanas.fdfd.functional
+
+::: meanas.fdfd.operators
+
+::: meanas.fdfd.solvers
+
+::: meanas.fdfd.scpml
+
+::: meanas.fdfd.farfield

docs/api/fdmath.md

@@ -0,0 +1,13 @@
+# fdmath
+
+::: meanas.fdmath
+
+## Functional and sparse operators
+
+::: meanas.fdmath.functional
+
+::: meanas.fdmath.operators
+
+::: meanas.fdmath.vectorization
+
+::: meanas.fdmath.types

docs/api/fdtd.md

@@ -0,0 +1,15 @@
+# fdtd
+
+::: meanas.fdtd
+
+## Core update and analysis helpers
+
+::: meanas.fdtd.base
+
+::: meanas.fdtd.pml
+
+::: meanas.fdtd.boundaries
+
+::: meanas.fdtd.energy
+
+::: meanas.fdtd.phasor

docs/api/index.md

@@ -0,0 +1,14 @@
+# API Overview
+
+The package is documented directly from its docstrings. The most useful entry
+points are:
+
+- [meanas](meanas.md): top-level package overview
+- [eigensolvers](eigensolvers.md): generic eigenvalue utilities used by the mode solvers
+- [fdfd](fdfd.md): frequency-domain operators, sources, PML, solvers, and far-field transforms
+- [waveguides](waveguides.md): straight, cylindrical, and 3D waveguide mode helpers
+- [fdtd](fdtd.md): timestepping, CPML, energy/flux helpers, and phasor extraction
+- [fdmath](fdmath.md): shared discrete operators, vectorization helpers, and derivation background
+
+The waveguide and FDTD pages are the best places to start if you want the
+mathematical derivations rather than just the callable reference.

docs/api/meanas.md

@@ -0,0 +1,3 @@
+# meanas
+
+::: meanas

docs/api/waveguides.md

@@ -0,0 +1,7 @@
+# waveguides
+
+::: meanas.fdfd.waveguide_2d
+
+::: meanas.fdfd.waveguide_3d
+
+::: meanas.fdfd.waveguide_cyl

docs/assets/vendor/mathjax/manifest.json

@@ -0,0 +1,38 @@
+{
+  "etag": "7ab8013dfc2c395304109fe189c1772ef87b366a",
+  "files": {
+    "core.js": 212262,
+    "loader.js": 16370,
+    "startup.js": 22870,
+    "input/tex-full.js": 270711,
+    "input/asciimath.js": 107690,
+    "input/mml.js": 13601,
+    "input/mml/entities.js": 32232,
+    "output/chtml.js": 211041,
+    "output/chtml/fonts/tex.js": 104359,
+    "output/chtml/fonts/woff-v2/MathJax_Zero.woff": 1368,
+    "output/chtml/fonts/woff-v2/MathJax_Vector-Regular.woff": 1136,
+    "output/chtml/fonts/woff-v2/MathJax_Vector-Bold.woff": 1116,
+    "output/chtml/fonts/woff-v2/MathJax_Typewriter-Regular.woff": 17604,
+    "output/chtml/fonts/woff-v2/MathJax_Size4-Regular.woff": 5148,
+    "output/chtml/fonts/woff-v2/MathJax_Size3-Regular.woff": 3244,
+    "output/chtml/fonts/woff-v2/MathJax_Size2-Regular.woff": 5464,
+    "output/chtml/fonts/woff-v2/MathJax_Size1-Regular.woff": 5792,
+    "output/chtml/fonts/woff-v2/MathJax_Script-Regular.woff": 11852,
+    "output/chtml/fonts/woff-v2/MathJax_SansSerif-Regular.woff": 12660,
+    "output/chtml/fonts/woff-v2/MathJax_SansSerif-Italic.woff": 14628,
+    "output/chtml/fonts/woff-v2/MathJax_SansSerif-Bold.woff": 15944,
+    "output/chtml/fonts/woff-v2/MathJax_Math-Regular.woff": 19288,
+    "output/chtml/fonts/woff-v2/MathJax_Math-Italic.woff": 19360,
+    "output/chtml/fonts/woff-v2/MathJax_Math-BoldItalic.woff": 19776,
+    "output/chtml/fonts/woff-v2/MathJax_Main-Regular.woff": 34160,
+    "output/chtml/fonts/woff-v2/MathJax_Main-Italic.woff": 20832,
+    "output/chtml/fonts/woff-v2/MathJax_Main-Bold.woff": 34464,
+    "output/chtml/fonts/woff-v2/MathJax_Fraktur-Regular.woff": 21480,
+    "output/chtml/fonts/woff-v2/MathJax_Fraktur-Bold.woff": 22340,
+    "output/chtml/fonts/woff-v2/MathJax_Calligraphic-Regular.woff": 9600,
+    "output/chtml/fonts/woff-v2/MathJax_Calligraphic-Bold.woff": 9908,
+    "output/chtml/fonts/woff-v2/MathJax_AMS-Regular.woff": 40808
+  },
+  "version": "3.1.4"
+}

docs/index.md

@@ -0,0 +1,33 @@
+# meanas
+
+`meanas` is a Python package for finite-difference electromagnetic simulation.
+It combines:
+
+- `meanas.fdfd` for frequency-domain operators, sources, waveguide modes, and SCPML
+- `meanas.fdtd` for Yee-grid timestepping, CPML, energy/flux accounting, and phasor extraction
+- `meanas.fdmath` for the shared discrete operators and derivations underneath both solvers
+
+This documentation is built directly from the package docstrings. The API pages
+are the source of truth for the mathematical derivations and calling
+conventions.
+
+## Recommended starting points
+
+- Use the [FDTD API](api/fdtd.md) when you need time-domain stepping, CPML, or
+  phasor extraction.
+- Use the [FDFD API](api/fdfd.md) when you need driven frequency-domain solves
+  or operator algebra.
+- Use the [Waveguide API](api/waveguides.md) for mode solving, port sources, and
+  overlap windows.
+- Use the [fdmath API](api/fdmath.md) when you need the lower-level finite-difference
+  operators or the derivation background shared across the package.
+
+## Build outputs
+
+The docs build generates two HTML views from the same source:
+
+- a normal multi-page site
+- a print-oriented combined page under `site/print_page/`
+
+If `htmlark` is installed, `./make_docs.sh` also writes a fully inlined
+`site/standalone.html`.

docs/javascripts/mathjax.js

@@ -0,0 +1,19 @@
+window.MathJax = {
+  loader: {
+    load: ["input/tex-full", "output/chtml"]
+  },
+  tex: {
+    processEscapes: true,
+    processEnvironments: true
+  },
+  options: {
+    ignoreHtmlClass: ".*|",
+    processHtmlClass: "arithmatex"
+  }
+};
+
+document$.subscribe(() => {
+  MathJax.typesetPromise?.(
+    document.querySelectorAll(".arithmatex")
+  ).catch((error) => console.error(error));
+});

docs/stylesheets/extra.css

@@ -0,0 +1,13 @@
+.md-typeset .arithmatex {
+  overflow-x: auto;
+}
+
+.md-typeset .doc-contents {
+  overflow-wrap: anywhere;
+}
+
+.md-typeset h1 code,
+.md-typeset h2 code,
+.md-typeset h3 code {
+  word-break: break-word;
+}