mkdocs + iolanta

Features

By integrating MkDocs static site builder with Iolanta knowledge management workspace, you can empower your static site with:

Links

Easily link from page to page; check out {{ render("linking-to-pages") }} for more info.

Tables

Visualize tables from YAML data with iolanta-tables plugin.

Roadmaps

Draw roadmaps with iolanta-roadmap plugin.

ADRs

Manage Architecture Decision Records with iolanta-adr.

Something missing?

Or anything doesn't work? — submit an issue!

Installation

Python ⩾ 3.10 required.

mkdocs-iolanta is on PyPI.

pip poetrypipenvpdm conda

pip install mkdocs-iolanta

poetry add mkdocs-iolanta

pipenv install mkdocs-iolanta

pdm add mkdocs-iolanta

conda install -c conda-forge mkdocs-iolanta

Configuration

Open your mkdocs.yml configuration file and configure its plugins section as follows:

plugins:
  - search                  
  - …
  - iolanta                 
  - macros:                 
      on_error_fail: true   
  - …