ERROR - Config value: 'theme'. Error: Unrecognised theme name:

user_10792131 0
Viewed 1875

The solution to similar issues on Github about this all point to installing MkDocs or the theme with a package manager and not pip. However, I have installed both with pip.

  1. Installed MkDocs with pip (not a package manager)
  2. Installed n number of MkDocs themes with pip
  3. updated mkdocs.yaml to add:
theme:
   name: '{name_of_theme}'
  1. then
mkdocs serve
  1. result
ERROR   -  Config value: 'theme'. Error: Unrecognised theme name: '{name_of_theme}'. The available installed themes are: mkdocs, readthedocs

What am I missing?

mkdocs
2 Answers

In your mkdocs.yaml, use:

theme:
   name: mkdocs

or 

theme:
   name: readthedocs

Essentially, the name of a theme you actually installed.

user_27396890

I've never seen the yaml file with the extension ".yaml".
Have you tried changing it to ".yml", so it's "mkdocs.yml".

You can definitely install mkdocs and a theme with pip.

user_39849200
Related