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.
You basically just define templates in pseudo html for common content (header, nav panel, footer, etc), and then you write your articles in markdown and Hugo combines the two and outputs actual html files.
You also have a content folder for js, css, and images which get output as is.
That’s about all there is to it, it’s a pretty minimalist static site generator.
Hosting wise you can just put it on github pages for free.
What I use for a lot of my sites is SvelteKit. It has a static site generator. If you like writing the HTML by hand, it’s great. Also HTML5 Up is where I get my templates. I made the https://nymph.io website this way. And https://sveltematerialui.com.
I had a workflow a few years ago where I ran and configured a local drupal instance, then ran this HTTrack tool which would export all the pages and images to flat HTML which I then zipped and pushed to an S3 bucket to host the website. Worked great because it just needed to host info, no comments or accounts or anything.
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.
If you use github pages, you can create, deploy, and host static websites for free. Only cost, if you want your own URL, is for a custom DNS name.
You can use their default Jekyll static rendering engine, and create the content using Markdown. And with github actions, all you need to update the content is create markdown, then push the change to the same repo. After a few minutes, the new content shows up.
You can also find ‘themes’ to customize the look and feel of the site, specific to the site generation tool.
If you want a lot of extra features, Docusaurus is pretty much as good as it gets, and you can set it up to push out to GH pages: https://docusaurus.io/docs/deployment
You are not logged in. However you can subscribe from another Fediverse account, for example Lemmy or Mastodon. To do this, paste the following into the search field of your instance: !selfhosted@lemmy.world
A place to share alternatives to popular online services that can be self-hosted without giving up privacy or locking you into a service you don’t control.
Rules:
Be civil: we’re here to support and learn from one another. Insults won’t be tolerated. Flame wars are frowned upon.
No spam posting.
Posts have to be centered around self-hosting. There are other communities for discussing hardware or home computing. If it’s not obvious why your post topic revolves around selfhosting, please include details to make it clear.
Don’t duplicate the full text of your blog or github here. Just post the link for folks to click.
Submission headline should match the article title (don’t cherry-pick information from the title to fit your agenda).
I use Hugo, it’s not super complicated.
You basically just define templates in pseudo html for common content (header, nav panel, footer, etc), and then you write your articles in markdown and Hugo combines the two and outputs actual html files.
You also have a content folder for js, css, and images which get output as is.
That’s about all there is to it, it’s a pretty minimalist static site generator.
Hosting wise you can just put it on github pages for free.
Mkdocs is great! Used by many different OS projects. Simple markdown to HTML site.
Grav may fit your needs.
What I use for a lot of my sites is SvelteKit. It has a static site generator. If you like writing the HTML by hand, it’s great. Also HTML5 Up is where I get my templates. I made the https://nymph.io website this way. And https://sveltematerialui.com.
I had a workflow a few years ago where I ran and configured a local drupal instance, then ran this HTTrack tool which would export all the pages and images to flat HTML which I then zipped and pushed to an S3 bucket to host the website. Worked great because it just needed to host info, no comments or accounts or anything.
https://www.httrack.com/
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.
My vote goes to Zola, too.
I recently migrated my Hugo blog to Zola.
DocFx could do what you’re looking for. You would write your stuff in markdown and it generates an interactive and customizable site.
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. ;)
If you use github pages, you can create, deploy, and host static websites for free. Only cost, if you want your own URL, is for a custom DNS name.
You can use their default Jekyll static rendering engine, and create the content using Markdown. And with github actions, all you need to update the content is create markdown, then push the change to the same repo. After a few minutes, the new content shows up.
https://pages.github.com/
Hugo can also be used, but it takes a few extra steps: https://gohugo.io/hosting-and-deployment/hosting-on-github/
You can also find ‘themes’ to customize the look and feel of the site, specific to the site generation tool.
If you want a lot of extra features, Docusaurus is pretty much as good as it gets, and you can set it up to push out to GH pages: https://docusaurus.io/docs/deployment