Add example gallery to docs

[jessegrabowski]

Description

This PR adds an example gallery to the Pytensor docs (like PyMC-Examples). Right now it's a bit hidden, but it's more a proof of concept than anything else. We can start populating it with short vignettes on how to use pytensor, and maybe some longer worked examples of what you can do with the library.

There's a dumb example notebook in there now, but that should be replaced with some real stuff before this is merged.

Related Issue

• Closes #
• Related to How can we make docs better? #715

Checklist

• Checked that the pre-commit linting/style checks pass
• Included tests that prove the fix is effective or that the new feature works
• Added necessary documentation (docstrings and/or example notebooks)
• If you are a pro: each commit corresponds to a relevant logical change

Type of change

• New feature / enhancement
• Bug fix
• Documentation
• Maintenance
• Other (please specify):

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[ricardoV94]

The footer still says "Citing PyMC examples"

[ricardoV94]

Looks good to me. I have some ideas on the Scan example but I would do it after we merge this PR

[jessegrabowski]

We don't need to merge these notebooks. Obviously the intro to pytensor one should be deleted. I just wanted stuff in there to check that things were working, and I remembered @cluhmann 's comment that "the best source for scan isn't even in our docs".

[ricardoV94]

We can remove the intro (or bring from the docs). Not too worried about merging these examples as is

[jessegrabowski]

I was also thinking about porting the tutorial series into the gallery. They will be much easier to maintain as notebooks, and should have a lot more visibility.

But we should have an into notebook that answers the question "what is this package and why should I use it"

[jessegrabowski]

I also need to add inter-package links to the two remaining notebooks. I was also thinking we should either put some plots in the notebooks or generate images, so the thumbnails aren't both just the rocket logo

[ricardoV94]

I was also thinking about porting the tutorial series into the gallery. They will be much easier to maintain as notebooks, and should have a lot more visibility.

Yeah

But we should have an into notebook that answers the question "what is this package and why should I use it"

Not sure it's better has a notebook but I'm doing something like that

[jessegrabowski]

Gonna stop tinkering on this one and call it done. I am starting to look at fixing other issues in the docs that are unrelated to the gallery, but those should be separate issues.

The only super out-of-scope thing I did here was to add a robots.txt and a sitemap.xml that should improve our indexing. I can drop that commit if we want someone with more web experience to look at it first.

[ricardoV94]

The failing tests are due to new scipy, I have a fix in another PR