Open specific version of tutorial in Colab

[adamjstewart]

If you view the tutorials on RtD, we now default to the latest stable release. However, the "Open in Colab" button still opens up the main version. This PR fixes that.

The only remaining "gotcha" is that all versions of the tutorial will pip install torchgeo, so they'll all use the latest stable release, even if something has changed since then in main. We can avoid this issue by defaulting to the docs for the latest stable release, but as soon as someone tries a different versions of the docs it may not work.

Fixes #274
Fixes #310

[adamjstewart]

I guess the pip install issue could be solved by including the entire installation procedure in the prolog before the tutorial title. Seems kinda ugly though...

[adamjstewart]

Ah no, we can't move the pip install to the prolog because the prolog only affects what gets displayed on RtD, the file that gets opened in Colab is only the raw file itself.

[RitwikGupta]

lgtm

[RitwikGupta]

What's the hope with the tutorials, that they work off of the latest changes on main?

[adamjstewart]

I think the ideal behavior would be that if I view a certain version of the docs:

1. I get the same version of the tutorial,
2. the "Open in Colab" button opens the same version of the tutorial, and
3. pip install installs the same version of TorchGeo.

So if I view the "latest" version, it displays the tutorial for main, opens it in Colab, and installs a development version. But if I view the docs for a stable release X.Y.Z, it displays that version of the tutorial, opens it in Colab, and installs the X.Y.Z release of TorchGeo.

Currently we have 1, with this PR we now have 2, but 3 is still elusive.

[sofstef]

I'm still having the same issue as #274 and #310. Is there a way to pip install the latest version in Google colab and if not how do you recommend running the tutorials in Google colab?

[isaaccorley]

@sofstef pip install git+https://github.com/microsoft/torchgeo

[adamjstewart]

Yep, instructions for installing from main can be found at https://torchgeo.readthedocs.io/en/latest/user/installation.html

The problem is that we want to keep only a single version of the tutorial in the repo, but pip install always installs the latest stable release by default. If you have any suggestions for how to handle this I would love to hear them.