Live data from Hacker News

Show HN: Bearclaw – tiny static site generator with RSS

github.com

1–10 of 25 posts

Show HN: Bearclaw – tiny static site generator with RSS

#1
hey yall, I made bearclaw because I just wanted an unopinionated static site generator with no toolchain and fancy stuff going on; it'd be my pleasure to show it to you today and answer any questions you might have.

If you do end up trying out bearclaw, you can use nginx or your favorite webserver. Earlier this week I made eclaire - a static site webserver with compression, caching, and automatic HTTPS through letsencrypt. https://github.com/donuts-are-good/eclaire

Show HN: Bearclaw – tiny static site generator with RSS
github.com

Re: Show HN: Bearclaw – tiny static site generator with RSS

#4
post #3

Looks cool! What are it's advantages over hugo?

Hey thanks for looking :) hugo has a lot more moving parts, and a lot more dependencies [0]. bearclaw is written to be simple and easy to understand without instructions or learning any new paradigms about templating or frontmatter or other markup languages.

[0] https://github.com/gohugoio/hugo#dependencies

Re: Show HN: Bearclaw – tiny static site generator with RSS

#7
post #6

For someone completely unfamiliar with GO, how do I install this or where should I get started?

Hey there, thanks for asking. There are precompiled versions of it so you can run it like an .exe if you want to.

You can grab one of the binaries here [0] for your system, then put your markdown content in the markdown folder that bearclaw makes when you run it the first time. Bearclaw puts the html it generates in the output folder. If you want to, you can tell markdown to just keep an eye on the folder and it will generate the output as you make it, like if you have a webserver pointing at your output/ folder.

From there it's up to you, you can put it on github, or use your own server with nginx or apache or caddy.

[0] - https://github.com/donuts-are-good/bearclaw/releases/tag/1.1...

Re: Show HN: Bearclaw – tiny static site generator with RSS

#8
Hello all, thanks for checking out my project! For those of you trying out Eclaire right now to host your Bearclaw site, I'm getting a weird 500 error right now that I probably introduced in the last day or two, and I'd bet you guys would too. I'll do some thinking about it tomorrow and see what I can do to smooth it out. Bookmark it and hang in there, or chime in on the issue I made to remind me to fix it, and we'll see you soon!

Re: Show HN: Bearclaw – tiny static site generator with RSS

#9
I got really frustrated with Hugo yesterday when I couldn't add a page with just a list of all my posts on it. I spent a few hours playing around with a bunch of different options, Hexo seemed to come the closest to something I could fire up and just drop my existing markdown in (though it did blow up on a youtube embedded player I had in one post).

Bearclaw does look super simple to get going, but seemed to be missing a few things I was hoping for:

  - No real documentation, so I copied my markdown files over.
  - Ran bearclaw and put the output in a web accessible location.
  - Went there and there was no index.html (though "home" on the "posts" page seems to link to it).
  - The "posts.html" page just has filenames, so it doesn't seem to pick up the frontmater.
It's definitely leaning in the direction I was looking for, but maybe a little too far. :-)

Re: Show HN: Bearclaw – tiny static site generator with RSS

#10
post #3

Looks cool! What are it's advantages over hugo?

Hey thanks for looking :) hugo has a lot more moving parts, and a lot more dependencies [0]. bearclaw is written to be simple and easy to understand without instructions or learning any new paradigms about templating or frontmatter or other markup languages. [0] https://github.com/gohugoio/hugo#dependencies

Not using a template language and avoiding to do error handling are not good ways to make a program "simple and easy to understand".

If your users run into one of the many string escaping bugs or get an unexpected error code from the file system, the program will not behave as expected and not detect the error either.

Post reply on HN