Commit Graph

6 Commits

Author SHA1 Message Date
Wez Furlong 8c0eb21df3 docs: workaround upstream mkdocs live reloading bug
refs: https://github.com/mkdocs/mkdocs/issues/4032
refs: https://github.com/pallets/click/issues/3084
refs: https://github.com/squidfunk/mkdocs-material/issues/8478
2025-10-25 07:00:07 +01:00
Wez Furlong a95e78cfa7 docs: enable build w/ podman on apple silicon 2025-03-24 21:58:47 -07:00
Wez Furlong aa22e788c9 mkdocs: make build the default command, rather than serve
This makes it easier to run in woodpecker
2024-07-03 15:37:27 -07:00
Wez Furlong d416b31af9 docs: add toml_data macro
This macro allows embedding TOML data into the docs,
and showing it in a tab that has both the TOML and JSON
representation of that data.

It works by executing the toml2jsonc helper that was added
in an earlier commit.

There's some machinery here to compile that utility to run
in the context of the mkdocs docker image; that works
locally, let's see how well it works in CI!

Usage is simple; before:

```toml
["something"]
foo = "bar"
```

after:

{% call toml_data() %}
["something"]
foo = "bar"
{% endcall %}

The first page to get switched over to this is https://docs.kumomta.com/tutorial/configuring_kumomta/

refs: https://github.com/KumoCorp/kumomta/issues/212
2024-07-03 14:59:52 -07:00
Wez Furlong e93002c22d ci: docs: try using podman instead of docker(!)
It's a PITA to bootstrap the docker daemon, and pointing it to the host
daemon to sidestep all that is insecure and should not be trusted in a
public repo like this.

So, let's just try podman for this: it doesn't need a daemon and
doesn't need any special privs.
2024-02-09 12:57:08 -07:00
Wez Furlong f1de881ebb docs: switch to using docker based mkdocs
ubuntu is making it awkward to use pip for user-installed stuff,
so let's just use the docker image.
2024-02-08 08:09:53 -07:00