fix sphinx docs

circle.yml

@@ -45,8 +45,11 @@ references:
      command: |
        sudo apt-get install pandoc
        sudo pip install -r docs/requirements.txt
-       # sphinx-apidoc -o ./docs/source ./imsegm ./tests/* --force --follow-links
-       cd docs; make html
+       # sphinx-apidoc -o ./docs/source ./imsegm **/test_* --force --follow-links
+       cd docs
+       make html --debug --jobs 2 SPHINXOPTS="-W"
+       make latexpdf
+
 
 jobs:
   Py3-Tests:
@@ -61,8 +64,6 @@ jobs:
       - *build_project
       # TESTING
       - *test_coverage
-      # DOCUMENTATION
-      - *make_docs
 
       # PASSING
       - run:
@@ -106,6 +107,21 @@ jobs:
       - image: circleci/python:2.7
     steps: *steps_expt
 
+  Build-Docs:
+    docker:
+      - image: circleci/python:3.6
+    steps:
+      - checkout
+      - run:
+          name: TexLive
+          command: |
+            sudo apt-get update -qq
+            sudo apt-get install -y imagemagick ghostscript latexmk texlive texlive-latex-recommended texlive-fonts-recommended texlive-formats-extra
+      # INSTALLATION
+      - *install_pips
+      # DOCUMENTATION
+      - *make_docs
+
 workflows:
   version: 2
   build: