From 970d9af7e679de14eb0cff1595f932c36463bad1 Mon Sep 17 00:00:00 2001 From: Yixing Lao Date: Sat, 8 Aug 2020 19:42:20 -0700 Subject: [PATCH] pin python deps version for building docs (#2154) --- .travis.yml | 2 +- docs/builddocs.rst | 14 ++++---------- 2 files changed, 5 insertions(+), 11 deletions(-) diff --git a/.travis.yml b/.travis.yml index f3ef486a279..de4a3370361 100644 --- a/.travis.yml +++ b/.travis.yml @@ -70,7 +70,7 @@ matrix: # Install Python dependencies for building docs - which python - python -V - - pip install -U -q "sphinx>=3.0" sphinx-rtd-theme nbsphinx Pillow + - pip install -U -q "sphinx==3.1.2" "sphinx-rtd-theme==0.5.0" "nbsphinx==0.7.1" "Pillow==7.2.0" # m2r needs a patch for sphinx 3 # https://github.com/sphinx-doc/sphinx/issues/7420 - pip install -U -q git+https://github.com/intel-isl/m2r@dev#egg=m2r diff --git a/docs/builddocs.rst b/docs/builddocs.rst index 41919d9af36..9ec9239889d 100644 --- a/docs/builddocs.rst +++ b/docs/builddocs.rst @@ -40,19 +40,13 @@ First, install a TeX distribution such as `MacTeX `_ .. code-block:: bash - # For pip - pip install "sphinx>=3.0" sphinx-autobuild nbsphinx Pillow + # Install deps + pip install -U "sphinx==3.1.2" "sphinx-rtd-theme==0.5.0" "nbsphinx==0.7.1" "Pillow==7.2.0" - # Or, for Conda - conda install "sphinx>=3.0" sphinx-autobuild nbsphinx Pillow - -Install the patched ``m2r`` package for converting ``.md`` to ``.rst``. - -.. code-block:: bash - - # https://github.com/sphinx-doc/sphinx/issues/7420 + # Patched m2r: https://github.com/sphinx-doc/sphinx/issues/7420 pip install -U -q git+https://github.com/intel-isl/m2r@dev#egg=m2r + Build -----