docs/.travis.yml
Peter J. Mello b91e882cfe
Switch mkdocs from JS theming to Pygments at build
This commit changes several configuration options for MkDocs
that were originally made in an effort to debug the unexpected
rendering of install-gnu.md following commit a746567c. In summary, those are:

- Remove deprecated Python Markdown extension nl2br.
- Switch from client-side syntax highlighting via JavaScript
  to using Pygments at build time to bake the highlighting into
  the generated output. This had the benefit of much better
  determinism and cost only an extra minute added to the build.
- Remove deprecated CodeHilite extension in favor recommended
  Highlight and InlineHilite extensions.

Ultimately, the documentation site loads more quickly and has
greater simplicity, which seemed worth the ~50% increase in
time to generate.

Signed-off-by: Peter J. Mello <admin@petermello.net>
2024-08-21 00:57:29 +01:00

11 lines
184 B
YAML

language: python
python:
- "3.6"
install:
- pip install mkdocs
- pip install mkdocs-material
- pip install pymdown-extensions
- pip install pygments
script:
- mkdocs build