Try out mkdocs build in CI

Author: thibaudcolas

.travis.yml

@@ -20,10 +20,19 @@ jobs:
         - npm install --no-optional --no-audit --progress=false
       script:
         - npm run build
+    - python: 3.8
+      install:
+        - poetry install
+      script:
+        - cp README.md docs/README.md
+        - poetry run mkdocs
 install:
   - pip install poetry tox
 script:
   - tox -e lint
   - tox -e $(tox -l | grep ${PYVER} | xargs echo | sed 's/ /,/g')
+branches:
+  except:
+    - gh-pages
 notifications:
   email: false

mkdocs.yml

@@ -22,5 +22,6 @@ markdown_extensions:
   - pymdownx.tilde
 
 nav:
+  # Auto-magically copied from the root of the project in the CI build.
   - 'Home': 'README.md'
   - 'Overview': 'overview.md'