From a3f4a02cf87e71aa5cb84b0bd75eef7aa9f5da09 Mon Sep 17 00:00:00 2001 From: Dean Moldovan Date: Thu, 23 Feb 2017 08:57:25 +0100 Subject: [PATCH] Minor docs build maintenance (#692) * Switch breathe to stable releases. It was previously pulling directly from master because a required bugfix was not in a stable release yet. * Force update sphinx and RTD theme. When using conda, readthedocs pins sphinx==1.3.5 and sphinx_rtd_theme==0.1.7, which is a bit older than the ones used in the RTD regular (non-conda) build. The newer theme has nicer sidebar navigation (4-level depth vs. only 2-level on the older version). Note that the python==3.5 requirement must stay because RTD still installs the older sphinx at one point which isn't available with Python 3.6. [skip ci] --- docs/environment.yml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/environment.yml b/docs/environment.yml index 06ffdb0da..879afc432 100644 --- a/docs/environment.yml +++ b/docs/environment.yml @@ -4,7 +4,9 @@ channels: - defaults dependencies: - python==3.5 +- sphinx==1.5.1 +- sphinx_rtd_theme==0.1.9 - doxygen - pip - pip: - - https://github.com/michaeljones/breathe/archive/master.zip + - breathe