I’m planning to teach folks about making their own website later this year, but I’m conflicted about which static site generator to use. Jekyll is what I’m most experienced with, but it seems to be more complex to install and stuff. Jekyll also doesn’t have stuff like multi language websites and alike.

Tho Hugo seems something I’d like to avoid, since apparently themes end up being completely different frameworks from each other so the documentation doesn’t always apply and switching themes on a ready website seems harder?

Are there any other options out there? Ideally easier to install than jekyll, easy to set up on codeberg/github pages, extensible and more complete but without Hugos issues.

I’ll probably migrate my website to whatever I choose as a way to learn the new generator.

Edit: Zola seems interesting, anyone has opinions about that one?

Edit 2: Nah I didn’t like Zola

Do note that the target audience includes people who never touched a terminal or any programming language before, so not needing much of those paradigms is preferred (I could, and probably will, give them a basic template to begin with tho)

Zola seems interesting, anyone has opinions about that one?
Ugh, Zola doesn't support having the dates in blog pages urls? That sucks
And you need to write the homepage in html as a template or something instead of having an index.md? Ok ugh I don't think I like Zola actually. I was going to migrate my website to it today but nevermind.

And you can't put the codes stufff in content pages???

Like, this doesn't work

content/awawa/_index.md:

+++
title = "Blog"
template = "index.html"
+++

{% for post in section.pages %}
<li><a href="{{ post.permalink }}">{{ post.title }}</a></li>
{% endfor %}

It literaly renders the
{% for post in section.pages %} and etc as text on the final html... What the fuck

Ok yeah that's it I'm in the market for static site generators again
  • Jekyll: Sucks to install and run locally
  • Hugo: Sucks to use
  • Zola: Sucks to use
@luana Zine next???
@bakaq Just checked, didn’t like its syntax. I’d rather something more similar to Tera/Jinja2/Liquid/Django…
@luana Why not just use Jinja then? This is only 30% ironic.

@bakaq @luana

Pelican is python-based.

https://getpelican.com/

Pelican – A Python Static Site Generator

Pelican static site generator

@luana Zola is totally made for people who want to tinker with the templating engine a bunch (which is what I do for my blog). IMO if you want something thats more "batteries included", I'd stay away from Zola. I think theres some stellar alternatives out there that'll meet your needs

@luana
Zola may be a nice one to introduce as its a binary it may help a bit.

For a more "recent" one check on [lume](https://lume.land/) too   

Using gulp to clean, minify and publish is also handy, it may be something to use and explain in your case.

Lume, the static site generator for Deno

Support for multiple file formats like Markdown, YAML, JavaScript, TypeScript, JSX, Nunjucks etc.

@luana as far codeberg pages are concerned, if you are using woodpecker ci, setting up automatic deployment of static page can be done with codeberg.org/sugar700/plugin-codeberg-pages-deploy, which was written by faer ​​

no idea about the static page generator that would supports multiple languages, but whatever you decide on, as long it makes a directory with a generated website, it will work with faer deployment plugin
​​
plugin-codeberg-pages-deploy

Woodpecker CI Plugin to deploy sites to Codeberg Pages

Codeberg.org

@luana I like Pelican: https://getpelican.com/. It's Python, pretty much all the configuration is in one or two files, natively does reStructuredText but can do Markdown too. Installation is one pip command and then there is a quickstart wizard, but it comes with disadvantages of Python (mainly virtualenvs). Themes are Jinja2, have good documentation and to me they felt quite straightforward. (I felt they may not be too consistent, as in not all themes use all the β€œstandard” variables from the config.)

If you want some inspiration, the #HackerTrain website is done with it. Here are the sources, this is the output as served on https://hackertrain.org. (We went with the output being a git submodule of the source repo, which might not be beginer friendly, though. The docs have some other tips, on a quick glance it looks like not so much pain.)

Another inspiration might be my blog, whose source including the theme is here, but I self host it, so deployment by pointing nginx at particular directory is probably out of scope.

Pelican – A Python Static Site Generator

Pelican static site generator

@luana I really like Kiki https://tomotama.itch.io/kiki.

Still working slowly on mine in my spare time, to replace my current site.

kiki: a tiny homepage construction set by tomotama

a construction set for building your own homepage, wiki and blog

itch.io

@luana I like Jekyll and @cwebber has been pushing Haunt.

Idk about multi language but Jekyll can certainly filter/group a collection by a language properly on collection members.

@luana I use Zola. It works pretty well, for even advanced stuff. My most complex site using it is https://aw2.help

I found it much easier than Jekyll, though there are a few github gotchas -- creating a .nojekyll file being the primary thing.

Can't compare with Hugo, never tried it.

Accessibility Wars

Accessible Builds for the Guild Wars 2 Community

Accessibility Wars

@luana https://makko.starlightnet.work/ is a one-binary-download-and-execute install and has a more limited scope which might make it easier than some others that have very extensive feature sets

it is also strictly anti llm which i value, this is no longer true for zola, pelican and others

makko :)

@luana honestly I’ve managed to teach a few people who have never coded in their lives HTML, so it can’t be *that* hard :P