Documentation: Add configuration for "Read the Docs"

[amotl]

This patch implements the suggestion from GH-140, to use "Read the Docs" for hosting the documentation.

[blaylockbk]

Thanks for your efforts here and elsewhere.
Yes, I agree hosting on readthedocs would be great. I went ahead and signed up and imported Herbie. My only question before merging this is the URL the docs are hosted from. You changed all the docs URL to https://herbie-data.readthedocs.io/, but when I imported Herbie to readthe docs, it says the URL would be http://herbie.readthedocs.io/ (herbie and not herbie-data).

I think I'd like to keep it http://herbie.readthedocs.io/ to have the URL match the repo and package name. The name herbie-data I have only used for installing because herbie is already claimed on pypi.

[amotl]

Sounds good. I will update all links accordingly.

[amotl]

04c6a3f now uses https://herbie.readthedocs.io/ across the board.

[blaylockbk]

The docs build failed because ModuleNotFoundError: No module named 'herbie'.

I thought selecting this checkbox would have taken care of this

Is there another way of telling rtd to install herbie?

[blaylockbk]

Hmmm, I added these lines to .readthedocs.config

- method: pip
      path: .

which did attempt to install herbie, but then it ran into the issue where cartopy couldn't be installed with pip. Do you know of a workaround for this? The docs use the sphinx autosummary, which I think requires herbie to be installed, but I may be wrong.

[blaylockbk]

another thing I tried was adding herbie and herbie.archive to the autodoc_mock_imports in docs/config.py, but that didn't help either. I'm not sure what else to try next.

[amotl]

The docs use the sphinx autosummary, which I think requires the herbie package to be installed. The installation on RTD ran into the issue where cartopy couldn't be installed with pip.

Oh I see, thanks. Based on learnings from GH-139, let's see how we can add this to the RTD configuration. It should satisfy the prerequisites for installing cartopy (geos), and others (eccodes), without needing to go all in with a full Conda environment.

Herbie/.github/workflows/tests-python.yml

Lines 57 to 60 in 899fb5f

	- name: Install prerequisites (Linux)
	if: runner.os == 'Linux'
	run: |
	sudo apt -y install libgeos-dev libeccodes-dev