Add example notebook for PlasmaPy particles

[namurphy]

This PR is to add a notebook that goes through some examples in plasmapy.particles. I copied it directly from the PlasmaPy documentation, and converted it with jupytext to a .py file.

[sapols]

Thanks for the new example, Nick! And thanks for opening issue #33. This gallery is in a weird state right now; the fix-broken-examples branch got ahead of main so it is the branch I've been merging new examples into. Can you do me a favor and see if the spacepy wheels build when you use the fix-broken-examples branch instead?

I am going to revisit migrating this gallery to JupyterBook in a month, at which point adding a new example will be as easy as adding a .ipynb file. Depending how things go it might make sense to wait and add this new PlasmaPy example to the newly-deployed JupyterBook gallery.

[namurphy]

@sapols — done! I didn't get a spacepy install error, but now rather an error that the most recent version of PlasmaPy can't be found.

Depending how things go it might make sense to wait and add this new PlasmaPy example to the newly-deployed JupyterBook gallery.

An excuse to procrastinate? Count me in! 😹

Have you looked into Myst-NB? That looks like a really handy way to build Jupyter notebooks out of MyST Markdown files, though it's still in beta. We tried a pull request in PlasmaPy but there were some features that we depend on that it didn't have yet (PlasmaPy/PlasmaPy#1472).

[namurphy]

I also copied over and adapted a GitHub Action from PlasmaPy as an attempt to have GitHub Actions do the doc build. It still needs some work.

[namurphy]

I had to change the settings in conf.py a little bit, but was able to get the GitHub Action to mostly work. Right now the error is not due to the package setup, but rather a problem with the notebook. Since my plan is to wait to add this until after the Jupyterbook gallery is set up in order to add this, I'm going to let this sit for a while.

[sapols]

Good deal, I'll ping back here when the Jupyter Book work starts! 👍