Enh/readthedocs

[satra]

adds the preferred way to set readthedocs settings for building the docs.

currently readthedocs is still failing in master with the same alt error.

[codecov]

Codecov Report

Merging #3207 into master will increase coverage by 0.00%.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master    #3207   +/-   ##
=======================================
  Coverage   64.89%   64.89%           
=======================================
  Files         301      301           
  Lines       39717    39717           
  Branches     5268     5268           
=======================================
+ Hits        25775    25776    +1     
  Misses      12884    12884           
+ Partials     1058     1057    -1     

Flag	Coverage Δ
#unittests	64.89% <ø> (+<0.01%)	⬆️

Impacted Files	Coverage Δ
nipype/pipeline/engine/utils.py	71.72% <0.00%> (+0.11%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 28ef1af...d3a965c. Read the comment docs.

[oesteban]

LGTM

[satra]

unfortunately still failing on readthedocs. https://readthedocs.org/projects/nipype/builds/10866072/
i will walk away for a bit. (@effigies and @oesteban if you have any ideas, let me know).

[effigies]

Oh, the issue is that installing niflow-nipype1-workflows is installing nipype from PyPI.

I'm going to fiddle with the RTD yaml directly on master so we get some feedback from readthedocs.

[satra]

Oh, the issue is that installing niflow-nipype1-workflows is installing nipype from PyPI.

aha. thanks @effigies

[effigies]

Got most of the way, and then failed on the nipype_tutorial.ipynb example: https://readthedocs.org/projects/nipype/builds/10866330/

We haven't been rendering up to now, so I've just blacklisted it from being copied in a10d3da.

[effigies]

PDF is problematic: https://readthedocs.org/projects/nipype/builds/10866371/

I assume EPUB is no less so. If we want to get these built, let's open issues to work on them.

[satra]

sounds good.