this post was submitted on 28 Oct 2024
143 points (100.0% liked)

Selfhosted

39868 readers
405 users here now

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:

  1. Be civil: we're here to support and learn from one another. Insults won't be tolerated. Flame wars are frowned upon.

  2. No spam posting.

  3. 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.

  4. Don't duplicate the full text of your blog or github here. Just post the link for folks to click.

  5. Submission headline should match the article title (don’t cherry-pick information from the title to fit your agenda).

  6. No trolling.

Resources:

Any issues on the community? Report it using the report flag.

Questions? DM the mods!

founded 1 year ago
MODERATORS
 

Hi,

I'm interested in setting up a small static-site-generator site. Looked at 11ty recently and feel pretty uncomfortable with the amount of javascript and "funny language" churn just to make some html happen.

Do you know of any alternative that's simpler / easier / less complicated dependencies? Or do you have an approach to 11ty that you think I should try?

Thanks in advance for any input, it's appreciated!

top 50 comments
sorted by: hot top controversial new old
[–] [email protected] 1 points 10 hours ago

https://www.sphinx-doc.org/ + https://pradyunsg.me/furo/ theme + https://myst-parser.readthedocs.io/ markdown parser + https://sphinx-design.readthedocs.io/ extensions.

Just drop all your markdown files in a directory and run sphinx-build. Highly customizable but also works out of the box

[–] [email protected] 2 points 1 day ago (1 children)

I want to second Pelican for Python. Really easy to set up and get going. No need to learn a complicated templating language (it's jinja2, which is what everything uses).

[–] [email protected] 1 points 19 hours ago

Thanks for the recommendation!

[–] [email protected] 4 points 2 days ago (1 children)

In case you're familiar with Obsidian, there's Quartz: quartz.jzhao.xyz/ Runs in docker too, practically zero config to start

[–] [email protected] 1 points 1 day ago

Thanks for the recommendation!

[–] [email protected] 1 points 1 day ago* (last edited 1 day ago) (1 children)
[–] [email protected] 1 points 19 hours ago

Quarto is probably the most unique one I've seen so far. Thanks for the input.

[–] [email protected] 21 points 3 days ago (2 children)

Zola. Similar to Hugo, but newer and written in Rust.

https://www.getzola.org/

[–] [email protected] 4 points 2 days ago

I used Zola for a while, but at the end of the day there wasnt enough themes available that fit what I was looking for. I ended up messing with the templating engine to get what I needed.

I suggest OP choose Hugo over Zola, in the hopes that they find a theme that suits them best and for the most part prevents them from having to touch templating to begin with.

load more comments (1 replies)
[–] [email protected] 34 points 3 days ago (3 children)

I use Hugo and I've been pretty happy with it. It has a lot of layout templates you can use out of the box so you don't need to learn a new templating language unless you want to do customizations. I write blogs in markdown and it's automatically rendered and published.

[–] [email protected] 11 points 3 days ago (1 children)

But as soon as you do want to customize it, you're stuck learning one of the most esoteric languages that wasn't meant as a joke.

[–] [email protected] 4 points 3 days ago

Thanks for the heads up. That feels like the same roadblock I got with 11ty. It ran OK on markdown, but one you dig into how wide the customizations go I couldn't keep up.

[–] [email protected] 5 points 3 days ago (1 children)

I used Hugo for my portfolio site, and it's great if you like an existing theme, but making one from scratch is a challenge. The documentation is unclear and there's a chicken and egg problem about how to learn Hugo.

The go templating is OK, I prefer other syntax but it works.

load more comments (1 replies)
load more comments (1 replies)
[–] [email protected] 13 points 3 days ago (2 children)

https://getpublii.com/

It's a GUI app that runs on your local system and pushes sites to a server.

[–] [email protected] 3 points 3 days ago

I’m planning on porting my Wordpress site to this. I haven’t used it yet but based on what I’ve read it will be easier than Hugo.

[–] [email protected] 2 points 3 days ago

Thank you for the recommendation!

[–] [email protected] 11 points 3 days ago (6 children)

I think you might like hugo

It's what I use for my blog

[–] [email protected] 6 points 3 days ago (1 children)
[–] [email protected] 1 points 1 day ago

Lol yes another gd deer, just got the car back yesterday.

[–] [email protected] 4 points 3 days ago

Seconded. OP, if you can write Markdown, Hugo will turn it into a website.

[–] [email protected] 3 points 3 days ago

Thank you for the recommendation!

And best of luck with the repair. That's a crazy bill estimate.

load more comments (3 replies)
[–] [email protected] 10 points 3 days ago (1 children)

This might be what you're looking for: Zola

Single binary that lets you keep your markdown/config in git and just build it from the git clone folder you're in at the time.

I know some people that have moved off of Hugo to this, and Alex from the Selfhosted podcast recently talked about it on their show.

load more comments (1 replies)
[–] [email protected] -3 points 1 day ago* (last edited 1 day ago)

I used an LLM... Took me about an hour to set up a cicd pipeline in cloudflare pages which pulls code on change from my GitHub

The LLM guided me through that part too..

Then I used Cursor to make the thing. It actually performed really well. Just told it to make it look like medium.com since I like that clean look.

Https://slashdir.net

Entirely ai generated, blog post too.

[–] [email protected] 4 points 2 days ago (1 children)

I think mkdocs is easier than hugo but less flexible in terms of capability. However it serves all my needs (list of webpages accessible from a central frontpage)

[–] [email protected] 1 points 1 day ago
[–] [email protected] 8 points 3 days ago (1 children)

Try Publii. It does everything for you. You can even set up the FTP upload.

load more comments (1 replies)
[–] [email protected] 7 points 3 days ago (1 children)

Use Publii, it has a WYSIWYG editor, a block editor and a markdown editor. It creates the files on your PC and can upload it to your server. Just point your webserver to the uploaded folder.

Very beginner friendly ☝🏻

[–] [email protected] 2 points 3 days ago

Thanks for the recommendation!

[–] [email protected] 6 points 3 days ago (1 children)

I like using Hugo at present

load more comments (1 replies)
[–] [email protected] 6 points 3 days ago (1 children)

I found pelican to be quite simple to start with and depending on how deep you want to go it can be quite customizable. Being proficient in python helps.

load more comments (1 replies)
[–] JackbyDev 3 points 3 days ago (1 children)
[–] [email protected] 1 points 1 day ago

Neat, thanks!

[–] [email protected] 3 points 3 days ago* (last edited 3 days ago) (1 children)
[–] [email protected] 1 points 1 day ago

Thanks for the recommendations!

[–] [email protected] 4 points 3 days ago* (last edited 3 days ago) (3 children)

Have you checked out grav https://learn.getgrav.org/17/basics/what-is-grav

https://github.com/getgrav/grav

I use it just to make simple markdown sites for info like my gaming servers or if I feel like making a random blog post

[–] [email protected] 4 points 3 days ago (1 children)

Technically Grav is not a static site generator, it is just a flat file cms. It means there is no need to generate all the files of website and upload them to server each time you write a post. I have no idea why people like static sites for blogging.

load more comments (1 replies)
[–] [email protected] 3 points 3 days ago

As the sibling comment says, not a static site generator. If you want to customize pretty much anything about the layout or theming you still need to use Twig, CSS and if you're unlucky JS.

[–] [email protected] 2 points 3 days ago

Thanks for the recommendation. I actually did look at grav a while back, but I can't recall why I moved on. Will give it another pass.

[–] [email protected] 2 points 3 days ago (2 children)

Docusaurus. It's all markdown.

[–] [email protected] 1 points 1 day ago

Will give that a look, thanks!

[–] [email protected] 3 points 3 days ago* (last edited 3 days ago) (1 children)

Thanks for the rec! Looks awesome; Imma try it :)

https://docusaurus.io/

[–] [email protected] 3 points 3 days ago

Oof. Meta open source. Srsly sus. •͡˘㇁•͡˘

[–] [email protected] 2 points 3 days ago* (last edited 3 days ago) (1 children)

Codeberg Pages if you don't mind a give-or-take weekly 30 min downtime. GitHub Pages if you do. GitLab Pages if you have a creditcard which they require to verify your identity.

[–] [email protected] 1 points 2 days ago (1 children)

I recently switched to Codeberg Pages and it's the first time I'm hearing about a weekly downtime. Is there somewhere this is documented or I can read more about it?

[–] [email protected] 1 points 2 days ago

“Honestly, I am completely unsure how to proceed with the pages server.
It might be the best idea to deprecate it.

[–] [email protected] 3 points 3 days ago (1 children)
[–] [email protected] 2 points 3 days ago

Thank you for the recommendation!

[–] [email protected] 3 points 3 days ago (3 children)

I did try setting up 11ty, despite my misgivings over node.js. Using Markdown went OK, except it wouldn't render explicit tag parameters to allow me to do one-off formatting.

load more comments (3 replies)
load more comments
view more: next ›