Add the demo run to the website pages

[davidorme]

Description

This adds a new page to the docs that contains the current simple walkthrough of running the model. It fixes a couple of minor sphinx issues along the way.

See: https://virtual-ecosystem.readthedocs.io/en/426-add-a-demo-run-to-the-website-pages/virtual_ecosystem/virtual_ecosystem_in_use.html

Closes #426

Type of change

• New feature (non-breaking change which adds functionality)
• Optimization (back-end change that speeds up the code)
• Bug fix (non-breaking change which fixes an issue)

Key checklist

• Make sure you've run the pre-commit checks: $ pre-commit run -a
• All tests pass: $ poetry run pytest

Further checks

• Code is commented, particularly in hard-to-understand areas
• Tests added that prove fix is effective or that feature works

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 94.68%. Comparing base (13af7ac) to head (b508176).

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #428      +/-   ##
===========================================
+ Coverage    94.52%   94.68%   +0.16%     
===========================================
  Files           70       70              
  Lines         3744     3744              
===========================================
+ Hits          3539     3545       +6     
+ Misses         205      199       -6     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[jacobcook1995]

LGTM! Only comment is that it isn't as engrossing as the live demo as it doesn't run while you watch it, but I'm guessing that isn't straightforward to setup the docs to do.

[davidorme]

Yeah - there's no way to generate this dynamically on request. We'd need a live jupyter server running an instance - which we could do but probably not now 😄

[jacobcook1995]

Yeah that definitely feels like overkill for this PR

[vgro]

Looks good to me, a few small comments regarding the input data.

[davidorme]

Yeah that definitely feels like overkill for this PR

I think it's probably as simple as using Binder? https://mybinder.org/