formula-cpp/mkdocs.yml at master · LASTRADA-Software/formula-cpp · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
site_name: formula-cpp
site_description: Declarative, traceable, self-documenting formulas for C++23
repo_url: https://github.com/LASTRADA-Software/formula-cpp
# MkDocs builds every Markdown file under docs_dir, not only the ones listed
# in nav below -- so without this, docs/superpowers/ (the design spec and the
# implementation plans: internal planning documents, not site content) would
# be built and published as public pages even though nav deliberately never
# links to them.
exclude_docs: superpowers/
theme:
  name: material
  features:
    - navigation.sections
    - content.code.copy
markdown_extensions:
  - admonition
  - pymdownx.highlight
  - pymdownx.superfences
  # The gallery (docs/gallery.md, generated by tools/gallery/main.cpp) emits
  # its LaTeX rendering as `$$ ... $$` blocks. Without this extension those
  # are inert text on the published site; with it, pymdownx rewrites them
  # into the \[ \] / \( \) spelling docs/javascripts/mathjax.js's MathJax
  # configuration is set up to read.
  - pymdownx.arithmatex:
      generic: true
extra_javascript:
  - javascripts/mathjax.js
  # Pinned, in keeping with this repository's own habit of pinning its other
  # dependencies (Catch2, the CI Clang version) rather than tracking "latest".
  - https://cdn.jsdelivr.net/npm/mathjax@3.2.2/es5/tex-mml-chtml.js
nav:
  - Home: index.md
  - Numbers: numbers.md
  - Numeric headroom: numeric-headroom.md
  - Dimensions and units: dimensions.md
  - Quantities and measurements: quantities.md
  - Expressions and evaluation: expressions.md
  - Citations and rendering: citations.md
  - Tracing and audit trails: tracing.md
  - Displaying numbers: display.md
  - Calculations and worksheets: calculations.md
  - Rounding and conditionals: rounding-and-conditionals.md
  - Constraints and verdicts: constraints.md
  - Lookup tables: lookup-tables.md
  - Methods and overlays: methods-and-overlays.md
  - Series and grading curves: series.md
  - Statistics, outliers and precision: statistics.md
  - Other samples and other tests: records.md
  - Opaque operations and bounded retry: opaque-and-retry.md
  - Gallery: gallery.md
  # Doxygen output, dropped into the built site's api/ directory by
  # .github/workflows/pages.yml after `mkdocs build` runs -- not a page
  # MkDocs itself builds, so it is linked as an external-style URL rather
  # than a page in docs/.
  - API reference: https://lastrada-software.github.io/formula-cpp/api/