[Bf-docboard-svn] bf-manual: [8155] trunk/blender_docs: Use pinned dependencies for sphinx

Aaron Carlisle noreply at blender.org
Tue Jun 22 04:26:11 CEST 2021


Revision: 8155
          https://developer.blender.org/rBM8155
Author:   Blendify
Date:     2021-06-22 04:26:10 +0200 (Tue, 22 Jun 2021)
Log Message:
-----------
Use pinned dependencies for sphinx

Sphinx has rather loose dependency requirements which can cause issues if we aren't careful.
As a solution they recommend that you pin sphinx dependency versions

This also removes the need of ` --upgrade-strategy eager` which is bad practice as it could install incompatible versions

Modified Paths:
--------------
    trunk/blender_docs/manual/about/contribute/install/linux.rst
    trunk/blender_docs/manual/about/contribute/install/macos.rst
    trunk/blender_docs/manual/about/contribute/install/windows.rst
    trunk/blender_docs/requirements.txt

Modified: trunk/blender_docs/manual/about/contribute/install/linux.rst
===================================================================
--- trunk/blender_docs/manual/about/contribute/install/linux.rst	2021-06-22 01:02:31 UTC (rev 8154)
+++ trunk/blender_docs/manual/about/contribute/install/linux.rst	2021-06-22 02:26:10 UTC (rev 8155)
@@ -59,4 +59,4 @@
 
    Every now and then you may want to make sure your dependencies are up to date using::
 
-      sudo pip3 install -r requirements.txt --upgrade --upgrade-strategy eager
+      sudo pip3 install -r requirements.txt --upgrade

Modified: trunk/blender_docs/manual/about/contribute/install/macos.rst
===================================================================
--- trunk/blender_docs/manual/about/contribute/install/macos.rst	2021-06-22 01:02:31 UTC (rev 8154)
+++ trunk/blender_docs/manual/about/contribute/install/macos.rst	2021-06-22 02:26:10 UTC (rev 8155)
@@ -54,4 +54,4 @@
 
    Every now and then you may want to make sure your dependencies are up to date using::
 
-      sudo pip install -r requirements.txt --upgrade --upgrade-strategy eager
+      sudo pip install -r requirements.txt --upgrade

Modified: trunk/blender_docs/manual/about/contribute/install/windows.rst
===================================================================
--- trunk/blender_docs/manual/about/contribute/install/windows.rst	2021-06-22 01:02:31 UTC (rev 8154)
+++ trunk/blender_docs/manual/about/contribute/install/windows.rst	2021-06-22 02:26:10 UTC (rev 8155)
@@ -69,4 +69,4 @@
 
    Every now and then you may want to make sure your dependencies are up to date using::
 
-      pip install -r requirements.txt --upgrade --upgrade-strategy eager
+      pip install -r requirements.txt --upgrade

Modified: trunk/blender_docs/requirements.txt
===================================================================
--- trunk/blender_docs/requirements.txt	2021-06-22 01:02:31 UTC (rev 8154)
+++ trunk/blender_docs/requirements.txt	2021-06-22 02:26:10 UTC (rev 8155)
@@ -1,5 +1,13 @@
-sphinx==3.5.3
+sphinx==3.5.4
 
+# Sphinx dependencies that are important
+Jinja2==2.11.3
+Pygments==2.9.0
+docutils==0.16
+snowballstemmer==2.1.0
+babel==2.9.1
+requests==2.25.1
+
 # Only needed for building translations.
 sphinx-intl==2.0.1
 
@@ -10,4 +18,4 @@
 # Only for convenience, allows live updating while editing RST files.
 # Access by running:
 #   make livehtml
-sphinx-autobuild
+sphinx-autobuild==2021.3.14



More information about the Bf-docboard-svn mailing list