Skip to content
This repository was archived by the owner on Jun 2, 2020. It is now read-only.
This repository was archived by the owner on Jun 2, 2020. It is now read-only.

Explore alternatives to Hugo #71

Closed
@Mr0grog

Description

@Mr0grog

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:

Metadata

Metadata

Assignees

No one assigned

    Labels

    dif/hardHaving worked on the specific codebase is importanttopic/design-contentContent design, writing, information architecture

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions