Troubleshooting

This page contains common bugs that may occur and how to deal with them

Combined use of awesome-pages and mkdocs-versioning

In case of using awesome-pages the order of registration within the plugins is important. The following error may occur:

Traceback (most recent call last):
  [...]
  File "/path/to/mkversion/entry.py", line 47, on_config
    for count, i in enumerate(nav):
TypeError: 'NoneType' object is not iterable

You need to make sure, that the awesome-pages plugin is registered after mkdocs-versioning:

plugins:
  - mkdocs-versioning:
      version: "1.0"
  - awesome-pages

---

Last update: February 11, 2021 10:13:01