Failing RTD build

[bmorris3]

I'm trying to build the docs on a package I'm developing based on the package template, and I get the following build error when RTD runs conda env create --quiet --name latest --file /home/docs/checkouts/readthedocs.org/user_builds/fleck/checkouts/latest/.rtd-environment.yml:

Solving environment: ...working... failed

ResolvePackageNotFound: 
  - sphinx-astropy
  - sphinx-gallery

Could be related to #387?

[pllim]

You need to add those two packages to your RTD pip requirements? At some point, they were take out of helpers. Did you just updated your helpers or something?

[bmorris3]

Do you mean like this? Because I tried and it didn't work.

[pllim]

You can try their v2 format: https://docs.readthedocs.io/en/stable/config-file/v2.html

[pllim]

Also check your RTD admin settings.

[pllim]

Oh, wait, don't use conda on RTD. Use pip.

[bmorris3]

I'm not sure I follow – where can I specify pip instead of conda?

[pllim]

Like this: https://docs.readthedocs.io/en/stable/config-file/v2.html#conda

Your original comment above mentioned conda.

[bmorris3]

As @pllim suggested, switching some dependencies to pip solved the problem, like so:

dependencies:
    - python>=3.5
    - numpy
    - astropy
    - Cython
    - pip:
       - matplotlib
       - sphinx-astropy
       - batman-package
       - shapely

[bsipocz]

pip these days are faster than conda, so the suggestion here was to use pip only.