Recently, at the CDH we were discussing the possibility of creating a research periodical using a static site, and the question came up regarding which library to choose. In digital humanities, Jekyll seems to be by far the preferred choice, but beyond DH, there’s hundreds of options. Quickly, I realized that part of the issue for DHers is not so much actually getting a static site up an running, but understanding the larger landscape to decide which fits best for your project/problem.
So I quickly put together a workshop with the idea of talking more about the conceptual issues and technical tradeoffs around static sites, rather than getting people to install another programming library (though I do think that’s the number one way you actually get a sense of static site libraries).
Regardless, though I tried to focus on these broader questions and how you can answer them.
How much complexity will your site have? How many pages? How many different types of content? Some static site generators and themes make assumptions for how your content is organized so you may want to find a fairly close example project.
How many contributors? If you are working on a team, you’ll want to invest in testing, continuous integration and deployment to make sure the site doesn’t break. You’ll also want to decide on an editorial process (for an example see the submissions process for the Programming Historian).
How much do you want to customize your site? Some static site generators like Gatsby are easier to customize the styling, whereas others have a whole host of themes to choose from but are harder to manipulate.