use sphinx to build the site?

[lheagy]

[transferred from simpeg/old-website#23]

It might be helpful to add a page about the weekly meeting, similar to the pangeo weekly meetings page that shows both the upcoming meetings and the notes. As I dug into the code a bit, the overhead right now for generating a new page isn't completely trivial. (It isn't impossible, but still requires a level of comfort with html).

I had a look around the web and both pangeo and fatiando sites nicely apply their own css and use sphinx, which is already familiar to those who contribute to the simpeg and discretize docs. What are peoples' thoughts on building the site from .rst or .md files using sphinx?

[lheagy]

@rowanc1: I would appreciate hearing your take on this when you have a chance

[lheagy]

The discussion of including publications in #15 and simpeg/community#11 is re-surfacing how we build the site. With the current format, my approach would be to hack together a custom script that parses the bibtex and gives us the associated HTML page, but this is making me wonder if we should look at another static site generator format so that we can produce simpler intermediate files (e.g. markdown or rst). I would be curious to hear thoughts from others. A couple of possibilities from googling around that would still let us bring in a custom format

• sphinx
• jekyll

I would be curious to hear thoughts.

[prisae]

I vote for sphinx - it keeps the barrier low as the same system is used for the website as is used for the documentation. Nice examples of sphinx-pages in our realm include https://www.pygimli.org/ and https://www.fatiando.org/ (I also started using it for https://emsig.xyz/).

[lheagy]

@jcapriot: you did some work to get the docs template to match the theme on the website. Is that something you think would be easy to port over here?

[jcapriot]

Oh yeah! It should be pretty easy. I’ll look into it