Explore alternatives to Hugo #71
Description
I think it makes sense to move ahead with #68, which uses Hugo, but mostly because that keeps what’s changing there small (just content and menus, not the whole framework).
However, we noted the following in that PR:
@Mr0grog: I’m also not 100% sure Hugo is the best fit (this nav bar code is horrifying, and while it could be better, it would still be pretty complicated because of Hugo’s lack of plugins)
@olizilla: Strongly agree. I find Hugo's template system deeply bizarre. I feel I must be missing a super strong grounding in Go templates. Anything even mildy data driven gets really complex. And the error messages are infuriatingly cryptic too. I'd gladly discuss moving to something else, the challenge is finding a static site generator that can deal with relative paths for links and resouces like css background-image urls and inline styles.
Let’s use this issue to explore/discuss potential tools. (Off the top of my head: maybe Gitbook? I used it for the research and I know it can be customized, but I don’t know quite how extensively.)
Running list of suggested tools:
- Gitbook (Both a hosting service and a free, open source static site generation tool. Used in @flyingzumwalt’s Decentralized Web Primer)
- Gatsby.js (Being used for the new js.ipfs.io; make sure to check gatsby-plugin-ipfs)
- Metalsmith (More of a plug-in framework for static sites)
- VuePress (See also the “book”)
- Hexo
- Sphinx