Hello everyone! I was thinking about starting a website where to dump some guides on stuff Iearn about selfhosting and general IT stuff.

I don’t want a WordPress or similar. I want static pages (but I’m ok with some JavaScript for navigation maybe, or for proper display on different kind of devices). Ideally I’d like to host it on an AWS S3 bucket since it has the built-in option for static hosting.

I could even go back to the '90s and do it myself from scratch in textedit and html by hand, but I’m pretty sure there are better options out there.

I took a look at Hugo but even that it seems overly complicated for what I need.

Any ideas or suggestions?

Thanks!

  • @chips@startrek.website
    link
    fedilink
    English
    07 months ago

    Hey there! For a friendly and simple static site generator, you might wanna check out Jekyll. It’s pretty lightweight, works great with Markdown, and has a nice community. Plus, it’s super easy to deploy on S3. You can still hand-code if you want, but Jekyll will save you a bunch of time!

  • rand_alpha19
    link
    fedilink
    08 months ago

    Have you considered a wiki instead? I use OtterWiki and I like it a lot. It has version control using Git too.

    There are several dozen different wiki softwares out there, you can compare their features using this site.

    • @rsolva@lemmy.world
      link
      fedilink
      English
      08 months ago

      OtterWiki looks awesome! The combination of markdown, git and a web interface is powerful.

      • rand_alpha19
        link
        fedilink
        08 months ago

        Yeah! It lets me focus on content instead of building the actual site so I thought I would suggest it given OP’s use case.

        Also the CSS can be modified with a separate file that overrides the default, so it’s pretty customizable without touching the actual config files at all.

  • anguo
    link
    fedilink
    English
    08 months ago

    If you don’t want to code it, give Publii a look. Otherwise, my go-to is Eleventy, simple and clean.

  • @Moonrise2473@feddit.it
    link
    fedilink
    English
    08 months ago

    What about Publii?

    WYSIWYG static site generator but personally I like to keep the content in markdown pages in a git repository so i can keep unlimited edit history; this saves everything in a local sqlite database.

    Unfortunately the most powerful one that checks all the boxes, including automatic upload to s3 is hugo, but as you said the learning curve is high. Maybe try to see if you can run the example site of this theme, install hugo in your system, then go in the examplesite directory and run hugo serve. Slowly edit the files until you understand how it works.

  • String
    link
    fedilink
    English
    08 months ago

    I’ve been meaning to change my website from Hugo to Zola. It has a few good themes to choose from and it’s easy to set up. Hugo has way more themes though.

    You might want to check out a lot of SSGs to see what themes each has, and pick the one you like the most.

    • @manuel2258@lemy.lol
      link
      fedilink
      English
      08 months ago

      I build my website using Zola, which worked pretty good. However I wasn’t satisfied with the existing templates so I did build my own using DaisyUI. That also worked pretty good most of the time and was a pleasant experience!

  • @mbirth@lemmy.ml
    link
    fedilink
    English
    08 months ago

    GitHub supports Jekyll page generation. Or at least did this a few years ago.

    And please make sure to also generate an RSS feed for us feed reader users. ;)

  • @rutrum@lm.paradisus.day
    link
    fedilink
    English
    08 months ago

    I recently built a site with hugo. Its very easy. You pick a theme, then write some markdown files. And when you need flexibility, you have it for later. I also think it’s the most popular right now, which lends to a lot of themes to pick from and a lot of cpmmunity support.

  • @thayerw@lemmy.ca
    link
    fedilink
    English
    08 months ago

    Lots of great responses here already. In terms of simplicity and ease of maintenance, Hugo is going to be the best solution with its single binary, built-in features, and ease of setup/use.

  • @Kcg@lemmy.ml
    link
    fedilink
    English
    0
    edit-2
    8 months ago

    Mkdocs is great! Used by many different OS projects. Simple markdown to HTML site.