This past week however, I built a new machine and installed the beta of Linux Mint 18 with KDE 5. So naturally I tried to install MKDOCS...which didn't go so well.
Initially I tried doing a 'sudo pip install mkdocs' and that failed at several different points. And somehow pip was having troubles installing a prerequisite (setuptools). Also, PIP was complaining about being outdated, but I could not get past the 2nd set of errors:
So, then I tried installing the native packaged version and found it was so old (version .014) that it did not properly render the site theme.
In the end the solution was to install the python 3 version of pip and use pip3 to install the software. I still had to upgrade setuptools first though. Not sure what that is all about as I have installed MKDOCS a dozen times on OpenIndiana and Linux Mint 17.x and never run into it before. And PIP was still complaining about being outdated, so I upgraded it.
If you follow the steps below, it should all work just fine for you.
$ sudo pip3 install --upgrade pip
$ sudo pip3 install mkdocs
$ mkdocs --version
mkdocs, version 0.15.3
